RFA: ARM unwinding tutorial

[Mark Mitchell]

Nick Clifton wrote:

>> This patch adds some tutorial to the GAS manual explaining how to use
>> some of the ARM unwinding pseudo ops from hand-written assembly code.
>> The intent is to enable users who need to write assembly code that
>> calls functions which might throw exceptions.  Paul Brook has reviewed
>> the documentation for accuracy.
>>
>> OK to apply?
> 
> Approved - please apply.

> Just a suggestion - I like to follow the GNU Coding conventions in
> example pieces of code in the documentation.  It makes everything
> consistent.

Thanks, committed.  I made the GNU Coding Conventions change, and I also
took the liberty of adding a paragraph (following an offlist suggestion)
to explain the lack of constraint on the location of these directives:

Only the order of the other pseudos ops (e.g., @code{.setfp} or
@code{.pad}) matters; their exact locations are irrelevant.  In the
example above, the compiler emits the pseudo ops with particular
instructions.  That makes it easier to understand the code, but it is
not required for correctness.  It would work just as well to emit all
of the pseudo ops other than @code{.fnend} in the same order, but
immediately after @code{.fnstart}.

Here's the version I've committed.  Please let me know if there's any
problem with me adding this additional paragraph.

Thanks,

-- 
Mark Mitchell
CodeSourcery
mark@codesourcery.com
(650) 331-3385 x713
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: binutils.patch
URL: <https://sourceware.org/pipermail/binutils/attachments/20080826/b32a6c3f/attachment.ksh>