From eed5eeab82f30c1ac11c2cfc90093364de995681 Mon Sep 17 00:00:00 2001 From: David MacKenzie Date: Sat, 30 Oct 1993 02:24:39 +0000 Subject: [PATCH] put objcopy in alphabetical order --- binutils/binutils.texi | 172 ++++++++++++++++++++--------------------- 1 file changed, 86 insertions(+), 86 deletions(-) diff --git a/binutils/binutils.texi b/binutils/binutils.texi index f8cf76b27da..8ce3360b1f1 100644 --- a/binutils/binutils.texi +++ b/binutils/binutils.texi @@ -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 -- 2.30.2