[COMMIT] Final portion of documenting undocumented

["Eli Zaretskii" <eliz at gnu dot org>]

This is the last chunk of manual patches aimed at documenting as yet
undocumented commands.

Committed.

2005-04-16  Eli Zaretskii  <eliz@gnu.org>

	* gdb.texinfo (Debugging Output): Document "set/show debug
	solib-frv".  Fix "set/show debugvarobj".
	(ARM): Document "rdilogfile", "rdilogenable", "set/show
	rdiromatzero", "set/show rdiheartbeat".
	(PowerPC): Document SDS-specific commands "set/show sdstimeout",
	"sds".
	(Embedded Processors): Document the "sim" command.
	(Remote): Document the "remote" command.
	(DJGPP Native): Document the "info serial" command.
	(Threads): Document "maint info sol-threads".
	(Files): Document "nosharedlibrary", "add-symbol-file-from-memory".
	(Set Breaks): Improve indexing.
	(Command Syntax): Add a reference to dont-repeat.
	(Define): Document "dont-repeat".
	(TUI Commands): Document "tabset".
	(WinCE): New subsection.  Document "set/show remotedirectory",
	"set/show remoteupload", "set/show remoteaddhost".

Index: gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.243
diff -u -r1.243 gdb.texinfo
--- gdb.texinfo	16 Apr 2005 12:03:29 -0000	1.243
+++ gdb.texinfo	16 Apr 2005 14:25:55 -0000
@@ -1267,7 +1267,8 @@
 repeat the previous command.  Certain commands (for example, @code{run})
 will not repeat this way; these are commands whose unintentional
 repetition might cause trouble and which you are unlikely to want to
-repeat.
+repeat.  User-defined commands can disable this feature; see
+@ref{Define, dont-repeat}.
 
 The @code{list} and @code{x} commands, when you repeat them with
 @key{RET}, construct new arguments rather than repeating
@@ -2257,6 +2258,16 @@
                                from /usr/lib/libc.2
 @end smallexample
 
+On Solaris, you can display more information about user threads with a
+Solaris-specific command:
+
+@table @code
+@item maint info sol-threads
+@kindex maint info sol-threads
+@cindex thread info (Solaris)
+Display info on Solaris user threads.
+@end table
+
 @table @code
 @kindex thread @var{threadno}
 @item thread @var{threadno}
@@ -2606,6 +2617,8 @@
 
 @kindex rbreak
 @cindex regular expression
+@cindex breakpoints in functions matching a regexp
+@cindex set breakpoints in many functions
 @item rbreak @var{regex}
 Set breakpoints on all functions matching the regular expression
 @var{regex}.  This command sets an unconditional breakpoint on all
@@ -10675,6 +10688,19 @@
 the @code{symbol-file} command, to change how @value{GDBN} manages the symbol
 table information for @var{filename}.
 
+@kindex add-symbol-file-from-memory
+@cindex @code{syscall DSO}
+@cindex load symbols from memory
+@item add-symbol-file-from-memory @var{address}
+Load symbols from the given @var{address} in a dynamically loaded
+object file whose image is mapped directly into the inferior's memory.
+For example, the Linux kernel maps a @code{syscall DSO} into each
+process's address space; this DSO provides kernel-specific code for
+some system calls.  The argument can be any expression whose
+evaluation yields the address of the file's shared object file header.
+For this command to work, you must have used @code{symbol-file} or
+@code{exec-file} commands in advance.
+
 @kindex add-shared-symbol-files
 @kindex assf
 @item add-shared-symbol-files @var{library-file}
@@ -10830,6 +10856,7 @@
 Display the current autoloading mode.
 @end table
 
+@cindex load shared library
 To explicitly load shared library symbols, use the @code{sharedlibrary}
 command:
 
@@ -10850,6 +10877,14 @@
 required by your program for a core file or after typing @code{run}.  If
 @var{regex} is omitted all shared libraries required by your program are
 loaded.
+
+@item nosharedlibrary
+@kindex nosharedlibrary
+@cindex unload symbols from shared libraries
+Unload all shared object library symbols.  This discards all symbols
+that have been loaded from all shared libraries.  Symbols from shared
+libraries that were loaded by explicit user requests are not
+discarded.
 @end table
 
 On some systems, such as HP-UX systems, @value{GDBN} supports
@@ -11528,6 +11563,17 @@
 Other remote targets may be available in your
 configuration of @value{GDBN}; use @code{help target} to list them.
 
+Once you've connected to the remote target, @value{GDBN} allows you to
+send arbitrary commands to the remote monitor:
+
+@table @code
+@item remote @var{command}
+@kindex remote@r{, a command}
+@cindex send command to remote monitor
+Send an arbitrary @var{command} string to the remote monitor.
+@end table
+
+
 @node KOD
 @section Kernel Object Display
 @cindex kernel object display
@@ -12698,6 +12744,7 @@
 This command is supported only with some DPMI servers.
 @end table
 
+@cindex DOS serial data link, remote debugging
 In addition to native debugging, the DJGPP port supports remote
 debugging via a serial data link.  The following commands are specific
 to remote serial debugging in the DJGPP port of @value{GDBN}.
@@ -12734,6 +12781,14 @@
 The related commands @samp{show com1base}, @samp{show com1irq} etc.@:
 display the current settings of the base address and the @code{IRQ}
 lines used by the COM ports.
+
+@item info serial
+@kindex info serial
+@cindex DOS serial port status
+This command prints the status of the 4 DOS serial ports.  For each
+port, it prints whether it's active or not, its I/O base address and
+IRQ number, whether it uses a 16550-style FIFO, its baudrate, and the
+counts of various errors encountered so far.
 @end table
 
 
@@ -13325,9 +13380,21 @@
 This section goes into details specific to particular embedded
 configurations.
 
+@cindex send command to simulator
+Whenever a specific embedded processor has a simulator, @value{GDBN}
+allows to send an arbitrary command to the simulator.
+
+@table @code
+@item sim @var{command}
+@kindex sim@r{, a command}
+Send an arbitrary @var{command} string to the simulator.  Consult the
+documentation for the specific simulator in use for information about
+acceptable commands.
+@end table
+
 
 @menu
-* ARM::                         ARM
+* ARM::                         ARM RDI
 * H8/300::                      Renesas H8/300
 * H8/500::                      Renesas H8/500
 * M32R/D::                      Renesas M32R/D
@@ -13344,13 +13411,14 @@
 * AVR::                         Atmel AVR
 * CRIS::                        CRIS
 * Super-H::                     Renesas Super-H
+* WinCE::                       Windows CE child processes
 @end menu
 
 @node ARM
 @subsection ARM
+@cindex ARM RDI
 
 @table @code
-
 @kindex target rdi
 @item target rdi @var{dev}
 ARM Angel monitor, via RDI library interface to ADP protocol.  You may
@@ -13417,6 +13485,50 @@
 Show whether ARM-specific debugging messages are enabled.
 @end table
 
+The following commands are available when an ARM target is debugged
+using the RDI interface:
+
+@table @code
+@item rdilogfile @r{[}@var{file}@r{]}
+@kindex rdilogfile
+@cindex ADP (Angel Debugger Protocol) logging
+Set the filename for the ADP (Angel Debugger Protocol) packet log.
+With an argument, sets the log file to the specified @var{file}.  With
+no argument, show the current log file name.  The default log file is
+@file{rdi.log}.
+
+@item rdilogenable @r{[}@var{arg}@r{]}
+@kindex rdilogenable
+Control logging of ADP packets.  With an argument of 1 or @code{"yes"}
+enables logging, with an argument 0 or @code{"no"} disables it.  With
+no arguments displays the current setting.  When logging is enabled,
+ADP packets exchanged between @value{GDBN} and the RDI target device
+are logged to a file.
+
+@item set rdiromatzero
+@kindex set rdiromatzero
+@cindex ROM at zero address, RDI
+Tell @value{GDBN} whether the target has ROM at address 0.  If on,
+vector catching is disabled, so that zero address can be used.  If off
+(the default), vector catching is enabled.  For this command to take
+effect, it needs to be invoked prior to the @code{target rdi} command.
+
+@item show rdiromatzero
+@kindex show rdiromatzero
+Show the current setting of ROM at zero address.
+
+@item set rdiheartbeat
+@kindex set rdiheartbeat
+@cindex RDI heartbeat
+Enable or disable RDI heartbeat packets.  It is not recommended to
+turn on this option, since it confuses ARM and EPI JTAG interface, as
+well as the Angel monitor.
+
+@item show rdiheartbeat
+@kindex show rdiheartbeat
+Show the setting of RDI heartbeat packets.
+@end table
+
 
 @node H8/300
 @subsection Renesas H8/300
@@ -14088,7 +14200,6 @@
 @subsection PowerPC
 
 @table @code
-
 @kindex target dink32
 @item target dink32 @var{dev}
 DINK32 ROM monitor.
@@ -14102,9 +14213,28 @@
 @kindex target sds
 @item target sds @var{dev}
 SDS monitor, running on a PowerPC board (such as Motorola's ADS).
+@end table
 
+@cindex SDS protocol
+The following commands specifi to the SDS protocol are supported
+by@value{GDBN}:
+
+@table @code
+@item set sdstimeout @var{nsec}
+@kindex set sdstimeout
+Set the timeout for SDS protocol reads to be @var{nsec} seconds.  The
+default is 2 seconds.
+
+@item show sdstimeout
+@kindex show sdstimeout
+Show the current value of the SDS timeout.
+
+@item sds @var{command}
+@kindex sds@r{, a command}
+Send the specified @var{command} string to the SDS monitor.
 @end table
 
+
 @node PA
 @subsection HP PA Embedded
 
@@ -14461,6 +14591,44 @@
 Show the values of all Super-H registers.
 @end table
 
+@node WinCE
+@subsection Windows CE
+@cindex Windows CE
+
+The following commands are available for Windows CE:
+
+@table @code
+@item set remotedirectory @var{dir}
+@kindex set remotedirectory
+Tell @value{GDBN} to upload files from the named directory @var{dir}.
+The default is @file{/gdb}, i.e.@: the root directory on the current
+drive.
+
+@item show remotedirectory
+@kindex show remotedirectory
+Show the current value of the upload directory.
+
+@item set remoteupload @var{method}
+@kindex set remoteupload
+Set the method used to upload files to remote device.  Valid values
+for @var{method} are @samp{always}, @samp{newer}, and @samp{never}.
+The default is @samp{newer}.
+
+@item show remoteupload
+@kindex show remoteupload
+Show the current setting of the upload method.
+
+@item set remoteaddhost
+@kindex set remoteaddhost
+Tell @value{GDBN} whether to add this host to the remote stub's
+arguments when you debug over a network.
+
+@item show remoteaddhost
+@kindex show remoteaddhost
+Show whether to add this host to remote stub's arguments when
+debugging over a network.
+@end table
+
 
 @node Architectures
 @section Architectures
@@ -15227,6 +15395,12 @@
 @item show debug serial
 Displays the current state of displaying @value{GDBN} serial debugging
 info.
+@item set debug solib-frv
+@cindex FR-V shared-library debugging
+Turns on or off debugging messages for FR-V shared-library code.
+@item show debug solib-frv
+Display the current state of FR-V shared-library code debugging
+messages.
 @item set debug target
 @cindex target debugging info
 Turns on or off display of @value{GDBN} target debugging info. This info
@@ -15237,11 +15411,11 @@
 @item show debug target
 Displays the current state of displaying @value{GDBN} target debugging
 info.
-@item set debug varobj
+@item set debugvarobj
 @cindex variable object debugging info
 Turns on or off display of @value{GDBN} variable object debugging
 info. The default is off.
-@item show debug varobj
+@item show debugvarobj
 Displays the current state of displaying @value{GDBN} variable object
 debugging info.
 @end table
@@ -15332,6 +15506,13 @@
 documentation of a command.  Redefining the command with @code{define}
 does not change the documentation.
 
+@kindex dont-repeat
+@cindex don't repeat command
+@item dont-repeat
+Used inside a user-defined command, this tells @value{GDBN} that this
+command should not be repeated when the user hits @key{RET}
+(@pxref{Command Syntax, repeat last command}).
+
 @kindex help user-defined
 @item help user-defined
 List all user-defined commands, with the first line of the documentation
@@ -16053,6 +16234,10 @@
 lines.  Positive counts increase the height, while negative counts
 decrease it.
 
+@item tabset
+@kindex tabset @var{nchars}
+Set the width of tab stops to be @var{nchars} characters.
+
 @end table
 
 @node TUI Configuration