From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 1317 invoked by alias); 9 Mar 2006 18:05:37 -0000 Received: (qmail 1308 invoked by uid 22791); 9 Mar 2006 18:05:37 -0000 X-Spam-Check-By: sourceware.org Received: from xproxy.gmail.com (HELO xproxy.gmail.com) (66.249.82.202) by sourceware.org (qpsmtpd/0.31) with ESMTP; Thu, 09 Mar 2006 18:05:35 +0000 Received: by xproxy.gmail.com with SMTP id s9so360928wxc for ; Thu, 09 Mar 2006 10:05:33 -0800 (PST) Received: by 10.70.124.1 with SMTP id w1mr2505304wxc; Thu, 09 Mar 2006 10:05:32 -0800 (PST) Received: by 10.70.125.17 with HTTP; Thu, 9 Mar 2006 10:05:31 -0800 (PST) Message-ID: <8f2776cb0603091005p22906cbao333e51f7e4da3b4b@mail.gmail.com> Date: Thu, 09 Mar 2006 19:11:00 -0000 From: "Jim Blandy" To: "Eli Zaretskii" Subject: Re: RFA: update 'target remote' description Cc: "Jim Blandy" , gdb-patches@sourceware.org In-Reply-To: MIME-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable Content-Disposition: inline References: X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2006-03/txt/msg00139.txt.bz2 On 3/8/06, Eli Zaretskii wrote: > > From: Jim Blandy > > Date: Tue, 07 Mar 2006 14:27:45 -0800 > > > > > > src/gdb/doc/ChangeLog: > > 2006-03-07 Jim Blandy > > > > * gdb.texinfo (Target Commands): Update text describing how to > > specify a target. Refer to the detailed section on remote > > debugging, not the brief mention. > > This is approved, but: > > > +@item target remote @var{medium} > > +@cindex @code{target remote} > > @cindex remote target > > Please remove this cindex entry. You already added such an entry > where the detailed description of this command is given; having > another one here is redundant, and even harmful, since this section > doesn't really explain about the command. Okay. > > +@code{target remote} supports the @code{load} command. This is only > > +useful if you have some other way of getting the stub to the target > > +system, and you can put it somewhere in memory where it won't get > > +clobbered by the download. > > I'm guessing that this paragraph might be important in some situation > (which one, btw?), otherwise you wouldn't be adding it. So perhaps an > index entry related to that situation would in order here. What > phrases would a person who looks for this information have in mind? Actually, I didn't add that: it's present in the current text. I don't think it belongs there; I was simply avoiding moving it. Ideally, I think the entry for 'target remote' in @section Commands for managing targets should just be a brief reference to @chapter Debugging remote programs, and @section Remote Debugging should be removed, with all its content moved to @chapter Debugging remote programs. But I'd like to keep problems separate here. May I commit this change, with the @cindex @code{target remote} omitted?