No header files?

[Adam D. Ruppe]

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