* objcopy.c (filter_bytes): New function.

	(copy_section): Call it.
	(copy_options, copy_usage, copy_main): Add --byte option to
	activate it.  Appropriate the -b option (which was an undocumented
	synonym for -F) for it, also.  Add --interleave, -i option for
	additional control.
	(setup_section, copy_section, mangle_section): Renamed with no `s'
	on the end.
	* objcopy.1, binutils.texi: Document the new options.

	* objdump.c (display_target_tables, display_target_list):
	New functions broken out of display_info.
	Eliminate some magic constants.  Use more meaningful variable names.
	(dump_bfd_header): New function broken out of display_bfd.
	(dump_section_header): New function broken out of dump_headers.
	(remove_useless_symbols): Don't shadow global variable name with
	parameter.
	(objdump_print_address): Fix backward test.

1 files changed, 14 insertions, 5 deletions

diff --git a/binutils/binutils.texi b/binutils/binutils.texi
index 7187b7e..003f63e 100644
--- a/binutils/binutils.texi
+++ b/binutils/binutils.texi
@@ -731,8 +731,9 @@ objcopy [ -F @var{bfdname} | --target=@var{bfdname} ]
         [ -O @var{bfdname} | --output-target=@var{bfdname} ]
         [ -S | --strip-all ]  [ -g | --strip-debug ]
         [ -x | --discard-all ]  [ -X | --discard-locals ]
-        [ -b @var{byte} | --byte=@var{byte} ]  [ -v | --verbose ]
-        [ -V | --version ]  [ --help ]
+        [ -b @var{byte} | --byte=@var{byte} ]
+        [ -i @var{interleave} | --interleave=@var{interleave} ]
+        [ -v | --verbose ] [ -V | --version ]  [ --help ]
         @var{infile} [@var{outfile}]
 @end smallexample
 
@@ -793,9 +794,17 @@ Do not copy compiler-generated local symbols.
 @item -b @var{byte}
 @itemx --byte=@var{byte}
 Keep only every @var{byte}th byte of the input file (header data is not
-affected).  @var{byte} can be in the range from 0 to 3.  This option is
-useful for creating files to program 4 ROMs to create 32-bit words.  It
-is typically used with an @code{srec} output target.
+affected).  @var{byte} can be in the range from 0 to @var{interleave}-1,
+where @var{interleave} is given by the @samp{-i} or @samp{--interleave}
+option, or the default of 4.  This option is useful for creating files
+to program ROMs.  It is typically used with an @code{srec} output
+target.
+
+@item -i @var{interleave}
+@itemx --interleave=@var{interleave}
+Only copy one out of every @var{interleave} bytes.  Which one to copy is
+selected by the @var{-b} or @samp{--byte} option.  The default is 4.
+The interleave is ignored if neither @samp{-b} nor @samp{--byte} is given.
 
 @item -V
 @itemx --version