Re: Improve "help all"

[Eli Zaretskii <eliz@gnu.org>]

> From:  Vladimir Prus <ghost@cs.msu.su>
> Date:  Wed, 01 Nov 2006 12:50:55 +0300
> >> >
> >> >    (gdb) help step
> >> >    Step program until it reaches a different source line.
> >> >    Argument N means do this N times (or till program stops for another
> >> >  reason).
> >> >
> >> >    Run "help running" for the list of all commands in this class.
> >> >
> >> >  This patch would require changing "breakpoint" command that already
> >> >  suggests
> >> >  to use "help breakpoints" in its own help string -- I'll do this later
> >> >  if this patch is approved.
> >> 
> >> I really don't like this.
> > 
> > Me neither.  How about this output instead:
> > 
> >    (gdb) help step
> >    Step program until it reaches a different source line.
> >    Argument N means do this N times (or till program stops for another
> >    reason). 
> >    (This command belongs to the class `running'.) 
> 
> 
> So:
>         - you changed wording (and I trust you on this)
>         - you remove a newline.

My goal was not to minimize output, it was to reach an agreement as to
how to provide the information you thought would be useful in a more
palatable way, in the hope that both you and Mark agree (and no one
else objects).

Here's another suggestion, maybe people will like it better:

    (gdb) help step
    Command: `step'; class: `running'.
    Step program until it reaches a different source line.
    Argument N means do this N times (or till program stops for another
    reason).