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.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 11fb77289b82947aab832c1bec156fd0eb205c79..7d0c9bbff1b16409940f71b275f0dc57bc60202f 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,5 +1,9 @@
 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.
+
        * gdb.texinfo (Connecting): Organize the different 'target remote'
        connection methods into a table.  Add a 'target remote' index
        entry. (!!!)

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 5fb3c5e2ceb026c9834790ddc4291555e0672447..6fc2a3a4a5bf06626600ee9be38f509d1b177784 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -11906,14 +11906,23 @@ An executable file.  @samp{target exec @var{program}} is the same as
 A core dump file.  @samp{target core @var{filename}} is the same as
 @samp{core-file @var{filename}}.
 
-@item target remote @var{dev}
+@item target remote @var{medium}
 @cindex remote target
-Remote serial target in GDB-specific protocol.  The argument @var{dev}
-specifies what serial device to use for the connection (e.g.@:
-@file{/dev/ttya}). @xref{Remote, ,Remote debugging}.  @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.
+A remote system connected to @value{GDBN} via a serial line or network
+connection.  This command tells @value{GDBN} to use its own remote
+protocol over @var{medium} for debugging.  @xref{Remote Debugging}.
+
+For example, if you have a board connected to @file{/dev/ttya} on the
+machine running @value{GDBN}, you could say:
+
+@smallexample
+target remote /dev/ttya
+@end smallexample
+
+@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.
 
 @item target sim
 @cindex built-in simulator target