[llvm] r363264 - [docs][llvm-dwarfdump] Add missing options and behaviour to documentation

[James Henderson via llvm-commits]

Author: jhenderson
Date: Thu Jun 13 06:53:16 2019
New Revision: 363264

URL: http://llvm.org/viewvc/llvm-project?rev=363264&view=rev
Log:
[docs][llvm-dwarfdump] Add missing options and behaviour to documentation

This fixes https://bugs.llvm.org/show_bug.cgi?id=42185.

llvm-dwarfdump's documentation was missing a number of options and other
behaviours. This change tries to fix up the documentation by adding
these missing items.

Reviewed by: JDevlieghere

Differential Revision: https://reviews.llvm.org/D63217

Modified:
    llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst

Modified: llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst
URL: http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst?rev=363264&r1=363263&r2=363264&view=diff
==============================================================================
--- llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst (original)
+++ llvm/trunk/docs/CommandGuide/llvm-dwarfdump.rst Thu Jun 13 06:53:16 2019
@@ -14,6 +14,10 @@ archives, and `.dSYM` bundles and prints
 human-readable form. Only the .debug_info section is printed unless one of
 the section-specific options or :option:`--all` is specified.
 
+If no input file is specified, `a.out` is used instead. If `-` is used as the
+input file, :program:`llvm-dwarfdump` reads the input from its standard input
+stream.
+
 OPTIONS
 -------
 
@@ -35,6 +39,10 @@ OPTIONS
             the :option:`--debug-info`, :option:`--find`,
             and :option:`--name` options.
 
+.. option:: --color
+
+            Use colors in output.
+
 .. option:: -f <name>, --find=<name>
 
             Search for the exact text <name> in the accelerator tables
@@ -51,6 +59,11 @@ OPTIONS
 
             Show help and usage for this command.
 
+.. option:: --help-list
+
+            Show help and usage for this command without grouping the options
+            into categories.
+
 .. option:: -i, --ignore-case
 
             Ignore case distinctions when searching.
@@ -70,7 +83,8 @@ OPTIONS
 
 .. option:: -o <path>
 
-            Redirect output to a file specified by <path>.
+            Redirect output to a file specified by <path>, where `-` is the
+            standard output stream.
 
 .. option:: -p, --show-parents
 
@@ -78,9 +92,18 @@ OPTIONS
             :option:`--debug-info`, :option:`--find`, and
             :option:`--name` options.
 
-.. option:: -r <n>, --recurse-depth=<n>
+.. option:: --parent-recurse-depth=<N>
+
+            Only recurse to a maximum depth of <N> when displaying parents of
+            debug info entries.
+
+.. option:: --quiet
 
-            Only recurse to a maximum depth of <n> when dumping debug info
+            Use with :option:`--verify` to not emit to `STDOUT`.
+
+.. option:: -r <N>, --recurse-depth=<N>
+
+            Only recurse to a maximum depth of <N> when dumping debug info
             entries.
 
 .. option:: --statistics
@@ -88,6 +111,10 @@ OPTIONS
             Collect debug info quality metrics and print the results
             as machine-readable single-line JSON output.
 
+.. option:: --summarize-types
+
+            Abbreviate the description of type unit entries.
+
 .. option:: -x, --regex
 
             Treat any <pattern> strings as regular expressions when searching
@@ -117,7 +144,7 @@ OPTIONS
 
             Display the version of the tool.
 
-.. option:: --debug-abbrev, --debug-aranges, --debug-cu-index, --debug-frame [=<offset>], --debug-gnu-pubnames, --debug-gnu-pubtypes, --debug-info [=<offset>], --debug-line [=<offset>], --debug-loc [=<offset>], --debug-macro, --debug-pubnames, --debug-pubtypes, --debug-ranges, --debug-str, --debug-str-offsets, --debug-tu-index, --debug-types, --eh-frame, --gdb-index, --apple-names, --apple-types, --apple-namespaces, --apple-objc
+.. option:: --debug-abbrev, --debug-addr, --debug-aranges, --debug-cu-index, --debug-frame [=<offset>], --debug-gnu-pubnames, --debug-gnu-pubtypes, --debug-info [=<offset>], --debug-line [=<offset>], --debug-line-str, --debug-loc [=<offset>], --debug-loclists [=<offset>], --debug-macro, --debug-names, --debug-pubnames, --debug-pubtypes, --debug-ranges, --debug-rnglists, --debug-str, --debug-str-offsets, --debug-tu-index, --debug-types, --eh-frame [=<offset>], --gdb-index, --apple-names, --apple-types, --apple-namespaces, --apple-objc
 
             Dump the specified DWARF section by name. Only the
             `.debug_info` section is shown by default. Some entries
@@ -129,6 +156,10 @@ OPTIONS
             offset can be dumped by also using the
             :option:`--show-children` option where applicable.
 
+.. option:: @<FILE>
+
+            Read command-line options from `<FILE>`.
+
 EXIT STATUS
 -----------