From: Eli Zaretskii Date: Sun, 20 Apr 2008 09:06:44 +0000 (+0000) Subject: * gdb.texinfo (Set Breaks): Mention that multiple location X-Git-Tag: sid-snapshot-20080501~103 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=2e9132cc003f90acebc7f3bca182dcf1311ed934;p=external%2Fbinutils.git * gdb.texinfo (Set Breaks): Mention that multiple location breakpoints need line number info. Add index entries. --- 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 + + * 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 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