[binutils] Add response file option to help and docs
Many LLVM-based tools already support response files (i.e. files
containing a list of options, specified with '@'). This change simply
updates the documentation and help text for some of these tools to
include it. I haven't attempted to fix all tools, just a selection that
I am interested in.
I've taken the opportunity to add some tests for --help behaviour, where
they were missing. We could expand these tests, but I don't think that's
within scope of this patch.
This fixes https://bugs.llvm.org/show_bug.cgi?id=42233 and
https://bugs.llvm.org/show_bug.cgi?id=42236.
Reviewed by: grimar, MaskRay, jkorous
Differential Revision: https://reviews.llvm.org/D63597
llvm-svn: 364036
diff --git a/llvm/docs/CommandGuide/llvm-nm.rst b/llvm/docs/CommandGuide/llvm-nm.rst
index 4678a7a..874a184 100644
--- a/llvm/docs/CommandGuide/llvm-nm.rst
+++ b/llvm/docs/CommandGuide/llvm-nm.rst
@@ -136,6 +136,10 @@
Specify the radix of the symbol address(es). Values accepted d(decimal),
x(hexadecimal) and o(octal).
+.. option:: @<FILE>
+
+ Read command-line options from response file `<FILE>`.
+
BUGS
----
diff --git a/llvm/docs/CommandGuide/llvm-objdump.rst b/llvm/docs/CommandGuide/llvm-objdump.rst
index 24bfe9e..8c81560 100644
--- a/llvm/docs/CommandGuide/llvm-objdump.rst
+++ b/llvm/docs/CommandGuide/llvm-objdump.rst
@@ -316,6 +316,10 @@
Display weak binding information.
+.. option:: @<FILE>
+
+ Read command-line options and commands from response file `<FILE>`.
+
BUGS
----
diff --git a/llvm/docs/CommandGuide/llvm-readobj.rst b/llvm/docs/CommandGuide/llvm-readobj.rst
index 7d4679f..0e752f7 100644
--- a/llvm/docs/CommandGuide/llvm-readobj.rst
+++ b/llvm/docs/CommandGuide/llvm-readobj.rst
@@ -88,6 +88,10 @@
Print demangled symbol names in the output.
+.. option:: @<FILE>
+
+ Read command-line options from response file `<FILE>`.
+
EXIT STATUS
-----------
diff --git a/llvm/docs/CommandGuide/llvm-symbolizer.rst b/llvm/docs/CommandGuide/llvm-symbolizer.rst
index 1c31a38..7e2f205 100644
--- a/llvm/docs/CommandGuide/llvm-symbolizer.rst
+++ b/llvm/docs/CommandGuide/llvm-symbolizer.rst
@@ -169,6 +169,10 @@
inc at /tmp/x.c:3
main at /tmp/x.c:14
+.. option:: @<FILE>
+
+ Read command-line options from response file `<FILE>`.
+
EXIT STATUS
-----------