This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: RFA: update 'target remote' description
- From: Eli Zaretskii <eliz at gnu dot org>
- To: Jim Blandy <jimb at codesourcery dot com>
- Cc: gdb-patches at sourceware dot org
- Date: Thu, 09 Mar 2006 06:38:04 +0200
- Subject: Re: RFA: update 'target remote' description
- References: <vt2lkvlvqji.fsf@theseus.home.>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> 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.
> +@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?
Thanks.