Worst Phobos documentation evar!

[Andrei Alexandrescu via Digitalmars-d]

On 12/29/14 5:49 PM, Adam D. Ruppe wrote:
> 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".

Oh yah! https://github.com/D-Programming-Language/dlang.org/pull/271 
(which I'm breaking into bite-sized pieces) uses it! -- Andrei