[docs][llvm-nm] Add missing options to documentation

[jhenderson]

Summary

There were several options missing from the documentation. This patch adds them as well as improving some wording and separating the Mach-O only options into a separate section.

Fixes https://bugs.llvm.org/show_bug.cgi?id=42234.

[MaskRay]

docs/CommandGuide/llvm-nm.rst

72 ↗

(On Diff #206014)

-B is the default, even on macOS (explicit -m to enable the Darwin style)

[jhenderson]

docs/CommandGuide/llvm-nm.rst

72 ↗

(On Diff #206014)

Since -B is an alias for --format=bsd, we don't need to mention it in both places. Note the following bit from the --format description: The default is *bsd*.

[jhenderson]

Thanks @MaskRay. I'm going to land this shortly, to reduce the number of in-flight patches I have on the docs, but I'll happily take further feedback for improvements if anybody has any.

llvm/docs/CommandGuide/llvm-nm.rst

 symbol in an LLVM bitcode file, even symbols which are defined in the bitcode
 file.
 
 OPTIONS
 -------
 
 .. program:: llvm-nm
 
-.. option:: -B    (default)
+.. option:: -B
 
- Use BSD output format.  Alias for `--format=bsd`.
-
-.. option:: -P
-
- Use POSIX.2 output format.  Alias for `--format=posix`.
+ Use BSD output format. Alias for ``--format=bsd``.
 
 .. option:: --debug-syms, -a
 
  Show all symbols, even debugger only.
 
-.. option:: --defined-only
+.. option:: --defined-only, -U
+
+ Print only symbols defined in this file.
 
- Print only symbols defined in this file (as opposed to
- symbols which may be referenced by objects in this file, but not
- defined in this file.)
+.. option:: --demangle, -C
+
+ Demangle symbol names.
 
 .. option:: --dynamic, -D
 
  Display dynamic symbols instead of normal symbols.
 
 .. option:: --extern-only, -g
 
- Print only symbols whose definitions are external; that is, accessible
- from other files.
-
-.. option:: --no-weak, -W
-
- Don't print any weak symbols in the output.
+ Print only symbols whose definitions are external; that is, accessible from
+ other files.
 
-.. option:: --format=format, -f format
+.. option:: --format=<format>, -f
 
  Select an output format; *format* may be *sysv*, *posix*, *darwin*, or *bsd*.
  The default is *bsd*.
 
 .. option:: --help, -h
 
  Print a summary of command-line options and their meanings.
 
+.. option:: --help-list
+
+ Print an uncategorized summary of command-line options and their meanings.
+
+.. option:: --just-symbol-name, -j
+
+ Print just the symbol names.
+
+.. option:: -m
+
+ Use Darwin format. Alias for ``--format=darwin``.
+
+.. option:: --no-demangle
+
+ Don't demangle symbol names. This is the default.
+
+.. option:: --no-llvm-bc
+
+ Disable the LLVM bitcode reader.
+
 .. option:: --no-sort, -p
 
  Shows symbols in order encountered.
 
+.. option:: --no-weak, -W
+
+ Don't print weak symbols.
+
 .. option:: --numeric-sort, -n, -v
 
  Sort symbols by address.
 
+.. option:: --portability, -P
+
+ Use POSIX.2 output format.  Alias for ``--format=posix``.
+
+.. option:: --print-armap, -M
+
+ Print the archive symbol table, in addition to the symbols.
+
 .. option:: --print-file-name, -A, -o
 
  Precede each symbol with the file it came from.
 
 .. option:: --print-size, -S
 
  Show symbol size as well as address (not applicable for Mach-O).
 
+.. option:: --radix=<RADIX>, -t
+
+ Specify the radix of the symbol address(es). Values accepted are *d* (decimal),
+ *x* (hexadecimal) and *o* (octal).
+
+.. option:: --reverse-sort, -r
+
+ Sort symbols in reverse order.
+
 .. option:: --size-sort
 
  Sort symbols by size.
 
+.. option:: --special-syms
+
+ Ignored. For GNU compatibility only.
+
 .. option:: --undefined-only, -u
 
- Print only symbols referenced but not defined in this file.
+ Print only undefined symbols.
+
+.. option:: --version
+
+ Display the version of this program. Does not stack with other commands.
 
-.. option:: --radix=RADIX, -t
+.. option:: --without-aliases
 
- Specify the radix of the symbol address(es). Values accepted d(decimal),
- x(hexadecimal) and o(octal).
+ Exclude aliases from the output.
 
 .. option:: @<FILE>
 
  Read command-line options from response file `<FILE>`.
 
+MACH-O SPECIFIC OPTIONS
+-----------------------
+
+.. option:: --add-dyldinfo
+
+ Add symbols from the dyldinfo, if they are not already in the symbol table.
+ This is the default.
+
+.. option:: --arch=<arch1[,arch2,...]>
+
+ Dump the symbols from the specified architecture(s).
+
+.. option:: --dyldinfo-only
+
+ Dump only symbols from the dyldinfo.
+
+.. option:: --no-dyldinfo
+
+ Do not add any symbols from the dyldinfo.
+
+.. option:: -s=<segment section>
+
+ Dump only symbols from this segment and section name.
+
+.. option:: -x
+
+ Print symbol entry in hex.
+
 BUGS
 ----
 
  * :program:`llvm-nm` does not support the full set of arguments that GNU
    :program:`nm` does.
 
 EXIT STATUS
 -----------
 
 :program:`llvm-nm` exits with an exit code of zero.
 
 SEE ALSO
 --------
 
 llvm-dis, ar(1), nm(1)