I would agree that macros are a bit hard to read in ddoc. There's some
nice ideas in this thread.
Luckily I don't get to see garbage like this in D code:
/// <summary>
/// Required designer variable.
/// </summary>
private System.ComponentModel.Container components = null;
Really, you need XML tags to give me 3 words of information that I
could live without? It basically guarantees nobody will touch the
language without an XML processing IDE/editor. Maybe VIM/Emacs do have
XML processing built in so they can hide this thing, but a single '//'
would do just fine here, no? :)