0) Update descriptions of symbol-file, file, add-symbol-file cmds for use

of *options* "-readnow" and "-mapped".

1) Change title/subtitle to come closer to text used by FSF when they
printed this thing (but still avoid silliness of having word "manual" in
the title).

2) First few minor corrections from most recent Chassell pass.
This commit is contained in:
Roland Pesch 1992-04-06 23:29:36 +00:00
parent ce9260ae3e
commit 95d5ceb921

View File

@ -6,10 +6,10 @@ _dnl__ $Id$
@c %**start of header
@setfilename _GDBP__.info
_if__(_GENERIC__)
@settitle Using _GDBN__ (v4)
@settitle _GDB__, The GNU Debugger
_fi__(_GENERIC__)
_if__(!_GENERIC__)
@settitle Using _GDBN__ v4 (_HOST__)
@settitle _GDB__, The GNU Debugger (_HOST__)
_fi__(!_GENERIC__)
@setchapternewpage odd
@c @smallbook
@ -68,7 +68,7 @@ This is Edition 4.04, March 1992,
of @cite{Using GDB: A Guide to the GNU Source-Level Debugger}
for GDB Version _GDB_VN__.
Copyright (C) 1988, 1989, 1990, 1991 1992 Free Software Foundation, Inc.
Copyright (C) 1988, 1989, 1990, 1991, 1992 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of
this manual provided the copyright notice and this permission notice
@ -97,7 +97,7 @@ instead of in the original English.
@titlepage
@title Using _GDBN__
@subtitle A Guide to the GNU Source-Level Debugger
@subtitle The GNU Source-Level Debugger
_if__(!_GENERIC__)
@subtitle on _HOST__ Systems
_fi__(!_GENERIC__)
@ -150,7 +150,7 @@ This is Edition 4.04, March 1992, for GDB Version _GDB_VN__.
@menu
* Summary:: Summary of _GDBN__
* New Features:: New features since GDB version 3.5
* Sample Session:: A Sample _GDBN__ session
* Sample Session:: A sample _GDBN__ session
* Invocation:: Getting in and out of _GDBN__
* Commands:: _GDBN__ commands
* Running:: Running programs under _GDBN__
@ -176,14 +176,14 @@ This is Edition 4.04, March 1992, for GDB Version _GDB_VN__.
Summary of _GDBN__
* Free Software:: Free Software
* Free Software:: Freely redistributable software
* Contributors:: Contributors to _GDBN__
Getting In and Out of _GDBN__
* Invoking _GDBN__:: Starting _GDBN__
* Leaving _GDBN__:: Leaving _GDBN__
* Shell Commands:: Shell Commands
* Invoking _GDBN__:: How to start _GDBN__
* Leaving _GDBN__:: How to quit _GDBN__
* Shell Commands:: How to use shell commands inside _GDBN__
Starting _GDBN__
@ -5896,8 +5896,9 @@ On systems with memory-mapped files, an auxiliary symbol table file
@file{@var{filename}.syms} may be available for @var{filename}. If it
is, _GDBN__ will map in the symbol table from
@file{@var{filename}.syms}, starting up more quickly. See the
descriptions of the keywords @samp{mapped} and @samp{readnow} (available
with either @code{file} or @code{symbol-file}), for more information.
descriptions of the options @samp{-mapped} and @samp{-readnow} (available
with @code{file}, @code{symbol-file}, or @code{add-symbol-file}), for
more information.
@item file
@code{file} with no argument makes _GDBN__ discard any information it
@ -5952,8 +5953,8 @@ When the symbol table is stored in COFF format, @code{symbol-file} does
read the symbol table data in full right away. We have not implemented
the two-stage strategy for COFF yet.
@item symbol-file @var{filename} @r{[} readnow @r{]} @r{[} mapped @r{]}
@itemx file @var{filename} @r{[} readnow @r{]} @r{[} mapped @r{]}
@item symbol-file @var{filename} @r{[} -readnow @r{]} @r{[} -mapped @r{]}
@itemx file @var{filename} @r{[} -readnow @r{]} @r{[} -mapped @r{]}
@kindex readnow
@cindex reading symbols immediately
@cindex symbols, reading immediately
@ -5961,20 +5962,20 @@ the two-stage strategy for COFF yet.
@cindex memory-mapped symbol file
@cindex saving symbol table with memory mapping
You can override the _GDBN__ two-stage strategy for reading symbol
tables by using the @samp{readnow} keyword with any of the commands that
tables by using the @samp{-readnow} option with any of the commands that
load symbol table information, if you want to be sure _GDBN__ has the
entire symbol table available.
If memory-mapped files are available on your system through the
@code{mmap} system call, you can use another keyword, @samp{mapped}, to
@code{mmap} system call, you can use another option, @samp{-mapped}, to
get _GDBN__ to write out the symbols for your program in a reusable
file. Next time _GDBN__ starts up (if the program hasn't changed), it
will map in symbol information from this auxiliary symbol file, rather
than spending time reading the symbol table from the executable program.
Using the @samp{mapped} keyword has the same effect as starting _GDBN__
Using the @samp{-mapped} option has the same effect as starting _GDBN__
with the @samp{-m} command-line option.
You can use both keywords together, to make sure the auxiliary symbol
You can use both options together, to make sure the auxiliary symbol
file has all the symbol information for your program.
The auxiliary symbol file for a program called @var{myprog} is called
@ -6047,6 +6048,7 @@ _fi__(_H8__)
@code{load} will not repeat if you press @key{RET} again after using it.
@item add-symbol-file @var{filename} @var{address}
@itemx add-symbol-file @var{filename} @var{address} @r{[} -readnow @r{]} @r{[} -mapped @r{]}
@kindex add-symbol-file
@cindex dynamic linking
The @code{add-symbol-file} command reads additional symbol table information
@ -6063,6 +6065,10 @@ use the @code{symbol-file} command.
@code{add-symbol-file} will not repeat if you press @key{RET} after using it.
You can use the @samp{-mapped} and @samp{-readnow} options just as with
the @code{symbol-file} command, to change how _GDBN__ manages the symbol
tabl einformation for @var{filename}.
@item info files
@itemx info target
@kindex info files