Re: Help strings in the text body of the manual

[Pantxo Diribarne]

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