From 2e9132cc003f90acebc7f3bca182dcf1311ed934 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sun, 20 Apr 2008 09:06:44 +0000 Subject: [PATCH] * gdb.texinfo (Set Breaks): Mention that multiple location breakpoints need line number info. Add index entries. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 10 +++++++--- 2 files changed, 12 insertions(+), 3 deletions(-) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index d88828100d..12e82c8e8a 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2008-04-20 Eli Zaretskii + + * gdb.texinfo (Set Breaks): Mention that multiple location + breakpoints need line number info. Add index entries. + 2008-04-19 Craig Silverstein * gdb.texinfo (Requirements): Add an optional requirement on diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index d033530daa..f5122962d0 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