-
Book Overview & Buying
-
Table Of Contents
D Cookbook
By :
To verify your code is working correctly, you must know what it is supposed to do. Like with unit testing, D has a built-in documentation generator called Ddoc. Ddoc is fairly simple, but it gets the job done and is always available.
Perform the following steps to document your code:
Attach documentation comments to declarations by writing /** Docs */ or /++ Docs +/ above them or /// short description directly after them.
Put documentation comments on both collections and members. For example, if you document a class member, ensure that there's a doc comment on the class itself too.
Document unit tests that you want to serve as usage examples.
Document function parameters by writing lines in the format: name = meaning under a section Params:.
Compile the module with the –D flag to dmd to generate the documentation's HTML file.
You may define and use macros. They are defined in a special section named Macros: with a name=value syntax and used with $(name...
Change the font size
Change margin width
Change background colour