binutils: Fix broken bullet lists in objcopy documentation

The documentation for --add-gnu-debuglink and --extract-symbol
uses diverse formatting styles for list items, including @table and
manual bullets. This looked broken in the generated man pages, showing
raw text artifacts like "*<..>" instead of real bullet points.

This patch unifies these sections to use @itemize @bullet, resulting in
cleaner output and better readability for these options.

binutils/
        * doc/binutils.texi (objcopy): Use @itemize @bullet
        for --add-gnu-debuglink and --extract-symbol.

diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi
index 42957cba5b50b71266c10cc1f43fd2b41bdc6a8f..e52ec69616a020ace937892f16c730e665e8949e 100644 (file)
--- a/binutils/doc/binutils.texi
+++ b/binutils/doc/binutils.texi
@@ -2038,20 +2038,22 @@ like this:
  objcopy --add-gnu-debuglink=foo.debug
 @end smallexample
 
-At debug time the debugger will attempt to look for the separate debug
+At debug time, the debugger will attempt to look for the separate debug
 info file in a set of known locations.  The exact set of these
 locations varies depending upon the distribution being used, but it
 typically includes:
 
-@table @code
-
-@item * The same directory as the executable.
+@itemize @bullet
+@item
+The same directory as the executable.
 
-@item * A sub-directory of the directory containing the executable
-called .debug
+@item
+A sub-directory of the directory containing the executable called
+.debug.
 
-@item * A global debug directory such as /usr/lib/debug.
-@end table
+@item
+A global debug directory such as /usr/lib/debug.
+@end itemize
 
 As long as the debug info file has been installed into one of these
 locations before the debugger is run everything should work
@@ -2199,12 +2201,17 @@ the subsystem version also.  Numeric values are also accepted for
 
 @item --extract-symbol
 Keep the file's section flags and symbols but remove all section data.
-Specifically, the option:
+Specifically, this option:
+
+@itemize @bullet
+@item
+Removes the contents of all sections.
 
-@itemize
-@item removes the contents of all sections;
-@item sets the size of every section to zero; and
-@item sets the file's start address to zero.
+@item
+Sets the size of every section to zero.
+
+@item
+Sets the file's start address to zero.
 @end itemize
 
 This option is used to build a @file{.sym} file for a VxWorks kernel.