put objcopy in alphabetical order
authorDavid MacKenzie <djm@cygnus>
Sat, 30 Oct 1993 02:24:39 +0000 (02:24 +0000)
committerDavid MacKenzie <djm@cygnus>
Sat, 30 Oct 1993 02:24:39 +0000 (02:24 +0000)
binutils/binutils.texi

index f8cf76b27da4b29412f93cc77748d6d2da14443a..8ce3360b1f12a0434460d443559e88d7742fd2d4 100644 (file)
@@ -92,12 +92,12 @@ utilities (collectively version 2.2):
 @item ar
 Create, modify, and extract from archives
 
-@item objcopy
-Copy and translate object files
-
 @item nm
 List symbols from object files
 
+@item objcopy
+Copy and translate object files
+
 @item objdump
 Display information from object files
 
@@ -117,9 +117,9 @@ Discard symbols
 
 @menu
 * ar::                          Create, modify, and extract from archives
-* objcopy::                    Copy and translate object files
 * ld:(ld)Overview.              Combine object and archive files
 * nm::                          List symbols from object files
+* objcopy::                    Copy and translate object files
 * objdump::                     Display information from object files
 * ranlib::                      Generate index to archive contents
 * size::                        List section sizes and total size
@@ -129,7 +129,7 @@ Discard symbols
 * Index::                       
 @end menu
 
-@node ar, objcopy, Top, Top
+@node ar, nm, Top, Top
 @chapter ar
 
 @kindex ar
@@ -543,85 +543,6 @@ Requires prior use of @code{OPEN} or @code{CREATE}.
 
 @end table
 
-@node objcopy, nm, ar, Top
-@chapter objcopy
-
-@smallexample
-objcopy [ -F @var{format} | --format=@var{format} ]
-        [ -I @var{format} | --input-format=@var{format} ]
-        [ -O @var{format} | --output-format=@var{format} ]
-        [ -S | --strip-all ]  [ -g | --strip-debug ]
-        [ -x | --discard-all ]  [ -X | --discard-locals ]
-        [ -v | --verbose ]  [ -V | --version ]  [ --help ]
-        @var{infile} [@var{outfile}]
-@end smallexample
-
-The GNU @code{objcopy} utility copies the contents of an object file to
-another.  @code{objcopy} uses the GNU BFD Library to read and write the
-object files.  It can write the destination object file in a format
-different from that of the source object file.  The exact behavior of
-@code{objcopy} is controlled by command-line options.
-
-@code{objcopy} creates temporary files to do its translations and
-deletes them afterward.  @code{objcopy} uses BFD to do all its
-translation work; it knows about all the formats BFD knows about, and
-thus is able to recognize most formats without being told explicitly.
-@xref{BFD,,BFD,ld.info,Using LD, the GNU linker}.
-
-@table @code
-@item @var{infile}
-@itemx @var{outfile}
-The source and output files respectively.
-If you do not specify @var{outfile}, @code{objcopy} creates a
-temporary file and destructively renames the result with
-the name of the input file.
-
-@item -I @var{format}  
-@itemx --input-format=@var{format}
-Consider the source file's object format to be @var{format}, rather than
-attempting to deduce it.
-
-@item -O @var{format}
-@itemx --output-format=@var{format}
-Write the output file using the object format @var{format}.
-
-@item -F @var{format}
-@itemx --format=@var{format}
-Use @var{format} as the object format for both the input and the output
-file; i.e. simply transfer data from source to destination with no
-translation.
-
-@item -S
-@itemx --strip-all
-Do not copy relocation and symbol information from the source file.
-
-@item -g
-@itemx --strip-debug
-Do not copy debugging symbols from the source file.
-
-@item -x
-@itemx --discard-all
-Do not copy non-global symbols from the source file.
-@c FIXME any reason to prefer "non-global" to "local" here?
-
-@item -X
-@itemx --discard-locals
-Do not copy compiler-generated local symbols.
-(These usually start with @samp{L} or @samp{.}.)
-
-@item -V
-@itemx --version
-Show the version number of @code{objcopy}.
-
-@item -v
-@itemx --verbose
-Verbose output: list all object files modified.  In the case of
-archives, @samp{objcopy -V} lists all members of the archive.
-
-@item --help
-Show a summary of the options to @code{objcopy}.
-@end table
-
 @iftex
 @node ld
 @chapter ld
@@ -631,7 +552,7 @@ The GNU linker @code{ld} is now described in a separate manual.
 @xref{Top,, Overview,, Using LD: the GNU linker}.
 @end iftex
 
-@node nm, objdump, objcopy, Top
+@node nm, objcopy, ar, Top
 @chapter nm
 @cindex symbols
 @kindex nm
@@ -792,7 +713,86 @@ Show the version number of @code{nm} and exit.
 Show a summary of the options to @code{nm} and exit.
 @end table
 
-@node objdump, ranlib, nm, Top
+@node objcopy, objdump, nm, Top
+@chapter objcopy
+
+@smallexample
+objcopy [ -F @var{format} | --format=@var{format} ]
+        [ -I @var{format} | --input-format=@var{format} ]
+        [ -O @var{format} | --output-format=@var{format} ]
+        [ -S | --strip-all ]  [ -g | --strip-debug ]
+        [ -x | --discard-all ]  [ -X | --discard-locals ]
+        [ -v | --verbose ]  [ -V | --version ]  [ --help ]
+        @var{infile} [@var{outfile}]
+@end smallexample
+
+The GNU @code{objcopy} utility copies the contents of an object file to
+another.  @code{objcopy} uses the GNU BFD Library to read and write the
+object files.  It can write the destination object file in a format
+different from that of the source object file.  The exact behavior of
+@code{objcopy} is controlled by command-line options.
+
+@code{objcopy} creates temporary files to do its translations and
+deletes them afterward.  @code{objcopy} uses BFD to do all its
+translation work; it knows about all the formats BFD knows about, and
+thus is able to recognize most formats without being told explicitly.
+@xref{BFD,,BFD,ld.info,Using LD, the GNU linker}.
+
+@table @code
+@item @var{infile}
+@itemx @var{outfile}
+The source and output files respectively.
+If you do not specify @var{outfile}, @code{objcopy} creates a
+temporary file and destructively renames the result with
+the name of the input file.
+
+@item -I @var{format}  
+@itemx --input-format=@var{format}
+Consider the source file's object format to be @var{format}, rather than
+attempting to deduce it.
+
+@item -O @var{format}
+@itemx --output-format=@var{format}
+Write the output file using the object format @var{format}.
+
+@item -F @var{format}
+@itemx --format=@var{format}
+Use @var{format} as the object format for both the input and the output
+file; i.e. simply transfer data from source to destination with no
+translation.
+
+@item -S
+@itemx --strip-all
+Do not copy relocation and symbol information from the source file.
+
+@item -g
+@itemx --strip-debug
+Do not copy debugging symbols from the source file.
+
+@item -x
+@itemx --discard-all
+Do not copy non-global symbols from the source file.
+@c FIXME any reason to prefer "non-global" to "local" here?
+
+@item -X
+@itemx --discard-locals
+Do not copy compiler-generated local symbols.
+(These usually start with @samp{L} or @samp{.}.)
+
+@item -V
+@itemx --version
+Show the version number of @code{objcopy}.
+
+@item -v
+@itemx --verbose
+Verbose output: list all object files modified.  In the case of
+archives, @samp{objcopy -V} lists all members of the archive.
+
+@item --help
+Show a summary of the options to @code{objcopy}.
+@end table
+
+@node objdump, ranlib, objcopy, Top
 @chapter objdump
 
 @cindex object file information