[llvm] [llvm-objdump] Document selecting symbols containing commas (PR #221619)

[James Henderson via llvm-commits]

================
@@ -37,12 +37,26 @@ Disassemble all sections found in the input files.
 :::
 
 :::{option} --disassemble-symbols=<symbol1[,symbol2,...]>
-:::
-
-:::{option} --disassemble=symbol1 --disassemble=symbol2 ...
 Disassemble only the specified symbols. Takes demangled symbol names when
 {option}`--demangle` is specified, otherwise takes mangled symbol names.
 Implies {option}`--disassemble`.
+
+Each argument is split on commas. To select a symbol whose name contains commas,
+use `--disassemble=<symbol>` instead.
+:::
+
+:::{option} --disassemble=<symbol>
+Disassemble only the specified symbol. Takes a demangled symbol name when
+{option}`--demangle` is specified, otherwise takes a mangled symbol name.
+Implies {option}`--disassemble`.
+
+The argument is a single symbol name, including any commas. Repeat the option to
+select multiple symbols, for example:
----------------
jh7370 wrote:

The "including any commas" bit of this comment seems a little weird without the wider context of the change. I don't think it's needed, so delete it. You should also consider referencing `--diassemble-symbols` in addition to suggesting repeating the option.

https://github.com/llvm/llvm-project/pull/221619