Re: Improve "help all"

Mark Kettenis
2006-11-01T22:50:25Z

> 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