[binutils-gdb] Document ld -t behaviour

[Alan Modra <amodra at sourceware dot org>]

https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=4f4690cd42476b0907b51a410fc026bfc94c66d2

commit 4f4690cd42476b0907b51a410fc026bfc94c66d2
Author: Alan Modra <amodra@gmail.com>
Date:   Thu Jan 31 11:37:44 2019 +1030

    Document ld -t behaviour
    
    	* NEWS: Mention -t change.
    	* ld.texi (--trace/-t): Expand documentation a little.

Diff:
---
 ld/ChangeLog | 5 +++++
 ld/NEWS      | 6 ++++++
 ld/ld.texi   | 6 +++++-
 3 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/ld/ChangeLog b/ld/ChangeLog
index dc99b16..5713b00 100644
--- a/ld/ChangeLog
+++ b/ld/ChangeLog
@@ -1,3 +1,8 @@
+2019-01-31  Alan Modra  <amodra@gmail.com>
+
+	* NEWS: Mention -t change.
+	* ld.texi (--trace/-t): Expand documentation a little.
+
 2019-01-29  H.J. Lu  <hongjiu.lu@intel.com>
 
 	PR ld/24008
diff --git a/ld/NEWS b/ld/NEWS
index f13cdd7..d737af7 100644
--- a/ld/NEWS
+++ b/ld/NEWS
@@ -6,6 +6,12 @@ Changes in 2.32:
 
 * Add support for the C-SKY processor series.
 
+* -t now doesn't report members within archives, unless -t is given twice.
+  A single -t is now more useful when generating a list of files that should be
+  packaged for a linker bug report.  For example:
+    gcc hello.c -save-temps -Wl,-t | xargs realpath | sort | uniq > files
+    tar cJf test.tar.xz `cat files`
+
 Changes in 2.31:
 
 * Speed up direct linking with DLLs for Cygwin and Mingw targets.
diff --git a/ld/ld.texi b/ld/ld.texi
index d0ceea1..9bede66 100644
--- a/ld/ld.texi
+++ b/ld/ld.texi
@@ -961,7 +961,11 @@ Enabled by default.
 @cindex input files, displaying
 @item -t
 @itemx --trace
-Print the names of the input files as @command{ld} processes them.
+Print the names of the input files as @command{ld} processes them.  If
+@samp{-t} is given twice then members within archives are also printed.
+@samp{-t} output is useful to generate a list of all the object files
+and scripts involved in linking, for example, when packaging files for
+a linker bug report.
 
 @kindex -T @var{script}
 @kindex --script=@var{script}