GDB includes an already formatted copy of the on-line Info version of
this manual in the @file{gdb} subdirectory. The main Info file is
@file{gdb-@var{version-number}/gdb/gdb.info}, and it refers to
-subordinate files matching @samp{gdb.info*} in the same directory.
-You can read these files
-by hand if necessary, but they are easier to read using the @code{info}
-subsystem in GNU Emacs, or by using the standalone @code{info} program,
-available as part of the texinfo distribution.
+subordinate files matching @samp{gdb.info*} in the same directory. If
+necessary, you can print out these files, or read them with any editor;
+but they are easier to read using the @code{info} subsystem in GNU Emacs
+or the standalone @code{info} program, available as part of the GNU
+Texinfo distribution.
If you want to format these Info files yourself, you need one of the
Info formatting programs, such as @code{texinfo-format-buffer} or
@kindex device
@cindex serial device for H8/300
-Use the special @code{gdb83} 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; on Unix hosts, this is typically something
-like @file{/dev/ttya}, and on DOS hosts @file{com1}.
+Use the special @code{gdb83} 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}.
+
+On DOS hosts, communication with the serial device is handled by an
+auxiliary program, @code{asynctsr}. For example, to use @code{COM2} as
+the serial device from a DOS host, execute @samp{asynctsr 2}
+@emph{before} starting GDB.
@kindex speed
@cindex serial line speed for H8/300
@code{gdb83} has another special command to set the communications speed
-for the H8/300: @samp{speed @var{bps}}.
+for the H8/300: @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).
For example, you might start an H8/300 debugging session at 19200 bps
like this (exploiting the default target and device):
@smallexample
$ gdb83
-@c FIXME: this falsifies the exact text played out, to permit smallbook
-@c FIXME... format to come out better.
+@c FIXME: this falsifies the linebreaks in the exact text played out, to
+@c FIXME... permit smallbook format to come out better.
GDB is free software and you are welcome to distribute copies
of it under certain conditions; type "show copying" to see
the conditions.