binutils-gdb/gdb/doc
Andrew Cagney 25d29d7093 2003-08-09 Andrew Cagney <cagney@redhat.com>
Fix GDB PR cli/926.
	* cli/cli-decode.c (add_setshow_uinteger_cmd): New function.
	* command.h (add_setshow_uinteger_cmd): Declare.
	* frame.c (set_backtrace_cmd): New function.
	(show_backtrace_cmd): New function.
	* frame.c (_initialize_frame): Replace "set/show
	backtrace-below-main" with "set/show backtrace past-main".  Add
	command "set/show backtrace limit".
	(backtrace_past_main): Rename "backtrace_below_main".
	(backtrace_limit): New variable.
	(get_prev_frame): Update.  Check the backtrace_limit.

2003-08-09  Andrew Cagney  <cagney@redhat.com>

	* gdb.texinfo (Backtrace): Replace "set/show backtrace-below-main"
	with "set/show backtrace past-main" and "set/show backtrace
	limit".

Index: doc/gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.174
diff -u -r1.174 gdb.texinfo
--- doc/gdb.texinfo	8 Aug 2003 01:58:00 -0000	1.174
+++ doc/gdb.texinfo	9 Aug 2003 14:57:10 -0000
@@ -3922,27 +3922,40 @@
 value, indicating that your program has stopped at the beginning of the
 code for line @code{993} of @code{builtin.c}.

-@kindex set backtrace-below-main
-@kindex show backtrace-below-main
+@kindex set backtrace past-main
+@kindex show backtrace past-main
+@kindex set backtrace limit
+@kindex show backtrace limit

-Most programs have a standard entry point---a place where system libraries
-and startup code transition into user code.  For C this is @code{main}.
-When @value{GDBN} finds the entry function in a backtrace it will terminate
-the backtrace, to avoid tracing into highly system-specific (and generally
-uninteresting) code.  If you need to examine the startup code, then you can
-change this behavior.
+Most programs have a standard user entry point---a place where system
+libraries and startup code transition into user code.  For C this is
+@code{main}.  When @value{GDBN} finds the entry function in a backtrace
+it will terminate the backtrace, to avoid tracing into highly
+system-specific (and generally uninteresting) code.
+
+If you need to examine the startup code, or limit the number of levels
+in a backtrace, you can change this behavior:

 @table @code
-@item set backtrace-below-main off
+@item set backtrace past-main
+@itemx set backtrace past-main on
+Backtraces will continue past the user entry point.
+
+@item set backtrace past-main off
 Backtraces will stop when they encounter the user entry point.  This is the
 default.

-@item set backtrace-below-main
-@itemx set backtrace-below-main on
-Backtraces will continue past the user entry point to the top of the stack.
+@item show backtrace past-main
+Display the current user entry point backtrace policy.
+
+@item set backtrace limit @var{n}
+@itemx set backtrace limit 0
+@cindex backtrace limit
+Limit the backtrace to @var{n} levels.  A value of zero means
+unlimited.

-@item show backtrace-below-main
-Display the current backtrace policy.
+@item show backtrace limit
+Display the current limit on backtrace levels.
 @end table

 @node Selection
2003-08-09 15:10:09 +00:00
..
ChangeLog 2003-08-09 Andrew Cagney <cagney@redhat.com> 2003-08-09 15:10:09 +00:00
LRS Initial creation of sourceware repository 1999-04-16 01:35:26 +00:00
Makefile.in gdb/ 2003-08-08 17:30:37 +00:00
a4rc.sed Initial creation of sourceware repository 1999-04-16 01:35:26 +00:00
agentexpr.texi 2003-08-04 Andrew Cagney <cagney@redhat.com> 2003-08-04 20:43:57 +00:00
all-cfg.texi Use @sc{gcc} and @sc{gdb}. 2002-09-27 17:56:37 +00:00
annotate.texinfo 2003-07-28 Andrew Cagney <cagney@redhat.com> 2003-07-30 04:14:38 +00:00
configure regenerate 2000-05-19 19:14:45 +00:00
configure.in * Makefile.in (LN_S): Define. 2000-04-16 08:47:41 +00:00
fdl.texi * doc/fdl.texi: Revert the last change. 2002-12-30 02:47:27 +00:00
gdb.texinfo 2003-08-09 Andrew Cagney <cagney@redhat.com> 2003-08-09 15:10:09 +00:00
gdbint.texinfo 2003-08-04 Andrew Cagney <cagney@redhat.com> 2003-08-04 20:43:57 +00:00
gpl.texi * gdbint.texinfo: Include fdl.texi. 2002-02-24 17:18:25 +00:00
lpsrc.sed Initial creation of sourceware repository 1999-04-16 01:35:26 +00:00
observer.texi * observer.texi (GDB Observers): Adjust the documentation for the 2003-04-03 15:14:48 +00:00
psrc.sed Initial creation of sourceware repository 1999-04-16 01:35:26 +00:00
refcard.tex Update/correct copyright notices. 2001-03-06 08:22:02 +00:00
stabs.texinfo 2003-08-04 Andrew Cagney <cagney@redhat.com> 2003-08-04 20:43:57 +00:00