[Bug binutils/31659] New: Fix Windows DEF file documentation

[pali at kernel dot org]

https://sourceware.org/bugzilla/show_bug.cgi?id=31659

            Bug ID: 31659
           Summary: Fix Windows DEF file documentation
           Product: binutils
           Version: unspecified
            Status: UNCONFIRMED
          Severity: normal
          Priority: P2
         Component: binutils
          Assignee: unassigned at sourceware dot org
          Reporter: pali at kernel dot org
  Target Milestone: ---

binutils documentation for Windows DEF file is currently at these locations:

* https://sourceware.org/binutils/docs/binutils/def-file-format.html
* https://sourceware.org/binutils/docs/ld/WIN32.html

First one documents EXPORTS keyword as:

EXPORTS ( ( ( name1 [ = name2 ] ) | ( name1 = module-name . external-name ) ) [
== its_name ] [ integer ] [ NONAME ] [ CONSTANT ] [ DATA ] [ PRIVATE ] ) *

And second one as:

EXPORTS
  ( (  ( <name1> [ = <name2> ] )
     | ( <name1> = <module-name> . <external-name>))
  [ @ <integer> ] [NONAME] [DATA] [CONSTANT] [PRIVATE] [== <name3>] ) *


As can be seen these specifications differs. First one does not accept trailing
"== name3" for symbol aliasing and second one requires @ before integer for
specifying ordinal of the symbol.


Also the first one contains sentense "see PR binutils/13710 for more details"
but there is no hyperlink to which it referes. Also there is no explanation
where is that PR (pull request?).


Please update binutils documentations to specify format of DEF file correctly.
So that documentation would match the format used & supported by binutils.

-- 
You are receiving this mail because:
You are on the CC list for the bug.