Bug 11823 – ddoc: built-in symbols with leading underscore should be specially parsed

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.

I'm not sure this is the right approach. An alternative is to recognize __FILE__, etc., as special.

(In reply to comment #2) > I'm not sure this is the right approach. An alternative is to recognize > __FILE__, etc., as special. Well according to the spec compiler-reserved symbols start with double underscores, so I picked that approach. I guess we could instead implement an isBuiltinSymbol check?

(In reply to comment #3) > (In reply to comment #2) > > I'm not sure this is the right approach. An alternative is to recognize > > __FILE__, etc., as special. > > Well according to the spec compiler-reserved symbols start with double > underscores, so I picked that approach. I guess we could instead implement an > isBuiltinSymbol check? Even if double-underscored symbols are reserved in language spec, users can use them in their own own responsibility. (currently dmd does not reject defining such names). Therefore I think isBuiltinSymbol check would be better, because it is more conservative way.

Commits pushed to master at https://github.com/D-Programming-Language/dmd https://github.com/D-Programming-Language/dmd/commit/85464688ef3fcadbfe1537bcc72eb4b7ebdd9fca Fixes Issue 11823 - Ddoc symbol with a double underscore prefix should be specially parsed. https://github.com/D-Programming-Language/dmd/commit/706dd3928d817fc05cc830a36b471cd0e094f9ae Merge pull request #3180 from AndrejMitrovic/Fix11823 Issue 11823 - Ddoc symbol with a double underscore prefix should be specially parsed.