[Issue 11050] New: DDoc should provide file and line information

[d-bugmail at puremagic.com]

http://d.puremagic.com/issues/show_bug.cgi?id=11050

           Summary: DDoc should provide file and line information
           Product: D
           Version: unspecified
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: enhancement
          Priority: P2
         Component: DMD
        AssignedTo: nobody at puremagic.com
        ReportedBy: andrei at erdani.com


--- Comment #0 from Andrei Alexandrescu <andrei at erdani.com> 2013-09-16 03:19:18 PDT ---
For each symbol described by ddoc, file and line information should be
available.

The file is global to the document so one DDOC_FILENAME macro definition should
be provided. The path is relative.

The line is per-symbol and should be provided as input to a macro
DDOC_DECL_LINE. That macro has two arguments, the symbol introduced and its
line. By default

DDOC_DECL_LINE = $1

meaning the line is ignored (for backward compatibility).

For example, if a symbol foobar is being introduced at line 359, ddoc will
expand 

DDOC_DECL(DDOC_DECL_LINE(foobar, 359))

which with the default definition will expand to

$(DT $(BIG foobar))

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------