This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [RFA 01/12] Fix help and documentation for inferior commands
- From: Tom Tromey <tom at tromey dot com>
- To: Eli Zaretskii <eliz at gnu dot org>
- Cc: Tom Tromey <tom at tromey dot com>, gdb-patches at sourceware dot org
- Date: Wed, 09 May 2018 14:29:28 -0600
- 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>
>>>>> "Eli" == Eli Zaretskii <eliz@gnu.org> writes:
>> From: Tom Tromey <tom@tromey.com>
>> Cc: Tom Tromey <tom@tromey.com>
>> 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