* objdump.c (_DUMMY_NAME_): Don't define.

[deliverable/binutils-gdb.git] / binutils / objcopy.1

diff --git a/binutils/objcopy.1 b/binutils/objcopy.1
index 64d1c36e59d1162db192766481054c40a94aa134..4ba11646d72d0b94904aa94b145fd5f316b30eef 100644 (file)
--- a/binutils/objcopy.1
+++ b/binutils/objcopy.1
@@ -15,18 +15,20 @@ objcopy \- copy and translate object files
 .na
 .TP
 .B objcopy
-.RB "[\|" \-F \fIformat\fB | \-\-format=\fIformat\fB "\|]" 
-.RB "[\|" \-I \fIformat\fB | \-\-input\-format=\fIformat\fB "\|]" 
-.RB "[\|" \-O \fIformat\fB | \-\-output\-format=\fIformat\fB "\|]" 
-.RB "[\|" \-S | \-\-strip\-all "\|]" 
-.RB "[\|" \-g | \-\-strip\-debug "\|]" 
-.RB "[\|" \-x | \-\-discard\-all "\|]" 
-.RB "[\|" \-X | \-\-discard\-locals "\|]" 
-.RB "[\|" \-v | \-\-verbose "\|]" 
-.RB "[\|" \-V | \-\-version "\|]" 
-.RB "[\|" \-\-help "\|]" 
+.RB "[\|" \-F\ \fIbfdname\fB\ |\ \-\-target=\fIbfdname\fR "\|]" 
+.RB "[\|" \-I\ \fIbfdname\fB\ |\ \-\-input\-target=\fIbfdname\fR "\|]" 
+.RB "[\|" \-O\ \fIbfdname\fB\ |\ \-\-output\-target=\fIbfdname\fR "\|]" 
+.RB "[\|" \-S\ |\ \-\-strip\-all\fR "\|]" 
+.RB "[\|" \-g\ |\ \-\-strip\-debug\fR "\|]" 
+.RB "[\|" \-x\ |\ \-\-discard\-all\fR "\|]" 
+.RB "[\|" \-X\ |\ \-\-discard\-locals\fR "\|]" 
+.RB  "[\|" \-b\ \fIbyte\fP |\ \-\-byte=\fIbyte\fP "\|]" 
+.RB  "[\|" \-i\ \fIinterleave\fP |\ \-\-interleave=\fIinterleave\fP "\|]" 
+.RB "[\|" \-v\ |\ \-\-verbose\fR "\|]" 
+.RB "[\|" \-V\ |\ \-\-version\fR "\|]" 
+.RB "[\|" \-\-help\fR "\|]" 
 .B infile
-.RB "[\|" outfile "\|]" 
+.RB "[\|" outfile\fR "\|]" 
 .SH DESCRIPTION
 The GNU 
 .B objcopy
@@ -57,57 +59,50 @@ name of the input file.
 
 .SH OPTIONS
 .TP
-.B \-I \fIformat
-.TP
-.B \-\-input\-format=\fIformat
+.B \-I \fIbfdname\fR, \fB\-\-input\-target=\fIbfdname
 Consider the source file's object format to be 
-.IR format ,
+.IR bfdname ,
 rather than attempting to deduce it.
 .TP
-.B \-O \fIformat
-.TP
-.B \-\-output\-format=\fIformat
+.B \-O \fIbfdname\fR, \fB\-\-output\-target=\fIbfdname
 Write the output file using the object format 
-.IR format .
-.TP
-.B \-F \fIformat\fB
+.IR bfdname .
 .TP
-.B \-\-format=\fIformat
+.B \-F \fIbfdname\fR, \fB\-\-target=\fIbfdname
 Use 
-.I format
+.I bfdname
 as the object format for both the input and the output file; i.e.
 simply transfer data from source to destination with no translation.
 .TP
-.B \-S
-.TP
-.B \-\-strip\-all
+.B \-S\fR, \fB\-\-strip\-all
 Do not copy relocation and symbol information from the source file.
 .TP
-.B \-g
-.TP
-.B \-\-strip\-debug
+.B \-g\fR, \fB\-\-strip\-debug
 Do not copy debugging symbols from the source file.
 .TP
-.B \-x
-.TP
-.B \-\-discard\-all
+.B \-x\fR, \fB \-\-discard\-all
 Do not copy non-global symbols from the source file.
 .TP
-.B \-X
-.TP
-.B \-\-discard\-locals
+.B \-X\fR, \fB\-\-discard\-locals
 Do not copy compiler-generated local symbols. (These usually start
 with "L" or ".").
 .TP
-.B \-v
+.B \-b \fIbyte\fR, \fB\-\-byte=\fIbyte
+Keep only every \fIbyte\fPth byte of the input file (header data is
+not affected).  \fIbyte\fP can be in the range from 0 to the
+interleave-1.  This option is useful for creating files to program
+ROMs.  It is typically used with an srec output target.
 .TP
-.B \-\-verbose
+.B \-i \fIinterleave\fR, \fB\-\-interleave=\fIinterleave
+Only copy one out of every \fIinterleave\fP bytes.  Which one to copy is
+selected by the \fB\-b\fP or \fB\-\-byte\fP option.  The default is 4.
+The interleave is ignored if neither \fB\-b\fP nor \fB\-\-byte\fP is given.
+.TP
+.B \-v\fR, \fB\-\-verbose
 Verbose output: list all object files modified.  In the case of
 archives, "\fBobjcopy \-V\fR" lists all members of the archive.
 .TP
-.B \-V
-.TP
-.B \-\-version
+.B \-V\fR, \fB\-\-version
 Show the version number of
 .B objcopy
 and exit.