octave-maintainers
[Top][All Lists]
Advanced

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

Re: Help strings in the text body of the manual


From: Doug Stewart
Subject: Re: Help strings in the text body of the manual
Date: Sun, 24 Apr 2016 17:34:30 -0400



On Sun, Apr 24, 2016 at 5:19 PM, Pantxo Diribarne <address@hidden> wrote:


Le 24/04/2016 22:49, Jordi Gutiérrez Hermoso a écrit :
On Sun, 2016-04-24 at 21:41 +0200, Pantxo Diribarne wrote:
I find some sections of the manual hardly readable due to the verbatim
inclusion of lists of function help strings.
Can you give an example of the section that ought to be rewritten?
Even better, can you provide a patch of what you think should be done?

- Jordi G. H.




An example in the plotting section:
https://gnu.org/software/octave/doc/interpreter/Two_002dDimensional-Plots.html#Two_002dDimensional-Plots

A bit of text, then a block of 5 help strings, then a bit of text and
then an endless list of help strings.

The reason I asked is I suppose this organisation of the manual has
already been discussed so I won't write a patch if there are already
arguments against the change I propose.

Pantxo






I don't see what you are talking about. Can you explain it more fully?

--
DAS


reply via email to

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