This is the mail archive of the dwarf2@corp.sgi.com mailing list for the dwarf2 project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

PROPOSAL: Rename DW_FORM_ref_addr to DW_FORM_ref_info


Proposal:  Rename DW_FORM_ref_addr to DW_FORM_ref_info

Related proposals: 991108.4, 0000410.4

Discussion
----------

At least two proposals as well as review comments re the V2.1 Draft 1 have
made attempts to better describe what DW_FORM_ref_addr really means/does.

Some of the V2 problem exists, not doubt, because DW_FORM_ref_addr gets
confused with an "address" -- which is exceedingly natural because of the
name. If we just change the name from DW_FORM_ref_addr to DW_FORM_ref_info
(chosen because it is a section offset into the .debug_info section), such
confusion should be much less likely.

[DW_FORM_addr is an address, of course, but not DW_FORM_ref_addr.]
         ^^^^                                           ^^^^^^^^

This need not be considered an incompatible change. No bits need to change
in any DWARF file, and no code needs to change in any DWARF producer or
consumer. Producers and consumers can phase in the DW_FORM_ref_info name
as soon or as late as they want, and can even #define one in terms of the
other to allow them to co-exist.

[Maybe that last paragraph would make a good italized comment to include
following the definition of DW_FORM_ref_info.]


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]