This is the mail archive of the
binutils@sources.redhat.com
mailing list for the binutils project.
[RFC]: Improvement in binutils man page generation
- To: binutils at sourceware dot cygnus dot com
- Subject: [RFC]: Improvement in binutils man page generation
- From: Stephane Carrez <Stephane dot Carrez at worldnet dot fr>
- Date: Wed, 11 Jul 2001 23:57:36 +0200
Hi!
I would like to propose the following changes for binutils documentation
in order to improve man page generation. The main idea is to follow
the gcc documentation style:
- use @command{name} instead of @code{name}
- use @option{-opt} instead of @code{-opt}, @samp{-opt} or -opt.
- use [@option{-a}|@option{-b}] instead of [ -a | -b ]
ie, no space after [ | or before | ]
- use @table @env instead of @table @code
for the definition of the list of options.
(here, gcc uses @table @gcctabopt)
After that, the binutils generated man page are close to the gcc
generated man page, and they are far better (from my point of view,
...hope for yours too).
The dvi/ps/pdf documentation looks good too and is coherent with gcc dvi
(for options in the text for example). However, there is one regression
which is that the use of @option{-opt} in the synopsis looks a little
bit uggly (although it looks good on man).
I also suggest to change the main title 'GNU' into 'GNU Development Tools'
as it was before.
The patch below does the above changes with two or three typos I discovered
while doing the changes. The patch is not context diff because I found
it was probably easier to track my changes.
Tested on today CVS, under Red Hat 7.1, with podlators 1.10.
What do you think?
Stephane
2001-07-11 Stephane Carrez <Stephane.Carrez@worldnet.fr>
* doc/binutils.texi: Use @command{name} for commands;
use @option{-opt} for options; use @table @env for list of options;
remove spaces arround [ | ] in synopsis.
* doc/Makefile.am (POD2MAN): Use 'GNU Development Tools' for the
center title.
Index: doc/Makefile.am
===================================================================
RCS file: /cvs/src/src/binutils/doc/Makefile.am,v
retrieving revision 1.2
diff -r1.2 Makefile.am
13c13,14
< POD2MAN = pod2man --center="GNU" --release="binutils-$(VERSION)" --section=1
---
> POD2MAN = pod2man --center="GNU Development Tools" \
> --release="binutils-$(VERSION)" --section=1
Index: doc/binutils.texi
===================================================================
RCS file: /cvs/src/src/binutils/doc/binutils.texi,v
retrieving revision 1.2
diff -r1.2 binutils.texi
188c188
< The @sc{gnu} @code{ar} program creates, modifies, and extracts from
---
> The @sc{gnu} @command{ar} program creates, modifies, and extracts from
198,199c198,199
< @sc{gnu} @code{ar} can maintain archives whose members have names of any
< length; however, depending on how @code{ar} is configured on your
---
> @sc{gnu} @command{ar} can maintain archives whose members have names of any
> length; however, depending on how @command{ar} is configured on your
206c206
< @code{ar} is considered a binary utility because archives of this sort
---
> @command{ar} is considered a binary utility because archives of this sort
211c211
< @code{ar} creates an index to the symbols defined in relocatable
---
> @command{ar} creates an index to the symbols defined in relocatable
213c213
< Once created, this index is updated in the archive whenever @code{ar}
---
> Once created, this index is updated in the archive whenever @command{ar}
220,221c220,221
< table. If an archive lacks the table, another form of @code{ar} called
< @code{ranlib} can be used to add just the table.
---
> table. If an archive lacks the table, another form of @command{ar} called
> @command{ranlib} can be used to add just the table.
223,225c223,225
< @cindex compatibility, @code{ar}
< @cindex @code{ar} compatibility
< @sc{gnu} @code{ar} is designed to be compatible with two different
---
> @cindex compatibility, @command{ar}
> @cindex @command{ar} compatibility
> @sc{gnu} @command{ar} is designed to be compatible with two different
227,228c227,228
< like the different varieties of @code{ar} on Unix systems; or, if you
< specify the single command-line option @samp{-M}, you can control it
---
> like the different varieties of @command{ar} on Unix systems; or, if you
> specify the single command-line option @option{-M}, you can control it
235,236c235,236
< * ar cmdline:: Controlling @code{ar} on the command line
< * ar scripts:: Controlling @code{ar} with a script
---
> * ar cmdline:: Controlling @command{ar} on the command line
> * ar scripts:: Controlling @command{ar} with a script
241c241
< @section Controlling @code{ar} on the command line
---
> @section Controlling @command{ar} on the command line
245c245
< ar [-X32_64] [-]@var{p}[@var{mod} [@var{relpos}] [@var{count}]] @var{archive} [@var{member}@dots{}]
---
> ar [@option{-X32_64}] [@option{-}]@var{p}[@var{mod} [@var{relpos}] [@var{count}]] @var{archive} [@var{member}@dots{}]
249,250c249,250
< @cindex Unix compatibility, @code{ar}
< When you use @code{ar} in the Unix style, @code{ar} insists on at least two
---
> @cindex Unix compatibility, @command{ar}
> When you use @command{ar} in the Unix style, @command{ar} insists on at least two
260c260
< @sc{gnu} @code{ar} allows you to mix the operation code @var{p} and modifier
---
> @sc{gnu} @command{ar} allows you to mix the operation code @var{p} and modifier
270c270
< @table @code
---
> @table @samp
277c277
< If you specify the @samp{v} modifier, @code{ar} lists each module
---
> If you specify the @samp{v} modifier, @command{ar} lists each module
310c310
< The modifier @samp{v} makes @code{ar} list each file as it is appended.
---
> The modifier @samp{v} makes @command{ar} list each file as it is appended.
314c314
< @code{ranlib} explicitly to update the symbol table index.
---
> @command{ranlib} explicitly to update the symbol table index.
326c326
< If one of the files named in @var{member}@dots{} does not exist, @code{ar}
---
> If one of the files named in @var{member}@dots{} does not exist, @command{ar}
363c363
< @code{ar} list each name as it extracts it.
---
> @command{ar} list each name as it extracts it.
373c373
< @table @code
---
> @table @samp
395c395
< Truncate names in the archive. @sc{gnu} @code{ar} will normally permit file
---
> Truncate names in the archive. @sc{gnu} @command{ar} will normally permit file
397c397
< not compatible with the native @code{ar} program on some systems. If
---
> not compatible with the native @command{ar} program on some systems. If
425c425
< @code{ar} can not create an archive with a full path name (such archives
---
> @command{ar} can not create an archive with a full path name (such archives
427c427
< will cause @sc{gnu} @code{ar} to match file names using a complete path
---
> will cause @sc{gnu} @command{ar} to match file names using a complete path
462c462
< This modifier shows the version number of @code{ar}.
---
> This modifier shows the version number of @command{ar}.
465c465
< @code{ar} ignores an initial option spelt @code{-X32_64}, for
---
> @command{ar} ignores an initial option spelt @samp{-X32_64}, for
467,469c467,469
< default for GNU @code{ar}. @code{ar} does not support any of the other
< @code{-X} options; in particular, it does not support @code{-X32}
< which is the default for AIX @code{ar}.
---
> default for GNU @command{ar}. @command{ar} does not support any of the other
> @samp{-X} options; in particular, it does not support @option{-X32}
> which is the default for AIX @command{ar}.
480c480
< @section Controlling @code{ar} with a script
---
> @section Controlling @command{ar} with a script
486,488c486,488
< @cindex MRI compatibility, @code{ar}
< @cindex scripts, @code{ar}
< If you use the single command-line option @samp{-M} with @code{ar}, you
---
> @cindex MRI compatibility, @command{ar}
> @cindex scripts, @command{ar}
> If you use the single command-line option @samp{-M} with @command{ar}, you
490,491c490,491
< form of @code{ar} operates interactively if standard input is coming
< directly from a terminal. During interactive use, @code{ar} prompts for
---
> form of @command{ar} operates interactively if standard input is coming
> directly from a terminal. During interactive use, @command{ar} prompts for
494c494
< issued, and @code{ar} abandons execution (with a nonzero exit code)
---
> issued, and @command{ar} abandons execution (with a nonzero exit code)
497c497
< The @code{ar} command language is @emph{not} designed to be equivalent
---
> The @command{ar} command language is @emph{not} designed to be equivalent
500c500
< transition to @sc{gnu} @code{ar} for developers who already have scripts
---
> transition to @sc{gnu} @command{ar} for developers who already have scripts
503c503
< The syntax for the @code{ar} command language is straightforward:
---
> The syntax for the @command{ar} command language is straightforward:
522c522
< Whenever you use a list of names as part of the argument to an @code{ar}
---
> Whenever you use a list of names as part of the argument to an @command{ar}
532,533c532,533
< Here are the commands you can use in @code{ar} scripts, or when using
< @code{ar} interactively. Three of them have special significance:
---
> Here are the commands you can use in @command{ar} scripts, or when using
> @command{ar} interactively. Three of them have special significance:
584c584
< specify @var{outputfile} as a final argument, @code{ar} directs the
---
> specify @var{outputfile} as a final argument, @command{ar} directs the
588c588
< Exit from @code{ar}, with a @code{0} exit code to indicate successful
---
> Exit from @command{ar}, with a @code{0} exit code to indicate successful
610c610
< tv @var{archive}}. (This single command is a @sc{gnu} @code{ar}
---
> tv @var{archive}}. (This single command is a @sc{gnu} @command{ar}
647c647
< The @sc{gnu} linker @code{ld} is now described in a separate manual.
---
> The @sc{gnu} linker @command{ld} is now described in a separate manual.
660,668c660,668
< nm [ -a | --debug-syms ] [ -g | --extern-only ]
< [ -B ] [ -C | --demangle[=@var{style}] ] [ -D | --dynamic ]
< [ -s | --print-armap ] [ -A | -o | --print-file-name ]
< [ -n | -v | --numeric-sort ] [ -p | --no-sort ]
< [ -r | --reverse-sort ] [ --size-sort ] [ -u | --undefined-only ]
< [ -t @var{radix} | --radix=@var{radix} ] [ -P | --portability ]
< [ --target=@var{bfdname} ] [ -f @var{format} | --format=@var{format} ]
< [ --defined-only ] [-l | --line-numbers ] [ --no-demangle ]
< [ -V | --version ] [ -X 32_64 ] [ --help ] [ @var{objfile}@dots{} ]
---
> nm [@option{-a}|@option{--debug-syms}] [@option{-g}|@option{--extern-only}]
> [@option{-B}] [@option{-C}|@option{--demangle}[=@var{style}]] [@option{-D}|@option{--dynamic}]
> [@option{-s}|@option{--print-armap}] [@option{-A}|@option{-o}|@option{--print-file-name}]
> [@option{-n}|@option{-v}|@option{--numeric-sort}] [@option{-p}|@option{--no-sort}]
> [@option{-r}|@option{--reverse-sort}] [@option{--size-sort}] [@option{-u}|@option{--undefined-only}]
> [@option{-t} @var{radix}|@option{--radix=}@var{radix}] [@option{-P}|@option{--portability}]
> [@option{--target=}@var{bfdname}] [@option{-f}@var{format}|@option{--format=}@var{format}]
> [@option{--defined-only}] [@option{-l}|@option{--line-numbers}] [@option{--no-demangle}]
> [@option{-V}|@option{--version}] [@option{-X 32_64}] [@option{--help}] [@var{objfile}@dots{}]
673,674c673,674
< @sc{gnu} @code{nm} lists the symbols from object files @var{objfile}@dots{}.
< If no object files are listed as arguments, @code{nm} assumes the file
---
> @sc{gnu} @command{nm} lists the symbols from object files @var{objfile}@dots{}.
> If no object files are listed as arguments, @command{nm} assumes the file
677c677
< For each symbol, @code{nm} shows:
---
> For each symbol, @command{nm} shows:
752,753c752,754
< the stab type. Stabs symbols are used to hold debugging information;
< for more information, see @ref{Top,Stabs,Stabs Overview,stabs.info, The
---
> the stab type. Stabs symbols are used to hold debugging information.
> @ifclear man
> For more information, see @ref{Top,Stabs,Stabs Overview,stabs.info, The
754a756
> @end ifclear
770c772
< @table @code
---
> @table @env
788,790c790,792
< @cindex @code{nm} format
< @cindex @code{nm} compatibility
< The same as @samp{--format=bsd} (for compatibility with the MIPS @code{nm}).
---
> @cindex @command{nm} format
> @cindex @command{nm} compatibility
> The same as @option{--format=bsd} (for compatibility with the MIPS @command{nm}).
814,815c816,817
< @cindex @code{nm} format
< @cindex @code{nm} compatibility
---
> @cindex @command{nm} format
> @cindex @command{nm} compatibility
856c858
< (stored in the archive by @code{ar} or @code{ranlib}) of which modules
---
> (stored in the archive by @command{ar} or @command{ranlib}) of which modules
892c894
< Show the version number of @code{nm} and exit.
---
> Show the version number of @command{nm} and exit.
896,898c898,900
< @code{nm}. It takes one parameter which must be the string
< @code{32_64}. The default mode of AIX @code{nm} corresponds
< to @code{-X 32}, which is not supported by @sc{gnu} @code{nm}.
---
> @command{nm}. It takes one parameter which must be the string
> @option{32_64}. The default mode of AIX @command{nm} corresponds
> to @option{-X 32}, which is not supported by @sc{gnu} @command{nm}.
901c903
< Show a summary of the options to @code{nm} and exit.
---
> Show a summary of the options to @command{nm} and exit.
919,952c921,955
< objcopy [ -F @var{bfdname} | --target=@var{bfdname} ]
< [ -I @var{bfdname} | --input-target=@var{bfdname} ]
< [ -O @var{bfdname} | --output-target=@var{bfdname} ]
< [ -B @var{bfdarch} | --binary-architecture=@var{bfdarch} ]
< [ -S | --strip-all ] [ -g | --strip-debug ]
< [ -K @var{symbolname} | --keep-symbol=@var{symbolname} ]
< [ -N @var{symbolname} | --strip-symbol=@var{symbolname} ]
< [ -G @var{symbolname} | --keep-global-symbol=@var{symbolname}]
< [ -L @var{symbolname} | --localize-symbol=@var{symbolname} ]
< [ -W @var{symbolname} | --weaken-symbol=@var{symbolname} ]
< [ -x | --discard-all ] [ -X | --discard-locals ]
< [ -b @var{byte} | --byte=@var{byte} ]
< [ -i @var{interleave} | --interleave=@var{interleave} ]
< [ -j @var{sectionname} | --only-section=@var{sectionname} ]
< [ -R @var{sectionname} | --remove-section=@var{sectionname} ]
< [ -p | --preserve-dates ] [ --debugging ]
< [ --gap-fill=@var{val} ] [ --pad-to=@var{address} ]
< [ --set-start=@var{val} ] [ --adjust-start=@var{incr} ]
< [ --change-addresses=@var{incr} ]
< [ --change-section-address @var{section}@{=,+,-@}@var{val} ]
< [ --change-section-lma @var{section}@{=,+,-@}@var{val} ]
< [ --change-section-vma @var{section}@{=,+,-@}@var{val} ]
< [ --change-warnings ] [ --no-change-warnings ]
< [ --set-section-flags @var{section}=@var{flags} ]
< [ --add-section @var{sectionname}=@var{filename} ]
< [ --change-leading-char ] [ --remove-leading-char ]
< [ --srec-len=@var{ival} ] [ --srec-forceS3 ]
< [ --redefine-sym @var{old}=@var{new} ] [ --weaken ]
< [ --keep-symbols=@var{filename} ]
< [ --strip-symbols=@var{filename} ]
< [ --keep-global-symbols=@var{filename} ]
< [ --localize-symbols=@var{filename} ]
< [ --weaken-symbols=@var{filename} ]
< [ -v | --verbose ] [ -V | --version ] [ --help ]
---
> objcopy [@option{-F} @var{bfdname}|@option{--target=}@var{bfdname}]
> [@option{-I} @var{bfdname}|@option{--input-target=}@var{bfdname}]
> [@option{-O} @var{bfdname}|@option{--output-target=}@var{bfdname}]
> [@option{-B} @var{bfdarch}|@option{--binary-architecture=}@var{bfdarch}]
> [@option{-S}|@option{--strip-all}] [@option{-g}|@option{--strip-debug}]
> [@option{-K} @var{symbolname}|@option{--keep-symbol=}@var{symbolname}]
> [@option{-N} @var{symbolname}|@option{--strip-symbol=}@var{symbolname}]
> [@option{-G} @var{symbolname}|@option{--keep-global-symbol=}@var{symbolname}]
> [@option{-L} @var{symbolname}|@option{--localize-symbol=}@var{symbolname}]
> [@option{-W} @var{symbolname}|@option{--weaken-symbol=}@var{symbolname}]
> [@option{-x}|@option{--discard-all}] [@option{-X}|@option{--discard-locals}]
> [@option{-b} @var{byte}|@option{--byte=}@var{byte}]
> [@option{-i} @var{interleave}|@option{--interleave=}@var{interleave}]
> [@option{-j} @var{sectionname}|@option{--only-section=}@var{sectionname}]
> [@option{-R} @var{sectionname}|@option{--remove-section=}@var{sectionname}]
> [@option{-p}|@option{--preserve-dates}] [@option{--debugging}]
> [@option{--gap-fill=}@var{val}] [@option{--pad-to=}@var{address}]
> [@option{--set-start=}@var{val}] [@option{--adjust-start=}@var{incr}]
> [@option{--change-addresses=}@var{incr}]
> [@option{--change-section-address} @var{section}@{=,+,-@}@var{val}]
> [@option{--change-section-lma} @var{section}@{=,+,-@}@var{val}]
> [@option{--change-section-vma} @var{section}@{=,+,-@}@var{val}]
> [@option{--change-warnings}] [@option{--no-change-warnings}]
> [@option{--set-section-flags} @var{section}=@var{flags}]
> [@option{--add-section} @var{sectionname}=@var{filename}]
> [@option{--change-leading-char} ] [@option{--remove-leading-char}]
> [@option{--srec-len=}@var{ival} ] [@option{--srec-forceS3}]
> [@option{--redefine-sym} @var{old}=@var{new} ] [@option{--weaken}]
> [@option{--keep-symbols=}@var{filename}]
> [@option{--strip-symbols=}@var{filename}]
> [@option{--keep-global-symbols=}@var{filename}]
> [@option{--localize-symbols=}@var{filename}]
> [@option{--weaken-symbols=}@var{filename}]
> [@option{-v}|@option{--verbose}] [@option{-V} | @option{--version}]
> [@option{--help}]
958,959c961,962
< The @sc{gnu} @code{objcopy} utility copies the contents of an object
< file to another. @code{objcopy} uses the @sc{gnu} @sc{bfd} Library to
---
> The @sc{gnu} @command{objcopy} utility copies the contents of an object
> file to another. @command{objcopy} uses the @sc{gnu} @sc{bfd} Library to
962,963c965,966
< exact behavior of @code{objcopy} is controlled by command-line options.
< Note that @code{objcopy} should be able to copy a fully linked file
---
> exact behavior of @command{objcopy} is controlled by command-line options.
> Note that @command{objcopy} should be able to copy a fully linked file
967,968c970,971
< @code{objcopy} creates temporary files to do its translations and
< deletes them afterward. @code{objcopy} uses @sc{bfd} to do all its
---
> @command{objcopy} creates temporary files to do its translations and
> deletes them afterward. @command{objcopy} uses @sc{bfd} to do all its
973c976
< @code{objcopy} can be used to generate S-records by using an output
---
> @command{objcopy} can be used to generate S-records by using an output
976,978c979,981
< @code{objcopy} can be used to generate a raw binary file by using an
< output target of @samp{binary} (e.g., use @samp{-O binary}). When
< @code{objcopy} generates a raw binary file, it will essentially produce
---
> @command{objcopy} can be used to generate a raw binary file by using an
> output target of @samp{binary} (e.g., use @option{-O binary}). When
> @command{objcopy} generates a raw binary file, it will essentially produce
984,985c987,988
< use @samp{-S} to remove sections containing debugging information. In
< some cases @samp{-R} will be useful to remove sections which contain
---
> use @option{-S} to remove sections containing debugging information. In
> some cases @option{-R} will be useful to remove sections which contain
988c991
< Note - @code{objcopy} is not able to change the endianness of its input
---
> Note - @command{objcopy} is not able to change the endianness of its input
990c993
< @code{objcopy} can only copy the inputs into file formats that have the
---
> @command{objcopy} can only copy the inputs into file formats that have the
997c1000
< @table @code
---
> @table @env
1001c1004
< If you do not specify @var{outfile}, @code{objcopy} creates a
---
> If you do not specify @var{outfile}, @command{objcopy} creates a
1005c1008
< @item -I @var{bfdname}
---
> @item -I @var{bfdname}
1094c1097
< where @var{interleave} is given by the @samp{-i} or @samp{--interleave}
---
> where @var{interleave} is given by the @option{-i} or @option{--interleave}
1102,1104c1105,1107
< copy with the @var{-b} or @samp{--byte} option. The default is 4.
< @code{objcopy} ignores this option if you do not specify either @samp{-b} or
< @samp{--byte}.
---
> copy with the @option{-b} or @option{--byte} option. The default is 4.
> @command{objcopy} ignores this option if you do not specify either @option{-b} or
> @option{--byte}.
1125c1128
< filled in with the value specified by @samp{--gap-fill} (default zero).
---
> filled in with the value specified by @option{--gap-fill} (default zero).
1153c1156
< section address. See the comments under @samp{--change-addresses},
---
> section address. See the comments under @option{--change-addresses},
1155c1158
< be issued, unless @samp{--no-change-warnings} is used.
---
> be issued, unless @option{--no-change-warnings} is used.
1166c1169
< section address. See the comments under @samp{--change-addresses},
---
> section address. See the comments under @option{--change-addresses},
1168c1171
< will be issued, unless @samp{--no-change-warnings} is used.
---
> will be issued, unless @option{--no-change-warnings} is used.
1180c1183
< @samp{--change-addresses}, above. If @var{section} does not exist in
---
> @option{--change-addresses}, above. If @var{section} does not exist in
1182c1185
< @samp{--no-change-warnings} is used.
---
> @option{--no-change-warnings} is used.
1186,1187c1189,1190
< If @samp{--change-section-address} or @samp{--change-section-lma} or
< @samp{--change-section-vma} is used, and the named section does not
---
> If @option{--change-section-address} or @option{--change-section-lma} or
> @option{--change-section-vma} is used, and the named section does not
1192,1193c1195,1196
< Do not issue a warning if @samp{--change-section-address} or
< @samp{--adjust-section-lma} or @samp{--adjust-section-vma} is used, even
---
> Do not issue a warning if @option{--change-section-address} or
> @option{--adjust-section-lma} or @option{--adjust-section-vma} is used, even
1216c1219
< often add before every symbol. This option tells @code{objcopy} to
---
> often add before every symbol. This option tells @command{objcopy} to
1230c1233
< @code{--change-leading-char} because it always changes the symbol name
---
> @option{--change-leading-char} because it always changes the symbol name
1251c1254
< the @code{-R} option to the linker. This option is only effective when
---
> the @option{-R} option to the linker. This option is only effective when
1255c1258
< Apply @samp{--keep-symbol} option to each symbol listed in the file
---
> Apply @option{--keep-symbol} option to each symbol listed in the file
1261c1264
< Apply @samp{--strip-symbol} option to each symbol listed in the file
---
> Apply @option{--strip-symbol} option to each symbol listed in the file
1267c1270
< Apply @samp{--keep-global-symbol} option to each symbol listed in the
---
> Apply @option{--keep-global-symbol} option to each symbol listed in the
1273c1276
< Apply @samp{--localize-symbol} option to each symbol listed in the file
---
> Apply @option{--localize-symbol} option to each symbol listed in the file
1279c1282
< Apply @samp{--weaken-symbol} option to each symbol listed in the file
---
> Apply @option{--weaken-symbol} option to each symbol listed in the file
1286c1289
< Show the version number of @code{objcopy}.
---
> Show the version number of @command{objcopy}.
1294c1297
< Show a summary of the options to @code{objcopy}.
---
> Show a summary of the options to @command{objcopy}.
1315,1347c1318,1350
< objdump [ -a | --archive-headers ]
< [ -b @var{bfdname} | --target=@var{bfdname} ]
< [ -C | --demangle[=@var{style}] ]
< [ -d | --disassemble ]
< [ -D | --disassemble-all ]
< [ -z | --disassemble-zeroes ]
< [ -EB | -EL | --endian=@{big | little @} ]
< [ -f | --file-headers ]
< [ --file-start-context ]
< [ -g | --debugging ]
< [ -h | --section-headers | --headers ]
< [ -i | --info ]
< [ -j @var{section} | --section=@var{section} ]
< [ -l | --line-numbers ]
< [ -S | --source ]
< [ -m @var{machine} | --architecture=@var{machine} ]
< [ -M @var{options} | --disassembler-options=@var{options}]
< [ -p | --private-headers ]
< [ -r | --reloc ]
< [ -R | --dynamic-reloc ]
< [ -s | --full-contents ]
< [ -G | --stabs ]
< [ -t | --syms ]
< [ -T | --dynamic-syms ]
< [ -x | --all-headers ]
< [ -w | --wide ]
< [ --start-address=@var{address} ]
< [ --stop-address=@var{address} ]
< [ --prefix-addresses]
< [ --[no-]show-raw-insn ]
< [ --adjust-vma=@var{offset} ]
< [ -V | --version ]
< [ -H | --help ]
---
> objdump [@option{-a}|@option{--archive-headers}]
> [@option{-b} @var{bfdname}|@option{--target=@var{bfdname}}]
> [@option{-C}|@option{--demangle}[=@var{style}] ]
> [@option{-d}|@option{--disassemble}]
> [@option{-D}|@option{--disassemble-all}]
> [@option{-z}|@option{--disassemble-zeroes}]
> [@option{-EB}|@option{-EL}|@option{--endian=}@{big | little @}]
> [@option{-f}|@option{--file-headers}]
> [@option{--file-start-context}]
> [@option{-g}|@option{--debugging}]
> [@option{-h}|@option{--section-headers}|@option{--headers}]
> [@option{-i}|@option{--info}]
> [@option{-j} @var{section}|@option{--section=}@var{section}]
> [@option{-l}|@option{--line-numbers}]
> [@option{-S}|@option{--source}]
> [@option{-m} @var{machine}|@option{--architecture=}@var{machine}]
> [@option{-M} @var{options}|@option{--disassembler-options=}@var{options}]
> [@option{-p}|@option{--private-headers}]
> [@option{-r}|@option{--reloc}]
> [@option{-R}|@option{--dynamic-reloc}]
> [@option{-s}|@option{--full-contents}]
> [@option{-G}|@option{--stabs}]
> [@option{-t}|@option{--syms}]
> [@option{-T}|@option{--dynamic-syms}]
> [@option{-x}|@option{--all-headers}]
> [@option{-w}|@option{--wide}]
> [@option{--start-address=}@var{address}]
> [@option{--stop-address=}@var{address}]
> [@option{--prefix-addresses}]
> [@option{--[no-]show-raw-insn}]
> [@option{--adjust-vma=}@var{offset}]
> [@option{-V}|@option{--version}]
> [@option{-H}|@option{--help}]
1354c1357
< @code{objdump} displays information about one or more object files.
---
> @command{objdump} displays information about one or more object files.
1361c1364
< specify archives, @code{objdump} shows information on each of the member
---
> specify archives, @command{objdump} shows information on each of the member
1370c1373
< @samp{-a,-d,-D,-f,-g,-G,-h,-H,-p,-r,-R,-S,-t,-T,-V,-x} must be given.
---
> @option{-a,-d,-D,-f,-g,-G,-h,-H,-p,-r,-R,-S,-t,-T,-V,-x} must be given.
1372c1375
< @table @code
---
> @table @env
1402,1403c1405,1406
< displays summary information from the section headers (@samp{-h}) of
< @file{fu.o}, which is explicitly identified (@samp{-m}) as a VAX object
---
> displays summary information from the section headers (@option{-h}) of
> @file{fu.o}, which is explicitly identified (@option{-m}) as a VAX object
1405c1408
< formats available with the @samp{-i} option.
---
> formats available with the @option{-i} option.
1434c1437
< Like @samp{-d}, but disassemble the contents of all sections, not just
---
> Like @option{-d}, but disassemble the contents of all sections, not just
1464c1467
< (assumes '-S') from a file that has not yet been displayed, extend the
---
> (assumes @option{-S}) from a file that has not yet been displayed, extend the
1475,1476c1478,1479
< using the @samp{-Ttext}, @samp{-Tdata}, or @samp{-Tbss} options to
< @code{ld}. However, some object file formats, such as a.out, do not
---
> using the @option{-Ttext}, @option{-Tdata}, or @option{-Tbss} options to
> @command{ld}. However, some object file formats, such as a.out, do not
1478c1481
< although @code{ld} relocates the sections correctly, using @samp{objdump
---
> although @command{ld} relocates the sections correctly, using @samp{objdump
1484c1487
< Print a summary of the options to @code{objdump} and exit.
---
> Print a summary of the options to @command{objdump} and exit.
1491c1494
< for specification with @samp{-b} or @samp{-m}.
---
> for specification with @option{-b} or @option{-m}.
1503c1506
< Only useful with @samp{-d}, @samp{-D}, or @samp{-r}.
---
> Only useful with @option{-d}, @option{-D}, or @option{-r}.
1512c1515
< architectures with the @samp{-i} option.
---
> architectures with the @option{-i} option.
1521c1524
< @samp{-M reg-name-std} (the default) will select the register names as
---
> @option{-M reg-name-std} (the default) will select the register names as
1524,1525c1527,1528
< @samp{-M reg-names-apcs} will select the name set used by the ARM
< Procedure Call Standard, whilst specifying @samp{-M reg-names-raw} will
---
> @option{-M reg-names-apcs} will select the name set used by the ARM
> Procedure Call Standard, whilst specifying @option{-M reg-names-raw} will
1529,1531c1532,1534
< by @samp{-M reg-names-atpcs} and @samp{-M reg-names-special-atpcs} which
< use the ARM/Thumb Procedure Call Standard naming conventions. (Eiuther
< with the normal register name sor the special register names).
---
> by @option{-M reg-names-atpcs} and @option{-M reg-names-special-atpcs} which
> use the ARM/Thumb Procedure Call Standard naming conventions. (Either
> with the normal register name or the special register names).
1535c1538
< using the switch @samp{--disassembler-options=force-thumb}. This can be
---
> using the switch @option{--disassembler-options=force-thumb}. This can be
1548,1549c1551,1552
< Print the relocation entries of the file. If used with @samp{-d} or
< @samp{-D}, the relocations are printed interspersed with the
---
> Print the relocation entries of the file. If used with @option{-d} or
> @option{-D}, the relocations are printed interspersed with the
1570c1573
< @samp{-d}.
---
> @option{-d}.
1575c1578
< @code{--prefix-addresses} is used.
---
> @option{--prefix-addresses} is used.
1579c1582
< This is the default when @code{--prefix-addresses} is used.
---
> This is the default when @option{--prefix-addresses} is used.
1592c1595
< interleaved with linkage symbols, and are visible in the @samp{--syms}
---
> interleaved with linkage symbols, and are visible in the @option{--syms}
1602c1605
< of the @code{-d}, @code{-r} and @code{-s} options.
---
> of the @option{-d}, @option{-r} and @option{-s} options.
1607c1610
< of the @code{-d}, @code{-r} and @code{-s} options.
---
> of the @option{-d}, @option{-r} and @option{-s} options.
1621c1624
< program when given the @samp{-D} (@samp{--dynamic}) option.
---
> program when given the @option{-D} (@option{--dynamic}) option.
1624c1627
< Print the version number of @code{objdump} and exit.
---
> Print the version number of @command{objdump} and exit.
1631,1632c1634,1635
< relocation entries. Using @samp{-x} is equivalent to specifying all of
< @samp{-a -f -h -r -t}.
---
> relocation entries. Using @option{-x} is equivalent to specifying all of
> @option{-a -f -h -r -t}.
1659c1662
< ranlib [-vV] @var{archive}
---
> ranlib [@option{-vV}] @var{archive}
1665c1668
< @code{ranlib} generates an index to the contents of an archive and
---
> @command{ranlib} generates an index to the contents of an archive and
1675,1676c1678,1679
< The @sc{gnu} @code{ranlib} program is another form of @sc{gnu} @code{ar}; running
< @code{ranlib} is completely equivalent to executing @samp{ar -s}.
---
> The @sc{gnu} @command{ranlib} program is another form of @sc{gnu} @command{ar}; running
> @command{ranlib} is completely equivalent to executing @samp{ar -s}.
1683c1686
< @table @code
---
> @table @env
1687c1690
< Show the version number of @code{ranlib}.
---
> Show the version number of @command{ranlib}.
1708,1711c1711,1714
< size [ -A | -B | --format=@var{compatibility} ]
< [ --help ] [ -d | -o | -x | --radix=@var{number} ]
< [ --target=@var{bfdname} ] [ -V | --version ]
< [ @var{objfile}@dots{} ]
---
> size [@option{-A}|@option{-B}|@option{--format=}@var{compatibility}]
> [@option{--help}] [@option{-d}|@option{-o}|@option{-x}|@option{--radix=}@var{number}]
> [@option{--target=}@var{bfdname}] [@option{-V}|@option{--version}]
> [@var{objfile}@dots{}]
1717c1720
< The @sc{gnu} @code{size} utility lists the section sizes---and the total
---
> The @sc{gnu} @command{size} utility lists the section sizes---and the total
1731c1734
< @table @code
---
> @table @env
1735c1738
< @cindex @code{size} display format
---
> @cindex @command{size} display format
1737,1739c1740,1742
< @code{size} resembles output from System V @code{size} (using @samp{-A},
< or @samp{--format=sysv}), or Berkeley @code{size} (using @samp{-B}, or
< @samp{--format=berkeley}). The default is the one-line format similar to
---
> @command{size} resembles output from System V @command{size} (using @option{-A},
> or @option{--format=sysv}), or Berkeley @command{size} (using @option{-B}, or
> @option{--format=berkeley}). The default is the one-line format similar to
1746c1749
< @code{size}:
---
> @command{size}:
1782c1785
< @cindex @code{size} number format
---
> @cindex @command{size} number format
1785,1787c1788,1790
< section is given in decimal (@samp{-d}, or @samp{--radix=10}); octal
< (@samp{-o}, or @samp{--radix=8}); or hexadecimal (@samp{-x}, or
< @samp{--radix=16}). In @samp{--radix=@var{number}}, only the three
---
> section is given in decimal (@option{-d}, or @option{--radix=10}); octal
> (@option{-o}, or @option{--radix=8}); or hexadecimal (@option{-x}, or
> @option{--radix=16}). In @option{--radix=@var{number}}, only the three
1789,1790c1792,1793
< radices; decimal and hexadecimal for @samp{-d} or @samp{-x} output, or
< octal and hexadecimal if you're using @samp{-o}.
---
> radices; decimal and hexadecimal for @option{-d} or @option{-x} output, or
> octal and hexadecimal if you're using @option{-o}.
1795c1798
< @var{bfdname}. This option may not be necessary; @code{size} can
---
> @var{bfdname}. This option may not be necessary; @command{size} can
1801c1804
< Display the version number of @code{size}.
---
> Display the version number of @command{size}.
1823,1826c1826,1829
< strings [-afov] [-@var{min-len}] [-n @var{min-len}] [-t @var{radix}] [-]
< [--all] [--print-file-name] [--bytes=@var{min-len}]
< [--radix=@var{radix}] [--target=@var{bfdname}]
< [--help] [--version] @var{file}@dots{}
---
> strings [@option{-afov}] [@option{-}@var{min-len}] [@option{-n} @var{min-len}] [@option{-t} @var{radix}] [@option{-}]
> [@option{--all}] [@option{--print-file-name}] [@option{--bytes=}@var{min-len}]
> [@option{--radix=}@var{radix}] [@option{--target=}@var{bfdname}]
> [@option{--help}] [@option{--version}] @var{file}@dots{}
1832c1835
< For each @var{file} given, @sc{gnu} @code{strings} prints the printable
---
> For each @var{file} given, @sc{gnu} @command{strings} prints the printable
1839c1842
< @code{strings} is mainly useful for determining the contents of non-text
---
> @command{strings} is mainly useful for determining the contents of non-text
1846c1849
< @table @code
---
> @table @env
1867c1870
< Like @samp{-t o}. Some other versions of @code{strings} have @samp{-o}
---
> Like @samp{-t o}. Some other versions of @command{strings} have @option{-o}
1908,1917c1911,1920
< strip [ -F @var{bfdname} | --target=@var{bfdname} ]
< [ -I @var{bfdname} | --input-target=@var{bfdname} ]
< [ -O @var{bfdname} | --output-target=@var{bfdname} ]
< [ -s | --strip-all ] [ -S | -g | --strip-debug ]
< [ -K @var{symbolname} | --keep-symbol=@var{symbolname} ]
< [ -N @var{symbolname} | --strip-symbol=@var{symbolname} ]
< [ -x | --discard-all ] [ -X | --discard-locals ]
< [ -R @var{sectionname} | --remove-section=@var{sectionname} ]
< [ -o @var{file} ] [ -p | --preserve-dates ]
< [ -v | --verbose ] [ -V | --version ] [ --help ]
---
> strip [@option{-F} @var{bfdname} |@option{--target=}@var{bfdname} ]
> [@option{-I} @var{bfdname} |@option{--input-target=}@var{bfdname} ]
> [@option{-O} @var{bfdname} |@option{--output-target=}@var{bfdname} ]
> [@option{-s}|@option{--strip-all}] [@option{-S}|@option{-g}|@option{--strip-debug}]
> [@option{-K} @var{symbolname} |@option{--keep-symbol=}@var{symbolname} ]
> [@option{-N} @var{symbolname} |@option{--strip-symbol=}@var{symbolname} ]
> [@option{-x}|@option{--discard-all} ] [@option{-X} |@option{--discard-locals}]
> [@option{-R} @var{sectionname} |@option{--remove-section=}@var{sectionname} ]
> [@option{-o} @var{file} ] [@option{-p}|@option{--preserve-dates}]
> [@option{-v} |@option{--verbose}] [@option{-V}|@option{--version}] [@option{--help}]
1924c1927
< @sc{gnu} @code{strip} discards all symbols from object files
---
> @sc{gnu} @command{strip} discards all symbols from object files
1928c1931
< @code{strip} modifies the files named in its argument,
---
> @command{strip} modifies the files named in its argument,
1935c1938
< @table @code
---
> @table @env
1943c1946
< Show a summary of the options to @code{strip} and exit.
---
> Show a summary of the options to @command{strip} and exit.
1983c1986
< @code{-K}.
---
> @option{-K}.
2005c2008
< Show the version number for @code{strip}.
---
> Show the version number for @command{strip}.
2031,2035c2034,2038
< c++filt [ -_ | --strip-underscores ]
< [ -j | --java ]
< [ -n | --no-strip-underscores ]
< [ -s @var{format} | --format=@var{format} ]
< [ --help ] [ --version ] [ @var{symbol}@dots{} ]
---
> c++filt [@option{-_}|@option{--strip-underscores}]
> [@option{-j}|@option{--java}]
> [@option{-n}|@option{--no-strip-underscores}]
> [@option{-s} @var{format}|@option{--format=}@var{format}]
> [@option{--help}] [@option{--version}] [@var{symbol}@dots{}]
2046c2049
< @dfn{mangling}). The @code{c++filt}
---
> @dfn{mangling}). The @command{c++filt}
2048c2051
< MS-DOS this program is named @code{cxxfilt}.}
---
> MS-DOS this program is named @command{cxxfilt}.}
2058c2061
< You can use @code{c++filt} to decipher individual symbols:
---
> You can use @command{c++filt} to decipher individual symbols:
2064c2067
< If no @var{symbol} arguments are given, @code{c++filt} reads symbol
---
> If no @var{symbol} arguments are given, @command{c++filt} reads symbol
2072c2075
< @table @code
---
> @table @env
2078c2081
< @code{c++filt} removes the underscore by default is target dependent.
---
> @command{c++filt} removes the underscore by default is target dependent.
2091c2094
< @sc{gnu} @code{nm} can decode three different methods of mangling, used by
---
> @sc{gnu} @command{nm} can decode three different methods of mangling, used by
2111c2114
< Print a summary of the options to @code{c++filt} and exit.
---
> Print a summary of the options to @command{c++filt} and exit.
2114c2117
< Print the version number of @code{c++filt} and exit.
---
> Print the version number of @command{c++filt} and exit.
2126c2129
< @emph{Warning:} @code{c++filt} is a new utility, and the details of its
---
> @emph{Warning:} @command{c++filt} is a new utility, and the details of its
2153,2158c2156,2161
< addr2line [ -b @var{bfdname} | --target=@var{bfdname} ]
< [ -C | --demangle[=@var{style} ]
< [ -e @var{filename} | --exe=@var{filename} ]
< [ -f | --functions ] [ -s | --basename ]
< [ -H | --help ] [ -V | --version ]
< [ addr addr ... ]
---
> addr2line [@option{-b} @var{bfdname}|@option{--target=}@var{bfdname}]
> [@option{-C}|@option{--demangle}[=@var{style}]
> [@option{-e} @var{filename}|@option{--exe=}@var{filename}]
> [@option{-f}|@option{--functions}] [@option{-s}|@option{--basename}]
> [@option{-H}|@option{--help}] [@option{-V}|@option{--version}]
> [addr addr @dots{}]
2164c2167
< @code{addr2line} translates program addresses into file names and line
---
> @command{addr2line} translates program addresses into file names and line
2169c2172
< The executable to use is specified with the @code{-e} option. The
---
> The executable to use is specified with the @option{-e} option. The
2172c2175
< @code{addr2line} has two modes of operation.
---
> @command{addr2line} has two modes of operation.
2175c2178
< and @code{addr2line} displays the file name and line number for each
---
> and @command{addr2line} displays the file name and line number for each
2178c2181
< In the second, @code{addr2line} reads hexadecimal addresses from
---
> In the second, @command{addr2line} reads hexadecimal addresses from
2180c2183
< address on standard output. In this mode, @code{addr2line} may be used
---
> address on standard output. In this mode, @command{addr2line} may be used
2185c2188
< @code{-f} option is used, then each @samp{FILENAME:LINENO} line is
---
> @command{-f} option is used, then each @samp{FILENAME:LINENO} line is
2190,2191c2193,2194
< @code{addr2line} will print two question marks in their place. If the
< line number can not be determined, @code{addr2line} will print 0.
---
> @command{addr2line} will print two question marks in their place. If the
> line number can not be determined, @command{addr2line} will print 0.
2200c2203
< @table @code
---
> @table @env
2242c2245
< @code{nlmconv} converts a relocatable object file into a NetWare
---
> @command{nlmconv} converts a relocatable object file into a NetWare
2246c2249
< @code{nlmconv} currently works with @samp{i386} object
---
> @command{nlmconv} currently works with @samp{i386} object
2249c2252
< @code{nlmconv} should work with any @samp{i386} or @sc{sparc} object
---
> @command{nlmconv} should work with any @samp{i386} or @sc{sparc} object
2255c2258
< @emph{Warning:} @code{nlmconv} is not always built as part of the binary
---
> @emph{Warning:} @command{nlmconv} is not always built as part of the binary
2263,2267c2266,2270
< nlmconv [ -I @var{bfdname} | --input-target=@var{bfdname} ]
< [ -O @var{bfdname} | --output-target=@var{bfdname} ]
< [ -T @var{headerfile} | --header-file=@var{headerfile} ]
< [ -d | --debug] [ -l @var{linker} | --linker=@var{linker} ]
< [ -h | --help ] [ -V | --version ]
---
> nlmconv [@option{-I} @var{bfdname}|@option{--input-target=}@var{bfdname}]
> [@option{-O} @var{bfdname}|@option{--output-target=}@var{bfdname}]
> [@option{-T} @var{headerfile}|@option{--header-file=}@var{headerfile}]
> [@option{-d}|@option{--debug}] [@option{-l} @var{linker}|@option{--linker=}@var{linker}]
> [@option{-h}|@option{--help}] [@option{-V}|@option{--version}]
2274c2277
< @code{nlmconv} converts the relocatable @samp{i386} object file
---
> @command{nlmconv} converts the relocatable @samp{i386} object file
2281c2284
< @code{nlmconv} uses the @sc{gnu} Binary File Descriptor library to read
---
> @command{nlmconv} uses the @sc{gnu} Binary File Descriptor library to read
2287c2290
< @code{nlmconv} can perform a link step. In other words, you can list
---
> @command{nlmconv} can perform a link step. In other words, you can list
2290c2293
< In this case, @code{nlmconv} calls the linker for you.
---
> In this case, @command{nlmconv} calls the linker for you.
2296c2299
< @table @code
---
> @table @env
2299c2302
< Object format of the input file. @code{nlmconv} can usually determine
---
> Object format of the input file. @command{nlmconv} can usually determine
2305c2308
< Object format of the output file. @code{nlmconv} infers the output
---
> Object format of the output file. @command{nlmconv} infers the output
2320c2323
< Displays (on standard error) the linker command line used by @code{nlmconv}.
---
> Displays (on standard error) the linker command line used by @command{nlmconv}.
2333c2336
< Prints the version number for @code{nlmconv}.
---
> Prints the version number for @command{nlmconv}.
2347c2350
< @code{windres} may be used to manipulate Windows resources.
---
> @command{windres} may be used to manipulate Windows resources.
2350c2353
< @emph{Warning:} @code{windres} is not always built as part of the binary
---
> @emph{Warning:} @command{windres} is not always built as part of the binary
2364c2367
< @code{windres} reads resources from an input file and copies them into
---
> @command{windres} reads resources from an input file and copies them into
2381c2384
< When @code{windres} converts from the @code{rc} format to the @code{res}
---
> When @command{windres} converts from the @code{rc} format to the @code{res}
2383c2386
< @code{windres} converts from the @code{res} format to the @code{coff}
---
> @command{windres} converts from the @code{res} format to the @code{coff}
2386c2389
< When @code{windres} generates an @code{rc} file, the output is similar
---
> When @command{windres} generates an @code{rc} file, the output is similar
2391c2394
< If the input or output format is not specified, @code{windres} will
---
> If the input or output format is not specified, @command{windres} will
2398c2401
< If no output file is specified, @code{windres} will print the resources
---
> If no output file is specified, @command{windres} will print the resources
2401c2404
< The normal use is for you to write an @code{rc} file, use @code{windres}
---
> The normal use is for you to write an @code{rc} file, use @command{windres}
2410c2413
< @table @code
---
> @table @env
2414,2416c2417,2419
< @code{windres} will use the first non-option argument as the input file
< name. If there are no non-option arguments, then @code{windres} will
< read from standard input. @code{windres} can not read a COFF file from
---
> @command{windres} will use the first non-option argument as the input file
> name. If there are no non-option arguments, then @command{windres} will
> read from standard input. @command{windres} can not read a COFF file from
2422c2425
< @code{windres} will use the first non-option argument, after any used
---
> @command{windres} will use the first non-option argument, after any used
2424,2425c2427,2428
< non-option argument, then @code{windres} will write to standard output.
< @code{windres} can not write a COFF file to standard output.
---
> non-option argument, then @command{windres} will write to standard output.
> @command{windres} can not write a COFF file to standard output.
2430c2433
< @samp{coff}. If no input format is specified, @code{windres} will
---
> @samp{coff}. If no input format is specified, @command{windres} will
2437c2440
< @code{windres} will guess, as described above.
---
> @command{windres} will guess, as described above.
2442,2444c2445,2448
< is a BFD target name; you can use the @code{--help} option to see a list
< of supported targets. Normally @code{windres} will use the default
< format, which is the first one listed by the @code{--help} option.
---
> is a BFD target name; you can use the @option{--help} option to see a list
> of supported targets. Normally @command{windres} will use the default
> format, which is the first one listed by the @option{--help} option.
> @ifclear man
2445a2450
> @end ifclear
2448c2453
< When @code{windres} reads an @code{rc} file, it runs it through the C
---
> When @command{windres} reads an @code{rc} file, it runs it through the C
2455,2456c2460,2461
< @code{windres} will pass this to the preprocessor as an @code{-I}
< option. @code{windres} will also search this directory when looking for
---
> @command{windres} will pass this to the preprocessor as an @option{-I}
> option. @command{windres} will also search this directory when looking for
2461c2466
< Specify a @code{-D} option to pass to the preprocessor when reading an
---
> Specify a @option{-D} option to pass to the preprocessor when reading an
2488c2493
< Prints the version number for @code{windres}.
---
> Prints the version number for @command{windres}.
2491c2496
< If @code{windres} is compiled with @code{YYDEBUG} defined as @code{1},
---
> If @command{windres} is compiled with @code{YYDEBUG} defined as @code{1},
2508c2513
< @code{dlltool} may be used to create the files needed to build and use
---
> @command{dlltool} may be used to create the files needed to build and use
2512c2517
< @emph{Warning:} @code{dlltool} is not always built as part of the binary
---
> @emph{Warning:} @command{dlltool} is not always built as part of the binary
2520,2533c2525,2539
< dlltool [-d|--input-def @var{def-file-name}]
< [-b|--base-file @var{base-file-name}]
< [-e|--output-exp @var{exports-file-name}]
< [-z|--output-def @var{def-file-name}]
< [-l|--output-lib @var{library-file-name}]
< [--export-all-symbols] [--no-export-all-symbols]
< [--exclude-symbols @var{list}]
< [--no-default-excludes]
< [-S|--as @var{path-to-assembler}] [-f|--as-flags @var{options}]
< [-D|--dllname @var{name}] [-m|--machine @var{machine}]
< [-a|--add-indirect] [-U|--add-underscore] [-k|--kill-at]
< [-A|--add-stdcall-alias]
< [-x|--no-idata4] [-c|--no-idata5] [-i|--interwork]
< [-n|--nodelete] [-v|--verbose] [-h|--help] [-V|--version]
---
> dlltool [@option{-d}|@option{--input-def} @var{def-file-name}]
> [@option{-b}|@option{--base-file} @var{base-file-name}]
> [@option{-e}|@option{--output-exp} @var{exports-file-name}]
> [@option{-z}|@option{--output-def} @var{def-file-name}]
> [@option{-l}|@option{--output-lib} @var{library-file-name}]
> [@option{--export-all-symbols}] [@option{--no-export-all-symbols}]
> [@option{--exclude-symbols} @var{list}]
> [@option{--no-default-excludes}]
> [@option{-S}|@option{--as} @var{path-to-assembler}] [@option{-f}|@option{--as-flags} @var{options}]
> [@option{-D}|@option{--dllname} @var{name}] [@option{-m}|@option{--machine} @var{machine}]
> [@option{-a}|@option{--add-indirect}] [@option{-U}|@option{--add-underscore}] [@option{-k}|@option{--kill-at}]
> [@option{-A}|@option{--add-stdcall-alias}]
> [@option{-x}|@option{--no-idata4}] [@option{-c}|@option{--no-idata5}] [@option{-i}|@option{--interwork}]
> [@option{-n}|@option{--nodelete}] [@option{-v}|@option{--verbose}]
> [@option{-h}|@option{--help}] [@option{-V}|@option{--version}]
2540,2546c2546,2553
< @code{dlltool} reads its inputs, which can come from the @samp{-d} and
< @samp{-b} options as well as object files specified on the command
< line. It then processes these inputs and if the @samp{-e} option has
< been specified it creates a exports file. If the @samp{-l} option
< has been specified it creates a library file and if the @samp{-z} option
< has been specified it creates a def file. Any or all of the -e, -l
< and -z options can be present in one invocation of dlltool.
---
> @command{dlltool} reads its inputs, which can come from the @option{-d} and
> @option{-b} options as well as object files specified on the command
> line. It then processes these inputs and if the @option{-e} option has
> been specified it creates a exports file. If the @option{-l} option
> has been specified it creates a library file and if the @option{-z} option
> has been specified it creates a def file. Any or all of the @option{-e},
> @option{-l} and @option{-z} options can be present in one invocation of
> dlltool.
2549c2556
< to have three other files. @code{dlltool} can help with the creation of
---
> to have three other files. @command{dlltool} can help with the creation of
2554,2555c2561,2562
< is a text file and can be created by hand, or @code{dlltool} can be used
< to create it using the @samp{-z} option. In this case @code{dlltool}
---
> is a text file and can be created by hand, or @command{dlltool} can be used
> to create it using the @option{-z} option. In this case @command{dlltool}
2561c2568
< have an @samp{-export:<name_of_function>} entry in the @samp{.drectve}
---
> have an @option{-export:<name_of_function>} entry in the @samp{.drectve}
2575,2576c2582,2583
< binary file and it can be created by giving the @samp{-e} option to
< @code{dlltool} when it is creating or reading in a .def file.
---
> binary file and it can be created by giving the @option{-e} option to
> @command{dlltool} when it is creating or reading in a .def file.
2580c2587
< can be created by giving the @samp{-l} option to dlltool when it
---
> can be created by giving the @option{-l} option to dlltool when it
2583c2590
< @code{dlltool} builds the library file by hand, but it builds the
---
> @command{dlltool} builds the library file by hand, but it builds the
2585c2592
< and then assembling these. The @samp{-S} command line option can be
---
> and then assembling these. The @option{-S} command line option can be
2587,2589c2594,2596
< and the @samp{-f} option can be used to pass specific flags to that
< assembler. The @samp{-n} can be used to prevent dlltool from deleting
< these temporary assembler files when it is done, and if @samp{-n} is
---
> and the @option{-f} option can be used to pass specific flags to that
> assembler. The @option{-n} can be used to prevent dlltool from deleting
> these temporary assembler files when it is done, and if @option{-n} is
2610c2617
< @table @code
---
> @table @env
2639c2646
< are not exported by default; see the @code{--no-default-excludes}
---
> are not exported by default; see the @option{--no-default-excludes}
2641c2648
< @code{--exclude-symbols} option.
---
> @option{--exclude-symbols} option.
2653c2660
< @code{--export-all-symbols} is used.
---
> @option{--export-all-symbols} is used.
2656c2663
< When @code{--export-all-symbols} is used, it will by default avoid
---
> When @option{--export-all-symbols} is used, it will by default avoid
2659c2666
< @samp{impure_ptr}. You may use the @code{--no-default-excludes} option
---
> @samp{impure_ptr}. You may use the @option{--no-default-excludes} option
2661c2668
< when @code{--export-all-symbols} is used.
---
> when @option{--export-all-symbols} is used.
2672c2679
< the @samp{-S} option is not used. This option only takes one argument,
---
> the @option{-S} option is not used. This option only takes one argument,
2681,2682c2688,2689
< when the @samp{-e} option is used. If this option is not present, then
< the filename given to the @samp{-e} option will be used as the name of
---
> when the @option{-e} option is used. If this option is not present, then
> the filename given to the @option{-e} option will be used as the name of
2688c2695
< built. @code{dlltool} has a built in default type, depending upon how
---
> built. @command{dlltool} has a built in default type, depending upon how
2695c2702
< Specifies that when @code{dlltool} is creating the exports file it
---
> Specifies that when @command{dlltool} is creating the exports file it
2702c2709
< Specifies that when @code{dlltool} is creating the exports file it
---
> Specifies that when @command{dlltool} is creating the exports file it
2707c2714
< Specifies that when @code{dlltool} is creating the exports file it
---
> Specifies that when @command{dlltool} is creating the exports file it
2714c2721
< Specifies that when @code{dlltool} is creating the exports file it
---
> Specifies that when @command{dlltool} is creating the exports file it
2720,2721c2727,2728
< Specifies that when @code{dlltool} is creating the exports and library
< files it should omit the .idata4 section. This is for compatibility
---
> Specifies that when @command{dlltool} is creating the exports and library
> files it should omit the @code{.idata4} section. This is for compatibility
2726,2727c2733,2734
< Specifies that when @code{dlltool} is creating the exports and library
< files it should omit the .idata5 section. This is for compatibility
---
> Specifies that when @command{dlltool} is creating the exports and library
> files it should omit the @code{.idata5} section. This is for compatibility
2732c2739
< Specifies that @code{dlltool} should mark the objects in the library
---
> Specifies that @command{dlltool} should mark the objects in the library
2738c2745
< Makes @code{dlltool} preserve the temporary assembler files it used to
---
> Makes @command{dlltool} preserve the temporary assembler files it used to
2775,2791c2782,2798
< readelf [ -a | --all ]
< [ -h | --file-header]
< [ -l | --program-headers | --segments]
< [ -S | --section-headers | --sections]
< [ -e | --headers]
< [ -s | --syms | --symbols]
< [ -n | --notes]
< [ -r | --relocs]
< [ -u | --unwind]
< [ -d | --dynamic]
< [ -V | --version-info]
< [ -D | --use-dynamic]
< [ -x <number> | --hex-dump=<number>]
< [ -w[liaprmf] | --debug-dump[=line,=info,=abbrev,=pubnames,=ranges,=macro,=frames]]
< [ --histogram]
< [ -v | --version]
< [ -H | --help]
---
> readelf [@option{-a}|@option{--all}]
> [@option{-h}|@option{--file-header}]
> [@option{-l}|@option{--program-headers}|@option{--segments}]
> [@option{-S}|@option{--section-headers}|@option{--sections}]
> [@option{-e}|@option{--headers}]
> [@option{-s}|@option{--syms}|@option{--symbols}]
> [@option{-n}|@option{--notes}]
> [@option{-r}|@option{--relocs}]
> [@option{-u}|@option{--unwind}]
> [@option{-d}|@option{--dynamic}]
> [@option{-V}|@option{--version-info}]
> [@option{-D}|@option{--use-dynamic}]
> [@option{-x} <number>|@option{--hex-dump=}<number>]
> [@option{-w[liaprmf]}|@option{--debug-dump}[=line,=info,=abbrev,=pubnames,=ranges,=macro,=frames]]
> [@option{-histogram}]
> [@option{-v}|@option{--version}]
> [@option{-H}|@option{--help}]
2798c2805
< @code{readelf} displays information about one or more ELF format object
---
> @command{readelf} displays information about one or more ELF format object
2802c2809
< moment, @code{readelf} does not support examining archives, nor does it
---
> moment, @command{readelf} does not support examining archives, nor does it
2813c2820
< @table @code
---
> @table @env
2816,2819c2823,2826
< Equivalent to specifiying @samp{--file-header},
< @samp{--program-headers}, @samp{--sections}, @samp{--symbols},
< @samp{--relocs}, @samp{--dynamic}, @samp{--notes} and
< @samp{--version-info}.
---
> Equivalent to specifiying @option{--file-header},
> @option{--program-headers}, @option{--sections}, @option{--symbols},
> @option{--relocs}, @option{--dynamic}, @option{--notes} and
> @option{--version-info}.
2850c2857
< Display all the headers in the file. Equivalent to @samp{-h -l -S}.
---
> Display all the headers in the file. Equivalent to @option{-h -l -S}.
2881c2888
< When displaying symbols, this option makes @code{readelf} use the
---
> When displaying symbols, this option makes @command{readelf} use the
2905c2912
< Display the command line options understood by @code{readelf}.
---
> Display the command line options understood by @command{readelf}.
2940c2947
< @samp{--enable-targets=all}, the commands list most of the available
---
> @option{--enable-targets=all}, the commands list most of the available
2975c2982
< @subheading @code{objdump} Target
---
> @subheading @command{objdump} Target
2981c2988
< command line option: @samp{-b} or @samp{--target}
---
> command line option: @option{-b} or @option{--target}
2990c2997
< @subheading @code{objcopy} and @code{strip} Input Target
---
> @subheading @command{objcopy} and @command{strip} Input Target
2996c3003
< command line options: @samp{-I} or @samp{--input-target}, or @samp{-F} or @samp{--target}
---
> command line options: @option{-I} or @option{--input-target}, or @option{-F} or @option{--target}
3005c3012
< @subheading @code{objcopy} and @code{strip} Output Target
---
> @subheading @command{objcopy} and @command{strip} Output Target
3011c3018
< command line options: @samp{-O} or @samp{--output-target}, or @samp{-F} or @samp{--target}
---
> command line options: @option{-O} or @option{--output-target}, or @option{-F} or @option{--target}
3014c3021
< the input target (see ``@code{objcopy} and @code{strip} Input Target'' above)
---
> the input target (see ``@command{objcopy} and @command{strip} Input Target'' above)
3023c3030
< @subheading @code{nm}, @code{size}, and @code{strings} Target
---
> @subheading @command{nm}, @command{size}, and @command{strings} Target
3029c3036
< command line option: @samp{--target}
---
> command line option: @option{--target}
3044c3051
< command line option: @samp{-b} or @samp{--format}
---
> command line option: @option{-b} or @option{--format}
3066c3073
< command line option: @samp{-oformat}
---
> command line option: @option{-oformat}
3089c3096
< @subheading @code{objdump} Architecture
---
> @subheading @command{objdump} Architecture
3095c3102
< command line option: @samp{-m} or @samp{--architecture}
---
> command line option: @option{-m} or @option{--architecture}
3101c3108
< @subheading @code{objcopy}, @code{nm}, @code{size}, @code{strings} Architecture
---
> @subheading @command{objcopy}, @command{nm}, @command{size}, @command{strings} Architecture
3160c3167
< command line option: @samp{-m}
---
> command line option: @option{-m}
3261c3268
< with the @samp{--version} argument.
---
> with the @option{--version} argument.
3296c3303
< (e.g., @code{gcc}, @code{gas}, and/or the @sc{gnu} @code{ld}), then it
---
> (e.g., @command{gcc}, @command{gas}, and/or the @sc{gnu} @command{ld}), then it
3298c3305
< this case, be sure to say exactly what version of @code{gcc}, or
---
> this case, be sure to say exactly what version of @command{gcc}, or
3300c3307
< @code{gcc}, or whatever, was configured.
---
> @command{gcc}, or whatever, was configured.
3322c3329
< generated by @code{diff} with the @samp{-u}, @samp{-c}, or @samp{-p}
---
> generated by @command{diff} with the @option{-u}, @option{-c}, or @option{-p}
3324c3331
< wish to discuss something in the @code{ld} source, refer to it by
---
> wish to discuss something in the @command{ld} source, refer to it by