espressif/binutils-gdb
1
0
Fork 0
mirror of https://github.com/espressif/binutils-gdb.git synced 2025-06-22 19:09:31 +08:00
Code Issues Packages Projects Releases Wiki Activity

(1) add disclaimer to config section of "Installing" appendix (this is

Browse Source 
NOT full config doc) and xref to configure.info

(2) add brief mention of --help and --prefix=DIR configure options

(3) re-enable, with new command names, old doc for commands now
reorganized into maint.  (NO new doc yet for new maint commands or for
old undoc'd dump-me; nor for "maint" itself in general.)
This commit is contained in:
Roland Pesch
1992-07-14 01:14:30 +00:00
parent f7c7689713
commit d48da190b5
1 changed files with 39 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

78
gdb/doc/gdb.texinfo
View File

@ -2113,14 +2113,13 @@ _GDBN__ itself sometimes sets breakpoints in your program for special
purposes, such as proper handling of @code{longjmp} (in C programs). purposes, such as proper handling of @code{longjmp} (in C programs).
These internal breakpoints are assigned negative numbers, starting with These internal breakpoints are assigned negative numbers, starting with
@code{-1}; @samp{info breakpoints} does not display them. @code{-1}; @samp{info breakpoints} does not display them.
@ignore
@c FIXME! Moved to maint; doc when maint details avail.
You can see these breakpoints with the _GDBN__ maintenance command You can see these breakpoints with the _GDBN__ maintenance command
@samp{maint info breakpoints}. @samp{maint info breakpoints}.
@table @code @table @code
@kindex all-breakpoints @kindex maint info breakpoints
@item info all-breakpoints @item maint info breakpoints
Using the same format as @samp{info breakpoints}, display both the Using the same format as @samp{info breakpoints}, display both the
breakpoints you've set explicitly, and those _GDBN__ is using for breakpoints you've set explicitly, and those _GDBN__ is using for
internal purposes. Internal breakpoints are shown with negative internal purposes. Internal breakpoints are shown with negative
@ -2149,7 +2148,6 @@ Temporary internal breakpoint used by the _GDBN__ @code{finish} command.
@end table @end table
@end table @end table
@end ignore
@node Set Watchpoints, Exception Handling, Set Breaks, Breakpoints @node Set Watchpoints, Exception Handling, Set Breaks, Breakpoints
@ -5819,32 +5817,28 @@ from the @code{ptype} command can be overwhelming and hard to use. The
which match the regular-expression @var{regexp}. which match the regular-expression @var{regexp}.
@end ignore @end ignore
@ignore @item maint print symbols @var{filename}
@c FIXME!! The following have been subsumed into a new "maint" command. @itemx maint print psymbols @var{filename}
@c restore descriptions in right place when details of maint available. @itemx maint print msymbols @var{filename}
@item printsyms @var{filename} @kindex maint print symbols
@itemx printpsyms @var{filename}
@itemx printmsyms @var{filename}
@kindex printsyms
@cindex symbol dump @cindex symbol dump
@kindex printsyms @kindex maint print psymbols
@cindex partial symbol dump @cindex partial symbol dump
Write a dump of debugging symbol data into the file @var{filename}. Write a dump of debugging symbol data into the file @var{filename}.
These commands are used to debug the _GDBN__ symbol-reading code. Only These commands are used to debug the _GDBN__ symbol-reading code. Only
symbols with debugging data are included. If you use @code{printsyms}, symbols with debugging data are included. If you use @samp{maint print
_GDBN__ includes all the symbols for which it has already collected full symbols}, _GDBN__ includes all the symbols for which it has already
details: that is, @var{filename} reflects symbols for only those files collected full details: that is, @var{filename} reflects symbols for
whose symbols _GDBN__ has read. You can use the command @code{info only those files whose symbols _GDBN__ has read. You can use the
sources} to find out which files these are. If you use command @code{info sources} to find out which files these are. If you
@code{printpsyms} instead, the dump shows information about symbols that use @samp{maint print psymbols} instead, the dump shows information about
_GDBN__ only knows partially---that is, symbols defined in files that symbols that _GDBN__ only knows partially---that is, symbols defined in
_GDBN__ has skimmed, but not yet read completely. Finally, files that _GDBN__ has skimmed, but not yet read completely. Finally,
@code{printmsyms} dumps just the minimal symbol information required for @samp{maint print msymbols} dumps just the minimal symbol information
each object file from which _GDBN__ has read some symbols. The description of required for each object file from which _GDBN__ has read some symbols.
@code{symbol-file} explains how _GDBN__ reads symbols; both @code{info The description of @code{symbol-file} explains how _GDBN__ reads
source} and @code{symbol-file} are described in @ref{Files, ,Commands symbols; both @code{info source} and @code{symbol-file} are described in
to Specify Files}. @ref{Files, ,Commands to Specify Files}.
@end ignore
@end table @end table
@node Altering, _GDBN__ Files, Symbols, Top @node Altering, _GDBN__ Files, Symbols, Top
@ -6898,15 +6892,8 @@ It will make _GDBN__ tell you when it does a lengthy internal operation, so
you will not think it has crashed. you will not think it has crashed.
Currently, the messages controlled by @code{set verbose} are those Currently, the messages controlled by @code{set verbose} are those
which announce that the symbol table for a source file is being read which announce that the symbol table for a source file is being read;
(@pxref{Files, ,Commands to Specify Files}, in the description of the see @code{symbol-file} in @ref{Files, ,Commands to Specify Files}.
command @code{symbol-file}).
@c The following is the right way to do it, but emacs 18.55 does not support
@c @ref, and neither the emacs lisp manual version of texinfmt or makeinfo
@c is released.
@ignore
see @code{symbol-file} in @ref{Files, ,Commands to Specify Files}).
@end ignore
@table @code @table @code
@kindex set verbose @kindex set verbose
@ -8034,11 +8021,17 @@ directory (@file{gdb-_GDB_VN__}, for version _GDB_VN__).
@node configure Options, , Config Names, Installing GDB @node configure Options, , Config Names, Installing GDB
@section @code{configure} Options @section @code{configure} Options
Here is a summary of all the @code{configure} options and arguments that Here is a summary of the @code{configure} options and arguments that
you might use for building GDB: are most often useful for building _GDBN__. @code{configure} also has
several other options not listed here. @inforef{What Configure
Does,,configure.info}, for a full explanation of @code{configure}.
@c FIXME: Would this be more, or less, useful as an xref (ref to printed
@c manual in the printed manual, ref to info file only from the info file)?
@example @example
configure @r{[}--srcdir=@var{path}@r{]} configure @r{[}--help@r{]}
@r{[}--prefix=@var{dir}@r{]}
@r{[}--srcdir=@var{path}@r{]}
@r{[}--norecursion@r{]} @r{[}--rm@r{]} @r{[}--norecursion@r{]} @r{[}--rm@r{]}
@r{[}--target=@var{target}@r{]} @var{host} @r{[}--target=@var{target}@r{]} @var{host}
@end example @end example
@ -8049,6 +8042,13 @@ You may introduce options with a single @samp{-} rather than
@samp{--}. @samp{--}.
@table @code @table @code
@item --help
Display a quick summary of how to invoke @code{configure}.
@item -prefix=@var{dir}
Configure the source to install programs and files under directory
@file{@var{dir}}.
@item --srcdir=@var{path} @item --srcdir=@var{path}
@strong{Warning: using this option requires GNU @code{make}, or another @strong{Warning: using this option requires GNU @code{make}, or another
@code{make} that implements the @code{VPATH} feature.}@* @code{make} that implements the @code{VPATH} feature.}@*