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 2539fad36b41a2ca9129bf9d4045fc55d0a467f2..64b2b637b228c706ffbe552c05611ffca3a46280 100644 (file)
--- a/ld/ChangeLog
+++ b/ld/ChangeLog
@@ -1,3 +1,9 @@
+2020-08-10  Nick Clifton  <nickc@redhat.com>
+
+       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  <hongjiu.lu@intel.com>
 
        PR binutils/26302

diff --git a/ld/ld.texi b/ld/ld.texi
index b9b331b35605f92b3bb17309d1cab18580f3ec96..d03c1fe4631ee2b391e00239a62995d315babf02 100644 (file)
--- 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