gdbinv-s.texi, gdb.texinfo: include Hitachi SH target

gdb.texinfo: advance manual revision dates to present

gdbinv-s.texi, gdb.texinfo, all-config.texi, h8-config.texi:
stop using silly Roman numerals in @set variable names

5 files changed, 109 insertions, 72 deletions

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 0c518ef..5586edf 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,12 @@
+Fri Apr 23 17:21:13 1993  Roland H. Pesch  (pesch@fowanton.cygnus.com)
+
+	* gdbinv-s.texi, gdb.texinfo: include Hitachi SH target
+
+	* gdb.texinfo: advance manual revision dates to present
+
+	* gdbinv-s.texi, gdb.texinfo, all-config.texi, h8-config.texi:
+	stop using silly Roman numerals in @set variable names
+
 Fri Apr 23 07:30:01 1993  Jim Kingdon  (kingdon@cygnus.com)
 
 	* stabs.texinfo (Parameters): Keep trying to get this right.
diff --git a/gdb/doc/all-config.texi b/gdb/doc/all-config.texi
index fab8a62..765d4df 100644
--- a/gdb/doc/all-config.texi
+++ b/gdb/doc/all-config.texi
@@ -19,24 +19,24 @@
 @set GENERIC
 @c
 @c Hitachi H8/300 target:
-@set Hviii
+@set H8
 @c Hitachi H8/300 target ONLY:
-@clear HviiiEXCLUSIVE
+@clear H8EXCLUSIVE
 @c
 @c SPARC target:
 @set SPARC
 @c
 @c AMD 29000 target:
-@set AMDxxixK
+@set AMD29K
 @c
 @c Intel 960 target:
-@set Icmlx
+@set I960
 @c
 @c Tandem ST2000 (phone switch) target:
-@set STmm
+@set ST2000
 @c
 @c Zilog 8000 target:
-@set ZviiiK
+@set Z8K
 @c
 @c Lucid "Energize" environment:
 @clear LUCID
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index e1b33b6..eb72f4d 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -73,7 +73,7 @@ END-INFO-DIR-ENTRY
 This file documents the GNU debugger @value{GDBN}.
 
 @c !!set edition, date, version
-This is Edition 4.07, January 1993, 
+This is Edition 4.09, April 1993, 
 of @cite{Debugging with @value{GDBN}: the GNU Source-Level Debugger}
 for GDB Version @value{GDBVN}.
 
@@ -108,12 +108,12 @@ instead of in the original English.
 @title Debugging with @value{GDBN}
 @subtitle The GNU Source-Level Debugger
 @ifclear GENERIC
-@subtitle on @value{TARGET} Systems
+@subtitle (@value{TARGET})
 @end ifclear
 @sp 1
 @c !!set edition, date, version
-@subtitle Edition 4.07, for @value{GDBN} version @value{GDBVN}
-@subtitle January 1993
+@subtitle Edition 4.09, for @value{GDBN} version @value{GDBVN}
+@subtitle April 1993
 @author by Richard M. Stallman and Roland H. Pesch
 @page
 @tex
@@ -154,7 +154,7 @@ instead of in the original English.
 This file describes @value{GDBN}, the GNU symbolic debugger.
 
 @c !!set edition, date, version
-This is Edition 4.07, January 1993, for GDB Version @value{GDBVN}.
+This is Edition 4.09, April 1993, for GDB Version @value{GDBVN}.
 
 @menu
 * Summary::                     Summary of @value{GDBN}
@@ -341,7 +341,7 @@ He also enhanced the command-completion support to cover C++ overloaded
 symbols.
 @end ifclear
 
-Hitachi America, Ltd. sponsored the support for the H8/300 and H8/500.
+Hitachi America, Ltd. sponsored the support for Hitachi microprocessors.
 
 @ifset NOVEL
 @node New Features
@@ -718,10 +718,10 @@ or @kbd{C-d} to exit.)
 @node Invoking GDB
 @section Invoking @value{GDBN}
 
-@ifset HviiiEXCLUSIVE
+@ifset H8EXCLUSIVE
 For details on starting up @value{GDBP} as a
-remote debugger attached to a Hitachi H8/300 or H8/500 board, see @ref{Hitachi
-H8 Remote,,@value{GDBN} and the Hitachi H8/300 and H8/500}.
+remote debugger attached to a Hitachi microprocessor, see @ref{Hitachi
+Remote,,@value{GDBN} and Hitachi Microprocessors}.
 @end ifset
 
 Invoke @value{GDBN} by running the program @code{@value{GDBP}}.  Once started,
@@ -794,21 +794,21 @@ in sequential order.  The order makes a difference when the
 @ifset REMOTESTUB
 * Remote Serial::               @value{GDBN} remote serial protocol
 @end ifset
-@ifset Icmlx
+@ifset I960
 * i960-Nindy Remote::		@value{GDBN} with a remote i960 (Nindy)
 @end ifset
-@ifset AMDxxixK
+@ifset AMD29K
 * UDI29K Remote::               @value{GDBN} and the UDI protocol for AMD29K
 * EB29K Remote::		@value{GDBN} with a remote EB29K
 @end ifset
 @ifset VXWORKS
 * VxWorks Remote::		@value{GDBN} and VxWorks
 @end ifset
-@ifset STmm
+@ifset ST2000
 * ST2000 Remote::               @value{GDBN} with a Tandem ST2000
 @end ifset
-@ifset Hviii
-* Hitachi H8 Remote::           @value{GDBN} and the Hitachi H8/300 and H8/500
+@ifset H8
+* Hitachi Remote::              @value{GDBN} and Hitachi Microprocessors
 @end ifset
 @ifset SIMS
 * Simulator::                   Simulated CPU target
@@ -3476,7 +3476,7 @@ will be dumped.  Two arguments specify a range of addresses (first
 inclusive, second exclusive) to dump.
 @end table
 
-@ifclear HviiiEXCLUSIVE
+@ifclear H8EXCLUSIVE
 We can use @code{disassemble} to inspect the object code
 range shown in the last @code{info line} example (the example
 shows SPARC machine instructions):
@@ -3497,7 +3497,7 @@ End of assembler dump.
 @end smallexample
 @end ifclear
 
-@ifset HviiiEXCLUSIVE
+@ifset H8EXCLUSIVE
 For example, here is the beginning of the output for the
 disassembly of a function @code{fact}:
 
@@ -3575,7 +3575,7 @@ command rather than @code{print}. @xref{Symbols, ,Examining the Symbol Table}.
 * Value History::               Value history
 * Convenience Vars::            Convenience variables
 * Registers::                   Registers
-@ifclear HviiiEXCLUSIVE
+@ifclear HAVE-FLOAT
 * Floating Point Hardware::     Floating point hardware
 @end ifclear
 @end menu
@@ -4558,7 +4558,7 @@ code generated by your compiler.  If some registers are not saved, or if
 @value{GDBN} is unable to locate the saved registers, the selected stack
 frame will make no difference.
 
-@ifset AMDxxixK
+@ifset AMD29K
 @table @code
 @item set rstack_high_address @var{address}
 @kindex set rstack_high_address
@@ -4581,7 +4581,7 @@ processors.
 @end table
 @end ifset
 
-@ifclear HviiiEXCLUSIVE
+@ifclear HAVE-FLOAT
 @node Floating Point Hardware
 @section Floating point hardware
 @cindex floating point
@@ -6487,18 +6487,26 @@ On VxWorks, @code{load} will dynamically link @var{filename} on the
 current target system as well as adding its symbols in @value{GDBN}.
 @end ifset
 
-@ifset Icmlx
+@ifset I960
 @cindex download to Nindy-960
 With the Nindy interface to an Intel 960 board, @code{load} will
 download @var{filename} to the 960 as well as adding its symbols in
 @value{GDBN}.
 @end ifset
 
-@ifset Hviii
+@ifset H8
 @cindex download to H8/300 or H8/500
 @cindex H8/300 or H8/500 download
-When you select remote debugging to a Hitachi H8/300 or H8/500 board
-(@pxref{Hitachi H8 Remote,,@value{GDBN} and the Hitachi H8/300 and H8/500}),
+@c start-sanitize-Hitachi-SH
+@cindex download to Hitachi SH
+@cindex Hitachi SH download
+@c end-sanitize-Hitachi-SH
+When you select remote debugging to a Hitachi
+@c start-sanitize-Hitachi-SH
+SH,
+@c end-sanitize-Hitachi-SH
+H8/300, or H8/500 board
+(@pxref{Hitachi Remote,,@value{GDBN} and Hitachi Microprocessors}),
 the @code{load} command downloads your program to the Hitachi board and also
 opens it as the current executable target for @value{GDBN} on your host
 (like the @code{file} command).
@@ -6815,7 +6823,7 @@ specifies what serial device to use for the connection (e.g.
 CPU simulator.  @xref{Simulator,,Simulated CPU Target}.
 @end ifset
 
-@ifset AMDxxixK
+@ifset AMD29K
 @item target udi @var{keyword}
 @kindex target udi
 Remote AMD29K target, using the AMD UDI protocol.  The @var{keyword}
@@ -6832,16 +6840,23 @@ name of the program to be debugged, as it appears to DOS on the PC.
 @xref{EB29K Remote, ,@value{GDBN} with a remote EB29K}.
 
 @end ifset
-@ifset Hviii
+@ifset H8
 @item target hms
 @kindex target hms
-A Hitachi H8/300 or H8/500 board, attached via serial line to your host.  Use
-special commands @code{device} and @code{speed} to control the serial
-line and the communications speed used. @xref{Hitachi H8
-Remote,,@value{GDBN} and the Hitachi H8/300 and H8/500}.
+A Hitachi
+@c start-sanitize-Hitachi-SH
+SH,
+@c end-sanitize-Hitachi-SH
+H8/300, or H8/500 board, attached via serial line to your host.
+@ifclear H8EXCLUSIVE
+@c Unix only, not currently of interest for H8-only manual
+Use special commands @code{device} and @code{speed} to control the serial
+line and the communications speed used.
+@end ifclear
+@xref{Hitachi Remote,,@value{GDBN} and Hitachi Microprocessors}.
 
 @end ifset
-@ifset Icmlx
+@ifset I960
 @item target nindy @var{devicename}
 @kindex target nindy
 An Intel 960 board controlled by a Nindy Monitor.  @var{devicename} is
@@ -6849,7 +6864,7 @@ the name of the serial device to use for the connection, e.g.
 @file{/dev/ttya}.  @xref{i960-Nindy Remote, ,@value{GDBN} with a remote i960 (Nindy)}.
 
 @end ifset
-@ifset STmm
+@ifset ST2000
 @item target st2000 @var{dev} @var{speed}
 @kindex target st2000
 A Tandem ST2000 phone switch, running Tandem's STDBUG protocol.  @var{dev}
@@ -6901,21 +6916,21 @@ configuration of GDB; use @code{help targets} to list them.
 @ifset REMOTESTUB
 * Remote Serial::               @value{GDBN} remote serial protocol
 @end ifset
-@ifset Icmlx
+@ifset I960
 * i960-Nindy Remote::		@value{GDBN} with a remote i960 (Nindy)
 @end ifset
-@ifset AMDxxixK
+@ifset AMD29K
 * UDI29K Remote::               @value{GDBN} and the UDI protocol for AMD29K
 * EB29K Remote::		@value{GDBN} with a remote EB29K
 @end ifset
 @ifset VXWORKS
 * VxWorks Remote::		@value{GDBN} and VxWorks
 @end ifset
-@ifset STmm
+@ifset ST2000
 * ST2000 Remote::               @value{GDBN} with a Tandem ST2000
 @end ifset
-@ifset Hviii
-* Hitachi H8 Remote::           @value{GDBN} and the Hitachi H8/300 and H8/500
+@ifset H8
+* Hitachi Remote::              @value{GDBN} and Hitachi Microprocessors
 @end ifset
 @ifset SIMS
 * Simulator::                   Simulated CPU target
diff --git a/gdb/doc/gdbinv-s.texi b/gdb/doc/gdbinv-s.texi
index a94fa24..234cbdc 100644
--- a/gdb/doc/gdbinv-s.texi
+++ b/gdb/doc/gdbinv-s.texi
@@ -339,7 +339,7 @@ stream.  @code{set remotedebug off} turns it off, and @code{show
 remotedebug} will show you its current state.
 @end ifset
 
-@ifset Icmlx
+@ifset I960
 @node i960-Nindy Remote
 @subsection @value{GDBN} with a remote i960 (Nindy)
 
@@ -444,7 +444,7 @@ a break is detected.
 @c @end group
 @end ifset
 
-@ifset AMDxxixK
+@ifset AMD29K
 @node UDI29K Remote
 @subsection @value{GDBN} and the UDI protocol for AMD29K
 
@@ -655,7 +655,7 @@ unexpected events on the PC side of the connection.
 
 @end ifset
 
-@ifset STmm
+@ifset ST2000
 @node ST2000 Remote
 @subsection @value{GDBN} with a Tandem ST2000
 
@@ -836,16 +836,17 @@ or suspended when you attach to it.  If running, it will be suspended at
 the time of attachment.
 @end ifset
 
-@ifset Hviii
-@node Hitachi H8 Remote
-@subsection @value{GDBN} and the Hitachi H8/300 and H8/500
-@value{GDBN} needs to know these things to talk to your H8/300 or H8/500: 
+@ifset H8
+@node Hitachi Remote
+@subsection @value{GDBN} and Hitachi Microprocessors
+@value{GDBN} needs to know these things to talk to your
+Hitachi SH, H8/300, or H8/500: 
 
 @enumerate
 @item
-that you want to use @samp{target hms}, the remote debugging
-interface for the H8/300 and H8/500 (this is the default when
-GDB is configured specifically for the H8/300 or H8/500);
+that you want to use @samp{target hms}, the remote debugging interface
+for Hitachi microprocessors (this is the default when GDB is configured
+specifically for the Hitachi SH, H8/300, or H8/500);
 
 @item
 what serial device connects your host to your Hitachi board (the first
@@ -858,32 +859,37 @@ what speed to use over the serial device.
 @end ignore
 @end enumerate
 
-@ignore
+@ifclear H8EXCLUSIVE
 @c only for Unix hosts
 @kindex device
-@cindex serial device, H8/300 or H8/500
+@cindex serial device, Hitachi micros
 Use the special @code{@value{GDBP}} command @samp{device @var{port}} if you
 need to explicitly set the serial device.  The default @var{port} is the
 first available port on your host.  This is only necessary on Unix
 hosts, where it is typically something like @file{/dev/ttya}.
 
 @kindex speed
-@cindex serial line speed, H8/300 or H8/500
+@cindex serial line speed, Hitachi micros
 @code{@value{GDBP}} has another special command to set the communications
 speed: @samp{speed @var{bps}}.  This command also is only used from Unix
 hosts; on DOS hosts, set the line speed as usual from outside GDB with
 the DOS @kbd{mode} command (for instance, @w{@samp{mode
 com2:9600,n,8,1,p}} for a 9600 bps connection).
-@end ignore
 
+The @samp{device} and @samp{speed} commands are available only when you
+use a Unix host to debug your Hitachi microprocessor programs.  If you
+use a DOS host,
+@end ifclear
 @value{GDBN} depends on an auxiliary terminate-and-stay-resident program
 called @code{asynctsr} to communicate with the development board
 through a PC serial port.  You must also use the DOS @code{mode} command
 to set up the serial port on the DOS side.
 
+@ifset DOSHOST
 The following sample session illustrates the steps needed to start a
-program under @value{GDBN} control on an H8/300.  The example uses a sample
-H8/300 program called @file{t.x}.
+program under @value{GDBN} control on an H8/300.  The example uses a
+sample H8/300 program called @file{t.x}.  The procedure is the same for
+the Hitachi SH and the H8/500.
 
 First hook up your development board.  In this example, we use a
 board attached to serial port @code{COM2}; if you use a different serial
@@ -966,6 +972,7 @@ to detect program completion.
 In either case, @value{GDBN} will see the effect of a @sc{reset} on the
 development board as a ``normal exit'' of your program.
 @end ifset
+@end ifset
 
 @ifset SIMS
 @node Simulator
@@ -974,25 +981,30 @@ development board as a ``normal exit'' of your program.
 @ifset GENERIC
 @cindex simulator
 @cindex simulator, Z8000
-@cindex simulator, H8/300 or H8/500
 @cindex Z8000 simulator
+@cindex simulator, H8/300 or H8/500
 @cindex H8/300 or H8/500 simulator
+@cindex simulator, Hitachi SH
+@cindex Hitachi SH simulator
 @cindex CPU simulator
 For some configurations, @value{GDBN} includes a CPU simulator that you
 can use instead of a hardware CPU to debug your programs.  Currently,
 a simulator is available when @value{GDBN} is configured to debug Zilog
-Z8000 or Hitachi H8/300 or H8/500 targets.
+Z8000 or Hitachi microprocessor targets.
 @end ifset
 
 @ifclear GENERIC
-@ifset Hviii
+@ifset H8
 @cindex simulator, H8/300 or H8/500
 @cindex Hitachi H8/300 or H8/500 simulator
-When configured for debugging Hitachi H8/300 or H8/500 targets,
-@value{GDBN} includes an H8/300 or H8/500 CPU simulator.
+@cindex simulator, Hitachi SH
+@cindex Hitachi SH simulator
+When configured for debugging Hitachi microprocessor targets,
+@value{GDBN} includes a CPU simulator for the target chip (a Hitachi SH,
+H8/300, or H8/500).
 @end ifset
 
-@ifset ZviiiK
+@ifset Z8K
 @cindex simulator, Z8000
 @cindex Zilog Z8000 simulator
 When configured for debugging Zilog Z8000 targets, @value{GDBN} includes
@@ -1000,7 +1012,7 @@ a Z8000 simulator.
 @end ifset
 @end ifclear
 
-@ifset ZviiiK
+@ifset Z8K
 For the Z8000 family, @samp{target sim} simulates either the Z8002 (the
 unsegmented variant of the Z8000 architecture) or the Z8001 (the
 segmented variant).  The simulator recognizes which architecture is
diff --git a/gdb/doc/h8-config.texi b/gdb/doc/h8-config.texi
index fb18ede..167b522 100644
--- a/gdb/doc/h8-config.texi
+++ b/gdb/doc/h8-config.texi
@@ -2,15 +2,16 @@
 @include GDBvn.texi
 @c
 @set   AGGLOMERATION
-@clear AMDxxixK
+@clear AMD29K
 @set   BARETARGET
 @set   CONLY
 @set   DOSHOST
 @clear FSFDOC
 @clear GENERIC
-@set   Hviii
-@set   HviiiEXCLUSIVE
-@clear Icmlx
+@set   H8
+@set   H8EXCLUSIVE
+@clear HAVE-FLOAT
+@clear I960
 @clear NOVEL
 @clear POSIX
 @set   PRECONFIGURED
@@ -18,9 +19,9 @@
 @set   SIMS
 @clear SERIAL
 @clear SPARC
-@clear STmm
+@clear ST2000
 @clear VXWORKS
-@clear ZviiiK
+@clear Z8K
 @c ----------------------------------------------------------------------
 @c STRINGS:
 @c
@@ -34,7 +35,7 @@
 @set GDBINIT .gdbinit
 @c 
 @c Name of target.
-@set TARGET Hitachi H/300 and H/500
+@set TARGET Hitachi Microprocessors
 @c
 @c Name of GCC product
 @set NGCC GCC