Re: genscripts comment tidy

[Alan Modra <amodra at gmail dot com>]

On Wed, Oct 16, 2019 at 03:10:01PM +0100, Nick Alcock wrote:
> On 16 Oct 2019, Alan Modra spake thusly:
> 
> > -# A .x script file is the default script.
> > -# A .xr script is for linking without relocation (-r flag).
> > -# A .xu script is like .xr, but *do* create constructors (-Ur flag).
> > -# A .xn script is for linking with -n flag (mix text and data on same page).
> > -# A .xbn script is for linking with -N flag (mix text and data on same page).
> > -# A .xs script is for generating a shared library with the --shared
> > -#   flag; it is only generated if $GENERATE_SHLIB_SCRIPT is set by the
> > -#   emulation parameters.
> > -# A .xc script is for linking with -z combreloc; it is only generated if
> > -#   $GENERATE_COMBRELOC_SCRIPT is set by the emulation parameters or
> > -#   $SCRIPT_NAME is "elf".
> > -# A .xsc script is for linking with --shared -z combreloc; it is generated
> > -#   if $GENERATE_COMBRELOC_SCRIPT is set by the emulation parameters or
> > -#   $SCRIPT_NAME is "elf" and $GENERATE_SHLIB_SCRIPT is set by the emulation
> > -#   parameters too.
> 
> Is this stuff still documented anywhere after this commit? Because I
> know I found this specific comment very useful only a month ago, and the
> purpose of the differently suffixed linker scripts is otherwise quite opaque.

~/build/gas/x86_64-linux/ld/ldscripts$ grep 'Script for' elf_x86_64.x*
elf_x86_64.xbn:/* Script for -N */
elf_x86_64.xc:/* Script for -z combreloc */
elf_x86_64.xce:/* Script for -z combreloc -z separate-code */
elf_x86_64.xd:/* Script for -pie */
elf_x86_64.xdc:/* Script for -pie -z combreloc */
elf_x86_64.xdce:/* Script for -pie -z combreloc -z separate-code */
elf_x86_64.xde:/* Script for -pie -z separate-code */
elf_x86_64.xdw:/* Script for -pie -z combreloc -z relro -z now */
elf_x86_64.xdwe:/* Script for -pie -z combreloc -z separate-code -z relro -z now */
elf_x86_64.xe:/* Script for -z separate-code */
elf_x86_64.xn:/* Script for -n */
elf_x86_64.xr:/* Script for -r */
elf_x86_64.xs:/* Script for -shared */
elf_x86_64.xsc:/* Script for -shared -z combreloc */
elf_x86_64.xsce:/* Script for -shared -z combreloc -z separate-code */
elf_x86_64.xse:/* Script for -shared -z separate-code */
elf_x86_64.xsw:/* Script for -shared -z combreloc -z relro -z now */
elf_x86_64.xswe:/* Script for -shared -z combreloc -z separate-code -z relro -z now */
elf_x86_64.xu:/* Script for -Ur */
elf_x86_64.xw:/* Script for -z combreloc -z relro -z now */
elf_x86_64.xwe:/* Script for -z combreloc -z separate-code -z relro -z now */

-- 
Alan Modra
Australia Development Lab, IBM