From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-46004-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 9453 invoked by alias); 1 Nov 2006 20:16:48 -0000
Received: (qmail 9442 invoked by uid 22791); 1 Nov 2006 20:16:47 -0000
X-Spam-Check-By: sourceware.org
Received: from romy.inter.net.il (HELO romy.inter.net.il) (192.114.186.66)     by sourceware.org (qpsmtpd/0.31) with ESMTP; Wed, 01 Nov 2006 20:16:34 +0000
Received: from HOME-C4E4A596F7 (IGLD-80-230-68-222.inter.net.il [80.230.68.222]) 	by romy.inter.net.il (MOS 3.7.3-GA) 	with ESMTP id GDJ23316 (AUTH halo1); 	Wed, 1 Nov 2006 22:16:27 +0200 (IST)
Date: Wed, 01 Nov 2006 20:16:00 -0000
Message-Id: <uslh26hy9.fsf@gnu.org>
From: Eli Zaretskii <eliz@gnu.org>
To: Vladimir Prus <ghost@cs.msu.su>
CC: gdb-patches@sources.redhat.com
In-reply-to: <ei9qlv$olr$1@sea.gmane.org> (message from Vladimir Prus on Wed, 	01 Nov 2006 12:50:55 +0300)
Subject: Re: Improve "help all"
Reply-to: Eli Zaretskii <eliz@gnu.org>
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>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2006-11/txt/msg00008.txt.bz2

> 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).