This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: Improve "help all"
- From: Mark Kettenis <mark dot kettenis at xs4all dot nl>
- To: eliz at gnu dot org
- Cc: ghost at cs dot msu dot su, gdb-patches at sources dot redhat dot com
- Date: Wed, 1 Nov 2006 23:49:59 +0100 (CET)
- Subject: Re: Improve "help all"
- References: <200610272340.26372.vladimir@codesourcery.com> <ulkn0u1ae.fsf@gnu.org> <200610281557.57708.vladimir@codesourcery.com> <ud58ctyms.fsf@gnu.org> <20061028152928.GA396@nevyn.them.org> <ei7eff$al3$1@sea.gmane.org> <13003.192.87.1.22.1162297781.squirrel@webmail.xs4all.nl> <u64e06ry2.fsf@gnu.org> <ei9qlv$olr$1@sea.gmane.org> <uslh26hy9.fsf@gnu.org>
> 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