* objcopy.c (compare_section_lma): Rename from _vma.

	(copy_object): Gap fill based on LMA not VMA.
	* binutils.texi: Update and clarify.
	* objcopy.1: Likewise.

PR 14917

diff --git a/binutils/binutils.texi b/binutils/binutils.texi
index 95291fd695b20648f189eb581612d7418451f4ee..b56035e1d22b03bb5dcd00c567d8b1771ccf2f83 100644 (file)
--- a/binutils/binutils.texi
+++ b/binutils/binutils.texi
@@ -960,12 +960,13 @@ because only certain debugging formats are supported, and the
 conversion process can be time consuming.
 
 @item --gap-fill @var{val}
-Fill gaps between sections with @var{val}.  This is done by increasing
+Fill gaps between sections with @var{val}.  This operation applies to
+the @emph{load address} (LMA) of the sections.  It is done by increasing
 the size of the section with the lower address, and filling in the extra
 space created with @var{val}.
 
 @item --pad-to @var{address}
-Pad the output file up to the virtual address @var{address}.  This is
+Pad the output file up to the load address @var{address}.  This is
 done by increasing the size of the last section.  The extra space is
 filled in with the value specified by @samp{--gap-fill} (default zero).
 

diff --git a/binutils/objcopy.1 b/binutils/objcopy.1
index 07c52ece2c8e2540e755d0bb9c6acc2814d3f3f9..6c98df8d32ad2fbd448ec1de27b833b89aee4be6 100644 (file)
--- a/binutils/objcopy.1
+++ b/binutils/objcopy.1
@@ -178,12 +178,13 @@ because only certain debugging formats are supported, and the
 conversion process can be time consuming.
 .TP
 .B \-\-gap\-fill=\fIval
-Fill gaps between sections with \fIval\fP.  This is done by increasing
+Fill gaps between sections with \fIval\fP.  This operation applies to
+the \fIload address\fP (LMA) of the sections.  It is done by increasing
 the size of the section with the lower address, and filling in the extra
 space created with \fIval\fP.
 .TP
 .B \-\-pad\-to=\fIaddress
-Pad the output file up to the virtual address \fIaddress\fP.  This is
+Pad the output file up to the load address \fIaddress\fP.  This is
 done by increasing the size of the last section.  The extra space is
 filled in with the value specified by \fB\-\-gap\-fill\fP (default
 zero).