Add more comments

Author: Noisyfox

substratevm/src/com.oracle.objectfile/src/com/oracle/objectfile/macho/MachOUserDefinedSection.java

@@ -218,7 +218,13 @@ public RelocationRecord markRelocationSite(int offset, ByteBuffer bb, Relocation
                 case AARCH64_R_AARCH64_LDST8_ABS_LO12_NC:
                 case AARCH64_R_AARCH64_ADD_ABS_LO12_NC:
                     if (explicitAddend != 0) {
-                        // Create ARM64_RELOC_ADDEND
+                        /*
+                         * These relocations should use an explicit addend reloc record instead of an embedded addend,
+                         * according to the Mach-O ld code at
+                         * https://opensource.apple.com/source/ld64/ld64-274.2/src/ld/parsers/macho_relocatable_file.cpp.auto.html
+                         *
+                         * > xxxx instruction at xxxx has embedded addend. ARM64_RELOC_ADDEND should be used instead
+                         */
                         RelocationInfo addend = RelocationInfo.newAddend(el, this, offset, length, explicitAddend);
                         el.add(addend);
                     }