From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 81917 invoked by alias); 10 May 2018 02:31:40 -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 81892 invoked by uid 89); 10 May 2018 02:31:39 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-6.9 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_1,SPF_PASS autolearn=ham version=3.3.2 spammy=U*gdb-patches, gdbpatchessourcewareorg, sk:gdb-pat, sk:gdbpat X-HELO: eggs.gnu.org Received: from eggs.gnu.org (HELO eggs.gnu.org) (208.118.235.92) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 10 May 2018 02:31:31 +0000 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fGbMb-0004rp-AW for gdb-patches@sourceware.org; Wed, 09 May 2018 22:31:29 -0400 Received: from fencepost.gnu.org ([2001:4830:134:3::e]:52162) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fGbMb-0004ri-7o; Wed, 09 May 2018 22:31:25 -0400 Received: from [176.228.60.248] (port=4003 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1fGbMa-0004vn-Ne; Wed, 09 May 2018 22:31:25 -0400 Date: Thu, 10 May 2018 09:17:00 -0000 Message-Id: <83603wp7g7.fsf@gnu.org> From: Eli Zaretskii To: Tom Tromey CC: gdb-patches@sourceware.org In-reply-to: <87po244lp3.fsf@tromey.com> (message from Tom Tromey on Wed, 09 May 2018 14:29:28 -0600) Subject: Re: [RFA 01/12] Fix help and documentation for inferior commands Reply-to: Eli Zaretskii References: <20180430143731.30007-1-tom@tromey.com> <20180430143731.30007-2-tom@tromey.com> <837eoosokt.fsf@gnu.org> <87po244lp3.fsf@tromey.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-IsSubscribed: yes X-SW-Source: 2018-05/txt/msg00233.txt.bz2 > From: Tom Tromey > Cc: Tom Tromey , gdb-patches@sourceware.org > Date: Wed, 09 May 2018 14:29:28 -0600 > > >> @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. Yes, thanks. > This doesn't refer to @var{id} but I didn't see a clean way to do that. Like this: ... but the argument @var{id}@dots{} -- a space separated list ... (Note: "separated", not "separate".)