(Server): Clarify that `file' should be used before connecting to the server.

(Files): Add an xref to the above description.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 06ddd7296298507a01c2f1b35446013fa7c0520c..7f4d15916503b0dfdd044c93a34b973b8c93225b 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+2005-06-18  Eli Zaretskii  <eliz@gnu.org>
+
+       * gdb.texinfo (Server): Clarify that `file' should be used before
+       connecting to the server.
+       (Files): Add an xref to the above description.
+
 2005-06-18  Nick Roberts  <nickrob@snap.net.nz>
 
        * gdb.texinfo (GDB/MI Stack Manipulation): Remove reference to

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 2446da5947fa89b9c981eeb2ccd9cc8e0f4dd452..88b9a2676f1be9ab91247a43d3f2eb35b0c548fa 100644 (file)
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -10618,9 +10618,10 @@ way to do this is at start-up time, using the arguments to
 Out of @value{GDBN}}).
 
 Occasionally it is necessary to change to a different file during a
-@value{GDBN} session.  Or you may run @value{GDBN} and forget to specify
-a file you want to use.  In these situations the @value{GDBN} commands
-to specify new files are useful.
+@value{GDBN} session.  Or you may run @value{GDBN} and forget to
+specify a file you want to use.  Or you are debugging a remote target
+via @code{gdbserver} (@pxref{Server, file}).  In these situations the
+@value{GDBN} commands to specify new files are useful.
 
 @table @code
 @cindex executable file
@@ -11941,8 +11942,12 @@ For TCP connections, you must start up @code{gdbserver} prior to using
 the @code{target remote} command.  Otherwise you may get an error whose
 text depends on the host system, but which usually looks something like
 @samp{Connection refused}.  You don't need to use the @code{load}
-command in @value{GDBN} when using gdbserver, since the program is
-already on the target.
+command in @value{GDBN} when using @code{gdbserver}, since the program is
+already on the target.  However, if you want to load the symbols (as
+you normally would), do that with the @code{file} command, and issue
+it @emph{before} connecting to the server; otherwise, you will get an
+error message saying @code{"Program is already running"}, since the
+program is considered running after the connection.
 
 @end table