I'm not sure if this was mentioned earlier, I
haven't read about it in the thread yet and I figure that it is worth
mentioning.
There is an inline documentation system that (I
feel) is worth taking a look at. It seems to generate good documentation
with a minimum of extra symbols and such.
Have fun,
Jon
I've
put up a strawman proposal for embedding documentation in comments at
www.digitalmars.com/d/doc.html