Improving ddoc

[Adam D. Ruppe via Digitalmars-d]

On Thursday, 1 January 2015 at 19:57:56 UTC, Walter Bright wrote:
> Is also hard to read. Yes, I'm being facetious, but take a look 
> at those examples posted here about how ugly Ddoc is - they're 
> of that category.

The difference is the ddoc code posted here is copied verbatim  
from a real world project, Phobos, even the standard library.

Why the hell were they written that way in the first place? Beats 
the crap out of me, but they ARE written that way...