This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
Re: [committed] update gdb.texinfo for "set/show cygwin-exceptions"
- From: Eli Zaretskii <eliz at gnu dot org>
- To: gdb-patches at sourceware dot org
- Date: Mon, 22 May 2006 21:59:37 +0300
- Subject: Re: [committed] update gdb.texinfo for "set/show cygwin-exceptions"
- References: <20060522041938.GA7733@trixie.casa.cgf.cx>
- Reply-to: Eli Zaretskii <eliz at gnu dot org>
> Date: Mon, 22 May 2006 00:19:38 -0400
> From: Christopher Faylor <me@cgf.cx>
>
> 2006-05-22 Christopher Faylor <cgf@timesys.com>
>
> * gdb.texinfo (Cygwin Native): Document set/show cygwin-exceptions.
Thanks. This had some drawbacks; fixed thusly:
2006-05-22 Eli Zaretskii <eliz@gnu.org>
* gdb.texinfo (Cygwin Native): Fix last change.
Index: gdb/doc/gdb.texinfo
===================================================================
RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v
retrieving revision 1.331
diff -u -r1.331 gdb.texinfo
--- gdb/doc/gdb.texinfo 22 May 2006 04:17:59 -0000 1.331
+++ gdb/doc/gdb.texinfo 22 May 2006 18:58:35 -0000
@@ -13518,14 +13518,21 @@
add-sym command but without the need to specify a base address.
@kindex set cygwin-exceptions
+@cindex debugging the Cygwin DLL
+@cindex Cygwin DLL, debugging
@item set cygwin-exceptions @var{mode}
-If @var{mode} is @code{on} gdb will break on exceptions from the cygwin DLL itself.
-If @var{mode} is @code{off} gdb will delay recognition of exceptions and may ignore
-some exceptions which seem to be caused by internal cygwin DLL "bookkeeping".
+If @var{mode} is @code{on}, @value{GDBN} will break on exceptions that
+happen inside the Cygwin DLL. If @var{mode} is @code{off},
+@value{GDBN} will delay recognition of exceptions, and may ignore some
+exceptions which seem to be caused by internal Cygwin DLL
+``bookkeeping''. This option is meant primarily for debugging the
+Cygwin DLL itself; the default value is @code{off} to avoid annoying
+@value{GDBN} users with false @code{SIGSEGV} signals.
@kindex show cygwin-exceptions
@item show cygwin-exceptions
-Displays whether gdb will break on exceptions from the cygwin DLL itself.
+Displays whether @value{GDBN} will break on exceptions that happen
+inside the Cygwin DLL itself.
@kindex set new-console
@item set new-console @var{mode}