[Octave-bug-tracker] [bug #53006] GUI Documentation Browser displays Index chapters of manual poorly

[Rik]

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
Assistant.


    _______________________________________________________

Reply to this item at:

  <http://savannah.gnu.org/bugs/?53006>

_______________________________________________
  Message sent via/by Savannah
  http://savannah.gnu.org/