From 4f4690cd42476b0907b51a410fc026bfc94c66d2 Mon Sep 17 00:00:00 2001 From: Alan Modra Date: Thu, 31 Jan 2019 11:37:44 +1030 Subject: [PATCH] Document ld -t behaviour * NEWS: Mention -t change. * ld.texi (--trace/-t): Expand documentation a little. --- 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 dc99b16151..5713b0020c 100644 --- a/ld/ChangeLog +++ b/ld/ChangeLog @@ -1,3 +1,8 @@ +2019-01-31 Alan Modra + + * NEWS: Mention -t change. + * ld.texi (--trace/-t): Expand documentation a little. + 2019-01-29 H.J. Lu PR ld/24008 diff --git a/ld/NEWS b/ld/NEWS index f13cdd7a79..d737af7051 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 d0ceea1626..9bede662ad 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} -- 2.34.1