diff options
Diffstat (limited to 'gdb/doc/gdb.texinfo')
-rw-r--r-- | gdb/doc/gdb.texinfo | 65 |
1 files changed, 40 insertions, 25 deletions
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 79eca0d97d7..a4f474b940f 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -1,6 +1,6 @@ \input texinfo @c -*-texinfo-*- @c Copyright 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998, -@c 1999, 2000, 2001 +@c 1999, 2000, 2001, 2002 @c Free Software Foundation, Inc. @c @c %**start of header @@ -31,7 +31,7 @@ @set EDITION Ninth @c !!set GDB manual's revision date -@set DATE December 2001 +@set DATE January 2002 @c THIS MANUAL REQUIRES TEXINFO 3.12 OR LATER. @@ -50,8 +50,8 @@ This is the @value{EDITION} Edition, @value{DATE}, of @cite{Debugging with @value{GDBN}: the @sc{gnu} Source-Level Debugger} for @value{GDBN} Version @value{GDBVN}. -Copyright (C) 1988,1989,1990,1991,1992,1993,1994,1995,1996,1998,1999,2000,2001 - Free Software Foundation, Inc. +Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998,@* + 1999, 2000, 2001, 2002 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or @@ -60,9 +60,10 @@ Invariant Sections being ``Free Software'' and ``Free Software Needs Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,'' and with the Back-Cover Texts as in (a) below. -(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify -this GNU Manual, like GNU software. Copies published by the Free -Software Foundation raise funds for GNU development.'' +(a) The Free Software Foundation's Back-Cover Text is: ``You have +freedom to copy and modify this GNU Manual, like GNU software. Copies +published by the Free Software Foundation raise funds for GNU +development.'' @end ifinfo @titlepage @@ -82,8 +83,8 @@ Software Foundation raise funds for GNU development.'' @end tex @vskip 0pt plus 1filll -Copyright @copyright{} 1988,1989,1990,1991,1992,1993,1994,1995,1996,1998,1999,2000,2001 - Free Software Foundation, Inc. +Copyright @copyright{} 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, +1996, 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc. @sp 2 Published by the Free Software Foundation @* 59 Temple Place - Suite 330, @* @@ -97,9 +98,10 @@ Invariant Sections being ``Free Software'' and ``Free Software Needs Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,'' and with the Back-Cover Texts as in (a) below. -(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify -this GNU Manual, like GNU software. Copies published by the Free -Software Foundation raise funds for GNU development.'' +(a) The Free Software Foundation's Back-Cover Text is: ``You have +freedom to copy and modify this GNU Manual, like GNU software. Copies +published by the Free Software Foundation raise funds for GNU +development.'' @end titlepage @page @@ -113,7 +115,7 @@ This file describes @value{GDBN}, the @sc{gnu} symbolic debugger. This is the @value{EDITION} Edition, @value{DATE}, for @value{GDBN} Version @value{GDBVN}. -Copyright (C) 1988-2001 Free Software Foundation, Inc. +Copyright (C) 1988-2002 Free Software Foundation, Inc. @menu * Summary:: Summary of @value{GDBN} @@ -148,6 +150,7 @@ Copyright (C) 1988-2001 Free Software Foundation, Inc. * Command Line Editing:: Command Line Editing * Using History Interactively:: Using History Interactively * Installing GDB:: Installing GDB +* GNU Free Documentation License:: The license for this documentation * Index:: Index @end menu @@ -197,11 +200,12 @@ Copyright (C) 1988-2000 Free Software Foundation, Inc. * Command Line Editing:: Command Line Editing * Using History Interactively:: Using History Interactively * Installing GDB:: Installing GDB +* GNU Free Documentation License:: The license for this documentation * Index:: Index @end menu @end ifhtml - + @c TeX can handle the contents at the start but makeinfo 3.12 can not @iftex @contents @@ -5913,19 +5917,20 @@ user. Examples: @smallexample -(@value{GDBP}) @b{passcount 5 2} // Stop on the 5th execution of tracepoint 2 +(@value{GDBP}) @b{passcount 5 2} // Stop on the 5th execution of +@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// tracepoint 2} (@value{GDBP}) @b{passcount 12} // Stop on the 12th execution of the - // most recently defined tracepoint. +@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// most recently defined tracepoint.} (@value{GDBP}) @b{trace foo} (@value{GDBP}) @b{pass 3} (@value{GDBP}) @b{trace bar} (@value{GDBP}) @b{pass 2} (@value{GDBP}) @b{trace baz} (@value{GDBP}) @b{pass 1} // Stop tracing when foo has been - // executed 3 times OR when bar has - // been executed 2 times - // OR when baz has been executed 1 time. +@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// executed 3 times OR when bar has} +@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// been executed 2 times} +@exdent @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @code{// OR when baz has been executed 1 time.} @end smallexample @end table @@ -5953,9 +5958,9 @@ and follow it immediately with @samp{end}. @smallexample (@value{GDBP}) @b{collect @var{data}} // collect some data -(@value{GDBP}) @b{while-stepping 5} // single-step 5 times and collect data +(@value{GDBP}) @b{while-stepping 5} // single-step 5 times, collect data -(@value{GDBP}) @b{end} // signals the end of actions. +(@value{GDBP}) @b{end} // signals the end of actions. @end smallexample In the following example, the action list begins with @code{collect} @@ -6030,8 +6035,8 @@ You may abbreviate @code{while-stepping} as @code{ws} or @kindex info tracepoints @cindex information about tracepoints @item info tracepoints @r{[}@var{num}@r{]} -Display information the tracepoint @var{num}. If you don't specify a -tracepoint number displays information about all the tracepoints +Display information about the tracepoint @var{num}. If you don't specify +a tracepoint number, displays information about all the tracepoints defined so far. For each tracepoint, the following information is shown: @@ -6056,8 +6061,8 @@ its action list as given by the @code{actions} command (@value{GDBP}) @b{info trace} Num Enb Address PassC StepC What 1 y 0x002117c4 0 0 <gdb_asm> -2 y 0x0020dc64 0 0 in gdb_test at gdb_test.c:375 -3 y 0x0020b1f4 0 0 in collect_data at ../foo.c:1741 +2 y 0x0020dc64 0 0 in g_test at g_test.c:1375 +3 y 0x0020b1f4 0 0 in get_data at ../foo.c:41 (@value{GDBP}) @end smallexample @@ -10524,6 +10529,8 @@ The target does not need to look up any (more) symbols. @item @tab reply @code{qSymbol:}@var{sym_name} @tab +@sp 2 +@noindent The target requests the value of symbol @var{sym_name} (hex encoded). @value{GDBN} may provide the value by using the @code{qSymbol:}@var{sym_value}:@var{sym_name} @@ -10532,6 +10539,8 @@ message, described below. @item symbol value @tab @code{qSymbol:}@var{sym_value}:@var{sym_name} @tab +@sp 1 +@noindent Set the value of SYM_NAME to SYM_VALUE. @item @tab @@ -10551,6 +10560,8 @@ The target does not need to look up any (more) symbols. @item @tab reply @code{qSymbol:}@var{sym_name} @tab +@sp 2 +@noindent The target requests the value of a new symbol @var{sym_name} (hex encoded). @value{GDBN} will continue to supply the values of symbols (if available), until the target ceases to request them. @@ -14294,6 +14305,10 @@ There is no convenient way to generate a list of all available hosts. There are many other options available as well, but they are generally needed for special purposes only. +@node GNU Free Documentation License +@appendix GNU Free Documentation License +@include fdl.texi + @node Index @unnumbered Index |