[binutils-gdb] objcopy: Mention 'entry address' in description

Andrew Burgess aburgess@sourceware.org
Thu May 7 09:54:27 GMT 2020


https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=d11a9fabab657e592df9167535bc46804937cf18

commit d11a9fabab657e592df9167535bc46804937cf18
Author: Andrew Burgess <andrew.burgess@embecosm.com>
Date:   Tue May 5 15:48:13 2020 +0100

    objcopy: Mention 'entry address' in description
    
    The ELF header contains a start address, which is also sometimes
    called the entry address.  The 'objdump -x' output calls this field
    the 'start address', while readelf calls it 'entry point address'.
    The linker talks about setting the 'entry' point in its manual.
    
    I've always thought of this field as the 'entry address', and so when
    I recently wanted to know if objcopy could adjust this field I opened
    up the manual and searched for 'entry', which found no hits.
    
    I thought it would be useful (for people like me) if the description
    of 'set-start' and 'adjust-start' in the objcopy manual mentioned the
    word 'entry' to make it easier to find.
    
    binutils/ChangeLog:
    
            * doc/binutils.texi: Mention 'entry address' in the set-start and
            adjust-start options descriptions.

Diff:
---
 binutils/ChangeLog         |  5 +++++
 binutils/doc/binutils.texi | 10 ++++++----
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/binutils/ChangeLog b/binutils/ChangeLog
index 7d00344eb0d..b1fc9511a92 100644
--- a/binutils/ChangeLog
+++ b/binutils/ChangeLog
@@ -1,3 +1,8 @@
+2020-05-07  Andrew Burgess  <andrew.burgess@embecosm.com>
+
+	* doc/binutils.texi: Mention 'entry address' in the set-start and
+	adjust-start options descriptions.
+
 2020-05-05  Nick Clifton  <nickc@redhat.com>
 
 	* dwarf.c (do_checks): New global variable.
diff --git a/binutils/doc/binutils.texi b/binutils/doc/binutils.texi
index 9a3a40f1476..3c8a50b5d98 100644
--- a/binutils/doc/binutils.texi
+++ b/binutils/doc/binutils.texi
@@ -1568,14 +1568,16 @@ done by increasing the size of the last section.  The extra space is
 filled in with the value specified by @option{--gap-fill} (default zero).
 
 @item --set-start @var{val}
-Set the start address of the new file to @var{val}.  Not all object file
-formats support setting the start address.
+Set the start address (also known as the entry address) of the new
+file to @var{val}.  Not all object file formats support setting the
+start address.
 
 @item --change-start @var{incr}
 @itemx --adjust-start @var{incr}
 @cindex changing start address
-Change the start address by adding @var{incr}.  Not all object file
-formats support setting the start address.
+Change the start address (also known as the entry address) by adding
+@var{incr}.  Not all object file formats support setting the start
+address.
 
 @item --change-addresses @var{incr}
 @itemx --adjust-vma @var{incr}


More information about the Binutils-cvs mailing list