From: Roland Pesch Date: Fri, 15 May 1992 00:20:43 +0000 (+0000) Subject: Thu May 14 17:09:48 1992 Roland H. Pesch (pesch@fowanton.cygnus.com) X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=a89f94c23ad9fd97cdb081dcece750aba531e64d;p=binutils-gdb.git Thu May 14 17:09:48 1992 Roland H. Pesch (pesch@fowanton.cygnus.com) * gdb.texinfo: slight expansion of new text on reading info files * gdbinv-s.m4.in: correct and expand info on cross-debugging H8/300 from DOS. * ChangeLog: guess... --- diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index ecdc61be66f..5917ddc3261 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,9 @@ +Thu May 14 17:09:48 1992 Roland H. Pesch (pesch@fowanton.cygnus.com) + + * gdb.texinfo: slight expansion of new text on reading info files + * gdbinv-s.m4.in: correct and expand info on cross-debugging + H8/300 from DOS. + Tue May 12 12:22:47 1992 John Gilmore (gnu at cygnus.com) * gdb.texinfo: `info user' => `show user'. Noticed by David Taylor. diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 7b0cfe89fca..c8addb96d1c 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -7539,11 +7539,11 @@ and @TeX{} (or @code{texi2roff}) to typeset the printed version. 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 diff --git a/gdb/doc/gdbinv-s.m4.in b/gdb/doc/gdbinv-s.m4.in index 13824469a80..eae7e213273 100644 --- a/gdb/doc/gdbinv-s.m4.in +++ b/gdb/doc/gdbinv-s.m4.in @@ -478,23 +478,31 @@ what speed to use over the serial device. @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.