aboutsummaryrefslogtreecommitdiff
path: root/ld
diff options
context:
space:
mode:
authorNick Clifton <nickc@redhat.com>2020-08-10 16:35:57 +0100
committerNick Clifton <nickc@redhat.com>2020-08-10 16:35:57 +0100
commitccd9fae5d57b9a16d00d70d9dad916133ff1ea70 (patch)
tree87f17ed30699b373515d56557fee9a1a1445bb36 /ld
parentb3f8962bdb903bf8bc37935c189b3b32ad667c0b (diff)
downloadgdb-ccd9fae5d57b9a16d00d70d9dad916133ff1ea70.zip
gdb-ccd9fae5d57b9a16d00d70d9dad916133ff1ea70.tar.gz
gdb-ccd9fae5d57b9a16d00d70d9dad916133ff1ea70.tar.bz2
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.
Diffstat (limited to 'ld')
-rw-r--r--ld/ChangeLog6
-rw-r--r--ld/ld.texi14
2 files changed, 12 insertions, 8 deletions
diff --git a/ld/ChangeLog b/ld/ChangeLog
index 2539fad..64b2b63 100644
--- 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 b9b331b..d03c1fe 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