Update the linker documentation regarding the /DISCARD/ linker script section and...

	* ld.texi (Output Section Discarding): Add note indicating that
	/DISCARD/ed sections ignore ELF section grouping.

diff --git a/ld/ChangeLog b/ld/ChangeLog
index 43d858b5f5ccbee1fc7854a0b5ba2fbd8f1c9331..6498fb0e7ec3b8fbf883b2def1809384a41793f6 100644 (file)
--- a/ld/ChangeLog
+++ b/ld/ChangeLog
@@ -1,3 +1,8 @@
+2019-11-22  Nick Clifton  <nickc@redhat.com>
+
+       * ld.texi (Output Section Discarding): Add note indicating that
+       /DISCARD/ed sections ignore ELF section grouping.
+
 2019-11-22  Nick Clifton  <nickc@redhat.com>
 
        * ldlang.h (LANG_FOR_EACH_INPUT_STATEMENT): Use cast instead of

diff --git a/ld/ld.texi b/ld/ld.texi
index 3b2d05411f45e7d84ae8f11970783e086b4cecdd..ed538fbfe2b18ade20f46a857b33acb31e763395 100644 (file)
--- a/ld/ld.texi
+++ b/ld/ld.texi
@@ -4994,6 +4994,11 @@ The special output section name @samp{/DISCARD/} may be used to discard
 input sections.  Any input sections which are assigned to an output
 section named @samp{/DISCARD/} are not included in the output file.
 
+Note, sections that match the @samp{/DISCARD/} output section will be
+discarded even if they are in an ELF section group which has other
+members which are not being discarded.  This is deliberate.
+Discarding takes precedence over grouping.
+
 @node Output Section Attributes
 @subsection Output Section Attributes
 @cindex output section attributes