From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 21824 invoked by alias); 9 May 2018 20:29:33 -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 21809 invoked by uid 89); 9 May 2018 20:29:33 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-7.8 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_1,RCVD_IN_DNSWL_NONE,SPF_HELO_PASS autolearn=ham version=3.3.2 spammy=caps X-HELO: gateway36.websitewelcome.com Received: from gateway36.websitewelcome.com (HELO gateway36.websitewelcome.com) (192.185.186.5) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 09 May 2018 20:29:31 +0000 Received: from cm12.websitewelcome.com (cm12.websitewelcome.com [100.42.49.8]) by gateway36.websitewelcome.com (Postfix) with ESMTP id C0A61400FB24A for ; Wed, 9 May 2018 15:29:29 -0500 (CDT) Received: from box5379.bluehost.com ([162.241.216.53]) by cmsmtp with SMTP id GViLfTdTqlAdrGViLf10Eg; Wed, 09 May 2018 15:29:29 -0500 X-Authority-Reason: nr=8 Received: from 97-122-176-117.hlrn.qwest.net ([97.122.176.117]:34298 helo=bapiya) by box5379.bluehost.com with esmtpsa (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.89_1) (envelope-from ) id 1fGViL-001GpO-HE; Wed, 09 May 2018 15:29:29 -0500 From: Tom Tromey To: Eli Zaretskii Cc: Tom Tromey , gdb-patches@sourceware.org Subject: Re: [RFA 01/12] Fix help and documentation for inferior commands References: <20180430143731.30007-1-tom@tromey.com> <20180430143731.30007-2-tom@tromey.com> <837eoosokt.fsf@gnu.org> Date: Wed, 09 May 2018 20:29:00 -0000 In-Reply-To: <837eoosokt.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 30 Apr 2018 18:26:10 +0300") Message-ID: <87po244lp3.fsf@tromey.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.91 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-BWhitelist: no X-Source-L: No X-Exim-ID: 1fGViL-001GpO-HE X-Source-Sender: 97-122-176-117.hlrn.qwest.net (bapiya) [97.122.176.117]:34298 X-Source-Auth: tom+tromey.com X-Email-Count: 2 X-Source-Cap: ZWx5bnJvYmk7ZWx5bnJvYmk7Ym94NTM3OS5ibHVlaG9zdC5jb20= X-Local-Domain: yes X-SW-Source: 2018-05/txt/msg00213.txt.bz2 >>>>> "Eli" == Eli Zaretskii writes: >> From: Tom Tromey >> Cc: Tom Tromey >> Date: Mon, 30 Apr 2018 08:37:20 -0600 >> >> While doing this I noticed that the manual doesn't document the >> argument to "info inferiors", so I've added that as well. Eli> Thanks. >> @table @code >> -@kindex info inferiors >> +@kindex info inferiors [ @var{ID}@dots{} ] Eli> "ID" should be in lower-case. (It will be rendered in caps in Info, Eli> but not in the printed output, where it will be typeset in the slant Eli> typeface.) >> +By default all inferiors are printed, but an argument can be used to >> +limit the display to just the requested inferiors. Eli> This should reference @var{id} and explain what the "id" there is. Eli> Someone might think it's a PID, for example. How about like this: @kindex info inferiors [ @var{id}@dots{} ] @item info inferiors Print a list of all inferiors currently being managed by @value{GDBN}. By default all inferiors are printed, but the argument -- a space separate list of inferior numbers -- can be used to limit the display to just the requested inferiors. This doesn't refer to @var{id} but I didn't see a clean way to do that. Tom