Reformat the objdump.1 man output to avoid overlong lines.

This commit is contained in:
Nick Clifton 2014-12-23 13:11:10 +00:00
parent 422f1c65c9
commit c4416f3035
2 changed files with 59 additions and 19 deletions

View File

@ -1,3 +1,7 @@
2014-12-23 Nick Clifton <nickc@redhat.com>
* doc/binutils.texi (objdump): Reformat to avoid overlong lines.
2014-12-22 H.J. Lu <hongjiu.lu@intel.com>
* dwarf.c (read_cie): Cast size to long to warn.

View File

@ -1858,7 +1858,10 @@ objdump [@option{-a}|@option{--archive-headers}]
[@option{-R}|@option{--dynamic-reloc}]
[@option{-s}|@option{--full-contents}]
[@option{-W[lLiaprmfFsoRt]}|
@option{--dwarf}[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index]]
@option{--dwarf}[=rawline,=decodedline,=info,=abbrev,=pubnames]
[=aranges,=macro,=frames,=frames-interp,=str,=loc]
[=Ranges,=pubtypes,=trace_info,=trace_abbrev]
[=trace_aranges,=gdb_index]
[@option{-G}|@option{--stabs}]
[@option{-t}|@option{--syms}]
[@option{-T}|@option{--dynamic-syms}]
@ -2095,19 +2098,35 @@ compilers.
For the x86, some of the options duplicate functions of the @option{-m}
switch, but allow finer grained control. Multiple selections from the
following may be specified as a comma separated string.
@option{x86-64}, @option{i386} and @option{i8086} select disassembly for
the given architecture. @option{intel} and @option{att} select between
intel syntax mode and AT&T syntax mode.
@option{intel-mnemonic} and @option{att-mnemonic} select between
intel mnemonic mode and AT&T mnemonic mode. @option{intel-mnemonic}
implies @option{intel} and @option{att-mnemonic} implies @option{att}.
@option{addr64}, @option{addr32},
@option{addr16}, @option{data32} and @option{data16} specify the default
address size and operand size. These four options will be overridden if
@option{x86-64}, @option{i386} or @option{i8086} appear later in the
option string. Lastly, @option{suffix}, when in AT&T mode,
instructs the disassembler to print a mnemonic suffix even when the
suffix could be inferred by the operands.
@table @code
@item x86-64
@itemx i386
@itemx i8086
Select disassembly for the given architecture.
@item intel
@itemx att
Select between intel syntax mode and AT&T syntax mode.
@item intel-mnemonic
@itemx att-mnemonic
Select between intel mnemonic mode and AT&T mnemonic mode.
Note: @code{intel-mnemonic} implies @code{intel} and
@code{att-mnemonic} implies @code{att}.
@item addr64
@itemx addr32
@itemx addr16
@itemx data32
@itemx data16
Specify the default address size and operand size. These four options
will be overridden if @code{x86-64}, @code{i386} or @code{i8086}
appear later in the option string.
@item suffix
When in AT&T mode, instructs the disassembler to print a mnemonic
suffix even when the suffix could be inferred by the operands.
@end table
For PowerPC, @option{booke} controls the disassembly of BookE
instructions. @option{32} and @option{64} select PowerPC and
@ -2191,10 +2210,24 @@ Print information that is specific to the object file format. The
argument @var{options} is a comma separated list that depends on the
format (the lists of options is displayed with the help).
For XCOFF, the available options are: @option{header}, @option{aout},
@option{sections}, @option{syms}, @option{relocs}, @option{lineno},
@option{loader}, @option{except}, @option{typchk}, @option{traceback},
@option{toc} and @option{ldinfo}.
For XCOFF, the available options are:
@table @code
@item header
@item aout
@item sections
@item syms
@item relocs
@item lineno,
@item loader
@item except
@item typchk
@item traceback
@item toc
@item ldinfo
@end table
Not all object formats support this option. In particular the ELF
format does not use it.
@item -r
@itemx --reloc
@ -2251,7 +2284,10 @@ Display @var{width} bytes on a single line when disassembling
instructions.
@item -W[lLiaprmfFsoRt]
@itemx --dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames,=aranges,=macro,=frames,=frames-interp,=str,=loc,=Ranges,=pubtypes,=trace_info,=trace_abbrev,=trace_aranges,=gdb_index]
@itemx --dwarf[=rawline,=decodedline,=info,=abbrev,=pubnames]
@itemx --dwarf[=aranges,=macro,=frames,=frames-interp,=str,=loc]
@itemx --dwarf[=Ranges,=pubtypes,=trace_info,=trace_abbrev]
@itemx --dwarf[=trace_aranges,=gdb_index]
@cindex DWARF
@cindex debug symbols
Displays the contents of the debug sections in the file, if any are