[binutils-gdb] bfd-in2.h BFD_RELOC_* comments

Alan Modra amodra@sourceware.org
Sun Oct 22 23:45:47 GMT 2023


https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=23cdc1d6da5841510166cb5ee08ac97c0a388dcb

commit 23cdc1d6da5841510166cb5ee08ac97c0a388dcb
Author: Alan Modra <amodra@gmail.com>
Date:   Sat Oct 21 17:54:59 2023 +1030

    bfd-in2.h BFD_RELOC_* comments
    
    I noticed the regenerated BFD_RELOC_MICROBLAZE_32_NONE comment didn't
    match that committed to bfd-in2.h, and was just going to regen
    bfd-in2.h but then decided to do something about the silly formatting
    of these comments in bfd-in2.h.  eg. the BFD_RELOC_MICROBLAZE_32_NONE
    comment:
    
    -/* This is a 32 bit reloc that stores the 32 bit pc relative
    -value in two words (with an imm instruction).No relocation is
    -done here - only used for relaxing  */
    +  /* This is a 32 bit reloc that stores the 32 bit pc relative value in
    +     two words (with an imm instruction).  No relocation is done here -
    +     only used for relaxing.  */
       BFD_RELOC_MICROBLAZE_32_NONE,
    
    You'll notice how the second and third line of the original comment
    aren't indented properly relative to the first line, and the whole
    comment needs to be indented to match the code.
    
    I've also edited reloc.c ENUMDOC paragraphs.  Some of these had excess
    indentation, presumably in an attempt to properly indent bfd-in2.h
    comments but that fails due to chew.c removing leading whitespace
    early by skip_white_and_stars.  COMMENT was used in reloc.c to add
    extra blank lines in bfd-in2.h.  I've removed them too as I don't
    think they add anything to readability of that file.  (Perhaps more
    usefully, they also add blank lines to libbfd.h separating relocs for
    one target from others, but this isn't done consistently.)
    
            * doc/chew.c (drop, idrop): Move earlier.
            (strip_trailing_newlines): Check index before accessing array,
            not after.
            (wrap_comment): New function.
            (main): Add "wrap_comment" intrinsic.
            * doc/proto.str (ENUMDOC): Use wrap_comment.
            (make_enum_header, ENDSENUM): Put start and end braces on
            separate lines.
            * reloc.c: Remove uses of COMMENT and edit ENUMDOC paragraphs.
            * libbfd.h: Regenerate.
            * bfd-in2.h: Regenerate.

Diff:
---
 bfd/bfd-in2.h     | 2141 ++++++++++++++++++++++++++---------------------------
 bfd/doc/chew.c    |   68 +-
 bfd/doc/proto.str |    8 +-
 bfd/libbfd.h      |    8 -
 bfd/reloc.c       |  998 ++++++++++++-------------
 5 files changed, 1576 insertions(+), 1647 deletions(-)

diff --git a/bfd/bfd-in2.h b/bfd/bfd-in2.h
index 3d7dbf66638..e26bc40a9e1 100644
--- a/bfd/bfd-in2.h
+++ b/bfd/bfd-in2.h
@@ -3251,11 +3251,12 @@ bfd_reloc_status_type bfd_install_relocation
     asection *input_section,
     char **error_message);
 
-enum bfd_reloc_code_real {
+enum bfd_reloc_code_real
+{
   _dummy_first_bfd_reloc_code_real,
 
 
-/* Basic absolute relocations of N bits.  */
+  /* Basic absolute relocations of N bits.  */
   BFD_RELOC_64,
   BFD_RELOC_32,
   BFD_RELOC_26,
@@ -3264,9 +3265,10 @@ enum bfd_reloc_code_real {
   BFD_RELOC_14,
   BFD_RELOC_8,
 
-/* PC-relative relocations.  Sometimes these are relative to the address
-of the relocation itself; sometimes they are relative to the start of
-the section containing the relocation.  It depends on the specific target.  */
+  /* PC-relative relocations.  Sometimes these are relative to the
+     address of the relocation itself; sometimes they are relative to the
+     start of the section containing the relocation.  It depends on the
+     specific target.  */
   BFD_RELOC_64_PCREL,
   BFD_RELOC_32_PCREL,
   BFD_RELOC_24_PCREL,
@@ -3274,11 +3276,11 @@ the section containing the relocation.  It depends on the specific target.  */
   BFD_RELOC_12_PCREL,
   BFD_RELOC_8_PCREL,
 
-/* Section relative relocations.  Some targets need this for DWARF2.  */
+  /* Section relative relocations.  Some targets need this for DWARF2.  */
   BFD_RELOC_32_SECREL,
   BFD_RELOC_16_SECIDX,
 
-/* For ELF.  */
+  /* For ELF.  */
   BFD_RELOC_32_GOT_PCREL,
   BFD_RELOC_16_GOT_PCREL,
   BFD_RELOC_8_GOT_PCREL,
@@ -3301,11 +3303,11 @@ the section containing the relocation.  It depends on the specific target.  */
   BFD_RELOC_HI16_S_PLTOFF,
   BFD_RELOC_8_PLTOFF,
 
-/* Size relocations.  */
+  /* Size relocations.  */
   BFD_RELOC_SIZE32,
   BFD_RELOC_SIZE64,
 
-/* Relocations used by 68K ELF.  */
+  /* Relocations used by 68K ELF.  */
   BFD_RELOC_68K_GLOB_DAT,
   BFD_RELOC_68K_JMP_SLOT,
   BFD_RELOC_68K_RELATIVE,
@@ -3325,7 +3327,7 @@ the section containing the relocation.  It depends on the specific target.  */
   BFD_RELOC_68K_TLS_LE16,
   BFD_RELOC_68K_TLS_LE8,
 
-/* Linkage-table relative.  */
+  /* Linkage-table relative.  */
   BFD_RELOC_32_BASEREL,
   BFD_RELOC_16_BASEREL,
   BFD_RELOC_LO16_BASEREL,
@@ -3334,33 +3336,33 @@ the section containing the relocation.  It depends on the specific target.  */
   BFD_RELOC_8_BASEREL,
   BFD_RELOC_RVA,
 
-/* Absolute 8-bit relocation, but used to form an address like 0xFFnn.  */
+  /* Absolute 8-bit relocation, but used to form an address like 0xFFnn.  */
   BFD_RELOC_8_FFnn,
 
-/* These PC-relative relocations are stored as word displacements --
-i.e., byte displacements shifted right two bits.  The 30-bit word
-displacement (<<32_PCREL_S2>> -- 32 bits, shifted 2) is used on the
-SPARC.  (SPARC tools generally refer to this as <<WDISP30>>.)  The
-signed 16-bit displacement is used on the MIPS, and the 23-bit
-displacement is used on the Alpha.  */
+  /* These PC-relative relocations are stored as word displacements --
+     i.e., byte displacements shifted right two bits.  The 30-bit word
+     displacement (<<32_PCREL_S2>> -- 32 bits, shifted 2) is used on the
+     SPARC.  (SPARC tools generally refer to this as <<WDISP30>>.)  The
+     signed 16-bit displacement is used on the MIPS, and the 23-bit
+     displacement is used on the Alpha.  */
   BFD_RELOC_32_PCREL_S2,
   BFD_RELOC_16_PCREL_S2,
   BFD_RELOC_23_PCREL_S2,
 
-/* High 22 bits and low 10 bits of 32-bit value, placed into lower bits of
-the target word.  These are used on the SPARC.  */
+  /* High 22 bits and low 10 bits of 32-bit value, placed into lower bits
+     of the target word.  These are used on the SPARC.  */
   BFD_RELOC_HI22,
   BFD_RELOC_LO10,
 
-/* For systems that allocate a Global Pointer register, these are
-displacements off that register.  These relocation types are
-handled specially, because the value the register will have is
-decided relatively late.  */
+  /* For systems that allocate a Global Pointer register, these are
+     displacements off that register.  These relocation types are
+     handled specially, because the value the register will have is
+     decided relatively late.  */
   BFD_RELOC_GPREL16,
   BFD_RELOC_GPREL32,
 
-/* SPARC ELF relocations.  There is probably some overlap with other
-relocation types already defined.  */
+  /* SPARC ELF relocations.  There is probably some overlap with other
+     relocation types already defined.  */
   BFD_RELOC_NONE,
   BFD_RELOC_SPARC_WDISP22,
   BFD_RELOC_SPARC22,
@@ -3386,11 +3388,11 @@ relocation types already defined.  */
   BFD_RELOC_SPARC_JMP_IREL,
   BFD_RELOC_SPARC_IRELATIVE,
 
-/* I think these are specific to SPARC a.out (e.g., Sun 4).  */
+  /* I think these are specific to SPARC a.out (e.g., Sun 4).  */
   BFD_RELOC_SPARC_BASE13,
   BFD_RELOC_SPARC_BASE22,
 
-/* SPARC64 relocations  */
+  /* SPARC64 relocations.  */
 #define BFD_RELOC_SPARC_64 BFD_RELOC_64
   BFD_RELOC_SPARC_10,
   BFD_RELOC_SPARC_11,
@@ -3420,10 +3422,10 @@ relocation types already defined.  */
   BFD_RELOC_SPARC_SIZE64,
   BFD_RELOC_SPARC_WDISP10,
 
-/* SPARC little endian relocation  */
+  /* SPARC little endian relocation.  */
   BFD_RELOC_SPARC_REV32,
 
-/* SPARC TLS relocations  */
+  /* SPARC TLS relocations.  */
   BFD_RELOC_SPARC_TLS_GD_HI22,
   BFD_RELOC_SPARC_TLS_GD_LO10,
   BFD_RELOC_SPARC_TLS_GD_ADD,
@@ -3449,7 +3451,7 @@ relocation types already defined.  */
   BFD_RELOC_SPARC_TLS_TPOFF32,
   BFD_RELOC_SPARC_TLS_TPOFF64,
 
-/* SPU Relocations.  */
+  /* SPU Relocations.  */
   BFD_RELOC_SPU_IMM7,
   BFD_RELOC_SPU_IMM8,
   BFD_RELOC_SPU_IMM10,
@@ -3466,92 +3468,92 @@ relocation types already defined.  */
   BFD_RELOC_SPU_PPU64,
   BFD_RELOC_SPU_ADD_PIC,
 
-/* Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
-"addend" in some special way.
-For GPDISP_HI16 ("gpdisp") relocations, the symbol is ignored when
-writing; when reading, it will be the absolute section symbol.  The
-addend is the displacement in bytes of the "lda" instruction from
-the "ldah" instruction (which is at the address of this reloc).  */
+  /* Alpha ECOFF and ELF relocations.  Some of these treat the symbol or
+     "addend" in some special way.
+     For GPDISP_HI16 ("gpdisp") relocations, the symbol is ignored when
+     writing; when reading, it will be the absolute section symbol.  The
+     addend is the displacement in bytes of the "lda" instruction from
+     the "ldah" instruction (which is at the address of this reloc).  */
   BFD_RELOC_ALPHA_GPDISP_HI16,
 
-/* For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
-with GPDISP_HI16 relocs.  The addend is ignored when writing the
-relocations out, and is filled in with the file's GP value on
-reading, for convenience.  */
+  /* For GPDISP_LO16 ("ignore") relocations, the symbol is handled as
+     with GPDISP_HI16 relocs.  The addend is ignored when writing the
+     relocations out, and is filled in with the file's GP value on
+     reading, for convenience.  */
   BFD_RELOC_ALPHA_GPDISP_LO16,
 
-/* The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
-relocation except that there is no accompanying GPDISP_LO16
-relocation.  */
+  /* The ELF GPDISP relocation is exactly the same as the GPDISP_HI16
+     relocation except that there is no accompanying GPDISP_LO16
+     relocation.  */
   BFD_RELOC_ALPHA_GPDISP,
 
-/* The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
-the assembler turns it into a LDQ instruction to load the address of
-the symbol, and then fills in a register in the real instruction.
-
-The LITERAL reloc, at the LDQ instruction, refers to the .lita
-section symbol.  The addend is ignored when writing, but is filled
-in with the file's GP value on reading, for convenience, as with the
-GPDISP_LO16 reloc.
-
-The ELF_LITERAL reloc is somewhere between 16_GOTOFF and GPDISP_LO16.
-It should refer to the symbol to be referenced, as with 16_GOTOFF,
-but it generates output not based on the position within the .got
-section, but relative to the GP value chosen for the file during the
-final link stage.
-
-The LITUSE reloc, on the instruction using the loaded address, gives
-information to the linker that it might be able to use to optimize
-away some literal section references.  The symbol is ignored (read
-as the absolute section symbol), and the "addend" indicates the type
-of instruction using the register:
-1 - "memory" fmt insn
-2 - byte-manipulation (byte offset reg)
-3 - jsr (target of branch)  */
+  /* The Alpha LITERAL/LITUSE relocs are produced by a symbol reference;
+     the assembler turns it into a LDQ instruction to load the address of
+     the symbol, and then fills in a register in the real instruction.
+
+     The LITERAL reloc, at the LDQ instruction, refers to the .lita
+     section symbol.  The addend is ignored when writing, but is filled
+     in with the file's GP value on reading, for convenience, as with the
+     GPDISP_LO16 reloc.
+
+     The ELF_LITERAL reloc is somewhere between 16_GOTOFF and GPDISP_LO16.
+     It should refer to the symbol to be referenced, as with 16_GOTOFF,
+     but it generates output not based on the position within the .got
+     section, but relative to the GP value chosen for the file during the
+     final link stage.
+
+     The LITUSE reloc, on the instruction using the loaded address, gives
+     information to the linker that it might be able to use to optimize
+     away some literal section references.  The symbol is ignored (read
+     as the absolute section symbol), and the "addend" indicates the type
+     of instruction using the register:
+     1 - "memory" fmt insn
+     2 - byte-manipulation (byte offset reg)
+     3 - jsr (target of branch)  */
   BFD_RELOC_ALPHA_LITERAL,
   BFD_RELOC_ALPHA_ELF_LITERAL,
   BFD_RELOC_ALPHA_LITUSE,
 
-/* The HINT relocation indicates a value that should be filled into the
-"hint" field of a jmp/jsr/ret instruction, for possible branch-
-prediction logic which may be provided on some processors.  */
+  /* The HINT relocation indicates a value that should be filled into the
+     "hint" field of a jmp/jsr/ret instruction, for possible branch-
+     prediction logic which may be provided on some processors.  */
   BFD_RELOC_ALPHA_HINT,
 
-/* The LINKAGE relocation outputs a linkage pair in the object file,
-which is filled by the linker.  */
+  /* The LINKAGE relocation outputs a linkage pair in the object file,
+     which is filled by the linker.  */
   BFD_RELOC_ALPHA_LINKAGE,
 
-/* The CODEADDR relocation outputs a STO_CA in the object file,
-which is filled by the linker.  */
+  /* The CODEADDR relocation outputs a STO_CA in the object file,
+     which is filled by the linker.  */
   BFD_RELOC_ALPHA_CODEADDR,
 
-/* The GPREL_HI/LO relocations together form a 32-bit offset from the
-GP register.  */
+  /* The GPREL_HI/LO relocations together form a 32-bit offset from the
+     GP register.  */
   BFD_RELOC_ALPHA_GPREL_HI16,
   BFD_RELOC_ALPHA_GPREL_LO16,
 
-/* Like BFD_RELOC_23_PCREL_S2, except that the source and target must
-share a common GP, and the target address is adjusted for
-STO_ALPHA_STD_GPLOAD.  */
+  /* Like BFD_RELOC_23_PCREL_S2, except that the source and target must
+     share a common GP, and the target address is adjusted for
+     STO_ALPHA_STD_GPLOAD.  */
   BFD_RELOC_ALPHA_BRSGP,
 
-/* The NOP relocation outputs a NOP if the longword displacement
-between two procedure entry points is < 2^21.  */
+  /* The NOP relocation outputs a NOP if the longword displacement
+     between two procedure entry points is < 2^21.  */
   BFD_RELOC_ALPHA_NOP,
 
-/* The BSR relocation outputs a BSR if the longword displacement
-between two procedure entry points is < 2^21.  */
+  /* The BSR relocation outputs a BSR if the longword displacement
+     between two procedure entry points is < 2^21.  */
   BFD_RELOC_ALPHA_BSR,
 
-/* The LDA relocation outputs a LDA if the longword displacement
-between two procedure entry points is < 2^16.  */
+  /* The LDA relocation outputs a LDA if the longword displacement
+     between two procedure entry points is < 2^16.  */
   BFD_RELOC_ALPHA_LDA,
 
-/* The BOH relocation outputs a BSR if the longword displacement
-between two procedure entry points is < 2^21, or else a hint.  */
+  /* The BOH relocation outputs a BSR if the longword displacement
+     between two procedure entry points is < 2^21, or else a hint.  */
   BFD_RELOC_ALPHA_BOH,
 
-/* Alpha thread-local storage relocations.  */
+  /* Alpha thread-local storage relocations.  */
   BFD_RELOC_ALPHA_TLSGD,
   BFD_RELOC_ALPHA_TLSLDM,
   BFD_RELOC_ALPHA_DTPMOD64,
@@ -3566,55 +3568,55 @@ between two procedure entry points is < 2^21, or else a hint.  */
   BFD_RELOC_ALPHA_TPREL_LO16,
   BFD_RELOC_ALPHA_TPREL16,
 
-/* The MIPS jump instruction.  */
+  /* The MIPS jump instruction.  */
   BFD_RELOC_MIPS_JMP,
   BFD_RELOC_MICROMIPS_JMP,
 
-/* The MIPS16 jump instruction.  */
+  /* The MIPS16 jump instruction.  */
   BFD_RELOC_MIPS16_JMP,
 
-/* MIPS16 GP relative reloc.  */
+  /* MIPS16 GP relative reloc.  */
   BFD_RELOC_MIPS16_GPREL,
 
-/* High 16 bits of 32-bit value; simple reloc.  */
+  /* High 16 bits of 32-bit value; simple reloc.  */
   BFD_RELOC_HI16,
 
-/* High 16 bits of 32-bit value but the low 16 bits will be sign
-extended and added to form the final result.  If the low 16
-bits form a negative number, we need to add one to the high value
-to compensate for the borrow when the low bits are added.  */
+  /* High 16 bits of 32-bit value but the low 16 bits will be sign
+     extended and added to form the final result.  If the low 16
+     bits form a negative number, we need to add one to the high value
+     to compensate for the borrow when the low bits are added.  */
   BFD_RELOC_HI16_S,
 
-/* Low 16 bits.  */
+  /* Low 16 bits.  */
   BFD_RELOC_LO16,
 
-/* High 16 bits of 32-bit pc-relative value  */
+  /* High 16 bits of 32-bit pc-relative value.  */
   BFD_RELOC_HI16_PCREL,
 
-/* High 16 bits of 32-bit pc-relative value, adjusted  */
+  /* High 16 bits of 32-bit pc-relative value, adjusted.  */
   BFD_RELOC_HI16_S_PCREL,
 
-/* Low 16 bits of pc-relative value  */
+  /* Low 16 bits of pc-relative value.  */
   BFD_RELOC_LO16_PCREL,
 
-/* Equivalent of BFD_RELOC_MIPS_*, but with the MIPS16 layout of
-16-bit immediate fields  */
+  /* Equivalent of BFD_RELOC_MIPS_*, but with the MIPS16 layout of
+     16-bit immediate fields.  */
   BFD_RELOC_MIPS16_GOT16,
   BFD_RELOC_MIPS16_CALL16,
 
-/* MIPS16 high 16 bits of 32-bit value.  */
+  /* MIPS16 high 16 bits of 32-bit value.  */
   BFD_RELOC_MIPS16_HI16,
 
-/* MIPS16 high 16 bits of 32-bit value but the low 16 bits will be sign
-extended and added to form the final result.  If the low 16
-bits form a negative number, we need to add one to the high value
-to compensate for the borrow when the low bits are added.  */
+  /* MIPS16 high 16 bits of 32-bit value but the low 16 bits will be sign
+     extended and added to form the final result.  If the low 16
+     bits form a negative number, we need to add one to the high value
+     to compensate for the borrow when the low bits are added.  */
   BFD_RELOC_MIPS16_HI16_S,
 
-/* MIPS16 low 16 bits.  */
+  /* MIPS16 low 16 bits.  */
   BFD_RELOC_MIPS16_LO16,
 
-/* MIPS16 TLS relocations  */
+  /* MIPS16 TLS relocations.  */
   BFD_RELOC_MIPS16_TLS_GD,
   BFD_RELOC_MIPS16_TLS_LDM,
   BFD_RELOC_MIPS16_TLS_DTPREL_HI16,
@@ -3623,31 +3625,31 @@ to compensate for the borrow when the low bits are added.  */
   BFD_RELOC_MIPS16_TLS_TPREL_HI16,
   BFD_RELOC_MIPS16_TLS_TPREL_LO16,
 
-/* Relocation against a MIPS literal section.  */
+  /* Relocation against a MIPS literal section.  */
   BFD_RELOC_MIPS_LITERAL,
   BFD_RELOC_MICROMIPS_LITERAL,
 
-/* microMIPS PC-relative relocations.  */
+  /* microMIPS PC-relative relocations.  */
   BFD_RELOC_MICROMIPS_7_PCREL_S1,
   BFD_RELOC_MICROMIPS_10_PCREL_S1,
   BFD_RELOC_MICROMIPS_16_PCREL_S1,
 
-/* MIPS16 PC-relative relocation.  */
+  /* MIPS16 PC-relative relocation.  */
   BFD_RELOC_MIPS16_16_PCREL_S1,
 
-/* MIPS PC-relative relocations.  */
+  /* MIPS PC-relative relocations.  */
   BFD_RELOC_MIPS_21_PCREL_S2,
   BFD_RELOC_MIPS_26_PCREL_S2,
   BFD_RELOC_MIPS_18_PCREL_S3,
   BFD_RELOC_MIPS_19_PCREL_S2,
 
-/* microMIPS versions of generic BFD relocs.  */
+  /* microMIPS versions of generic BFD relocs.  */
   BFD_RELOC_MICROMIPS_GPREL16,
   BFD_RELOC_MICROMIPS_HI16,
   BFD_RELOC_MICROMIPS_HI16_S,
   BFD_RELOC_MICROMIPS_LO16,
 
-/* MIPS ELF relocations.  */
+  /* MIPS ELF relocations.  */
   BFD_RELOC_MIPS_GOT16,
   BFD_RELOC_MICROMIPS_GOT16,
   BFD_RELOC_MIPS_CALL16,
@@ -3705,17 +3707,14 @@ to compensate for the borrow when the low bits are added.  */
   BFD_RELOC_MICROMIPS_TLS_TPREL_LO16,
   BFD_RELOC_MIPS_EH,
 
-
-/* MIPS ELF relocations (VxWorks and PLT extensions).  */
+  /* MIPS ELF relocations (VxWorks and PLT extensions).  */
   BFD_RELOC_MIPS_COPY,
   BFD_RELOC_MIPS_JUMP_SLOT,
 
-
-/* Moxie ELF relocations.  */
+  /* Moxie ELF relocations.  */
   BFD_RELOC_MOXIE_10_PCREL,
 
-
-/* FT32 ELF relocations.  */
+  /* FT32 ELF relocations.  */
   BFD_RELOC_FT32_10,
   BFD_RELOC_FT32_20,
   BFD_RELOC_FT32_17,
@@ -3726,8 +3725,7 @@ to compensate for the borrow when the low bits are added.  */
   BFD_RELOC_FT32_15,
   BFD_RELOC_FT32_DIFF32,
 
-
-/* Fujitsu Frv Relocations.  */
+  /* Fujitsu Frv Relocations.  */
   BFD_RELOC_FRV_LABEL16,
   BFD_RELOC_FRV_LABEL24,
   BFD_RELOC_FRV_LO16,
@@ -3768,45 +3766,43 @@ to compensate for the borrow when the low bits are added.  */
   BFD_RELOC_FRV_TLSOFF_RELAX,
   BFD_RELOC_FRV_TLSMOFF,
 
-
-/* This is a 24bit GOT-relative reloc for the mn10300.  */
+  /* This is a 24bit GOT-relative reloc for the mn10300.  */
   BFD_RELOC_MN10300_GOTOFF24,
 
-/* This is a 32bit GOT-relative reloc for the mn10300, offset by two bytes
-in the instruction.  */
+  /* This is a 32bit GOT-relative reloc for the mn10300, offset by two
+     bytes in the instruction.  */
   BFD_RELOC_MN10300_GOT32,
 
-/* This is a 24bit GOT-relative reloc for the mn10300, offset by two bytes
-in the instruction.  */
+  /* This is a 24bit GOT-relative reloc for the mn10300, offset by two
+     bytes in the instruction.  */
   BFD_RELOC_MN10300_GOT24,
 
-/* This is a 16bit GOT-relative reloc for the mn10300, offset by two bytes
-in the instruction.  */
+  /* This is a 16bit GOT-relative reloc for the mn10300, offset by two
+     bytes in the instruction.  */
   BFD_RELOC_MN10300_GOT16,
 
-/* Copy symbol at runtime.  */
+  /* Copy symbol at runtime.  */
   BFD_RELOC_MN10300_COPY,
 
-/* Create GOT entry.  */
+  /* Create GOT entry.  */
   BFD_RELOC_MN10300_GLOB_DAT,
 
-/* Create PLT entry.  */
+  /* Create PLT entry.  */
   BFD_RELOC_MN10300_JMP_SLOT,
 
-/* Adjust by program base.  */
+  /* Adjust by program base.  */
   BFD_RELOC_MN10300_RELATIVE,
 
-/* Together with another reloc targeted at the same location,
-allows for a value that is the difference of two symbols
-in the same section.  */
+  /* Together with another reloc targeted at the same location, allows
+     for a value that is the difference of two symbols in the same
+     section.  */
   BFD_RELOC_MN10300_SYM_DIFF,
 
-/* The addend of this reloc is an alignment power that must
-be honoured at the offset's location, regardless of linker
-relaxation.  */
+  /* The addend of this reloc is an alignment power that must be honoured
+     at the offset's location, regardless of linker relaxation.  */
   BFD_RELOC_MN10300_ALIGN,
 
-/* Various TLS-related relocations.  */
+  /* Various TLS-related relocations.  */
   BFD_RELOC_MN10300_TLS_GD,
   BFD_RELOC_MN10300_TLS_LD,
   BFD_RELOC_MN10300_TLS_LDO,
@@ -3817,16 +3813,15 @@ relaxation.  */
   BFD_RELOC_MN10300_TLS_DTPOFF,
   BFD_RELOC_MN10300_TLS_TPOFF,
 
-/* This is a 32bit pcrel reloc for the mn10300, offset by two bytes in the
-instruction.  */
+  /* This is a 32bit pcrel reloc for the mn10300, offset by two bytes in
+     the instruction.  */
   BFD_RELOC_MN10300_32_PCREL,
 
-/* This is a 16bit pcrel reloc for the mn10300, offset by two bytes in the
-instruction.  */
+  /* This is a 16bit pcrel reloc for the mn10300, offset by two bytes in
+     the instruction.  */
   BFD_RELOC_MN10300_16_PCREL,
 
-
-/* i386/elf relocations  */
+  /* i386/elf relocations.  */
   BFD_RELOC_386_GOT32,
   BFD_RELOC_386_PLT32,
   BFD_RELOC_386_COPY,
@@ -3853,7 +3848,7 @@ instruction.  */
   BFD_RELOC_386_IRELATIVE,
   BFD_RELOC_386_GOT32X,
 
-/* x86-64/elf relocations  */
+  /* x86-64/elf relocations.  */
   BFD_RELOC_X86_64_GOT32,
   BFD_RELOC_X86_64_PLT32,
   BFD_RELOC_X86_64_COPY,
@@ -3886,7 +3881,7 @@ instruction.  */
   BFD_RELOC_X86_64_GOTPCRELX,
   BFD_RELOC_X86_64_REX_GOTPCRELX,
 
-/* ns32k relocations  */
+  /* ns32k relocations.  */
   BFD_RELOC_NS32K_IMM_8,
   BFD_RELOC_NS32K_IMM_16,
   BFD_RELOC_NS32K_IMM_32,
@@ -3900,11 +3895,11 @@ instruction.  */
   BFD_RELOC_NS32K_DISP_16_PCREL,
   BFD_RELOC_NS32K_DISP_32_PCREL,
 
-/* PDP11 relocations  */
+  /* PDP11 relocations.  */
   BFD_RELOC_PDP11_DISP_8_PCREL,
   BFD_RELOC_PDP11_DISP_6_PCREL,
 
-/* Picojava relocs.  Not all of these appear in object files.  */
+  /* Picojava relocs.  Not all of these appear in object files.  */
   BFD_RELOC_PJ_CODE_HI16,
   BFD_RELOC_PJ_CODE_LO16,
   BFD_RELOC_PJ_CODE_DIR16,
@@ -3912,7 +3907,7 @@ instruction.  */
   BFD_RELOC_PJ_CODE_REL16,
   BFD_RELOC_PJ_CODE_REL32,
 
-/* Power(rs6000) and PowerPC relocations.  */
+  /* Power(rs6000) and PowerPC relocations.  */
   BFD_RELOC_PPC_B26,
   BFD_RELOC_PPC_BA26,
   BFD_RELOC_PPC_TOC16,
@@ -4018,7 +4013,7 @@ instruction.  */
   BFD_RELOC_PPC64_D28,
   BFD_RELOC_PPC64_PCREL28,
 
-/* PowerPC and PowerPC64 thread-local storage relocations.  */
+  /* PowerPC and PowerPC64 thread-local storage relocations.  */
   BFD_RELOC_PPC_TLS,
   BFD_RELOC_PPC_TLSGD,
   BFD_RELOC_PPC_TLSLD,
@@ -4083,57 +4078,58 @@ instruction.  */
   BFD_RELOC_PPC64_GOT_DTPREL_PCREL34,
   BFD_RELOC_PPC64_TLS_PCREL,
 
-/* IBM 370/390 relocations  */
+  /* IBM 370/390 relocations.  */
   BFD_RELOC_I370_D12,
 
-/* The type of reloc used to build a constructor table - at the moment
-probably a 32 bit wide absolute relocation, but the target can choose.
-It generally does map to one of the other relocation types.  */
+  /* The type of reloc used to build a constructor table - at the moment
+     probably a 32 bit wide absolute relocation, but the target can choose.
+     It generally does map to one of the other relocation types.  */
   BFD_RELOC_CTOR,
 
-/* ARM 26 bit pc-relative branch.  The lowest two bits must be zero and are
-not stored in the instruction.  */
+  /* ARM 26 bit pc-relative branch.  The lowest two bits must be zero and
+     are not stored in the instruction.  */
   BFD_RELOC_ARM_PCREL_BRANCH,
 
-/* ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
-not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
-field in the instruction.  */
+  /* ARM 26 bit pc-relative branch.  The lowest bit must be zero and is
+     not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
+     field in the instruction.  */
   BFD_RELOC_ARM_PCREL_BLX,
 
-/* Thumb 22 bit pc-relative branch.  The lowest bit must be zero and is
-not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
-field in the instruction.  */
+  /* Thumb 22 bit pc-relative branch.  The lowest bit must be zero and is
+     not stored in the instruction.  The 2nd lowest bit comes from a 1 bit
+     field in the instruction.  */
   BFD_RELOC_THUMB_PCREL_BLX,
 
-/* ARM 26-bit pc-relative branch for an unconditional BL or BLX instruction.  */
+  /* ARM 26-bit pc-relative branch for an unconditional BL or BLX
+     instruction.  */
   BFD_RELOC_ARM_PCREL_CALL,
 
-/* ARM 26-bit pc-relative branch for B or conditional BL instruction.  */
+  /* ARM 26-bit pc-relative branch for B or conditional BL instruction.  */
   BFD_RELOC_ARM_PCREL_JUMP,
 
-/* ARM 5-bit pc-relative branch for Branch Future instructions.  */
+  /* ARM 5-bit pc-relative branch for Branch Future instructions.  */
   BFD_RELOC_THUMB_PCREL_BRANCH5,
 
-/* ARM 6-bit pc-relative branch for BFCSEL instruction.  */
+  /* ARM 6-bit pc-relative branch for BFCSEL instruction.  */
   BFD_RELOC_THUMB_PCREL_BFCSEL,
 
-/* ARM 17-bit pc-relative branch for Branch Future instructions.  */
+  /* ARM 17-bit pc-relative branch for Branch Future instructions.  */
   BFD_RELOC_ARM_THUMB_BF17,
 
-/* ARM 13-bit pc-relative branch for BFCSEL instruction.  */
+  /* ARM 13-bit pc-relative branch for BFCSEL instruction.  */
   BFD_RELOC_ARM_THUMB_BF13,
 
-/* ARM 19-bit pc-relative branch for Branch Future Link instruction.  */
+  /* ARM 19-bit pc-relative branch for Branch Future Link instruction.  */
   BFD_RELOC_ARM_THUMB_BF19,
 
-/* ARM 12-bit pc-relative branch for Low Overhead Loop instructions.  */
+  /* ARM 12-bit pc-relative branch for Low Overhead Loop instructions.  */
   BFD_RELOC_ARM_THUMB_LOOP12,
 
-/* Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.
-The lowest bit must be zero and is not stored in the instruction.
-Note that the corresponding ELF R_ARM_THM_JUMPnn constant has an
-"nn" one smaller in all cases.  Note further that BRANCH23
-corresponds to R_ARM_THM_CALL.  */
+  /* Thumb 7-, 9-, 12-, 20-, 23-, and 25-bit pc-relative branches.
+     The lowest bit must be zero and is not stored in the instruction.
+     Note that the corresponding ELF R_ARM_THM_JUMPnn constant has an
+     "nn" one smaller in all cases.  Note further that BRANCH23
+     corresponds to R_ARM_THM_CALL.  */
   BFD_RELOC_THUMB_PCREL_BRANCH7,
   BFD_RELOC_THUMB_PCREL_BRANCH9,
   BFD_RELOC_THUMB_PCREL_BRANCH12,
@@ -4141,31 +4137,31 @@ corresponds to R_ARM_THM_CALL.  */
   BFD_RELOC_THUMB_PCREL_BRANCH23,
   BFD_RELOC_THUMB_PCREL_BRANCH25,
 
-/* 12-bit immediate offset, used in ARM-format ldr and str instructions.  */
+  /* 12-bit immediate offset, used in ARM-format ldr and str instructions.  */
   BFD_RELOC_ARM_OFFSET_IMM,
 
-/* 5-bit immediate offset, used in Thumb-format ldr and str instructions.  */
+  /* 5-bit immediate offset, used in Thumb-format ldr and str instructions.  */
   BFD_RELOC_ARM_THUMB_OFFSET,
 
-/* Pc-relative or absolute relocation depending on target.  Used for
-entries in .init_array sections.  */
+  /* Pc-relative or absolute relocation depending on target.  Used for
+     entries in .init_array sections.  */
   BFD_RELOC_ARM_TARGET1,
 
-/* Read-only segment base relative address.  */
+  /* Read-only segment base relative address.  */
   BFD_RELOC_ARM_ROSEGREL32,
 
-/* Data segment base relative address.  */
+  /* Data segment base relative address.  */
   BFD_RELOC_ARM_SBREL32,
 
-/* This reloc is used for references to RTTI data from exception handling
-tables.  The actual definition depends on the target.  It may be a
-pc-relative or some form of GOT-indirect relocation.  */
+  /* This reloc is used for references to RTTI data from exception
+     handling tables.  The actual definition depends on the target.  It
+     may be a pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_ARM_TARGET2,
 
-/* 31-bit PC relative address.  */
+  /* 31-bit PC relative address.  */
   BFD_RELOC_ARM_PREL31,
 
-/* Low and High halfword relocations for MOVW and MOVT instructions.  */
+  /* Low and High halfword relocations for MOVW and MOVT instructions.  */
   BFD_RELOC_ARM_MOVW,
   BFD_RELOC_ARM_MOVT,
   BFD_RELOC_ARM_MOVW_PCREL,
@@ -4175,7 +4171,7 @@ pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_ARM_THUMB_MOVW_PCREL,
   BFD_RELOC_ARM_THUMB_MOVT_PCREL,
 
-/* ARM FDPIC specific relocations.  */
+  /* ARM FDPIC specific relocations.  */
   BFD_RELOC_ARM_GOTFUNCDESC,
   BFD_RELOC_ARM_GOTOFFFUNCDESC,
   BFD_RELOC_ARM_FUNCDESC,
@@ -4184,7 +4180,7 @@ pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_ARM_TLS_LDM32_FDPIC,
   BFD_RELOC_ARM_TLS_IE32_FDPIC,
 
-/* Relocations for setting up GOTs and PLTs for shared libraries.  */
+  /* Relocations for setting up GOTs and PLTs for shared libraries.  */
   BFD_RELOC_ARM_JUMP_SLOT,
   BFD_RELOC_ARM_GLOB_DAT,
   BFD_RELOC_ARM_GOT32,
@@ -4194,7 +4190,7 @@ pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_ARM_GOTPC,
   BFD_RELOC_ARM_GOT_PREL,
 
-/* ARM thread-local storage relocations.  */
+  /* ARM thread-local storage relocations.  */
   BFD_RELOC_ARM_TLS_GD32,
   BFD_RELOC_ARM_TLS_LDO32,
   BFD_RELOC_ARM_TLS_LDM32,
@@ -4210,7 +4206,7 @@ pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_ARM_THM_TLS_DESCSEQ,
   BFD_RELOC_ARM_TLS_DESC,
 
-/* ARM group relocations.  */
+  /* ARM group relocations.  */
   BFD_RELOC_ARM_ALU_PC_G0_NC,
   BFD_RELOC_ARM_ALU_PC_G0,
   BFD_RELOC_ARM_ALU_PC_G1_NC,
@@ -4240,20 +4236,20 @@ pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_ARM_LDC_SB_G1,
   BFD_RELOC_ARM_LDC_SB_G2,
 
-/* Annotation of BX instructions.  */
+  /* Annotation of BX instructions.  */
   BFD_RELOC_ARM_V4BX,
 
-/* ARM support for STT_GNU_IFUNC.  */
+  /* ARM support for STT_GNU_IFUNC.  */
   BFD_RELOC_ARM_IRELATIVE,
 
-/* Thumb1 relocations to support execute-only code.  */
+  /* Thumb1 relocations to support execute-only code.  */
   BFD_RELOC_ARM_THUMB_ALU_ABS_G0_NC,
   BFD_RELOC_ARM_THUMB_ALU_ABS_G1_NC,
   BFD_RELOC_ARM_THUMB_ALU_ABS_G2_NC,
   BFD_RELOC_ARM_THUMB_ALU_ABS_G3_NC,
 
-/* These relocs are only used within the ARM assembler.  They are not
-(at present) written to any object files.  */
+  /* These relocs are only used within the ARM assembler.  They are not
+     (at present) written to any object files.  */
   BFD_RELOC_ARM_IMMEDIATE,
   BFD_RELOC_ARM_ADRL_IMMEDIATE,
   BFD_RELOC_ARM_T32_IMMEDIATE,
@@ -4282,7 +4278,7 @@ pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_ARM_THUMB_IMM,
   BFD_RELOC_ARM_THUMB_SHIFT,
 
-/* Renesas / SuperH SH relocs.  Not all of these appear in object files.  */
+  /* Renesas / SuperH SH relocs.  Not all of these appear in object files.  */
   BFD_RELOC_SH_PCDISP8BY2,
   BFD_RELOC_SH_PCDISP12BY2,
   BFD_RELOC_SH_IMM3,
@@ -4381,7 +4377,7 @@ pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_SH_GOTOFFFUNCDESC20,
   BFD_RELOC_SH_FUNCDESC,
 
-/* ARC relocs.  */
+  /* ARC relocs.  */
   BFD_RELOC_ARC_NONE,
   BFD_RELOC_ARC_8,
   BFD_RELOC_ARC_16,
@@ -4452,40 +4448,40 @@ pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_ARC_NPS_CMEM16,
   BFD_RELOC_ARC_JLI_SECTOFF,
 
-/* ADI Blackfin 16 bit immediate absolute reloc.  */
+  /* ADI Blackfin 16 bit immediate absolute reloc.  */
   BFD_RELOC_BFIN_16_IMM,
 
-/* ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.  */
+  /* ADI Blackfin 16 bit immediate absolute reloc higher 16 bits.  */
   BFD_RELOC_BFIN_16_HIGH,
 
-/* ADI Blackfin 'a' part of LSETUP.  */
+  /* ADI Blackfin 'a' part of LSETUP.  */
   BFD_RELOC_BFIN_4_PCREL,
 
-/* ADI Blackfin.  */
+  /* ADI Blackfin.  */
   BFD_RELOC_BFIN_5_PCREL,
 
-/* ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.  */
+  /* ADI Blackfin 16 bit immediate absolute reloc lower 16 bits.  */
   BFD_RELOC_BFIN_16_LOW,
 
-/* ADI Blackfin.  */
+  /* ADI Blackfin.  */
   BFD_RELOC_BFIN_10_PCREL,
 
-/* ADI Blackfin 'b' part of LSETUP.  */
+  /* ADI Blackfin 'b' part of LSETUP.  */
   BFD_RELOC_BFIN_11_PCREL,
 
-/* ADI Blackfin.  */
+  /* ADI Blackfin.  */
   BFD_RELOC_BFIN_12_PCREL_JUMP,
 
-/* ADI Blackfin Short jump, pcrel.  */
+  /* ADI Blackfin Short jump, pcrel.  */
   BFD_RELOC_BFIN_12_PCREL_JUMP_S,
 
-/* ADI Blackfin Call.x not implemented.  */
+  /* ADI Blackfin Call.x not implemented.  */
   BFD_RELOC_BFIN_24_PCREL_CALL_X,
 
-/* ADI Blackfin Long Jump pcrel.  */
+  /* ADI Blackfin Long Jump pcrel.  */
   BFD_RELOC_BFIN_24_PCREL_JUMP_L,
 
-/* ADI Blackfin FD-PIC relocations.  */
+  /* ADI Blackfin FD-PIC relocations.  */
   BFD_RELOC_BFIN_GOT17M4,
   BFD_RELOC_BFIN_GOTHI,
   BFD_RELOC_BFIN_GOTLO,
@@ -4501,184 +4497,174 @@ pc-relative or some form of GOT-indirect relocation.  */
   BFD_RELOC_BFIN_GOTOFFHI,
   BFD_RELOC_BFIN_GOTOFFLO,
 
-/* ADI Blackfin GOT relocation.  */
+  /* ADI Blackfin GOT relocation.  */
   BFD_RELOC_BFIN_GOT,
 
-/* ADI Blackfin PLTPC relocation.  */
+  /* ADI Blackfin PLTPC relocation.  */
   BFD_RELOC_BFIN_PLTPC,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_PUSH,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_CONST,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_ADD,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_SUB,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_MULT,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_DIV,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_MOD,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_LSHIFT,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_RSHIFT,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_AND,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_OR,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_XOR,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_LAND,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_LOR,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_LEN,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_NEG,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_COMP,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_PAGE,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_HWPAGE,
 
-/* ADI Blackfin arithmetic relocation.  */
+  /* ADI Blackfin arithmetic relocation.  */
   BFD_ARELOC_BFIN_ADDR,
 
-/* Mitsubishi D10V relocs.
-This is a 10-bit reloc with the right 2 bits
-assumed to be 0.  */
+  /* Mitsubishi D10V relocs.
+     This is a 10-bit reloc with the right 2 bits assumed to be 0.  */
   BFD_RELOC_D10V_10_PCREL_R,
 
-/* Mitsubishi D10V relocs.
-This is a 10-bit reloc with the right 2 bits
-assumed to be 0.  This is the same as the previous reloc
-except it is in the left container, i.e.,
-shifted left 15 bits.  */
+  /* Mitsubishi D10V relocs.
+     This is a 10-bit reloc with the right 2 bits assumed to be 0.  This
+     is the same as the previous reloc except it is in the left
+     container, i.e., shifted left 15 bits.  */
   BFD_RELOC_D10V_10_PCREL_L,
 
-/* This is an 18-bit reloc with the right 2 bits
-assumed to be 0.  */
+  /* This is an 18-bit reloc with the right 2 bits assumed to be 0.  */
   BFD_RELOC_D10V_18,
 
-/* This is an 18-bit reloc with the right 2 bits
-assumed to be 0.  */
+  /* This is an 18-bit reloc with the right 2 bits assumed to be 0.  */
   BFD_RELOC_D10V_18_PCREL,
 
-/* Mitsubishi D30V relocs.
-This is a 6-bit absolute reloc.  */
+  /* Mitsubishi D30V relocs.
+     This is a 6-bit absolute reloc.  */
   BFD_RELOC_D30V_6,
 
-/* This is a 6-bit pc-relative reloc with
-the right 3 bits assumed to be 0.  */
+  /* This is a 6-bit pc-relative reloc with the right 3 bits assumed to
+     be 0.  */
   BFD_RELOC_D30V_9_PCREL,
 
-/* This is a 6-bit pc-relative reloc with
-the right 3 bits assumed to be 0. Same
-as the previous reloc but on the right side
-of the container.  */
+  /* This is a 6-bit pc-relative reloc with the right 3 bits assumed to
+     be 0.  Same as the previous reloc but on the right side of the
+     container.  */
   BFD_RELOC_D30V_9_PCREL_R,
 
-/* This is a 12-bit absolute reloc with the
-right 3 bitsassumed to be 0.  */
+  /* This is a 12-bit absolute reloc with the right 3 bitsassumed to
+     be 0.  */
   BFD_RELOC_D30V_15,
 
-/* This is a 12-bit pc-relative reloc with
-the right 3 bits assumed to be 0.  */
+  /* This is a 12-bit pc-relative reloc with the right 3 bits assumed to
+     be 0.  */
   BFD_RELOC_D30V_15_PCREL,
 
-/* This is a 12-bit pc-relative reloc with
-the right 3 bits assumed to be 0. Same
-as the previous reloc but on the right side
-of the container.  */
+  /* This is a 12-bit pc-relative reloc with the right 3 bits assumed to
+     be 0.  Same as the previous reloc but on the right side of the
+     container.  */
   BFD_RELOC_D30V_15_PCREL_R,
 
-/* This is an 18-bit absolute reloc with
-the right 3 bits assumed to be 0.  */
+  /* This is an 18-bit absolute reloc with the right 3 bits assumed to
+     be 0.  */
   BFD_RELOC_D30V_21,
 
-/* This is an 18-bit pc-relative reloc with
-the right 3 bits assumed to be 0.  */
+  /* This is an 18-bit pc-relative reloc with the right 3 bits assumed to
+     be 0.  */
   BFD_RELOC_D30V_21_PCREL,
 
-/* This is an 18-bit pc-relative reloc with
-the right 3 bits assumed to be 0. Same
-as the previous reloc but on the right side
-of the container.  */
+  /* This is an 18-bit pc-relative reloc with the right 3 bits assumed to
+     be 0.  Same as the previous reloc but on the right side of the
+     container.  */
   BFD_RELOC_D30V_21_PCREL_R,
 
-/* This is a 32-bit absolute reloc.  */
+  /* This is a 32-bit absolute reloc.  */
   BFD_RELOC_D30V_32,
 
-/* This is a 32-bit pc-relative reloc.  */
+  /* This is a 32-bit pc-relative reloc.  */
   BFD_RELOC_D30V_32_PCREL,
 
-/* DLX relocs  */
+  /* DLX relocs.  */
   BFD_RELOC_DLX_HI16_S,
-
-/* DLX relocs  */
   BFD_RELOC_DLX_LO16,
-
-/* DLX relocs  */
   BFD_RELOC_DLX_JMP26,
 
-/* Renesas M16C/M32C Relocations.  */
+  /* Renesas M16C/M32C Relocations.  */
   BFD_RELOC_M32C_HI8,
   BFD_RELOC_M32C_RL_JUMP,
   BFD_RELOC_M32C_RL_1ADDR,
   BFD_RELOC_M32C_RL_2ADDR,
 
-/* Renesas M32R (formerly Mitsubishi M32R) relocs.
-This is a 24 bit absolute address.  */
+  /* Renesas M32R (formerly Mitsubishi M32R) relocs.
+     This is a 24 bit absolute address.  */
   BFD_RELOC_M32R_24,
 
-/* This is a 10-bit pc-relative reloc with the right 2 bits assumed to be 0.  */
+  /* This is a 10-bit pc-relative reloc with the right 2 bits assumed to
+     be 0.  */
   BFD_RELOC_M32R_10_PCREL,
 
-/* This is an 18-bit reloc with the right 2 bits assumed to be 0.  */
+  /* This is an 18-bit reloc with the right 2 bits assumed to be 0.  */
   BFD_RELOC_M32R_18_PCREL,
 
-/* This is a 26-bit reloc with the right 2 bits assumed to be 0.  */
+  /* This is a 26-bit reloc with the right 2 bits assumed to be 0.  */
   BFD_RELOC_M32R_26_PCREL,
 
-/* This is a 16-bit reloc containing the high 16 bits of an address
-used when the lower 16 bits are treated as unsigned.  */
+  /* This is a 16-bit reloc containing the high 16 bits of an address
+     used when the lower 16 bits are treated as unsigned.  */
   BFD_RELOC_M32R_HI16_ULO,
 
-/* This is a 16-bit reloc containing the high 16 bits of an address
-used when the lower 16 bits are treated as signed.  */
+  /* This is a 16-bit reloc containing the high 16 bits of an address
+     used when the lower 16 bits are treated as signed.  */
   BFD_RELOC_M32R_HI16_SLO,
 
-/* This is a 16-bit reloc containing the lower 16 bits of an address.  */
+  /* This is a 16-bit reloc containing the lower 16 bits of an address.  */
   BFD_RELOC_M32R_LO16,
 
-/* This is a 16-bit reloc containing the small data area offset for use in
-add3, load, and store instructions.  */
+  /* This is a 16-bit reloc containing the small data area offset for use
+     in add3, load, and store instructions.  */
   BFD_RELOC_M32R_SDA16,
 
-/* For PIC.  */
+  /* For PIC.  */
   BFD_RELOC_M32R_GOT24,
   BFD_RELOC_M32R_26_PLTREL,
   BFD_RELOC_M32R_COPY,
@@ -4697,82 +4683,84 @@ add3, load, and store instructions.  */
   BFD_RELOC_M32R_GOTPC_HI_SLO,
   BFD_RELOC_M32R_GOTPC_LO,
 
-/* NDS32 relocs.
-This is a 20 bit absolute address.  */
+  /* NDS32 relocs.
+     This is a 20 bit absolute address.  */
   BFD_RELOC_NDS32_20,
 
-/* This is a 9-bit pc-relative reloc with the right 1 bit assumed to be 0.  */
+  /* This is a 9-bit pc-relative reloc with the right 1 bit assumed to
+     be 0.  */
   BFD_RELOC_NDS32_9_PCREL,
 
-/* This is a 9-bit pc-relative reloc with the right 1 bit assumed to be 0.  */
+  /* This is a 9-bit pc-relative reloc with the right 1 bit assumed to
+     be 0.  */
   BFD_RELOC_NDS32_WORD_9_PCREL,
 
-/* This is an 15-bit reloc with the right 1 bit assumed to be 0.  */
+  /* This is an 15-bit reloc with the right 1 bit assumed to be 0.  */
   BFD_RELOC_NDS32_15_PCREL,
 
-/* This is an 17-bit reloc with the right 1 bit assumed to be 0.  */
+  /* This is an 17-bit reloc with the right 1 bit assumed to be 0.  */
   BFD_RELOC_NDS32_17_PCREL,
 
-/* This is a 25-bit reloc with the right 1 bit assumed to be 0.  */
+  /* This is a 25-bit reloc with the right 1 bit assumed to be 0.  */
   BFD_RELOC_NDS32_25_PCREL,
 
-/* This is a 20-bit reloc containing the high 20 bits of an address
-used with the lower 12 bits  */
+  /* This is a 20-bit reloc containing the high 20 bits of an address
+     used with the lower 12 bits.  */
   BFD_RELOC_NDS32_HI20,
 
-/* This is a 12-bit reloc containing the lower 12 bits of an address
-then shift right by 3. This is used with ldi,sdi...  */
+  /* This is a 12-bit reloc containing the lower 12 bits of an address
+     then shift right by 3.  This is used with ldi,sdi.  */
   BFD_RELOC_NDS32_LO12S3,
 
-/* This is a 12-bit reloc containing the lower 12 bits of an address
-then shift left by 2. This is used with lwi,swi...  */
+  /* This is a 12-bit reloc containing the lower 12 bits of an address
+     then shift left by 2.  This is used with lwi,swi.  */
   BFD_RELOC_NDS32_LO12S2,
 
-/* This is a 12-bit reloc containing the lower 12 bits of an address
-then shift left by 1. This is used with lhi,shi...  */
+  /* This is a 12-bit reloc containing the lower 12 bits of an address
+     then shift left by 1.  This is used with lhi,shi.  */
   BFD_RELOC_NDS32_LO12S1,
 
-/* This is a 12-bit reloc containing the lower 12 bits of an address
-then shift left by 0. This is used with lbisbi...  */
+  /* This is a 12-bit reloc containing the lower 12 bits of an address
+     then shift left by 0.  This is used with lbisbi.  */
   BFD_RELOC_NDS32_LO12S0,
 
-/* This is a 12-bit reloc containing the lower 12 bits of an address
-then shift left by 0. This is only used with branch relaxations  */
+  /* This is a 12-bit reloc containing the lower 12 bits of an address
+     then shift left by 0.  This is only used with branch relaxations.  */
   BFD_RELOC_NDS32_LO12S0_ORI,
 
-/* This is a 15-bit reloc containing the small data area 18-bit signed offset
-and shift left by 3 for use in ldi, sdi...  */
+  /* This is a 15-bit reloc containing the small data area 18-bit signed
+     offset and shift left by 3 for use in ldi, sdi.  */
   BFD_RELOC_NDS32_SDA15S3,
 
-/* This is a 15-bit reloc containing the small data area 17-bit signed offset
-and shift left by 2 for use in lwi, swi...  */
+  /* This is a 15-bit reloc containing the small data area 17-bit signed
+     offset and shift left by 2 for use in lwi, swi.  */
   BFD_RELOC_NDS32_SDA15S2,
 
-/* This is a 15-bit reloc containing the small data area 16-bit signed offset
-and shift left by 1 for use in lhi, shi...  */
+  /* This is a 15-bit reloc containing the small data area 16-bit signed
+     offset and shift left by 1 for use in lhi, shi.  */
   BFD_RELOC_NDS32_SDA15S1,
 
-/* This is a 15-bit reloc containing the small data area 15-bit signed offset
-and shift left by 0 for use in lbi, sbi...  */
+  /* This is a 15-bit reloc containing the small data area 15-bit signed
+     offset and shift left by 0 for use in lbi, sbi.  */
   BFD_RELOC_NDS32_SDA15S0,
 
-/* This is a 16-bit reloc containing the small data area 16-bit signed offset
-and shift left by 3  */
+  /* This is a 16-bit reloc containing the small data area 16-bit signed
+     offset and shift left by 3.  */
   BFD_RELOC_NDS32_SDA16S3,
 
-/* This is a 17-bit reloc containing the small data area 17-bit signed offset
-and shift left by 2 for use in lwi.gp, swi.gp...  */
+  /* This is a 17-bit reloc containing the small data area 17-bit signed
+     offset and shift left by 2 for use in lwi.gp, swi.gp.  */
   BFD_RELOC_NDS32_SDA17S2,
 
-/* This is a 18-bit reloc containing the small data area 18-bit signed offset
-and shift left by 1 for use in lhi.gp, shi.gp...  */
+  /* This is a 18-bit reloc containing the small data area 18-bit signed
+     offset and shift left by 1 for use in lhi.gp, shi.gp.  */
   BFD_RELOC_NDS32_SDA18S1,
 
-/* This is a 19-bit reloc containing the small data area 19-bit signed offset
-and shift left by 0 for use in lbi.gp, sbi.gp...  */
+  /* This is a 19-bit reloc containing the small data area 19-bit signed
+     offset and shift left by 0 for use in lbi.gp, sbi.gp.  */
   BFD_RELOC_NDS32_SDA19S0,
 
-/* for PIC  */
+  /* For PIC.  */
   BFD_RELOC_NDS32_GOT20,
   BFD_RELOC_NDS32_9_PLTREL,
   BFD_RELOC_NDS32_25_PLTREL,
@@ -4789,7 +4777,7 @@ and shift left by 0 for use in lbi.gp, sbi.gp...  */
   BFD_RELOC_NDS32_GOTPC_HI20,
   BFD_RELOC_NDS32_GOTPC_LO12,
 
-/* for relax  */
+  /* For relax.  */
   BFD_RELOC_NDS32_INSN16,
   BFD_RELOC_NDS32_LABEL,
   BFD_RELOC_NDS32_LONGCALL1,
@@ -4811,27 +4799,27 @@ and shift left by 0 for use in lbi.gp, sbi.gp...  */
   BFD_RELOC_NDS32_LONGJUMP6,
   BFD_RELOC_NDS32_LONGJUMP7,
 
-/* for PIC  */
+  /* For PIC.  */
   BFD_RELOC_NDS32_PLTREL_HI20,
   BFD_RELOC_NDS32_PLTREL_LO12,
   BFD_RELOC_NDS32_PLT_GOTREL_HI20,
   BFD_RELOC_NDS32_PLT_GOTREL_LO12,
 
-/* for floating point  */
+  /* For floating point.  */
   BFD_RELOC_NDS32_SDA12S2_DP,
   BFD_RELOC_NDS32_SDA12S2_SP,
   BFD_RELOC_NDS32_LO12S2_DP,
   BFD_RELOC_NDS32_LO12S2_SP,
 
-/* for dwarf2 debug_line.  */
+  /* For dwarf2 debug_line.  */
   BFD_RELOC_NDS32_DWARF2_OP1,
   BFD_RELOC_NDS32_DWARF2_OP2,
   BFD_RELOC_NDS32_DWARF2_LEB,
 
-/* for eliminate 16-bit instructions  */
+  /* For eliminating 16-bit instructions.  */
   BFD_RELOC_NDS32_UPDATE_TA,
 
-/* for PIC object relaxation  */
+  /* For PIC object relaxation.  */
   BFD_RELOC_NDS32_PLT_GOTREL_LO20,
   BFD_RELOC_NDS32_PLT_GOTREL_LO15,
   BFD_RELOC_NDS32_PLT_GOTREL_LO19,
@@ -4842,17 +4830,18 @@ and shift left by 0 for use in lbi.gp, sbi.gp...  */
   BFD_RELOC_NDS32_GOT15S2,
   BFD_RELOC_NDS32_GOT17S2,
 
-/* NDS32 relocs.
-This is a 5 bit absolute address.  */
+  /* NDS32 relocs.
+     This is a 5 bit absolute address.  */
   BFD_RELOC_NDS32_5,
 
-/* This is a 10-bit unsigned pc-relative reloc with the right 1 bit assumed to be 0.  */
+  /* This is a 10-bit unsigned pc-relative reloc with the right 1 bit
+     assumed to be 0.  */
   BFD_RELOC_NDS32_10_UPCREL,
 
-/* If fp were omitted, fp can used as another gp.  */
+  /* If fp were omitted, fp can used as another gp.  */
   BFD_RELOC_NDS32_SDA_FP7U2_RELA,
 
-/* relaxation relative relocation types  */
+  /* Relaxation relative relocation types.  */
   BFD_RELOC_NDS32_RELAX_ENTRY,
   BFD_RELOC_NDS32_GOT_SUFF,
   BFD_RELOC_NDS32_GOTOFF_SUFF,
@@ -4872,16 +4861,16 @@ This is a 5 bit absolute address.  */
   BFD_RELOC_NDS32_DIFF_ULEB128,
   BFD_RELOC_NDS32_EMPTY,
 
-/* This is a 25 bit absolute address.  */
+  /* This is a 25 bit absolute address.  */
   BFD_RELOC_NDS32_25_ABS,
 
-/* For ex9 and ifc using.  */
+  /* For ex9 and ifc using.  */
   BFD_RELOC_NDS32_DATA,
   BFD_RELOC_NDS32_TRAN,
   BFD_RELOC_NDS32_17IFC_PCREL,
   BFD_RELOC_NDS32_10IFCU_PCREL,
 
-/* For TLS.  */
+  /* For TLS.  */
   BFD_RELOC_NDS32_TPOFF,
   BFD_RELOC_NDS32_GOTTPOFF,
   BFD_RELOC_NDS32_TLS_LE_HI20,
@@ -4911,172 +4900,152 @@ This is a 5 bit absolute address.  */
   BFD_RELOC_NDS32_REMOVE,
   BFD_RELOC_NDS32_GROUP,
 
-/* For floating load store relaxation.  */
+  /* For floating load store relaxation.  */
   BFD_RELOC_NDS32_LSI,
 
-/* This is a 9-bit reloc  */
+  /* This is a 9-bit reloc.  */
   BFD_RELOC_V850_9_PCREL,
 
-/* This is a 22-bit reloc  */
+  /* This is a 22-bit reloc.  */
   BFD_RELOC_V850_22_PCREL,
 
-/* This is a 16 bit offset from the short data area pointer.  */
+  /* This is a 16 bit offset from the short data area pointer.  */
   BFD_RELOC_V850_SDA_16_16_OFFSET,
 
-/* This is a 16 bit offset (of which only 15 bits are used) from the
-short data area pointer.  */
+  /* This is a 16 bit offset (of which only 15 bits are used) from the
+     short data area pointer.  */
   BFD_RELOC_V850_SDA_15_16_OFFSET,
 
-/* This is a 16 bit offset from the zero data area pointer.  */
+  /* This is a 16 bit offset from the zero data area pointer.  */
   BFD_RELOC_V850_ZDA_16_16_OFFSET,
 
-/* This is a 16 bit offset (of which only 15 bits are used) from the
-zero data area pointer.  */
+  /* This is a 16 bit offset (of which only 15 bits are used) from the
+     zero data area pointer.  */
   BFD_RELOC_V850_ZDA_15_16_OFFSET,
 
-/* This is an 8 bit offset (of which only 6 bits are used) from the
-tiny data area pointer.  */
+  /* This is an 8 bit offset (of which only 6 bits are used) from the
+     tiny data area pointer.  */
   BFD_RELOC_V850_TDA_6_8_OFFSET,
 
-/* This is an 8bit offset (of which only 7 bits are used) from the tiny
-data area pointer.  */
+  /* This is an 8bit offset (of which only 7 bits are used) from the tiny
+     data area pointer.  */
   BFD_RELOC_V850_TDA_7_8_OFFSET,
 
-/* This is a 7 bit offset from the tiny data area pointer.  */
+  /* This is a 7 bit offset from the tiny data area pointer.  */
   BFD_RELOC_V850_TDA_7_7_OFFSET,
 
-/* This is a 16 bit offset from the tiny data area pointer.  */
+  /* This is a 16 bit offset from the tiny data area pointer.  */
   BFD_RELOC_V850_TDA_16_16_OFFSET,
 
-/* This is a 5 bit offset (of which only 4 bits are used) from the tiny
-data area pointer.  */
+  /* This is a 5 bit offset (of which only 4 bits are used) from the tiny
+     data area pointer.  */
   BFD_RELOC_V850_TDA_4_5_OFFSET,
 
-/* This is a 4 bit offset from the tiny data area pointer.  */
+  /* This is a 4 bit offset from the tiny data area pointer.  */
   BFD_RELOC_V850_TDA_4_4_OFFSET,
 
-/* This is a 16 bit offset from the short data area pointer, with the
-bits placed non-contiguously in the instruction.  */
+  /* This is a 16 bit offset from the short data area pointer, with the
+     bits placed non-contiguously in the instruction.  */
   BFD_RELOC_V850_SDA_16_16_SPLIT_OFFSET,
 
-/* This is a 16 bit offset from the zero data area pointer, with the
-bits placed non-contiguously in the instruction.  */
+  /* This is a 16 bit offset from the zero data area pointer, with the
+     bits placed non-contiguously in the instruction.  */
   BFD_RELOC_V850_ZDA_16_16_SPLIT_OFFSET,
 
-/* This is a 6 bit offset from the call table base pointer.  */
+  /* This is a 6 bit offset from the call table base pointer.  */
   BFD_RELOC_V850_CALLT_6_7_OFFSET,
 
-/* This is a 16 bit offset from the call table base pointer.  */
+  /* This is a 16 bit offset from the call table base pointer.  */
   BFD_RELOC_V850_CALLT_16_16_OFFSET,
 
-/* Used for relaxing indirect function calls.  */
+  /* Used for relaxing indirect function calls.  */
   BFD_RELOC_V850_LONGCALL,
 
-/* Used for relaxing indirect jumps.  */
+  /* Used for relaxing indirect jumps.  */
   BFD_RELOC_V850_LONGJUMP,
 
-/* Used to maintain alignment whilst relaxing.  */
+  /* Used to maintain alignment whilst relaxing.  */
   BFD_RELOC_V850_ALIGN,
 
-/* This is a variation of BFD_RELOC_LO16 that can be used in v850e ld.bu
-instructions.  */
+  /* This is a variation of BFD_RELOC_LO16 that can be used in v850e
+     ld.bu instructions.  */
   BFD_RELOC_V850_LO16_SPLIT_OFFSET,
 
-/* This is a 16-bit reloc.  */
+  /* This is a 16-bit reloc.  */
   BFD_RELOC_V850_16_PCREL,
 
-/* This is a 17-bit reloc.  */
+  /* This is a 17-bit reloc.  */
   BFD_RELOC_V850_17_PCREL,
 
-/* This is a 23-bit reloc.  */
+  /* This is a 23-bit reloc.  */
   BFD_RELOC_V850_23,
 
-/* This is a 32-bit reloc.  */
+  /* This is a 32-bit reloc.  */
   BFD_RELOC_V850_32_PCREL,
 
-/* This is a 32-bit reloc.  */
+  /* This is a 32-bit reloc.  */
   BFD_RELOC_V850_32_ABS,
 
-/* This is a 16-bit reloc.  */
+  /* This is a 16-bit reloc.  */
   BFD_RELOC_V850_16_SPLIT_OFFSET,
 
-/* This is a 16-bit reloc.  */
+  /* This is a 16-bit reloc.  */
   BFD_RELOC_V850_16_S1,
 
-/* Low 16 bits. 16 bit shifted by 1.  */
+  /* Low 16 bits.  16 bit shifted by 1.  */
   BFD_RELOC_V850_LO16_S1,
 
-/* This is a 16 bit offset from the call table base pointer.  */
+  /* This is a 16 bit offset from the call table base pointer.  */
   BFD_RELOC_V850_CALLT_15_16_OFFSET,
 
-/* DSO relocations.  */
+  /* DSO relocations.  */
   BFD_RELOC_V850_32_GOTPCREL,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_16_GOT,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_32_GOT,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_22_PLT_PCREL,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_32_PLT_PCREL,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_COPY,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_GLOB_DAT,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_JMP_SLOT,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_RELATIVE,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_16_GOTOFF,
-
-/* DSO relocations.  */
   BFD_RELOC_V850_32_GOTOFF,
 
-/* start code.  */
+  /* Start code.  */
   BFD_RELOC_V850_CODE,
 
-/* start data in text.  */
+  /* Start data in text.  */
   BFD_RELOC_V850_DATA,
 
-/* This is a 8bit DP reloc for the tms320c30, where the most
-significant 8 bits of a 24 bit word are placed into the least
-significant 8 bits of the opcode.  */
+  /* This is a 8bit DP reloc for the tms320c30, where the most
+     significant 8 bits of a 24 bit word are placed into the least
+     significant 8 bits of the opcode.  */
   BFD_RELOC_TIC30_LDP,
 
-/* This is a 7bit reloc for the tms320c54x, where the least
-significant 7 bits of a 16 bit word are placed into the least
-significant 7 bits of the opcode.  */
+  /* This is a 7bit reloc for the tms320c54x, where the least
+     significant 7 bits of a 16 bit word are placed into the least
+     significant 7 bits of the opcode.  */
   BFD_RELOC_TIC54X_PARTLS7,
 
-/* This is a 9bit DP reloc for the tms320c54x, where the most
-significant 9 bits of a 16 bit word are placed into the least
-significant 9 bits of the opcode.  */
+  /* This is a 9bit DP reloc for the tms320c54x, where the most
+     significant 9 bits of a 16 bit word are placed into the least
+     significant 9 bits of the opcode.  */
   BFD_RELOC_TIC54X_PARTMS9,
 
-/* This is an extended address 23-bit reloc for the tms320c54x.  */
+  /* This is an extended address 23-bit reloc for the tms320c54x.  */
   BFD_RELOC_TIC54X_23,
 
-/* This is a 16-bit reloc for the tms320c54x, where the least
-significant 16 bits of a 23-bit extended address are placed into
-the opcode.  */
+  /* This is a 16-bit reloc for the tms320c54x, where the least
+     significant 16 bits of a 23-bit extended address are placed into
+     the opcode.  */
   BFD_RELOC_TIC54X_16_OF_23,
 
-/* This is a reloc for the tms320c54x, where the most
-significant 7 bits of a 23-bit extended address are placed into
-the opcode.  */
+  /* This is a reloc for the tms320c54x, where the most
+     significant 7 bits of a 23-bit extended address are placed into
+     the opcode.  */
   BFD_RELOC_TIC54X_MS7_OF_23,
 
-/* TMS320C6000 relocations.  */
+  /* TMS320C6000 relocations.  */
   BFD_RELOC_C6000_PCR_S21,
   BFD_RELOC_C6000_PCR_S12,
   BFD_RELOC_C6000_PCR_S10,
@@ -5108,38 +5077,38 @@ the opcode.  */
   BFD_RELOC_C6000_FPHEAD,
   BFD_RELOC_C6000_NOCMP,
 
-/* This is a 48 bit reloc for the FR30 that stores 32 bits.  */
+  /* This is a 48 bit reloc for the FR30 that stores 32 bits.  */
   BFD_RELOC_FR30_48,
 
-/* This is a 32 bit reloc for the FR30 that stores 20 bits split up into
-two sections.  */
+  /* This is a 32 bit reloc for the FR30 that stores 20 bits split up
+     into two sections.  */
   BFD_RELOC_FR30_20,
 
-/* This is a 16 bit reloc for the FR30 that stores a 6 bit word offset in
-4 bits.  */
+  /* This is a 16 bit reloc for the FR30 that stores a 6 bit word offset
+     in 4 bits.  */
   BFD_RELOC_FR30_6_IN_4,
 
-/* This is a 16 bit reloc for the FR30 that stores an 8 bit byte offset
-into 8 bits.  */
+  /* This is a 16 bit reloc for the FR30 that stores an 8 bit byte offset
+     into 8 bits.  */
   BFD_RELOC_FR30_8_IN_8,
 
-/* This is a 16 bit reloc for the FR30 that stores a 9 bit short offset
-into 8 bits.  */
+  /* This is a 16 bit reloc for the FR30 that stores a 9 bit short offset
+     into 8 bits.  */
   BFD_RELOC_FR30_9_IN_8,
 
-/* This is a 16 bit reloc for the FR30 that stores a 10 bit word offset
-into 8 bits.  */
+  /* This is a 16 bit reloc for the FR30 that stores a 10 bit word offset
+     into 8 bits.  */
   BFD_RELOC_FR30_10_IN_8,
 
-/* This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
-short offset into 8 bits.  */
+  /* This is a 16 bit reloc for the FR30 that stores a 9 bit pc relative
+     short offset into 8 bits.  */
   BFD_RELOC_FR30_9_PCREL,
 
-/* This is a 16 bit reloc for the FR30 that stores a 12 bit pc relative
-short offset into 11 bits.  */
+  /* This is a 16 bit reloc for the FR30 that stores a 12 bit pc relative
+     short offset into 11 bits.  */
   BFD_RELOC_FR30_12_PCREL,
 
-/* Motorola Mcore relocations.  */
+  /* Motorola Mcore relocations.  */
   BFD_RELOC_MCORE_PCREL_IMM8BY4,
   BFD_RELOC_MCORE_PCREL_IMM11BY2,
   BFD_RELOC_MCORE_PCREL_IMM4BY2,
@@ -5147,7 +5116,7 @@ short offset into 11 bits.  */
   BFD_RELOC_MCORE_PCREL_JSR_IMM11BY2,
   BFD_RELOC_MCORE_RVA,
 
-/* Toshiba Media Processor Relocations.  */
+  /* Toshiba Media Processor Relocations.  */
   BFD_RELOC_MEP_8,
   BFD_RELOC_MEP_16,
   BFD_RELOC_MEP_32,
@@ -5169,8 +5138,7 @@ short offset into 11 bits.  */
   BFD_RELOC_MEP_GNU_VTINHERIT,
   BFD_RELOC_MEP_GNU_VTENTRY,
 
-
-/* Imagination Technologies Meta relocations.  */
+  /* Imagination Technologies Meta relocations.  */
   BFD_RELOC_METAG_HIADDR16,
   BFD_RELOC_METAG_LOADDR16,
   BFD_RELOC_METAG_RELBRANCH,
@@ -5210,190 +5178,192 @@ short offset into 11 bits.  */
   BFD_RELOC_METAG_TLS_LE_HI16,
   BFD_RELOC_METAG_TLS_LE_LO16,
 
-/* These are relocations for the GETA instruction.  */
+  /* These are relocations for the GETA instruction.  */
   BFD_RELOC_MMIX_GETA,
   BFD_RELOC_MMIX_GETA_1,
   BFD_RELOC_MMIX_GETA_2,
   BFD_RELOC_MMIX_GETA_3,
 
-/* These are relocations for a conditional branch instruction.  */
+  /* These are relocations for a conditional branch instruction.  */
   BFD_RELOC_MMIX_CBRANCH,
   BFD_RELOC_MMIX_CBRANCH_J,
   BFD_RELOC_MMIX_CBRANCH_1,
   BFD_RELOC_MMIX_CBRANCH_2,
   BFD_RELOC_MMIX_CBRANCH_3,
 
-/* These are relocations for the PUSHJ instruction.  */
+  /* These are relocations for the PUSHJ instruction.  */
   BFD_RELOC_MMIX_PUSHJ,
   BFD_RELOC_MMIX_PUSHJ_1,
   BFD_RELOC_MMIX_PUSHJ_2,
   BFD_RELOC_MMIX_PUSHJ_3,
   BFD_RELOC_MMIX_PUSHJ_STUBBABLE,
 
-/* These are relocations for the JMP instruction.  */
+  /* These are relocations for the JMP instruction.  */
   BFD_RELOC_MMIX_JMP,
   BFD_RELOC_MMIX_JMP_1,
   BFD_RELOC_MMIX_JMP_2,
   BFD_RELOC_MMIX_JMP_3,
 
-/* This is a relocation for a relative address as in a GETA instruction or
-a branch.  */
+  /* This is a relocation for a relative address as in a GETA instruction
+     or a branch.  */
   BFD_RELOC_MMIX_ADDR19,
 
-/* This is a relocation for a relative address as in a JMP instruction.  */
+  /* This is a relocation for a relative address as in a JMP instruction.  */
   BFD_RELOC_MMIX_ADDR27,
 
-/* This is a relocation for an instruction field that may be a general
-register or a value 0..255.  */
+  /* This is a relocation for an instruction field that may be a general
+     register or a value 0..255.  */
   BFD_RELOC_MMIX_REG_OR_BYTE,
 
-/* This is a relocation for an instruction field that may be a general
-register.  */
+  /* This is a relocation for an instruction field that may be a general
+     register.  */
   BFD_RELOC_MMIX_REG,
 
-/* This is a relocation for two instruction fields holding a register and
-an offset, the equivalent of the relocation.  */
+  /* This is a relocation for two instruction fields holding a register
+     and an offset, the equivalent of the relocation.  */
   BFD_RELOC_MMIX_BASE_PLUS_OFFSET,
 
-/* This relocation is an assertion that the expression is not allocated as
-a global register.  It does not modify contents.  */
+  /* This relocation is an assertion that the expression is not allocated
+     as a global register.  It does not modify contents.  */
   BFD_RELOC_MMIX_LOCAL,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit pc relative
-short offset into 7 bits.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit pc relative
+     short offset into 7 bits.  */
   BFD_RELOC_AVR_7_PCREL,
 
-/* This is a 16 bit reloc for the AVR that stores 13 bit pc relative
-short offset into 12 bits.  */
+  /* This is a 16 bit reloc for the AVR that stores 13 bit pc relative
+     short offset into 12 bits.  */
   BFD_RELOC_AVR_13_PCREL,
 
-/* This is a 16 bit reloc for the AVR that stores 17 bit value (usually
-program memory address) into 16 bits.  */
+  /* This is a 16 bit reloc for the AVR that stores 17 bit value (usually
+     program memory address) into 16 bits.  */
   BFD_RELOC_AVR_16_PM,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit value (usually
-data memory address) into 8 bit immediate value of LDI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit value (usually
+     data memory address) into 8 bit immediate value of LDI insn.  */
   BFD_RELOC_AVR_LO8_LDI,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
-of data memory address) into 8 bit immediate value of LDI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
+     of data memory address) into 8 bit immediate value of LDI insn.  */
   BFD_RELOC_AVR_HI8_LDI,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
-of program memory address) into 8 bit immediate value of LDI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit value (most
+     high 8 bit of program memory address) into 8 bit immediate value of
+     LDI insn.  */
   BFD_RELOC_AVR_HH8_LDI,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
-of 32 bit value) into 8 bit immediate value of LDI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit value (most
+     high 8 bit of 32 bit value) into 8 bit immediate value of LDI insn.  */
   BFD_RELOC_AVR_MS8_LDI,
 
-/* This is a 16 bit reloc for the AVR that stores negated 8 bit value
-(usually data memory address) into 8 bit immediate value of SUBI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
+     (usually data memory address) into 8 bit immediate value of SUBI insn.  */
   BFD_RELOC_AVR_LO8_LDI_NEG,
 
-/* This is a 16 bit reloc for the AVR that stores negated 8 bit value
-(high 8 bit of data memory address) into 8 bit immediate value of
-SUBI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
+     (high 8 bit of data memory address) into 8 bit immediate value of
+     SUBI insn.  */
   BFD_RELOC_AVR_HI8_LDI_NEG,
 
-/* This is a 16 bit reloc for the AVR that stores negated 8 bit value
-(most high 8 bit of program memory address) into 8 bit immediate value
-of LDI or SUBI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
+     (most high 8 bit of program memory address) into 8 bit immediate
+     value of LDI or SUBI insn.  */
   BFD_RELOC_AVR_HH8_LDI_NEG,
 
-/* This is a 16 bit reloc for the AVR that stores negated 8 bit value (msb
-of 32 bit value) into 8 bit immediate value of LDI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
+     (msb of 32 bit value) into 8 bit immediate value of LDI insn.  */
   BFD_RELOC_AVR_MS8_LDI_NEG,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit value (usually
-command address) into 8 bit immediate value of LDI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit value (usually
+     command address) into 8 bit immediate value of LDI insn.  */
   BFD_RELOC_AVR_LO8_LDI_PM,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit value
-(command address) into 8 bit immediate value of LDI insn. If the address
-is beyond the 128k boundary, the linker inserts a jump stub for this reloc
-in the lower 128k.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit value
+     (command address) into 8 bit immediate value of LDI insn. If the
+     address is beyond the 128k boundary, the linker inserts a jump stub
+     for this reloc in the lower 128k.  */
   BFD_RELOC_AVR_LO8_LDI_GS,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
-of command address) into 8 bit immediate value of LDI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
+     of command address) into 8 bit immediate value of LDI insn.  */
   BFD_RELOC_AVR_HI8_LDI_PM,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
-of command address) into 8 bit immediate value of LDI insn.  If the address
-is beyond the 128k boundary, the linker inserts a jump stub for this reloc
-below 128k.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit value (high 8 bit
+     of command address) into 8 bit immediate value of LDI insn.  If the
+     address is beyond the 128k boundary, the linker inserts a jump stub
+     for this reloc below 128k.  */
   BFD_RELOC_AVR_HI8_LDI_GS,
 
-/* This is a 16 bit reloc for the AVR that stores 8 bit value (most high 8 bit
-of command address) into 8 bit immediate value of LDI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores 8 bit value (most
+     high 8 bit of command address) into 8 bit immediate value of LDI
+     insn.  */
   BFD_RELOC_AVR_HH8_LDI_PM,
 
-/* This is a 16 bit reloc for the AVR that stores negated 8 bit value
-(usually command address) into 8 bit immediate value of SUBI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
+     (usually command address) into 8 bit immediate value of SUBI insn.  */
   BFD_RELOC_AVR_LO8_LDI_PM_NEG,
 
-/* This is a 16 bit reloc for the AVR that stores negated 8 bit value
-(high 8 bit of 16 bit command address) into 8 bit immediate value
-of SUBI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
+     (high 8 bit of 16 bit command address) into 8 bit immediate value
+     of SUBI insn.  */
   BFD_RELOC_AVR_HI8_LDI_PM_NEG,
 
-/* This is a 16 bit reloc for the AVR that stores negated 8 bit value
-(high 6 bit of 22 bit command address) into 8 bit immediate
-value of SUBI insn.  */
+  /* This is a 16 bit reloc for the AVR that stores negated 8 bit value
+     (high 6 bit of 22 bit command address) into 8 bit immediate
+     value of SUBI insn.  */
   BFD_RELOC_AVR_HH8_LDI_PM_NEG,
 
-/* This is a 32 bit reloc for the AVR that stores 23 bit value
-into 22 bits.  */
+  /* This is a 32 bit reloc for the AVR that stores 23 bit value
+     into 22 bits.  */
   BFD_RELOC_AVR_CALL,
 
-/* This is a 16 bit reloc for the AVR that stores all needed bits
-for absolute addressing with ldi with overflow check to linktime  */
+  /* This is a 16 bit reloc for the AVR that stores all needed bits
+     for absolute addressing with ldi with overflow check to linktime.  */
   BFD_RELOC_AVR_LDI,
 
-/* This is a 6 bit reloc for the AVR that stores offset for ldd/std
-instructions  */
+  /* This is a 6 bit reloc for the AVR that stores offset for ldd/std
+     instructions.  */
   BFD_RELOC_AVR_6,
 
-/* This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
-instructions  */
+  /* This is a 6 bit reloc for the AVR that stores offset for adiw/sbiw
+     instructions.  */
   BFD_RELOC_AVR_6_ADIW,
 
-/* This is a 8 bit reloc for the AVR that stores bits 0..7 of a symbol
-in .byte lo8(symbol)  */
+  /* This is a 8 bit reloc for the AVR that stores bits 0..7 of a symbol
+     in .byte lo8(symbol).  */
   BFD_RELOC_AVR_8_LO,
 
-/* This is a 8 bit reloc for the AVR that stores bits 8..15 of a symbol
-in .byte hi8(symbol)  */
+  /* This is a 8 bit reloc for the AVR that stores bits 8..15 of a symbol
+     in .byte hi8(symbol).  */
   BFD_RELOC_AVR_8_HI,
 
-/* This is a 8 bit reloc for the AVR that stores bits 16..23 of a symbol
-in .byte hlo8(symbol)  */
+  /* This is a 8 bit reloc for the AVR that stores bits 16..23 of a symbol
+     in .byte hlo8(symbol).  */
   BFD_RELOC_AVR_8_HLO,
 
-/* AVR relocations to mark the difference of two local symbols.
-These are only needed to support linker relaxation and can be ignored
-when not relaxing.  The field is set to the value of the difference
-assuming no relaxation.  The relocation encodes the position of the
-second symbol so the linker can determine whether to adjust the field
-value.  */
+  /* AVR relocations to mark the difference of two local symbols.
+     These are only needed to support linker relaxation and can be ignored
+     when not relaxing.  The field is set to the value of the difference
+     assuming no relaxation.  The relocation encodes the position of the
+     second symbol so the linker can determine whether to adjust the field
+     value.  */
   BFD_RELOC_AVR_DIFF8,
   BFD_RELOC_AVR_DIFF16,
   BFD_RELOC_AVR_DIFF32,
 
-/* This is a 7 bit reloc for the AVR that stores SRAM address for 16bit
-lds and sts instructions supported only tiny core.  */
+  /* This is a 7 bit reloc for the AVR that stores SRAM address for 16bit
+     lds and sts instructions supported only tiny core.  */
   BFD_RELOC_AVR_LDS_STS_16,
 
-/* This is a 6 bit reloc for the AVR that stores an I/O register
-number for the IN and OUT instructions  */
+  /* This is a 6 bit reloc for the AVR that stores an I/O register
+     number for the IN and OUT instructions.  */
   BFD_RELOC_AVR_PORT6,
 
-/* This is a 5 bit reloc for the AVR that stores an I/O register
-number for the SBIC, SBIS, SBI and CBI instructions  */
+  /* This is a 5 bit reloc for the AVR that stores an I/O register
+     number for the SBIC, SBIS, SBI and CBI instructions.  */
   BFD_RELOC_AVR_PORT5,
 
-/* RISC-V relocations.  */
+  /* RISC-V relocations.  */
   BFD_RELOC_RISCV_HI20,
   BFD_RELOC_RISCV_PCREL_HI20,
   BFD_RELOC_RISCV_PCREL_LO12_I,
@@ -5445,7 +5415,7 @@ number for the SBIC, SBIS, SBI and CBI instructions  */
   BFD_RELOC_RISCV_SET_ULEB128,
   BFD_RELOC_RISCV_SUB_ULEB128,
 
-/* Renesas RL78 Relocations.  */
+  /* Renesas RL78 Relocations.  */
   BFD_RELOC_RL78_NEG8,
   BFD_RELOC_RL78_NEG16,
   BFD_RELOC_RL78_NEG24,
@@ -5481,7 +5451,7 @@ number for the SBIC, SBIS, SBI and CBI instructions  */
   BFD_RELOC_RL78_CODE,
   BFD_RELOC_RL78_SADDR,
 
-/* Renesas RX Relocations.  */
+  /* Renesas RX Relocations.  */
   BFD_RELOC_RX_NEG8,
   BFD_RELOC_RX_NEG16,
   BFD_RELOC_RX_NEG24,
@@ -5510,97 +5480,97 @@ number for the SBIC, SBIS, SBI and CBI instructions  */
   BFD_RELOC_RX_ABS16UL,
   BFD_RELOC_RX_RELAX,
 
-/* Direct 12 bit.  */
+  /* Direct 12 bit.  */
   BFD_RELOC_390_12,
 
-/* 12 bit GOT offset.  */
+  /* 12 bit GOT offset.  */
   BFD_RELOC_390_GOT12,
 
-/* 32 bit PC relative PLT address.  */
+  /* 32 bit PC relative PLT address.  */
   BFD_RELOC_390_PLT32,
 
-/* Copy symbol at runtime.  */
+  /* Copy symbol at runtime.  */
   BFD_RELOC_390_COPY,
 
-/* Create GOT entry.  */
+  /* Create GOT entry.  */
   BFD_RELOC_390_GLOB_DAT,
 
-/* Create PLT entry.  */
+  /* Create PLT entry.  */
   BFD_RELOC_390_JMP_SLOT,
 
-/* Adjust by program base.  */
+  /* Adjust by program base.  */
   BFD_RELOC_390_RELATIVE,
 
-/* 32 bit PC relative offset to GOT.  */
+  /* 32 bit PC relative offset to GOT.  */
   BFD_RELOC_390_GOTPC,
 
-/* 16 bit GOT offset.  */
+  /* 16 bit GOT offset.  */
   BFD_RELOC_390_GOT16,
 
-/* PC relative 12 bit shifted by 1.  */
+  /* PC relative 12 bit shifted by 1.  */
   BFD_RELOC_390_PC12DBL,
 
-/* 12 bit PC rel. PLT shifted by 1.  */
+  /* 12 bit PC rel. PLT shifted by 1.  */
   BFD_RELOC_390_PLT12DBL,
 
-/* PC relative 16 bit shifted by 1.  */
+  /* PC relative 16 bit shifted by 1.  */
   BFD_RELOC_390_PC16DBL,
 
-/* 16 bit PC rel. PLT shifted by 1.  */
+  /* 16 bit PC rel. PLT shifted by 1.  */
   BFD_RELOC_390_PLT16DBL,
 
-/* PC relative 24 bit shifted by 1.  */
+  /* PC relative 24 bit shifted by 1.  */
   BFD_RELOC_390_PC24DBL,
 
-/* 24 bit PC rel. PLT shifted by 1.  */
+  /* 24 bit PC rel. PLT shifted by 1.  */
   BFD_RELOC_390_PLT24DBL,
 
-/* PC relative 32 bit shifted by 1.  */
+  /* PC relative 32 bit shifted by 1.  */
   BFD_RELOC_390_PC32DBL,
 
-/* 32 bit PC rel. PLT shifted by 1.  */
+  /* 32 bit PC rel. PLT shifted by 1.  */
   BFD_RELOC_390_PLT32DBL,
 
-/* 32 bit PC rel. GOT shifted by 1.  */
+  /* 32 bit PC rel. GOT shifted by 1.  */
   BFD_RELOC_390_GOTPCDBL,
 
-/* 64 bit GOT offset.  */
+  /* 64 bit GOT offset.  */
   BFD_RELOC_390_GOT64,
 
-/* 64 bit PC relative PLT address.  */
+  /* 64 bit PC relative PLT address.  */
   BFD_RELOC_390_PLT64,
 
-/* 32 bit rel. offset to GOT entry.  */
+  /* 32 bit rel. offset to GOT entry.  */
   BFD_RELOC_390_GOTENT,
 
-/* 64 bit offset to GOT.  */
+  /* 64 bit offset to GOT.  */
   BFD_RELOC_390_GOTOFF64,
 
-/* 12-bit offset to symbol-entry within GOT, with PLT handling.  */
+  /* 12-bit offset to symbol-entry within GOT, with PLT handling.  */
   BFD_RELOC_390_GOTPLT12,
 
-/* 16-bit offset to symbol-entry within GOT, with PLT handling.  */
+  /* 16-bit offset to symbol-entry within GOT, with PLT handling.  */
   BFD_RELOC_390_GOTPLT16,
 
-/* 32-bit offset to symbol-entry within GOT, with PLT handling.  */
+  /* 32-bit offset to symbol-entry within GOT, with PLT handling.  */
   BFD_RELOC_390_GOTPLT32,
 
-/* 64-bit offset to symbol-entry within GOT, with PLT handling.  */
+  /* 64-bit offset to symbol-entry within GOT, with PLT handling.  */
   BFD_RELOC_390_GOTPLT64,
 
-/* 32-bit rel. offset to symbol-entry within GOT, with PLT handling.  */
+  /* 32-bit rel. offset to symbol-entry within GOT, with PLT handling.  */
   BFD_RELOC_390_GOTPLTENT,
 
-/* 16-bit rel. offset from the GOT to a PLT entry.  */
+  /* 16-bit rel. offset from the GOT to a PLT entry.  */
   BFD_RELOC_390_PLTOFF16,
 
-/* 32-bit rel. offset from the GOT to a PLT entry.  */
+  /* 32-bit rel. offset from the GOT to a PLT entry.  */
   BFD_RELOC_390_PLTOFF32,
 
-/* 64-bit rel. offset from the GOT to a PLT entry.  */
+  /* 64-bit rel. offset from the GOT to a PLT entry.  */
   BFD_RELOC_390_PLTOFF64,
 
-/* s390 tls relocations.  */
+  /* s390 tls relocations.  */
   BFD_RELOC_390_TLS_LOAD,
   BFD_RELOC_390_TLS_GDCALL,
   BFD_RELOC_390_TLS_LDCALL,
@@ -5622,102 +5592,102 @@ number for the SBIC, SBIS, SBI and CBI instructions  */
   BFD_RELOC_390_TLS_DTPOFF,
   BFD_RELOC_390_TLS_TPOFF,
 
-/* Long displacement extension.  */
+  /* Long displacement extension.  */
   BFD_RELOC_390_20,
   BFD_RELOC_390_GOT20,
   BFD_RELOC_390_GOTPLT20,
   BFD_RELOC_390_TLS_GOTIE20,
 
-/* STT_GNU_IFUNC relocation.  */
+  /* STT_GNU_IFUNC relocation.  */
   BFD_RELOC_390_IRELATIVE,
 
-/* Score relocations
-Low 16 bit for load/store  */
+  /* Score relocations.
+     Low 16 bit for load/store.  */
   BFD_RELOC_SCORE_GPREL15,
 
-/* This is a 24-bit reloc with the right 1 bit assumed to be 0  */
+  /* This is a 24-bit reloc with the right 1 bit assumed to be 0.  */
   BFD_RELOC_SCORE_DUMMY2,
   BFD_RELOC_SCORE_JMP,
 
-/* This is a 19-bit reloc with the right 1 bit assumed to be 0  */
+  /* This is a 19-bit reloc with the right 1 bit assumed to be 0.  */
   BFD_RELOC_SCORE_BRANCH,
 
-/* This is a 32-bit reloc for 48-bit instructions.  */
+  /* This is a 32-bit reloc for 48-bit instructions.  */
   BFD_RELOC_SCORE_IMM30,
 
-/* This is a 32-bit reloc for 48-bit instructions.  */
+  /* This is a 32-bit reloc for 48-bit instructions.  */
   BFD_RELOC_SCORE_IMM32,
 
-/* This is a 11-bit reloc with the right 1 bit assumed to be 0  */
+  /* This is a 11-bit reloc with the right 1 bit assumed to be 0.  */
   BFD_RELOC_SCORE16_JMP,
 
-/* This is a 8-bit reloc with the right 1 bit assumed to be 0  */
+  /* This is a 8-bit reloc with the right 1 bit assumed to be 0.  */
   BFD_RELOC_SCORE16_BRANCH,
 
-/* This is a 9-bit reloc with the right 1 bit assumed to be 0  */
+  /* This is a 9-bit reloc with the right 1 bit assumed to be 0.  */
   BFD_RELOC_SCORE_BCMP,
 
-/* Undocumented Score relocs  */
+  /* Undocumented Score relocs.  */
   BFD_RELOC_SCORE_GOT15,
   BFD_RELOC_SCORE_GOT_LO16,
   BFD_RELOC_SCORE_CALL15,
   BFD_RELOC_SCORE_DUMMY_HI16,
 
-/* Scenix IP2K - 9-bit register number / data address  */
+  /* Scenix IP2K - 9-bit register number / data address.  */
   BFD_RELOC_IP2K_FR9,
 
-/* Scenix IP2K - 4-bit register/data bank number  */
+  /* Scenix IP2K - 4-bit register/data bank number.  */
   BFD_RELOC_IP2K_BANK,
 
-/* Scenix IP2K - low 13 bits of instruction word address  */
+  /* Scenix IP2K - low 13 bits of instruction word address.  */
   BFD_RELOC_IP2K_ADDR16CJP,
 
-/* Scenix IP2K - high 3 bits of instruction word address  */
+  /* Scenix IP2K - high 3 bits of instruction word address.  */
   BFD_RELOC_IP2K_PAGE3,
 
-/* Scenix IP2K - ext/low/high 8 bits of data address  */
+  /* Scenix IP2K - ext/low/high 8 bits of data address.  */
   BFD_RELOC_IP2K_LO8DATA,
   BFD_RELOC_IP2K_HI8DATA,
   BFD_RELOC_IP2K_EX8DATA,
 
-/* Scenix IP2K - low/high 8 bits of instruction word address  */
+  /* Scenix IP2K - low/high 8 bits of instruction word address.  */
   BFD_RELOC_IP2K_LO8INSN,
   BFD_RELOC_IP2K_HI8INSN,
 
-/* Scenix IP2K - even/odd PC modifier to modify snb pcl.0  */
+  /* Scenix IP2K - even/odd PC modifier to modify snb pcl.0.  */
   BFD_RELOC_IP2K_PC_SKIP,
 
-/* Scenix IP2K - 16 bit word address in text section.  */
+  /* Scenix IP2K - 16 bit word address in text section.  */
   BFD_RELOC_IP2K_TEXT,
 
-/* Scenix IP2K - 7-bit sp or dp offset  */
+  /* Scenix IP2K - 7-bit sp or dp offset.  */
   BFD_RELOC_IP2K_FR_OFFSET,
 
-/* Scenix VPE4K coprocessor - data/insn-space addressing  */
+  /* Scenix VPE4K coprocessor - data/insn-space addressing.  */
   BFD_RELOC_VPE4KMATH_DATA,
   BFD_RELOC_VPE4KMATH_INSN,
 
-/* These two relocations are used by the linker to determine which of
-the entries in a C++ virtual function table are actually used.  When
-the --gc-sections option is given, the linker will zero out the entries
-that are not used, so that the code for those functions need not be
-included in the output.
-
-VTABLE_INHERIT is a zero-space relocation used to describe to the
-linker the inheritance tree of a C++ virtual function table.  The
-relocation's symbol should be the parent class' vtable, and the
-relocation should be located at the child vtable.
-
-VTABLE_ENTRY is a zero-space relocation that describes the use of a
-virtual function table entry.  The reloc's symbol should refer to the
-table of the class mentioned in the code.  Off of that base, an offset
-describes the entry that is being used.  For Rela hosts, this offset
-is stored in the reloc's addend.  For Rel hosts, we are forced to put
-this offset in the reloc's section offset.  */
+  /* These two relocations are used by the linker to determine which of
+     the entries in a C++ virtual function table are actually used.  When
+     the --gc-sections option is given, the linker will zero out the
+     entries that are not used, so that the code for those functions need
+     not be included in the output.
+
+     VTABLE_INHERIT is a zero-space relocation used to describe to the
+     linker the inheritance tree of a C++ virtual function table.  The
+     relocation's symbol should be the parent class' vtable, and the
+     relocation should be located at the child vtable.
+
+     VTABLE_ENTRY is a zero-space relocation that describes the use of a
+     virtual function table entry.  The reloc's symbol should refer to
+     the table of the class mentioned in the code.  Off of that base, an
+     offset describes the entry that is being used.  For Rela hosts, this
+     offset is stored in the reloc's addend.  For Rel hosts, we are
+     forced to put this offset in the reloc's section offset.  */
   BFD_RELOC_VTABLE_INHERIT,
   BFD_RELOC_VTABLE_ENTRY,
 
-/* Intel IA64 Relocations.  */
+  /* Intel IA64 Relocations.  */
   BFD_RELOC_IA64_IMM14,
   BFD_RELOC_IA64_IMM22,
   BFD_RELOC_IA64_IMM64,
@@ -5798,136 +5768,137 @@ this offset in the reloc's section offset.  */
   BFD_RELOC_IA64_DTPREL64LSB,
   BFD_RELOC_IA64_LTOFF_DTPREL22,
 
-/* Motorola 68HC11 reloc.
-This is the 8 bit high part of an absolute address.  */
+  /* Motorola 68HC11 reloc.
+     This is the 8 bit high part of an absolute address.  */
   BFD_RELOC_M68HC11_HI8,
 
-/* Motorola 68HC11 reloc.
-This is the 8 bit low part of an absolute address.  */
+  /* Motorola 68HC11 reloc.
+     This is the 8 bit low part of an absolute address.  */
   BFD_RELOC_M68HC11_LO8,
 
-/* Motorola 68HC11 reloc.
-This is the 3 bit of a value.  */
+  /* Motorola 68HC11 reloc.
+     This is the 3 bit of a value.  */
   BFD_RELOC_M68HC11_3B,
 
-/* Motorola 68HC11 reloc.
-This reloc marks the beginning of a jump/call instruction.
-It is used for linker relaxation to correctly identify beginning
-of instruction and change some branches to use PC-relative
-addressing mode.  */
+  /* Motorola 68HC11 reloc.
+     This reloc marks the beginning of a jump/call instruction.
+     It is used for linker relaxation to correctly identify beginning
+     of instruction and change some branches to use PC-relative
+     addressing mode.  */
   BFD_RELOC_M68HC11_RL_JUMP,
 
-/* Motorola 68HC11 reloc.
-This reloc marks a group of several instructions that gcc generates
-and for which the linker relaxation pass can modify and/or remove
-some of them.  */
+  /* Motorola 68HC11 reloc.
+     This reloc marks a group of several instructions that gcc generates
+     and for which the linker relaxation pass can modify and/or remove
+     some of them.  */
   BFD_RELOC_M68HC11_RL_GROUP,
 
-/* Motorola 68HC11 reloc.
-This is the 16-bit lower part of an address.  It is used for 'call'
-instruction to specify the symbol address without any special
-transformation (due to memory bank window).  */
+  /* Motorola 68HC11 reloc.
+     This is the 16-bit lower part of an address.  It is used for 'call'
+     instruction to specify the symbol address without any special
+     transformation (due to memory bank window).  */
   BFD_RELOC_M68HC11_LO16,
 
-/* Motorola 68HC11 reloc.
-This is a 8-bit reloc that specifies the page number of an address.
-It is used by 'call' instruction to specify the page number of
-the symbol.  */
+  /* Motorola 68HC11 reloc.
+     This is a 8-bit reloc that specifies the page number of an address.
+     It is used by 'call' instruction to specify the page number of
+     the symbol.  */
   BFD_RELOC_M68HC11_PAGE,
 
-/* Motorola 68HC11 reloc.
-This is a 24-bit reloc that represents the address with a 16-bit
-value and a 8-bit page number.  The symbol address is transformed
-to follow the 16K memory bank of 68HC12 (seen as mapped in the window).  */
+  /* Motorola 68HC11 reloc.
+     This is a 24-bit reloc that represents the address with a 16-bit
+     value and a 8-bit page number.  The symbol address is transformed
+     to follow the 16K memory bank of 68HC12 (seen as mapped in the
+     window).  */
   BFD_RELOC_M68HC11_24,
 
-/* Motorola 68HC12 reloc.
-This is the 5 bits of a value.  */
+  /* Motorola 68HC12 reloc.
+     This is the 5 bits of a value.  */
   BFD_RELOC_M68HC12_5B,
 
-/* Freescale XGATE reloc.
-This reloc marks the beginning of a bra/jal instruction.  */
+  /* Freescale XGATE reloc.
+     This reloc marks the beginning of a bra/jal instruction.  */
   BFD_RELOC_XGATE_RL_JUMP,
 
-/* Freescale XGATE reloc.
-This reloc marks a group of several instructions that gcc generates
-and for which the linker relaxation pass can modify and/or remove
-some of them.  */
+  /* Freescale XGATE reloc.
+     This reloc marks a group of several instructions that gcc generates
+     and for which the linker relaxation pass can modify and/or remove
+     some of them.  */
   BFD_RELOC_XGATE_RL_GROUP,
 
-/* Freescale XGATE reloc.
-This is the 16-bit lower part of an address.  It is used for the '16-bit'
-instructions.  */
+  /* Freescale XGATE reloc.
+     This is the 16-bit lower part of an address.  It is used for the
+     '16-bit' instructions.  */
   BFD_RELOC_XGATE_LO16,
 
-/* Freescale XGATE reloc.  */
+  /* Freescale XGATE reloc.  */
   BFD_RELOC_XGATE_GPAGE,
 
-/* Freescale XGATE reloc.  */
+  /* Freescale XGATE reloc.  */
   BFD_RELOC_XGATE_24,
 
-/* Freescale XGATE reloc.
-This is a 9-bit pc-relative reloc.  */
+  /* Freescale XGATE reloc.
+     This is a 9-bit pc-relative reloc.  */
   BFD_RELOC_XGATE_PCREL_9,
 
-/* Freescale XGATE reloc.
-This is a 10-bit pc-relative reloc.  */
+  /* Freescale XGATE reloc.
+     This is a 10-bit pc-relative reloc.  */
   BFD_RELOC_XGATE_PCREL_10,
 
-/* Freescale XGATE reloc.
-This is the 16-bit lower part of an address.  It is used for the '16-bit'
-instructions.  */
+  /* Freescale XGATE reloc.
+     This is the 16-bit lower part of an address.  It is used for the
+     '16-bit' instructions.  */
   BFD_RELOC_XGATE_IMM8_LO,
 
-/* Freescale XGATE reloc.
-This is the 16-bit higher part of an address.  It is used for the '16-bit'
-instructions.  */
+  /* Freescale XGATE reloc.
+     This is the 16-bit higher part of an address.  It is used for the
+     '16-bit' instructions.  */
   BFD_RELOC_XGATE_IMM8_HI,
 
-/* Freescale XGATE reloc.
-This is a 3-bit pc-relative reloc.  */
+  /* Freescale XGATE reloc.
+     This is a 3-bit pc-relative reloc.  */
   BFD_RELOC_XGATE_IMM3,
 
-/* Freescale XGATE reloc.
-This is a 4-bit pc-relative reloc.  */
+  /* Freescale XGATE reloc.
+     This is a 4-bit pc-relative reloc.  */
   BFD_RELOC_XGATE_IMM4,
 
-/* Freescale XGATE reloc.
-This is a 5-bit pc-relative reloc.  */
+  /* Freescale XGATE reloc.
+     This is a 5-bit pc-relative reloc.  */
   BFD_RELOC_XGATE_IMM5,
 
-/* Motorola 68HC12 reloc.
-This is the 9 bits of a value.  */
+  /* Motorola 68HC12 reloc.
+     This is the 9 bits of a value.  */
   BFD_RELOC_M68HC12_9B,
 
-/* Motorola 68HC12 reloc.
-This is the 16 bits of a value.  */
+  /* Motorola 68HC12 reloc.
+     This is the 16 bits of a value.  */
   BFD_RELOC_M68HC12_16B,
 
-/* Motorola 68HC12/XGATE reloc.
-This is a PCREL9 branch.  */
+  /* Motorola 68HC12/XGATE reloc.
+     This is a PCREL9 branch.  */
   BFD_RELOC_M68HC12_9_PCREL,
 
-/* Motorola 68HC12/XGATE reloc.
-This is a PCREL10 branch.  */
+  /* Motorola 68HC12/XGATE reloc.
+     This is a PCREL10 branch.  */
   BFD_RELOC_M68HC12_10_PCREL,
 
-/* Motorola 68HC12/XGATE reloc.
-This is the 8 bit low part of an absolute address and immediately precedes
-a matching HI8XG part.  */
+  /* Motorola 68HC12/XGATE reloc.
+     This is the 8 bit low part of an absolute address and immediately
+     precedes a matching HI8XG part.  */
   BFD_RELOC_M68HC12_LO8XG,
 
-/* Motorola 68HC12/XGATE reloc.
-This is the 8 bit high part of an absolute address and immediately follows
-a matching LO8XG part.  */
+  /* Motorola 68HC12/XGATE reloc.
+     This is the 8 bit high part of an absolute address and immediately
+     follows a matching LO8XG part.  */
   BFD_RELOC_M68HC12_HI8XG,
 
-/* Freescale S12Z reloc.
-This is a 15 bit relative address.  If the most significant bits are all zero
-then it may be truncated to 8 bits.  */
+  /* Freescale S12Z reloc.
+     This is a 15 bit relative address.  If the most significant bits are
+     all zero then it may be truncated to 8 bits.  */
   BFD_RELOC_S12Z_15_PCREL,
 
-/* NS CR16 Relocations.  */
+  /* NS CR16 Relocations.  */
   BFD_RELOC_CR16_NUM8,
   BFD_RELOC_CR16_NUM16,
   BFD_RELOC_CR16_NUM32,
@@ -5962,7 +5933,7 @@ then it may be truncated to 8 bits.  */
   BFD_RELOC_CR16_GOTC_REGREL20,
   BFD_RELOC_CR16_GLOB_DAT,
 
-/* NS CRX Relocations.  */
+  /* NS CRX Relocations.  */
   BFD_RELOC_CRX_REL4,
   BFD_RELOC_CRX_REL8,
   BFD_RELOC_CRX_REL8_CMP,
@@ -5984,8 +5955,8 @@ then it may be truncated to 8 bits.  */
   BFD_RELOC_CRX_SWITCH16,
   BFD_RELOC_CRX_SWITCH32,
 
-/* These relocs are only used within the CRIS assembler.  They are not
-(at present) written to any object files.  */
+  /* These relocs are only used within the CRIS assembler.  They are not
+     (at present) written to any object files.  */
   BFD_RELOC_CRIS_BDISP8,
   BFD_RELOC_CRIS_UNSIGNED_5,
   BFD_RELOC_CRIS_SIGNED_6,
@@ -5997,34 +5968,35 @@ then it may be truncated to 8 bits.  */
   BFD_RELOC_CRIS_LAPCQ_OFFSET,
   BFD_RELOC_CRIS_UNSIGNED_4,
 
-/* Relocs used in ELF shared libraries for CRIS.  */
+  /* Relocs used in ELF shared libraries for CRIS.  */
   BFD_RELOC_CRIS_COPY,
   BFD_RELOC_CRIS_GLOB_DAT,
   BFD_RELOC_CRIS_JUMP_SLOT,
   BFD_RELOC_CRIS_RELATIVE,
 
-/* 32-bit offset to symbol-entry within GOT.  */
+  /* 32-bit offset to symbol-entry within GOT.  */
   BFD_RELOC_CRIS_32_GOT,
 
-/* 16-bit offset to symbol-entry within GOT.  */
+  /* 16-bit offset to symbol-entry within GOT.  */
   BFD_RELOC_CRIS_16_GOT,
 
-/* 32-bit offset to symbol-entry within GOT, with PLT handling.  */
+  /* 32-bit offset to symbol-entry within GOT, with PLT handling.  */
   BFD_RELOC_CRIS_32_GOTPLT,
 
-/* 16-bit offset to symbol-entry within GOT, with PLT handling.  */
+  /* 16-bit offset to symbol-entry within GOT, with PLT handling.  */
   BFD_RELOC_CRIS_16_GOTPLT,
 
-/* 32-bit offset to symbol, relative to GOT.  */
+  /* 32-bit offset to symbol, relative to GOT.  */
   BFD_RELOC_CRIS_32_GOTREL,
 
-/* 32-bit offset to symbol with PLT entry, relative to GOT.  */
+  /* 32-bit offset to symbol with PLT entry, relative to GOT.  */
   BFD_RELOC_CRIS_32_PLT_GOTREL,
 
-/* 32-bit offset to symbol with PLT entry, relative to this relocation.  */
+  /* 32-bit offset to symbol with PLT entry, relative to this
+     relocation.  */
   BFD_RELOC_CRIS_32_PLT_PCREL,
 
-/* Relocs used in TLS code for CRIS.  */
+  /* Relocs used in TLS code for CRIS.  */
   BFD_RELOC_CRIS_32_GOT_GD,
   BFD_RELOC_CRIS_16_GOT_GD,
   BFD_RELOC_CRIS_32_GD,
@@ -6038,7 +6010,7 @@ then it may be truncated to 8 bits.  */
   BFD_RELOC_CRIS_DTPMOD,
   BFD_RELOC_CRIS_32_IE,
 
-/* OpenRISC 1000 Relocations.  */
+  /* OpenRISC 1000 Relocations.  */
   BFD_RELOC_OR1K_REL_26,
   BFD_RELOC_OR1K_SLO16,
   BFD_RELOC_OR1K_PCREL_PG21,
@@ -6080,7 +6052,7 @@ then it may be truncated to 8 bits.  */
   BFD_RELOC_OR1K_TLS_DTPOFF,
   BFD_RELOC_OR1K_TLS_DTPMOD,
 
-/* H8 elf Relocations.  */
+  /* H8 elf Relocations.  */
   BFD_RELOC_H8_DIR16A8,
   BFD_RELOC_H8_DIR16R8,
   BFD_RELOC_H8_DIR24A8,
@@ -6088,40 +6060,39 @@ then it may be truncated to 8 bits.  */
   BFD_RELOC_H8_DIR32A16,
   BFD_RELOC_H8_DISP32A16,
 
-/* Sony Xstormy16 Relocations.  */
+  /* Sony Xstormy16 Relocations.  */
   BFD_RELOC_XSTORMY16_REL_12,
   BFD_RELOC_XSTORMY16_12,
   BFD_RELOC_XSTORMY16_24,
   BFD_RELOC_XSTORMY16_FPTR16,
 
-/* Self-describing complex relocations.  */
+  /* Self-describing complex relocations.  */
   BFD_RELOC_RELC,
 
-
-/* Relocations used by VAX ELF.  */
+  /* Relocations used by VAX ELF.  */
   BFD_RELOC_VAX_GLOB_DAT,
   BFD_RELOC_VAX_JMP_SLOT,
   BFD_RELOC_VAX_RELATIVE,
 
-/* Morpho MT - 16 bit immediate relocation.  */
+  /* Morpho MT - 16 bit immediate relocation.  */
   BFD_RELOC_MT_PC16,
 
-/* Morpho MT - Hi 16 bits of an address.  */
+  /* Morpho MT - Hi 16 bits of an address.  */
   BFD_RELOC_MT_HI16,
 
-/* Morpho MT - Low 16 bits of an address.  */
+  /* Morpho MT - Low 16 bits of an address.  */
   BFD_RELOC_MT_LO16,
 
-/* Morpho MT - Used to tell the linker which vtable entries are used.  */
+  /* Morpho MT - Used to tell the linker which vtable entries are used.  */
   BFD_RELOC_MT_GNU_VTINHERIT,
 
-/* Morpho MT - Used to tell the linker which vtable entries are used.  */
+  /* Morpho MT - Used to tell the linker which vtable entries are used.  */
   BFD_RELOC_MT_GNU_VTENTRY,
 
-/* Morpho MT - 8 bit immediate relocation.  */
+  /* Morpho MT - 8 bit immediate relocation.  */
   BFD_RELOC_MT_PCINSN8,
 
-/* msp430 specific relocation codes  */
+  /* msp430 specific relocation codes.  */
   BFD_RELOC_MSP430_10_PCREL,
   BFD_RELOC_MSP430_16_PCREL,
   BFD_RELOC_MSP430_16,
@@ -6147,7 +6118,7 @@ then it may be truncated to 8 bits.  */
   BFD_RELOC_MSP430_SET_ULEB128,
   BFD_RELOC_MSP430_SUB_ULEB128,
 
-/* Relocations used by the Altera Nios II core.  */
+  /* Relocations used by the Altera Nios II core.  */
   BFD_RELOC_NIOS2_S16,
   BFD_RELOC_NIOS2_U16,
   BFD_RELOC_NIOS2_CALL26,
@@ -6201,76 +6172,77 @@ then it may be truncated to 8 bits.  */
   BFD_RELOC_NIOS2_R2_T1X1I6,
   BFD_RELOC_NIOS2_R2_T1X1I6_2,
 
-/* PRU LDI 16-bit unsigned data-memory relocation.  */
+  /* PRU LDI 16-bit unsigned data-memory relocation.  */
   BFD_RELOC_PRU_U16,
 
-/* PRU LDI 16-bit unsigned instruction-memory relocation.  */
+  /* PRU LDI 16-bit unsigned instruction-memory relocation.  */
   BFD_RELOC_PRU_U16_PMEMIMM,
 
-/* PRU relocation for two consecutive LDI load instructions that load a
-32 bit value into a register. If the higher bits are all zero, then
-the second instruction may be relaxed.  */
+  /* PRU relocation for two consecutive LDI load instructions that load a
+     32 bit value into a register. If the higher bits are all zero, then
+     the second instruction may be relaxed.  */
   BFD_RELOC_PRU_LDI32,
 
-/* PRU QBBx 10-bit signed PC-relative relocation.  */
+  /* PRU QBBx 10-bit signed PC-relative relocation.  */
   BFD_RELOC_PRU_S10_PCREL,
 
-/* PRU 8-bit unsigned relocation used for the LOOP instruction.  */
+  /* PRU 8-bit unsigned relocation used for the LOOP instruction.  */
   BFD_RELOC_PRU_U8_PCREL,
 
-/* PRU Program Memory relocations.  Used to convert from byte addressing to
-32-bit word addressing.  */
+  /* PRU Program Memory relocations.  Used to convert from byte
+     addressing to 32-bit word addressing.  */
   BFD_RELOC_PRU_32_PMEM,
   BFD_RELOC_PRU_16_PMEM,
 
-/* PRU relocations to mark the difference of two local symbols.
-These are only needed to support linker relaxation and can be ignored
-when not relaxing.  The field is set to the value of the difference
-assuming no relaxation.  The relocation encodes the position of the
-second symbol so the linker can determine whether to adjust the field
-value. The PMEM variants encode the word difference, instead of byte
-difference between symbols.  */
+  /* PRU relocations to mark the difference of two local symbols.
+     These are only needed to support linker relaxation and can be
+     ignored when not relaxing.  The field is set to the value of the
+     difference assuming no relaxation.  The relocation encodes the
+     position of the second symbol so the linker can determine whether to
+     adjust the field value.  The PMEM variants encode the word
+     difference, instead of byte difference between symbols.  */
   BFD_RELOC_PRU_GNU_DIFF8,
   BFD_RELOC_PRU_GNU_DIFF16,
   BFD_RELOC_PRU_GNU_DIFF32,
   BFD_RELOC_PRU_GNU_DIFF16_PMEM,
   BFD_RELOC_PRU_GNU_DIFF32_PMEM,
 
-/* IQ2000 Relocations.  */
+  /* IQ2000 Relocations.  */
   BFD_RELOC_IQ2000_OFFSET_16,
   BFD_RELOC_IQ2000_OFFSET_21,
   BFD_RELOC_IQ2000_UHI16,
 
-/* Special Xtensa relocation used only by PLT entries in ELF shared
-objects to indicate that the runtime linker should set the value
-to one of its own internal functions or data structures.  */
+  /* Special Xtensa relocation used only by PLT entries in ELF shared
+     objects to indicate that the runtime linker should set the value
+     to one of its own internal functions or data structures.  */
   BFD_RELOC_XTENSA_RTLD,
 
-/* Xtensa relocations for ELF shared objects.  */
+  /* Xtensa relocations for ELF shared objects.  */
   BFD_RELOC_XTENSA_GLOB_DAT,
   BFD_RELOC_XTENSA_JMP_SLOT,
   BFD_RELOC_XTENSA_RELATIVE,
 
-/* Xtensa relocation used in ELF object files for symbols that may require
-PLT entries.  Otherwise, this is just a generic 32-bit relocation.  */
+  /* Xtensa relocation used in ELF object files for symbols that may
+     require PLT entries.  Otherwise, this is just a generic 32-bit
+     relocation.  */
   BFD_RELOC_XTENSA_PLT,
 
-/* Xtensa relocations for backward compatibility.  These have been replaced
-by BFD_RELOC_XTENSA_PDIFF and BFD_RELOC_XTENSA_NDIFF.
-Xtensa relocations to mark the difference of two local symbols.
-These are only needed to support linker relaxation and can be ignored
-when not relaxing.  The field is set to the value of the difference
-assuming no relaxation.  The relocation encodes the position of the
-first symbol so the linker can determine whether to adjust the field
-value.  */
+  /* Xtensa relocations for backward compatibility.  These have been
+     replaced by BFD_RELOC_XTENSA_PDIFF and BFD_RELOC_XTENSA_NDIFF.
+     Xtensa relocations to mark the difference of two local symbols.
+     These are only needed to support linker relaxation and can be
+     ignored when not relaxing.  The field is set to the value of the
+     difference assuming no relaxation.  The relocation encodes the
+     position of the first symbol so the linker can determine whether to
+     adjust the field value.  */
   BFD_RELOC_XTENSA_DIFF8,
   BFD_RELOC_XTENSA_DIFF16,
   BFD_RELOC_XTENSA_DIFF32,
 
-/* Generic Xtensa relocations for instruction operands.  Only the slot
-number is encoded in the relocation.  The relocation applies to the
-last PC-relative immediate operand, or if there are no PC-relative
-immediates, to the last immediate operand.  */
+  /* Generic Xtensa relocations for instruction operands.  Only the slot
+     number is encoded in the relocation.  The relocation applies to the
+     last PC-relative immediate operand, or if there are no PC-relative
+     immediates, to the last immediate operand.  */
   BFD_RELOC_XTENSA_SLOT0_OP,
   BFD_RELOC_XTENSA_SLOT1_OP,
   BFD_RELOC_XTENSA_SLOT2_OP,
@@ -6287,8 +6259,8 @@ immediates, to the last immediate operand.  */
   BFD_RELOC_XTENSA_SLOT13_OP,
   BFD_RELOC_XTENSA_SLOT14_OP,
 
-/* Alternate Xtensa relocations.  Only the slot is encoded in the
-relocation.  The meaning of these relocations is opcode-specific.  */
+  /* Alternate Xtensa relocations.  Only the slot is encoded in the
+     relocation.  The meaning of these relocations is opcode-specific.  */
   BFD_RELOC_XTENSA_SLOT0_ALT,
   BFD_RELOC_XTENSA_SLOT1_ALT,
   BFD_RELOC_XTENSA_SLOT2_ALT,
@@ -6305,24 +6277,24 @@ relocation.  The meaning of these relocations is opcode-specific.  */
   BFD_RELOC_XTENSA_SLOT13_ALT,
   BFD_RELOC_XTENSA_SLOT14_ALT,
 
-/* Xtensa relocations for backward compatibility.  These have all been
-replaced by BFD_RELOC_XTENSA_SLOT0_OP.  */
+  /* Xtensa relocations for backward compatibility.  These have all been
+     replaced by BFD_RELOC_XTENSA_SLOT0_OP.  */
   BFD[...]

[diff truncated at 100000 bytes]


More information about the Binutils-cvs mailing list