From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 68883 invoked by alias); 4 May 2018 18:07:45 -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 68865 invoked by uid 89); 4 May 2018 18:07:44 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-7.4 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_1,SPF_HELO_PASS autolearn=ham version=3.3.2 spammy=Zaretskii, zaretskii X-HELO: mx1.redhat.com Received: from mx3-rdu2.redhat.com (HELO mx1.redhat.com) (66.187.233.73) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Fri, 04 May 2018 18:07:43 +0000 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 2D117EB71E; Fri, 4 May 2018 18:07:42 +0000 (UTC) Received: from [127.0.0.1] (ovpn04.gateway.prod.ext.ams2.redhat.com [10.39.146.4]) by smtp.corp.redhat.com (Postfix) with ESMTP id 89A2B83B8E; Fri, 4 May 2018 18:07:41 +0000 (UTC) Subject: Re: [RFA 01/12] Fix help and documentation for inferior commands To: Eli Zaretskii , Tom Tromey References: <20180430143731.30007-1-tom@tromey.com> <20180430143731.30007-2-tom@tromey.com> <837eoosokt.fsf@gnu.org> Cc: gdb-patches@sourceware.org From: Pedro Alves Message-ID: Date: Fri, 04 May 2018 18:07:00 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 MIME-Version: 1.0 In-Reply-To: <837eoosokt.fsf@gnu.org> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-SW-Source: 2018-05/txt/msg00115.txt.bz2 On 04/30/2018 04:26 PM, Eli Zaretskii wrote: >> 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. > > Thanks. > >> @table @code >> -@kindex info inferiors >> +@kindex info inferiors [ @var{ID}@dots{} ] > > "ID" should be in lower-case. (It will be rendered in caps in Info, > but not in the printed output, where it will be typeset in the slant > typeface.) > >> +By default all inferiors are printed, but an argument can be used to >> +limit the display to just the requested inferiors. > > This should reference @var{id} and explain what the "id" there is. > Someone might think it's a PID, for example. I think it'll also to good to say that it's a space-separated list of IDs, like we say in the "info threads" help and documentation. See thread-id-list / "thread ID lists", and "breakpoint lists" in the manual for examples. Thanks, Pedro Alves