Worst Phobos documentation evar!

[Adam D. Ruppe via Digitalmars-d]

On Tuesday, 30 December 2014 at 01:45:09 UTC, Andrei Alexandrescu 
wrote:
>> Certain character sequences in LaTeX need to be escaped; for 
>> example "$"
>> needs to be written as "\$", whereas it can appear literally 
>> in HTML.
>> Again, the only solution is $(DOLLAR).
>
> Yah, as I said that's pretty much it. You need to encapsulate 
> special stuff in macros, which is all uniform and simple.


You know what drives me nuts about this? Ddoc's design has an 
elegant solution:

https://github.com/D-Programming-Language/dmd/blob/master/src/doc.c#L230

The ESCAPES thing. It is right there... been there for years... 
but not actually used. And now I think we're stuck with this 
nonsense since there's real world code that uses the html 
passthrough "feature".