From: Nick Clifton Date: Mon, 10 Aug 2020 15:35:57 +0000 (+0100) Subject: Improve the documentation of the linker's --relax option. X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=ccd9fae5d57b9a16d00d70d9dad916133ff1ea70;p=binutils-gdb.git Improve the documentation of the linker's --relax option. PR ld/21351 * ld.texi: Clarify the behaviour of the --relax and --no-relax options on systems that do not support them. --- diff --git a/ld/ChangeLog b/ld/ChangeLog index 2539fad36b4..64b2b637b22 100644 --- a/ld/ChangeLog +++ b/ld/ChangeLog @@ -1,3 +1,9 @@ +2020-08-10 Nick Clifton + + PR ld/21351 + * ld.texi: Clarify the behaviour of the --relax and --no-relax + options on systems that do not support them. + 2020-08-10 H.J. Lu PR binutils/26302 diff --git a/ld/ld.texi b/ld/ld.texi index b9b331b3560..d03c1fe4631 100644 --- a/ld/ld.texi +++ b/ld/ld.texi @@ -2030,7 +2030,7 @@ This option is only supported on a few targets. @xref{PowerPC ELF32,,@command{ld} and PowerPC 32-bit ELF Support}. @end ifset -On some platforms the @samp{--relax} option performs target-specific, +On some platforms the @option{--relax} option performs target specific, global optimizations that become possible when the linker resolves addressing in the program, such as relaxing address modes, synthesizing new instructions, selecting shorter version of current @@ -2043,14 +2043,12 @@ This is known to be the case for the Matsushita MN10200 and MN10300 family of processors. @end ifset -@ifset GENERIC -On platforms where this is not supported, @samp{--relax} is accepted, -but ignored. -@end ifset - -On platforms where @samp{--relax} is accepted the option -@samp{--no-relax} can be used to disable the feature. +On platforms where the feature is supported, the option +@option{--no-relax} will disable it. +On platforms where the feature is not supported, both @option{--relax} +and @option{--no-relax} are accepted, but ignored. + @cindex retaining specified symbols @cindex stripping all but some symbols @cindex symbols, retaining selectively