From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gdb-patches-return-44314-listarch-gdb-patches=sources.redhat.com@sourceware.org>
Received: (qmail 18067 invoked by alias); 22 May 2006 18:59:45 -0000
Received: (qmail 18057 invoked by uid 22791); 22 May 2006 18:59:43 -0000
X-Spam-Check-By: sourceware.org
Received: from romy.inter.net.il (HELO romy.inter.net.il) (192.114.186.66)     by sourceware.org (qpsmtpd/0.31) with ESMTP; Mon, 22 May 2006 18:59:40 +0000
Received: from HOME-C4E4A596F7 (IGLD-80-230-20-135.inter.net.il [80.230.20.135]) 	by romy.inter.net.il (MOS 3.7.3-GA) 	with ESMTP id EGE32967 (AUTH halo1); 	Mon, 22 May 2006 21:59:36 +0300 (IDT)
Date: Mon, 22 May 2006 23:11:00 -0000
Message-Id: <ud5e5ga1y.fsf@gnu.org>
From: Eli Zaretskii <eliz@gnu.org>
To: gdb-patches@sourceware.org
In-reply-to: <20060522041938.GA7733@trixie.casa.cgf.cx> (message from 	Christopher Faylor on Mon, 22 May 2006 00:19:38 -0400)
Subject: Re: [committed] update gdb.texinfo for "set/show cygwin-exceptions"
Reply-to: Eli Zaretskii <eliz@gnu.org>
References:  <20060522041938.GA7733@trixie.casa.cgf.cx>
X-IsSubscribed: yes
Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm
Precedence: bulk
List-Subscribe: <mailto:gdb-patches-subscribe@sourceware.org>
List-Archive: <http://sourceware.org/ml/gdb-patches/>
List-Post: <mailto:gdb-patches@sourceware.org>
List-Help: <mailto:gdb-patches-help@sourceware.org>, <http://sourceware.org/ml/#faqs>
Sender: gdb-patches-owner@sourceware.org
X-SW-Source: 2006-05/txt/msg00443.txt.bz2

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