ARM-software / abi-aa

Application Binary Interface for the Arm® Architecture
Other
938 stars 188 forks source link

Clarify use of DWARF versions #239

Open Stammark opened 8 months ago

Stammark commented 8 months ago

Hi all,

In:

https://github.com/ARM-software/abi-aa/blob/main/aadwarf32/aadwarf32.rst#overview https://github.com/ARM-software/abi-aa/blob/main/aadwarf64/aadwarf64.rst#overview

We have references to DWARF 3.0: The ABI for the Arm architecture specifies the use of DWARF 3.0-format debugging data. The ABI for the Arm 64-bit architecture specifies the use of DWARF 3.0 format debugging data.

These could be misread as a "Arm requires you to use DWARF 3.0" which isn't valid in practice, these days.

I'm raising this issue to suggest that be changed to more flexible wording. That could be something like:

And in all those cases we could come up with a statement like "refer to the documentation of your debugger for the best compatible DWARF version" (since that is outside the scope of the aadwarf doc)