From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-65060-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 22689 invoked by alias); 1 Jul 2009 19:16:55 -0000
Received: (qmail 22676 invoked by uid 22791); 1 Jul 2009 19:16:53 -0000
X-SWARE-Spam-Status: No, hits=2.0 required=5.0 	tests=AWL,BAYES_40,BOTNET,SPF_SOFTFAIL
X-Spam-Check-By: sourceware.org
Received: from mtaout1.012.net.il (HELO mtaout1.012.net.il) (84.95.2.1)     by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Wed, 01 Jul 2009 19:16:42 +0000
Received: from conversion-daemon.i-mtaout1.012.net.il by i-mtaout1.012.net.il (HyperSendmail v2007.08) id <0KM400100AIXPV00@i-mtaout1.012.net.il> for gdb-patches@sourceware.org; Wed, 01 Jul 2009 22:15:51 +0300 (IDT)
Received: from HOME-C4E4A596F7 ([84.228.13.73]) by i-mtaout1.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0KM4009XNAUENW80@i-mtaout1.012.net.il>; Wed, 01 Jul 2009 22:15:51 +0300 (IDT)
Date: Wed, 01 Jul 2009 19:16:00 -0000
From: Eli Zaretskii <eliz@gnu.org>
Subject: Re: Move the multi-forks support to the generic multi-inferiors support.
In-reply-to: <200907011927.59624.pedro@codesourcery.com>
To: Pedro Alves <pedro@codesourcery.com>
Cc: msnyder@vmware.com, gdb-patches@sourceware.org
Reply-to: Eli Zaretskii <eliz@gnu.org>
Message-id: <83y6r82p08.fsf@gnu.org>
References: <200905310013.38916.pedro@codesourcery.com> <4A315A9F.8090805@vmware.com> <200907011927.59624.pedro@codesourcery.com>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Id: <gdb-patches.sourceware.org>
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2009-07/txt/msg00039.txt.bz2

> From: Pedro Alves <pedro@codesourcery.com>
> Date: Wed, 1 Jul 2009 19:27:59 +0100
> Cc: "gdb-patches@sourceware.org" <gdb-patches@sourceware.org>,
>  Eli Zaretskii <eliz@gnu.org>
> 
> Eli, what do you think of this (and of the docs changes)?

I'm fine with it, but I have a couple of comments about the docs.

> +from it by using the @w{@code{detach inferior}} command (allowing it
> +to run independently), or kill it using the @w{@code{kill inferior}}
> +command.  Again, @pxref{Inferiors, ,Debugging Multiple Inferiors}.

@pxref is inappropriate here, since it is designed to be used inside
parentheses.  You want "see @ref" instead.

And I would lose the "Again" part (in which case you can simply use
@xref).

> +info inferiors
> +  List the inferiors currently under GDB's control.
> +
> +inferior NUM
> +  Switch focus to inferior number NUM.
> +
> +detach inferior NUM
> +  Detach from inferior number NUM.
> +
> +kill inferior NUM
> +  Kill inferior number NUM.

I think this deserves a short intro, like one or two sentences saying
something about multi-inferior debugging.

> +process PID
> +  Removed.

Perhaps say something about replacement command(s), or why none is
needed.

Thanks.