Doc Comments /
HTML
Difference (last change) (no other diffs, normal page display)
Deleted: 3,5d2
|
== More Information = == Examples = |
Changed: 8c5,7
|
Put your comments about the official/non-official page here. |
|
Add your comments here... === Embedding code in HTML is bad === |
Changed: 16,17c15
|
== Amendments = You may add a link to this page on the DocumentationAmendments page to draw extra attention to your suggestion. |
|
|
Changed: 20c18
See the corresponding page in the D Specification:  DigitalMars:d/html.html |
|
Corresponding page in the D Specification |
Embedding D in HTML
Messages
Add your comments here...
Embedding code in HTML is bad
[ Tsahi Asher: ] Embedding code in HTML is bad because:
- as a programmer, I want to code, not write HTML. The compiler, or some other utility like JavaDoc, should create the HTML out of the comments
- Doxygen is (somewhat) available for D too, this is for a different purpose
- code embedded in HTML is not readable
- There is a compiler flag (at least in GDC) to extract the code from the HTML
Links
Corresponding page in the D Specification