From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 29961 invoked by alias); 29 Sep 2011 07:20:35 -0000 Received: (qmail 29938 invoked by uid 22791); 29 Sep 2011 07:20:32 -0000 X-SWARE-Spam-Status: No, hits=-1.3 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_SOFTFAIL X-Spam-Check-By: sourceware.org Received: from mtaout21.012.net.il (HELO mtaout21.012.net.il) (80.179.55.169) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 29 Sep 2011 07:20:11 +0000 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0LS900F00VY5H400@a-mtaout21.012.net.il> for gdb-patches@sourceware.org; Thu, 29 Sep 2011 10:19:08 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.228.8.215]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LS900FREWBV9G70@a-mtaout21.012.net.il>; Thu, 29 Sep 2011 10:19:08 +0300 (IDT) Date: Thu, 29 Sep 2011 07:20:00 -0000 From: Eli Zaretskii Subject: Re: Rename "info definitions"? In-reply-to: To: Matt Rice Cc: dje@google.com, gdb-patches@sourceware.org Reply-to: Eli Zaretskii Message-id: <83wrcreryp.fsf@gnu.org> References: <20110921190419.542512461A9@ruffy.mtv.corp.google.com> X-IsSubscribed: yes 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 X-SW-Source: 2011-09/txt/msg00503.txt.bz2 > Date: Wed, 28 Sep 2011 19:13:58 -0700 > From: Matt Rice > Cc: gdb-patches@sourceware.org > > +info macro [-all] [--] MACRO > + The info macro command has new options -all and --. Please quote the options with `..'. Also, please have 2 spaces after the period. > The first or printing ^^ "for", I guess. > + all definitions of a macro. The second for explicitly specifying the end > + of arguments and the beginning of the macro name. I would add "in case the macro name starts with a hyphen". > +@item info macro @r{[}-a@r{|}-all@r{]} @r{[}--@r{]} @var{macro} You don't need the @r{} markup here. It is only needed in the @def* lines, because those cause the rest of the line automatically typeset as in @var{}, which produces a slanted typeface in print. Since we want the square brackets typeset in the normal Roman typeface, we countermand the slanted face with @r{}. But @item does not have that effect, so @r{} is not needed. OK with those changes.