Re: [RFA] Darwin/x86 port (v4 - part 0/4)

[Tristan Gingold <gingold@adacore.com>]

On Nov 14, 2008, at 7:42 PM, Eli Zaretskii wrote:
>> *** gdb/NEWS	22 Oct 2008 22:14:21 -0000	1.292
>> + * New native configurations
>> +
>> + x86 Darwin			i[34567]86-*-darwin*
>> +
>
> This is okay, but I thought you also support x86_64?

Right.  What about:

* New native configurations

x86/x86_64 Darwin		i[34567]86-*-darwin*


I realized that we don't support configuring as x86_64-*-darwin*.   
Maybe I should
add it ?

>>  The bigger the value is the more verbose the output is.
>
> Suggest to rephrase:
>
>  "Higher values produce more verbose output."
>
> If you agree, please make this change in all the other places you use
> a similar phrase.

Sure.  English is not my native language and I sometimes don't pick  
the right word.

>> + @item set debug mach-o @var{num}
>> + @kindex set debug mach-o
>> + When set to a non zero value, enables debugging messages specific  
>> to
>> mach-o
>> + object file processing.  The bigger the value is the more verbose  
>> the
>
> Do all Darwin developers know what is "mach-o object file processing"?
> If not, perhaps a sentence or two of explanations are due.

Ok.

>> +                 If on any inferior faults (but single stepping and
>> + breakpoint) will be reported as a mach exception before being  
>> reported to
>> + the kernel.
>
> "If on, any inferior faults (except single stepping and breakpoint
>  traps) will be announced as mach exceptions before being reported to
>  the kernel."
>
> To tell the truth, I don't really understand the meaning of the
> mach-exceptions option, nor when it will be useful to GDB users.  Can
> you explain?

I tried to explain better in the documentation.  Basically it is  
useful to understand the
reason of why a signal was sent.

Here is the updated doc patch.

Thank you for your comments,
Tristan.


+ @node Darwin
+ @subsection Darwin
+ @cindex Darwin
+
+ @value{GDBN} provides the following commands specific to the Darwin  
target:
+
+ @table @code
+ @item set debug darwin @var{num}
+ @kindex set debug darwin
+ When set to a non zero value, enables debugging messages specific to
+ the Darwin support.  Higher values produce more verbose output.
+
+ @item show debug darwin
+ @kindex show debug darwin
+ Show the current state of Darwin messages.
+
+ @item set debug mach-o @var{num}
+ @kindex set debug mach-o
+ When set to a non zero value, enables debugging messages while gdb is
+ reading Darwin object files.  The object and executable file format
+ for Darwin is named mach-o.  Higher values produce more verbose
+ output.
+
+ @item show debug mach-o
+ @kindex show debug mach-o
+ Show the current state of mach-o file messages.
+
+ @item set mach-exceptions on
+ @itemx set mach-exceptions off
+ @kindex set mach-exceptions
+ On Darwin, faults are first reported as a mach exception and then as a
+ signal.  Use this command to turn on trapping of mach exceptions in
+ the inferior.  This might be seldom useful to better understand the
+ cause of a fault. The default is off.
+
+ @item show mach-exceptions
+ @kindex show mach-exceptions
+ Show the current state of exceptions trapping.
+ @end table
+