ddoc: Can I escape a colon?

Adam D. Ruppe via Digitalmars-d-learn digitalmars-d-learn at puremagic.com
Thu Feb 23 13:35:41 PST 2017


On Thursday, 23 February 2017 at 21:17:33 UTC, H. S. Teoh wrote:
> 	_Note: Blah blabbety blah

Nope.

Ddoc considers [A-Za-z_]+: to be a section header. You can trick 
it by doing something like

/++
 Note: ass
+/

Yes, the html entity for a space. That trick's ddoc's stupid 
parser while being folded into surrounding whitespace by a html 
engine.

Of course, it breaks if the output is anything but html... and is 
just stupid....

Which leads me to the best solution: never use ddoc again.


More information about the Digitalmars-d-learn mailing list