This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
new diff: gdb.texinfo
- From: Brian Youmans <3diff at gnu dot org>
- To: gdb-patches at sources dot redhat dot com
- Date: Wed, 16 Jan 2002 17:13:35 -0500
- Subject: new diff: gdb.texinfo
This is a consolidated diff for the changes I have made to the
5.1.0.1 gdb.texinfo. It includes most of the diffs I sent yesterday.
1. I have removed the change I made adding the GFDL to the list of
Invariant Sections in the copying permissions - RMS does not think it
is proper to list it as an "Invariant Section", although it is
effectively one anyways, since you can't alter or remove it. The
changes I made to include the text of the GFDL are still in place.
2. Most of the new changes are meant to solve "Overfull /hbox"
problems when the manual is printed using @smallbook. Some of them
are very ugly and people may want to come up with better solutions.
3. This makes more fixes to the multitables. Have I mentioned lately
how much I *hate* multitables? The fixes don't solve the "Overfull
/hbox" problems, but they make it so that at least the text doesn't
print over itself.
4. I put in a FIXME at one spot I noticed where I think a word is
missing.
There are more Overfull /hboxes to fix, but I haven't figured out
good solutions for those yet.
- Brian Youmans, FSF office staff
----------------------------------------------------------------------------
*** /home/opus/manuscripts/GDB/gdb-5.1.0.1/gdb/doc/gdb.texinfo Thu Jan 3 00:40:49 2002
--- gdb.texinfo Wed Jan 16 16:56:10 2002
***************
*** 50,57 ****
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.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
--- 50,56 ----
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, 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,68 ****
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.''
@end ifinfo
@titlepage
--- 59,68 ----
Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below.
! (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,89 ****
@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.
@sp 2
Published by the Free Software Foundation @*
59 Temple Place - Suite 330, @*
--- 82,89 ----
@end tex
@vskip 0pt plus 1filll
! 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,105 ****
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.''
@end titlepage
@page
--- 97,106 ----
Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below.
! (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
***************
*** 148,153 ****
--- 149,155 ----
* 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,202 ****
--- 199,205 ----
* 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
***************
*** 5910,5928 ****
Examples:
@smallexample
! (@value{GDBP}) @b{passcount 5 2} // Stop on the 5th execution of tracepoint 2
(@value{GDBP}) @b{passcount 12} // Stop on the 12th execution of the
! // 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.
@end smallexample
@end table
--- 5913,5932 ----
Examples:
@smallexample
! (@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
! @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
! @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
***************
*** 5950,5958 ****
@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{end} // signals the end of actions.
@end smallexample
In the following example, the action list begins with @code{collect}
--- 5954,5962 ----
@smallexample
(@value{GDBP}) @b{collect @var{data}} // collect some data
! (@value{GDBP}) @b{while-stepping 5} // single-step 5 times, collect data
! (@value{GDBP}) @b{end} // signals the end of actions.
@end smallexample
In the following example, the action list begins with @code{collect}
***************
*** 6027,6032 ****
--- 6031,6038 ----
@kindex info tracepoints
@cindex information about tracepoints
@item info tracepoints @r{[}@var{num}@r{]}
+ @c FIXME: Shouldn't there be an "at", "on", or "for" in the next
+ @c sentence? - Brian Y., FSF office staff
Display information 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
***************
*** 6053,6060 ****
(@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
(@value{GDBP})
@end smallexample
--- 6059,6066 ----
(@value{GDBP}) @b{info trace}
Num Enb Address PassC StepC What
1 y 0x002117c4 0 0 <gdb_asm>
! 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
***************
*** 10521,10526 ****
--- 10527,10534 ----
@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}
***************
*** 10529,10534 ****
--- 10537,10544 ----
@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
***************
*** 10548,10553 ****
--- 10558,10565 ----
@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.
***************
*** 14291,14296 ****
--- 14303,14312 ----
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