[Issue 11823] New: ddoc: __FILE__ and other built-in symbols with underscores should be specially parsed

d-bugmail at puremagic.com d-bugmail at puremagic.com
Thu Dec 26 05:03:16 PST 2013


https://d.puremagic.com/issues/show_bug.cgi?id=11823

           Summary: ddoc: __FILE__ and other built-in symbols with
                    underscores should be specially parsed
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: DMD
        AssignedTo: nobody at puremagic.com
        ReportedBy: andrej.mitrovich at gmail.com


--- Comment #0 from Andrej Mitrovic <andrej.mitrovich at gmail.com> 2013-12-26 05:03:14 PST ---
http://dlang.org/phobos/std_exception.html#.assertNotThrown

string file     The file where the error occurred. Defaults to _FILE__.

Note the "_FILE__" instead of "__FILE__". This is because ddoc has a special
feature allowing you to avoid highlighting symbols in the output, e.g.:

-----
/// This function foo is named _foo
void foo() { }
-----

This will highlight the first foo word but not the second.

However, for __FILE__ and other built-in symbols beginning with an underscore
ddoc should probably avoid interpreting the leading underscore as an attempt to
de-emphasize the symbol, and instead just output these symbols as-is.

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


More information about the Digitalmars-d-bugs mailing list