From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-71951-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 27034 invoked by alias); 9 Apr 2010 17:48:54 -0000
Received: (qmail 27022 invoked by uid 22791); 9 Apr 2010 17:48:54 -0000
X-SWARE-Spam-Status: No, hits=-1.2 required=5.0 	tests=BAYES_00,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL
X-Spam-Check-By: sourceware.org
Received: from mtaout22.012.net.il (HELO mtaout22.012.net.il) (80.179.55.172)     by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Fri, 09 Apr 2010 17:48:49 +0000
Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0L0M00100EOI8100@a-mtaout22.012.net.il> for gdb-patches@sourceware.org; Fri, 09 Apr 2010 20:47:35 +0300 (IDT)
Received: from HOME-C4E4A596F7 ([77.124.92.42]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0L0M00KXGER9YZE0@a-mtaout22.012.net.il>; Fri, 09 Apr 2010 20:47:35 +0300 (IDT)
Date: Fri, 09 Apr 2010 17:48:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: [RFA] Add -s option to source command.
In-reply-to: <m3wrwglf99.fsf@fleche.redhat.com>
To: Tom Tromey <tromey@redhat.com>
Cc: sergiodj@redhat.com, gdb-patches@sourceware.org, dje@google.com
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <83ljcwzfev.fsf@gnu.org>
References: <20100406215751.7EC1784397@ruffy.mtv.corp.google.com> <m3fx37uija.fsf@fleche.redhat.com> <i2we394668d1004081549oede200ddkf7c8c51dde0dd8b1@mail.gmail.com> <201004082008.55981.sergiodj@redhat.com> <m3wrwglf99.fsf@fleche.redhat.com>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
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: 2010-04/txt/msg00270.txt.bz2

> From: Tom Tromey <tromey@redhat.com>
> Cc: gdb-patches@sourceware.org, Doug Evans <dje@google.com>
> Date: Fri, 09 Apr 2010 11:14:42 -0600
> 
> >>>>> "Sergio" == Sergio Durigan Junior <sergiodj@redhat.com> writes:
> 
> Sergio> IMHO if we are going to start formatting the help strings like
> Sergio> `--help' output, then we should do it for the majority (if not
> Sergio> all) of the strings.
> 
> Yeah.  I'm curious to hear what other think of this idea.
> 
> The reason I like it is that it is already fairly well understood, and
> existing gdb help strings are often less clear than the typical --help
> output when it comes to usage details.

The current doc strings are modeled after Emacs.  I actually like the
current format, while the suggested one will waste precious screen
space.  But if others want to switch, I won't object.