public inbox for binutils@sourceware.org
 help / color / mirror / Atom feed
* [PATCH] objcopy: Mention 'entry address' in description
@ 2020-05-05 14:54 Andrew Burgess
  2020-05-07  9:51 ` Nick Clifton
  0 siblings, 1 reply; 2+ messages in thread
From: Andrew Burgess @ 2020-05-05 14:54 UTC (permalink / raw)
  To: binutils

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.
---
 binutils/ChangeLog         |  5 +++++
 binutils/doc/binutils.texi | 10 ++++++----
 2 files changed, 11 insertions(+), 4 deletions(-)

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


^ permalink raw reply	[flat|nested] 2+ messages in thread

* Re: [PATCH] objcopy: Mention 'entry address' in description
  2020-05-05 14:54 [PATCH] objcopy: Mention 'entry address' in description Andrew Burgess
@ 2020-05-07  9:51 ` Nick Clifton
  0 siblings, 0 replies; 2+ messages in thread
From: Nick Clifton @ 2020-05-07  9:51 UTC (permalink / raw)
  To: Andrew Burgess, binutils

Hi Andrew,

> binutils/ChangeLog:
> 
> 	* doc/binutils.texi: Mention 'entry address' in the set-start and
> 	adjust-start options descriptions.

Approved - please apply.

Cheers
  Nick


^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2020-05-07  9:51 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-05-05 14:54 [PATCH] objcopy: Mention 'entry address' in description Andrew Burgess
2020-05-07  9:51 ` Nick Clifton

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).