Library standardization

[Robert Fraser]

Walter Bright wrote:
>> - There should be some kind of feature to automatically copy the 
>> "documentation comments" (ddoc, doxygen, etc) from the .d files to the 
>> .di files when they are generated. A solution would be to 
>> automatically include all comments which are not in implementation code.
> 
> The human-readable form is the ddoc output.

IDEs generally expect the documentation to be there along with the 
header. Sure, there could be a way to link extra docs (i.e. Eclipse JDT 
allows you to link Javadoc for .class files), but this is extra work for 
the programmer.