Data commit

Task/Documentation/D/documentation.d

@@ -0,0 +1,42 @@
+/**
+This is a documentation comment for someFunc and someFunc2.
+$(DDOC_COMMENT comment inside a documentation comment
+(results in a HTML comment not displayed by the browser))
+
+Header:
+    content (does not need to be tabbed out; this is done for clarity
+    of the comments and has no effect on the resulting documentation)
+
+Params:
+    arg1 = Something (listed as "int <i>arg1</i> Something")
+    arg2 = Something else
+
+Returns:
+    Nothing
+
+TODO:
+    Nothing at all
+
+BUG:
+    None found
+*/
+void someFunc(int arg1, int arg2) {}
+
+// This groups this function with the above (both have the
+//  same doc and are listed together)
+/// ditto
+void someFunc2(int arg1, int arg2) {}
+
+/// Sum function.
+int sum(in int x, in int y) pure nothrow {
+    return x + y;
+}
+
+// These unittests will become part of sum documentation:
+///
+unittest {
+    assert(sum(2, 3) == 5);
+}
+
+/++ Another documentation comment +/
+void main() {}