On Wed, Oct 21, 2009 at 08:05:46PM -0500, AJ wrote: > Well of course header files will have comments. The thing is though, tomes > of documentation are not necessary you have header files. And what are the > chances that the documentation will be in synch with the code if the > documentation is external? Much better chance of that if the header file IS > the documentation and the code is crafted such that it needs very little > doc.
That's what ddoc is all about. http://www.digitalmars.com/d/2.0/ddoc.html /// Some little documentation int someFunction(int a, int b) { implementation } All in one file. -- Adam D. Ruppe http://arsdnet.net