Last update January 22, 2007

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
FrontPage | News | TestPage | MessageBoard | Search | Contributors | Folders | Index | Help | Preferences | Edit

Edit text of this page (date of last change: January 22, 2007 21:30 (diff))