From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 40495 invoked by alias); 8 Dec 2015 07:48:04 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 40465 invoked by uid 89); 8 Dec 2015 07:48:03 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=0.2 required=5.0 tests=AWL,BAYES_50,RCVD_IN_DNSWL_NONE,SPF_FAIL autolearn=no version=3.3.2 X-HELO: mtaout20.012.net.il Received: from mtaout20.012.net.il (HELO mtaout20.012.net.il) (80.179.55.166) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Tue, 08 Dec 2015 07:48:01 +0000 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0NZ10020046Z3E00@a-mtaout20.012.net.il> for gdb-patches@sourceware.org; Tue, 08 Dec 2015 09:47:58 +0200 (IST) Received: from HOME-C4E4A596F7 ([84.94.185.246]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NYZ00JVZWGE7Q00@a-mtaout20.012.net.il>; Mon, 07 Dec 2015 18:00:15 +0200 (IST) Date: Tue, 08 Dec 2015 07:48:00 -0000 From: Eli Zaretskii Subject: Re: [PATCH] DOCO: Enhance the menu to select function overloads with signatures In-reply-to: <1449491748-2677-1-git-send-email-derodat@adacore.com> To: Pierre-Marie de Rodat Cc: gdb-patches@sourceware.org, brobecker@adacore.com, derodat@adacore.com Reply-to: Eli Zaretskii Message-id: <83egeydzat.fsf@gnu.org> References: <1449491748-2677-1-git-send-email-derodat@adacore.com> X-IsSubscribed: yes X-SW-Source: 2015-12/txt/msg00149.txt.bz2 > From: Pierre-Marie de Rodat > Cc: Joel Brobecker , Pierre-Marie de Rodat > Date: Mon, 7 Dec 2015 13:35:48 +0100 > > diff --git a/gdb/NEWS b/gdb/NEWS > index a222dfb..060f1e2 100644 > --- a/gdb/NEWS > +++ b/gdb/NEWS > @@ -28,6 +28,9 @@ > and "maint info program-spaces" now list the corresponding items in > ascending ID order, for consistency with all other "info" commands. > > +* In Ada, the overloads selection menu has been enhance to display the ^^^^^^^ "enhanced" > +show ada print-signatures" > + Control whether parameter types and return types are displayed in overloads > + selection menus. It is activaled (@code{on}) by default. ^^ Two spaces between sentences, please. > +@node Overloading support for Ada > +@subsubsection Overloading support for Ada > +@cindex Ada, overloading This index entry is backwards: it should be "overloading, Ada". That's because the reader is much more likely to think of "overloading" than of "Ada" when she wants to look up this entry. > +If, after narrowing, the set of matching definitions still contains more than > +one definition, GDB will display a menu to query which one it should use, for ^^^ "@value{GDBN}" > +In this case, just select one menu entry either to cancel expression evaluation > +(type @code{0} and press @code{ENTER}) or to continue evaluation with a ^^^^^^^^ ^^^^^^^^^^^^ @kbd{0} and @key{RET}, respectively. These are GNU conventions for markup of user input and key names. > +specific overloaded entity (type the corresponding number and press Won't "specific instance" be more accurate? Those entries are no longer overloaded, are they? > +@code{ENTER}). @key{RET}. > +@kindex set ada print-signatures > +@item set ada print-signatures > +Control whether parameter types and return types are displayed in overloads > +selection menus. It is activaled (@code{on}) by default. ^^ Two spaces where indicated. Also, I thing you can safely delete "activated" and leave just @code{on} without parentheses. > +@pxref{Overloading support for Ada} @xref, not @pxref, and place a period after the closing brace. OK with these fixed. Thanks.