Go to 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 New directory. Created to contain a copy of the texi2pod.pl script so that 2002-07-03 11:20:13 +00:00
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 comment typo fixes 2002-01-21 14:03:27 +00:00
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 Add MMIX support 2001-10-30 15:20:14 +00:00
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 19990502 sourceware import 1999-05-03 07:29:11 +00:00
COPYING.LIB 19990502 sourceware import 1999-05-03 07:29:11 +00:00
COPYING.LIBGLOSS 2002-12-20 Jeff Johnston <jjohnstn@redhat.com> 2002-12-20 21:36:01 +00:00
COPYING.NEWLIB 2003-05-28 Jeff Johnston <jjohnstn@redhat.com> 2003-05-28 17:51:42 +00:00
djunpack.bat * djunpack.bat: Change the Sed script to replace @V@ in fnchange.lst 2000-05-08 15:13:30 +00:00
gettext.m4 * gettext.m4: Test po/POTFILES.in exists before trying to read. 2001-10-03 01:46:25 +00:00
install-sh 19990502 sourceware import 1999-05-03 07:29:11 +00:00
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 2002-12-01 Nathanael Nerode <neroden@gcc.gnu.org> 2002-12-01 12:01:26 +00:00
ltcf-cxx.sh * libtool.m4 (LD): Append -melf* option to LD on IRIX with GNU ld. 2003-02-20 01:12:28 +00:00
ltcf-gcj.sh * ltcf-cxx.sh: Replace $linker_flags with $compiler_flags wherever 2003-02-19 23:51:28 +00:00
ltconfig Import patch to add FreeBSD support. 2003-05-29 14:02:04 +00:00
ltmain.sh * ltmain.sh (relink_command): Fix typo in previous change. 2002-03-16 14:43:09 +00:00
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 19990502 sourceware import 1999-05-03 07:29:11 +00:00
missing 19990502 sourceware import 1999-05-03 07:29:11 +00:00
mkdep * mkdep: New file. 1999-08-08 17:46:02 +00:00
mkinstalldirs * mkinstalldirs: Import autoconf 2.57 / automake 1.7 version. 2003-07-30 01:35:07 +00:00
move-if-change 19990502 sourceware import 1999-05-03 07:29:11 +00:00
mpw-build.in 19990502 sourceware import 1999-05-03 07:29:11 +00:00
mpw-config.in 19990502 sourceware import 1999-05-03 07:29:11 +00:00
mpw-configure 19990502 sourceware import 1999-05-03 07:29:11 +00:00
mpw-install 19990502 sourceware import 1999-05-03 07:29:11 +00:00
mpw-README 19990502 sourceware import 1999-05-03 07:29:11 +00:00
README 19990502 sourceware import 1999-05-03 07:29:11 +00:00
README-maintainer-mode Update URL 2003-05-30 07:30:26 +00:00
setup.com 19990502 sourceware import 1999-05-03 07:29:11 +00:00
src-release * src-release (DEVO_SUPPORT): Add src-release, Makefile.tpl, 2003-05-02 17:29:48 +00:00
symlink-tree gcc adopts symlink-tree, refer more to libiberty. 2001-12-05 10:07:09 +00:00
ylwrap 19990502 sourceware import 1999-05-03 07:29:11 +00:00

		   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.