[Bug ld/518] New: Documentation error for MEMORY command

[dk at artimi dot com]

As explained at

http://sources.redhat.com/ml/binutils/2004-03/msg00540.html

the documentation for ld's MEMORY command says this about the ORIGIN and 
LENGTH keywords:

------->snip<-------
The origin is an expression for the start address of the memory region. The 
expression must evaluate to a constant before memory allocation is performed, 
which means that you may not use any section relative symbols. The keyword 
ORIGIN may be abbreviated to org or o (but not, for example, ORG). 

The len is an expression for the size in bytes of the memory region. As with 
the origin expression, the expression must evaluate to a constant before 
memory allocation is performed. The keyword LENGTH may be abbreviated to len 
or l. 
------->snip<-------

but this is incorrect: in fact, neither ORIGIN nor LENGTH will accept anything 
except a numeric constant (expression?), and certainly not any kind of symbol 
at all.

  We've discussed this before, and basically reached the conclusion
(see http://sources.redhat.com/ml/binutils/2004-03/msg00571.html and thread)
that it's not going to get fixed in a hurry, so the documentation should be 
adjusted, either to say "This was supposed to work but never has", or perhaps 
to not even mention that it was ever an option (but that would perhaps 
discourage someone from picking up this problem at some future date and fixing 
it, so it might be more motivating to leave it documented as a broken feature).

  Since this issue just reared its head again on the mailing list, I'm filing 
this bug.  Should have done it way back when; sorry for letting it slip.

   cheers, 
      DaveK
-- 
Can't think of a witty .sigline today....

-- 
           Summary: Documentation error for MEMORY command
           Product: binutils
           Version: 2.15
            Status: NEW
          Severity: minor
          Priority: P2
         Component: ld
        AssignedTo: unassigned at sources dot redhat dot com
        ReportedBy: dk at artimi dot com
                CC: bug-binutils at gnu dot org
 GCC build triplet: all
  GCC host triplet: all
GCC target triplet: all


http://sources.redhat.com/bugzilla/show_bug.cgi?id=518

------- You are receiving this mail because: -------
You are on the CC list for the bug, or are watching someone who is.