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> 2014-12-22 H.J. Lu <hongjiu.lu@intel.com>
* dwarf.c (read_cie): Cast size to long to warn. * 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{-R}|@option{--dynamic-reloc}]
[@option{-s}|@option{--full-contents}] [@option{-s}|@option{--full-contents}]
[@option{-W[lLiaprmfFsoRt]}| [@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{-G}|@option{--stabs}]
[@option{-t}|@option{--syms}] [@option{-t}|@option{--syms}]
[@option{-T}|@option{--dynamic-syms}] [@option{-T}|@option{--dynamic-syms}]
@ -2095,19 +2098,35 @@ compilers.
For the x86, some of the options duplicate functions of the @option{-m} For the x86, some of the options duplicate functions of the @option{-m}
switch, but allow finer grained control. Multiple selections from the switch, but allow finer grained control. Multiple selections from the
following may be specified as a comma separated string. following may be specified as a comma separated string.
@option{x86-64}, @option{i386} and @option{i8086} select disassembly for @table @code
the given architecture. @option{intel} and @option{att} select between @item x86-64
intel syntax mode and AT&T syntax mode. @itemx i386
@option{intel-mnemonic} and @option{att-mnemonic} select between @itemx i8086
intel mnemonic mode and AT&T mnemonic mode. @option{intel-mnemonic} Select disassembly for the given architecture.
implies @option{intel} and @option{att-mnemonic} implies @option{att}.
@option{addr64}, @option{addr32}, @item intel
@option{addr16}, @option{data32} and @option{data16} specify the default @itemx att
address size and operand size. These four options will be overridden if Select between intel syntax mode and AT&T syntax mode.
@option{x86-64}, @option{i386} or @option{i8086} appear later in the
option string. Lastly, @option{suffix}, when in AT&T mode, @item intel-mnemonic
instructs the disassembler to print a mnemonic suffix even when the @itemx att-mnemonic
suffix could be inferred by the operands. 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 For PowerPC, @option{booke} controls the disassembly of BookE
instructions. @option{32} and @option{64} select PowerPC and 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 argument @var{options} is a comma separated list that depends on the
format (the lists of options is displayed with the help). format (the lists of options is displayed with the help).
For XCOFF, the available options are: @option{header}, @option{aout}, For XCOFF, the available options are:
@option{sections}, @option{syms}, @option{relocs}, @option{lineno}, @table @code
@option{loader}, @option{except}, @option{typchk}, @option{traceback}, @item header
@option{toc} and @option{ldinfo}. @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 @item -r
@itemx --reloc @itemx --reloc
@ -2251,7 +2284,10 @@ Display @var{width} bytes on a single line when disassembling
instructions. instructions.
@item -W[lLiaprmfFsoRt] @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 DWARF
@cindex debug symbols @cindex debug symbols
Displays the contents of the debug sections in the file, if any are Displays the contents of the debug sections in the file, if any are