Put your comments about the official/non-official page here.
It is simply wretched that the hardware tab does not match the indentation level. I have seen source code where indentation is a mix between tabs and spaces. Terrible! The hardware tab should be 4 spaces, this is not 1983 after all!
Doxygen accepts "JavaDoc"-style D comments, that look like:
there is a convenient documentation short format available too:
It would be nice if these could be mentioned in the D specification, and used in the D standard library (that would be Phobos)
- Since the Ddoc (embedded documentation) feature has been added to D, the D Specification and Phobos documentation are being converted into Ddoc format. I think the conversion is either mostly done or completely done at this point. -- JustinCalvarese, 2006/12/08