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

(1) C and C++ treated as separate languages, not one as originally doc'd

Browse Source 
(2) [temporarily, until "maint" details avail] hide explanations of commands
moved to "maint" so we don't risk releasing doc with obsolete names:
printsyms, printmsyms, printpsyms, info all-breakpoints.
This commit is contained in:
Roland Pesch
1992-07-11 02:12:00 +00:00
parent a252e71520
commit 5a2c1d8583
1 changed files with 22 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
gdb/doc/gdb.texinfo
View File

@ -990,7 +990,7 @@ Add @var{directory} to the path to search for source files.
supported on all systems.}@* supported on all systems.}@*
If memory-mapped files are available on your system through the @code{mmap} If memory-mapped files are available on your system through the @code{mmap}
system call, you can use this option system call, you can use this option
to cause _GDBN__ to write the symbols from your to have _GDBN__ write the symbols from your
program into a reusable file in the current directory. If the program you are debugging is program into a reusable file in the current directory. If the program you are debugging is
called @file{/tmp/fred}, the mapped symbol file will be @file{./fred.syms}. called @file{/tmp/fred}, the mapped symbol file will be @file{./fred.syms}.
Future _GDBN__ debugging sessions will notice the presence of this file, Future _GDBN__ debugging sessions will notice the presence of this file,
@ -2112,8 +2112,11 @@ the breakpoints are conditional, this is even useful
_GDBN__ itself sometimes sets breakpoints in your program for special _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, but the @code{-1}; @samp{info breakpoints} does not display them.
similar command @samp{info all-breakpoints} does. @ignore
@c FIXME! Moved to maint; doc when maint details avail.
You can see these breakpoints with the _GDBN__ maintenance command
@samp{maint info breakpoints}.
@table @code @table @code
@kindex all-breakpoints @kindex all-breakpoints
@ -2146,6 +2149,7 @@ 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
@ -4569,8 +4573,11 @@ source files, and examining their extensions:
Modula-2 source file Modula-2 source file
@item *.c @item *.c
C source file
@item *.C
@itemx *.cc @itemx *.cc
C or C++ source file. C++ source file
@end table @end table
This information is recorded for each function or procedure in a source This information is recorded for each function or procedure in a source
@ -4778,8 +4785,7 @@ being set automatically by _GDBN__.
@node Support, , Checks, Languages @node Support, , Checks, Languages
@section Supported Languages @section Supported Languages
_GDBN__ 4 supports C, C++, and Modula-2. The syntax for C and C++ is so _GDBN__ 4 supports C, C++, and Modula-2. Some _GDBN__
closely related that _GDBN__ does not distinguish the two. Some _GDBN__
features may be used in expressions regardless of the language you features may be used in expressions regardless of the language you
use: the _GDBN__ @code{@@} and @code{::} operators, and the use: the _GDBN__ @code{@@} and @code{::} operators, and the
@samp{@{type@}addr} construct (@pxref{Expressions, ,Expressions}) can be @samp{@{type@}addr} construct (@pxref{Expressions, ,Expressions}) can be
@ -4803,9 +4809,9 @@ look to these for a language reference or tutorial.
@cindex C and C++ @cindex C and C++
@cindex expressions in C or C++ @cindex expressions in C or C++
Since C and C++ are so closely related, _GDBN__ does not distinguish Since C and C++ are so closely related, many features of _GDBN__ apply
between them when interpreting the expressions recognized in _GDBN__ to both languages. Whenever this is the case, we discuss both languages
commands. together.
@cindex C++ @cindex C++
@kindex g++ @kindex g++
@ -5097,12 +5103,12 @@ debugging (@pxref{Variables, ,Program Variables}).
If you allow _GDBN__ to set type and range checking automatically, they If you allow _GDBN__ to set type and range checking automatically, they
both default to @code{off} whenever the working language changes to both default to @code{off} whenever the working language changes to
C/C++. This happens regardless of whether you, or _GDBN__, C or C++. This happens regardless of whether you, or _GDBN__,
selected the working language. selected the working language.
If you allow _GDBN__ to set the language automatically, it sets the If you allow _GDBN__ to set the language automatically, it sets the
working language to C/C++ on entering code compiled from a source file working language to C or C++ on entering code compiled from a source file
whose name ends with @file{.c} or @file{.cc}. whose name ends with @file{.c}, @file{.C}, or @file{.cc}.
@xref{Automatically, ,Having _GDBN__ infer the source language}, for @xref{Automatically, ,Having _GDBN__ infer the source language}, for
further details. further details.
@ -5786,6 +5792,9 @@ 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
@c FIXME!! The following have been subsumed into a new "maint" command.
@c restore descriptions in right place when details of maint available.
@item printsyms @var{filename} @item printsyms @var{filename}
@itemx printpsyms @var{filename} @itemx printpsyms @var{filename}
@itemx printmsyms @var{filename} @itemx printmsyms @var{filename}
@ -5808,6 +5817,7 @@ each object file from which _GDBN__ has read some symbols. The description of
@code{symbol-file} explains how _GDBN__ reads symbols; both @code{info @code{symbol-file} explains how _GDBN__ reads symbols; both @code{info
source} and @code{symbol-file} are described in @ref{Files, ,Commands source} and @code{symbol-file} are described in @ref{Files, ,Commands
to Specify Files}. to Specify Files}.
@end ignore
@end table @end table
@node Altering, _GDBN__ Files, Symbols, Top @node Altering, _GDBN__ Files, Symbols, Top