Re: [committed] update gdb.texinfo for "set/show cygwin-exceptions"

Eli Zaretskii
2006-05-22T18:59:45Z

> 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}