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.
This commit is contained in:
Andrew Burgess 2020-05-05 15:48:13 +01:00
parent ff84cef42f
commit d11a9fabab
2 changed files with 11 additions and 4 deletions

View File

@ -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.

View File

@ -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}