This is precisely the wrong way to fix this. DDoc needs to be
fixed in the compiler. It's one of the lowest hanging fruits I
think we have (a great concept (using compiler knowledge of
code structure to generate documentaiton) that is poorly
implemented).
-Steve
Would be a good change to move from ugly macros that make you cry
to
something more suitable like pythons sphinx.
The output should be roughly compatible and a pragma(doc,
sphinxalike) at the
top of the module lets the compiler use the new system.
