COFF CALC_ADDEND comment
authorAlan Modra <amodra@gmail.com>
Mon, 16 Jan 2023 04:53:21 +0000 (15:23 +1030)
committerAlan Modra <amodra@gmail.com>
Mon, 16 Jan 2023 12:55:26 +0000 (23:25 +1030)
Old COFF (and AOUT) targets have unusual relocation addends.

* coffcode.h (<Reading relocations>): Describe COFF addends.

bfd/coffcode.h

index e952bd77d6a8d74eb3449ef5d7bcddbf292c4544..c4f7d199c82dc5fc892da7c04c5ce55da6a8346a 100644 (file)
@@ -5092,6 +5092,14 @@ SUBSUBSECTION
        structure, in a back end specific way. For instance, the 386
        uses the @code{r_type} to directly produce an index
        into a howto table vector.
+
+       o Note that @code{arelent.addend} for COFF is often not what
+       most people understand as a relocation addend, but rather an
+       adjustment to the relocation addend stored in section contents
+       of relocatable object files.  The value found in section
+       contents may also be confusing, depending on both symbol value
+       and addend somewhat similar to the field value for a
+       final-linked object.  See @code{CALC_ADDEND}.
 */
 
 #ifndef CALC_ADDEND