This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [RFA/RFC/DOC] Fix the different between behavior of "detach inferior" "kill inferior" and doc
- From: Hui Zhu <teawater at gmail dot com>
- To: Eli Zaretskii <eliz at gnu dot org>, Joel Brobecker <brobecker at adacore dot com>
- Cc: gdb-patches at sourceware dot org
- Date: Fri, 30 Jul 2010 17:02:06 +0800
- Subject: Re: [RFA/RFC/DOC] Fix the different between behavior of "detach inferior" "kill inferior" and doc
- References: <AANLkTi=+Xmn+fVFD9KVzGJA0MF8_XB4KHZCCOHPF=W=z@mail.gmail.com> <83y6ctbbpw.fsf@gnu.org>
On Fri, Jul 30, 2010 at 16:44, Eli Zaretskii <eliz@gnu.org> wrote:
>> From: Hui Zhu <teawater@gmail.com>
>> Date: Fri, 30 Jul 2010 16:13:42 +0800
>> Cc: Eli Zaretskii <eliz@gnu.org>
>>
>> So I make a patch to update the doc.
>>
>> Thanks,
>> Hui
>>
>> 2010-07-30 ?Hui Zhu ?<teawater@gmail.com>
>>
>> ? ? ? * gdb.texinfo (Inferiors and Programs): Update the introduce of
>> ? ? ? "detach inferior" and "kill inferior".
>>
>>
>> ---
>> ?doc/gdb.texinfo | ? ?4 ++--
>> ?1 file changed, 2 insertions(+), 2 deletions(-)
>>
>> --- a/doc/gdb.texinfo
>> +++ b/doc/gdb.texinfo
>> @@ -2481,12 +2481,12 @@ using the @w{@code{kill inferior}} comma
>> ?@kindex detach inferior @var{infno}
>> ?@item detach inferior @var{infno}
>> ?Detach from the inferior identified by @value{GDBN} inferior number
>> -@var{infno}, and remove it from the inferior list.
>> +@var{infno}.
>>
>> ?@kindex kill inferior @var{infno}
>> ?@item kill inferior @var{infno}
>> ?Kill the inferior identified by @value{GDBN} inferior number
>> -@var{infno}, and remove it from the inferior list.
>> +@var{infno}.
>> ?@end table
>
> Assuming that the code behaves as intended (i.e. this isn't a bug), I
> suggest the following text instead:
>
> ?Kill the inferior identified by @value{GDBN} inferior number
> ?@var{infno}. ?Note that the inferior's entry still stays on the list
> ?of inferiors shown by @code{info inferiors}, but its Description will
> ?show @samp{<null>}.
>
> and similarly for "detach".
>
> Thanks.
>
OK. I made a new version.
Joel, do you think 7.2 need this patch?
Thanks,
Hui
2010-07-30 Hui Zhu <teawater@gmail.com>
* gdb.texinfo (Inferiors and Programs): Update the introduce of
"detach inferior" and "kill inferior".
---
doc/gdb.texinfo | 8 ++++++--
1 file changed, 6 insertions(+), 2 deletions(-)
--- a/doc/gdb.texinfo
+++ b/doc/gdb.texinfo
@@ -2481,12 +2481,16 @@ using the @w{@code{kill inferior}} comma
@kindex detach inferior @var{infno}
@item detach inferior @var{infno}
Detach from the inferior identified by @value{GDBN} inferior number
-@var{infno}, and remove it from the inferior list.
+@var{infno}. Note that the inferior's entry still stays on the list
+of inferiors shown by @code{info inferiors}, but its Description will
+show @samp{<null>}.
@kindex kill inferior @var{infno}
@item kill inferior @var{infno}
Kill the inferior identified by @value{GDBN} inferior number
-@var{infno}, and remove it from the inferior list.
+@var{infno}. Note that the inferior's entry still stays on the list
+of inferiors shown by @code{info inferiors}, but its Description will
+show @samp{<null>}.
@end table
After the successful completion of a command such as @code{detach},