ドキュメント

Dは言語にモダンなソフトウェアエンジニアリングの重要なパーツを統合することを試みます。 契約プログラミングユニットテスト以外にDはソースコードの外にネイティブに ドキュメントを生成します。

型や関数をドキュメント化するための標準スキーマであるコマンドdmd -D を使うことで便利にコマンドラインでソースファイルをもとにした HTMLドキュメントを生成します。 実際、Phobosライブラリドキュメント のすべてはDDocで生成されています。

下記のコメントスタイルはソースコードのドキュメントに含まれるものとDDocにみなされます:

  • /// 型もしくは関数の前の3つのスラッシュ
  • /++ 2つの + で複数行コメント +/
  • /** 2つの * で複数行コメント */

標準化されたドキュメントセクションについての詳細はソースコードサンプルを見てください。

掘り下げる

rdmd playground.d