[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Octave-bug-tracker] [bug #53006] GUI Documentation Browser displays Ind

From: Rik
Subject: [Octave-bug-tracker] [bug #53006] GUI Documentation Browser displays Index chapters of manual poorly
Date: Thu, 1 Feb 2018 16:58:35 -0500 (EST)
User-agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:55.0) Gecko/20100101 Firefox/55.0

Follow-up Comment #11, bug #53006 (project octave):

Impressively easy to generate reasonable looking documentation.

A couple quick things I noticed: First, it still isn't as good as the PDF
typeset documentation.  Formulas use the @ifinfo section of the TeXinfo source
which means they are text-based.  This is no worse than what we have today
with the current built-in viewer, but still not as nice.

Second, the example code blocks should be in a fixed width font so that the
decimal point aligns, but Qt Assistant is using a variable width font.  I
found in preferences a way to set the font, but it seemed to apply globally. 
If I want the code blocks to look okay then I need to accept that all the text
is in fixed with font.  Interestingly, this is not the case for the pure HTML
documentation which gets this right.

Third, there is an annoying extra colon before every function.  For example,

: mean (x)
: mean (x, dim)
: mean (x, opt)
: mean (x, dim, opt)

This is no worse than the HTML documentation that also has this defect, but it
looks weird.  I suppose we should fix that and have the effect ripple through
to the derived formats.

To me this is pointing towards making the HTML better and using a Qt widget
that can display that, unless someone sees an easy fix for fonts in Qt


Reply to this item at:


  Message sent via/by Savannah

reply via email to

[Prev in Thread] Current Thread [Next in Thread]