Re: RFA: update 'target remote' description

["Jim Blandy" <jimb at red-bean dot com>]

On 3/8/06, Eli Zaretskii <eliz@gnu.org> wrote:
> > From: Jim Blandy <jimb@codesourcery.com>
> > Date: Tue, 07 Mar 2006 14:27:45 -0800
> >
> >
> > src/gdb/doc/ChangeLog:
> > 2006-03-07  Jim Blandy  <jimb@red-bean.com>
> >
> >       * 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?