Worst Phobos documentation evar!

[Ary Borenszweig via Digitalmars-d]

On 12/29/14 8:49 PM, Walter Bright wrote:
> On 12/29/2014 2:40 PM, Adam D. Ruppe wrote:
>> Ddoc isn't too bad, but trying to document examples in dom.d turned
>> into a mess
>> of /// finds $(LT)foo/$(GT) quickly and I couldn't stand it.
>
> I'd make a macro:
>
>     XML=$(LT)$0/$(GT)
>
> I use custom macros all the time in Ddoc. If you aren't, you're not
> doing it right :-)

Macros are for code, not for documentation.

When wanting to contrirbute documentation you'll have to learn which 
macros the author defined and which ones to use. Again, this makes it 
harder to write docs, not easier.