dlangspec.pdf?

[Adam D. Ruppe]

On Monday, 7 January 2013 at 17:32:33 UTC, H. S. Teoh wrote:
> I think the simplest way would be to allow the definition of 
> some kind of post-processing filter that escapes LaTeX
> metacharacters with their appropriate substitutions.

Believe it or not, but dmd already has the beginnings of this 
code! There's a ddoc escapes table.

from doc.c:

ESCAPES = /</</\n
           />/>/\n
           /&/&/\n


And there's code to parse it, but it isn't actually used. I did a 
dmd pull request a while ago to bring in this functionality but 
it didn't pass reviews. (A consequence of proper escaping would 
be that inline HTML, outside of macros, would no longer be 
permitted, because <b> etc would be properly escaped instead of 
printed out verbatim. This is far, far, far superior to the 
status quo, but it does break a lot of phobos documentation.)