On 11/28/2011 05:41 PM, Alexey Veselovsky wrote:
Separate hand written specification is rulez for human. It is best
short module description (with some useful manually written comments).
I like it more then autogenerated docs (by doxygen and so on).
Autogenerated specifications (headers and so on) are worst and ugly.
But in language like java and C# it is last chance if there is no
autogenerated docs and sources.
The compiler _should_ enforce consistence between *.d and *.di files
when compiling the *.d file. It just does not because nobody has
implemented it. That is possibly because separate hand written
specification is rarely used in D development. (alternatively, it could
be the case that hand written specification is used rarely because DMD
does not check .d and .di for consistence.)
Autogeneration of *.di files does not have to be the normal case (and
currently it is so buggy that I managed to find a segfault bug in the
compiler while compiling a mis-generated *.di file!)
Also, auto generation can hardly even work satisfactory in the general
case, when there are many static if's/version statements or string mixin
declarations on module scope.