No description
Find a file
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
bfd daily update 2003-08-09 00:00:07 +00:00
binutils Updated French translation 2003-08-08 08:22:06 +00:00
config Import from gcc repository: 2003-07-14 18:38:36 +00:00
contrib
cpu * frv.cpu: Add IDOC attribute. 2003-06-10 21:24:48 +00:00
etc Replace i[3456]86 with i[3-7]86 2003-05-16 16:30:27 +00:00
gas gas/ 2003-08-08 14:46:41 +00:00
gdb 2003-08-09 Andrew Cagney <cagney@redhat.com> 2003-08-09 15:10:09 +00:00
gprof Updated French translations 2003-07-24 11:16:05 +00:00
include Convert cgen to C-90 2003-08-08 21:21:24 +00:00
intl
ld Add MSP430 variants 2003-08-08 10:14:52 +00:00
libiberty merge from gcc 2003-07-05 01:59:15 +00:00
mmalloc gdb/ 2003-08-08 17:30:37 +00:00
opcodes fix typo in ChangeLog 2003-08-09 00:46:53 +00:00
readline 2003-06-14 H.J. Lu <hongjiu.lu@intel.com> 2003-06-15 03:40:25 +00:00
sim 2003-08-09 Andrew Cagney <cagney@redhat.com> 2003-08-09 14:10:49 +00:00
texinfo 2003-03-06 Andrew Cagney <cagney@redhat.com> 2003-03-06 20:50:01 +00:00
.cvsignore
ChangeLog Merge from gcc: 2003-08-02 02:00:38 +00:00
config-ml.in 2003-07-06 H.J. Lu <hongjiu.lu@intel.com> 2003-07-06 21:38:00 +00:00
config.guess 2003-06-14 H.J. Lu <hongjiu.lu@intel.com> 2003-06-14 14:07:21 +00:00
config.if * config.if: Remove unused libc_interface determination. 2003-07-16 06:35:35 +00:00
config.sub Add MSP430 variants 2003-08-08 10:14:52 +00:00
configure 2003-08-01 Andrew Cagney <cagney@redhat.com> 2003-08-01 21:35:02 +00:00
configure.in 2003-08-01 Andrew Cagney <cagney@redhat.com> 2003-08-01 21:35:02 +00:00
COPYING
COPYING.LIB
COPYING.LIBGLOSS
COPYING.NEWLIB 2003-05-28 Jeff Johnston <jjohnstn@redhat.com> 2003-05-28 17:51:42 +00:00
djunpack.bat
gettext.m4
install-sh
libtool.m4 * libtool.m4 (lt_cv_deplibs_check_method): Use pass_all on mips*. 2003-04-11 03:58:39 +00:00
ltcf-c.sh
ltcf-cxx.sh
ltcf-gcj.sh
ltconfig Import patch to add FreeBSD support. 2003-05-29 14:02:04 +00:00
ltmain.sh
MAINTAINERS 2003-05-02 Andrew Cagney <cagney@redhat.com> 2003-05-03 00:44:23 +00:00
Makefile.def * Makefile.def: Introduce flags_to_pass. 2003-06-23 20:36:40 +00:00
Makefile.in Merge from gcc: 2003-08-02 02:00:38 +00:00
Makefile.tpl Merge from gcc: 2003-08-02 02:00:38 +00:00
makefile.vms
missing
mkdep
mkinstalldirs * mkinstalldirs: Import autoconf 2.57 / automake 1.7 version. 2003-07-30 01:35:07 +00:00
move-if-change
mpw-build.in
mpw-config.in
mpw-configure
mpw-install
mpw-README
README
README-maintainer-mode Update URL 2003-05-30 07:30:26 +00:00
setup.com
src-release * src-release (DEVO_SUPPORT): Add src-release, Makefile.tpl, 2003-05-02 17:29:48 +00:00
symlink-tree
ylwrap

		   README for GNU development tools

This directory contains various GNU compilers, assemblers, linkers, 
debuggers, etc., plus their support routines, definitions, and documentation.

If you are receiving this as part of a GDB release, see the file gdb/README.
If with a binutils release, see binutils/README;  if with a libg++ release,
see libg++/README, etc.  That'll give you info about this
package -- supported targets, how to use it, how to report bugs, etc.

It is now possible to automatically configure and build a variety of
tools with one command.  To build all of the tools contained herein,
run the ``configure'' script here, e.g.:

	./configure 
	make

To install them (by default in /usr/local/bin, /usr/local/lib, etc),
then do:
	make install

(If the configure script can't determine your type of computer, give it
the name as an argument, for instance ``./configure sun4''.  You can
use the script ``config.sub'' to test whether a name is recognized; if
it is, config.sub translates it to a triplet specifying CPU, vendor,
and OS.)

If you have more than one compiler on your system, it is often best to
explicitly set CC in the environment before running configure, and to
also set CC when running make.  For example (assuming sh/bash/ksh):

	CC=gcc ./configure
	make

A similar example using csh:

	setenv CC gcc
	./configure
	make

Much of the code and documentation enclosed is copyright by
the Free Software Foundation, Inc.  See the file COPYING or
COPYING.LIB in the various directories, for a description of the
GNU General Public License terms under which you can copy the files.

REPORTING BUGS: Again, see gdb/README, binutils/README, etc., for info
on where and how to report problems.