aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEli Zaretskii <eliz@gnu.org>2008-04-20 09:06:44 +0000
committerEli Zaretskii <eliz@gnu.org>2008-04-20 09:06:44 +0000
commit2e9132cc003f90acebc7f3bca182dcf1311ed934 (patch)
tree96f70ddd26e702cd468378b9f0320206e2d12498
parent31fffb02125a6c8a1182af5718e9fc49b23e0ed8 (diff)
downloadgdb-2e9132cc003f90acebc7f3bca182dcf1311ed934.zip
gdb-2e9132cc003f90acebc7f3bca182dcf1311ed934.tar.gz
gdb-2e9132cc003f90acebc7f3bca182dcf1311ed934.tar.bz2
* gdb.texinfo (Set Breaks): Mention that multiple location
breakpoints need line number info. Add index entries.
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/gdb.texinfo10
2 files changed, 12 insertions, 3 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index d888281..12e82c8 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2008-04-20 Eli Zaretskii <eliz@gnu.org>
+
+ * gdb.texinfo (Set Breaks): Mention that multiple location
+ breakpoints need line number info. Add index entries.
+
2008-04-19 Craig Silverstein <csilvers@google.com>
* gdb.texinfo (Requirements): Add an optional requirement on
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index d033530..f512296 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -3072,11 +3072,12 @@ your program. There is nothing silly or meaningless about this. When
the breakpoints are conditional, this is even useful
(@pxref{Conditions, ,Break Conditions}).
+@cindex multiple locations, breakpoints
+@cindex breakpoints, multiple locations
It is possible that a breakpoint corresponds to several locations
in your program. Examples of this situation are:
@itemize @bullet
-
@item
For a C@t{++} constructor, the @value{NGCC} compiler generates several
instances of the function body, used in different cases.
@@ -3088,11 +3089,14 @@ correspond to any number of instantiations.
@item
For an inlined function, a given source line can correspond to
several places where that function is inlined.
-
@end itemize
In all those cases, @value{GDBN} will insert a breakpoint at all
-the relevant locations.
+the relevant locations@footnote{
+As of this writing, multiple-location breakpoints work only if there's
+line number information for all the locations. This means that they
+will generally not work in system libraries, unless you have debug
+info with line numbers for them.}.
A breakpoint with multiple locations is displayed in the breakpoint
table using several rows---one header row, followed by one row for