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

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

[Christopher Faylor]

2006-05-22  Christopher Faylor  <cgf@timesys.com>

	* gdb.texinfo (Cygwin Native): Document set/show cygwin-exceptions.

Index: gdb.texinfo
===================================================================
RCS file: /cvs/uberbaum/gdb/doc/gdb.texinfo,v
retrieving revision 1.330
diff -u -p -r1.330 gdb.texinfo
--- gdb.texinfo	14 May 2006 15:09:51 -0000	1.330
+++ gdb.texinfo	22 May 2006 04:17:48 -0000
@@ -13517,6 +13517,16 @@ This is a Cygwin specific alias of info 
 This command loads symbols from a dll similarly to
 add-sym command but without the need to specify a base address.
 
+@kindex set cygwin-exceptions
+@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".
+
+@kindex show cygwin-exceptions
+@item show cygwin-exceptions
+Displays whether gdb will break on exceptions from the cygwin DLL itself.
+
 @kindex set new-console
 @item set new-console @var{mode}
 If @var{mode} is @code{on} the debuggee will

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

[Eli Zaretskii]

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

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

[Christopher Faylor]

On Mon, May 22, 2006 at 09:59:37PM +0300, Eli Zaretskii wrote:
>> 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.

There is no need to thank me.  It strikes me as pretty disingenuous given
your past views about Cygwin.

If you think my wording or usage is wrong then please just change it and
don't bother with the false gratitude.

cgf

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

[Jim Blandy]

Christopher Faylor <me@cgf.cx> writes:
> On Mon, May 22, 2006 at 09:59:37PM +0300, Eli Zaretskii wrote:
>>> 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.
>
> There is no need to thank me.  It strikes me as pretty disingenuous given
> your past views about Cygwin.
>
> If you think my wording or usage is wrong then please just change it and
> don't bother with the false gratitude.

Chris, this is horrible.  Eli is the GDB doc maintainer.  He says
"thanks" in response to almost any documentation submission.  I don't
see his edits to your text as insulting at all.

I don't know what sort of history you and Eli have, but as long as Eli
is doing his job in a civil way, the history should be left out of it.

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

[Eli Zaretskii]

> From: Jim Blandy <jimb@codesourcery.com>
> Date: Tue, 23 May 2006 10:58:28 -0700
> 
> I don't know what sort of history you and Eli have

AFAIK, we have no history.  A couple of intense technical arguments,
maybe, but I always thought we've succeeded to stay technical.  I
guess I was wrong...

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

[Eli Zaretskii]

> Date: Tue, 23 May 2006 00:54:53 -0400
> From: Christopher Faylor <me@cgf.cx>
> 
> On Mon, May 22, 2006 at 09:59:37PM +0300, Eli Zaretskii wrote:
> >> 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.
> 
> There is no need to thank me.  It strikes me as pretty disingenuous given
> your past views about Cygwin.
> 
> If you think my wording or usage is wrong then please just change it and
> don't bother with the false gratitude.

Chris,

To say the truth, I'm speechless.  What does one say in response to
such an unprovoked assault?  Would it help to say that, no matter what
are my opinions about the technical aspects of Cygwin, I'm treating it
as any other supported GDB port, and so would like its commands to be
documented as well as those of other ports?  That, no matter how many
times I re-read my message, I cannot find any hint there--not one--of
being disingenuous, or of false gratitude, or of any other bad
attitude towards you personally or Cygwin in general.  All I find is
IMHO a polite and technical response.

If you had a long and bad day, I'm sorry, but I'm pretty sure I had
nothing to do with that.  I don't think I deserve such an attack for
doing my job.