Re: Improve "help all"

[Mark Kettenis <mark dot kettenis at xs4all dot nl>]

> Date: Wed, 01 Nov 2006 22:16:30 +0200
> From: 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). 

To be honest, I just think this class information isn't particular
useful, and shouldn't be in the online help at all.

Mark