init);構文は形式文法の表記を使用して書かれることもあります。end]])角括弧は内部の引数が省略可能であることを表します。これは読者の多くを混乱させるため、推奨しません。代わりに角括弧を外して、構文ブロックの下にある引数の節で、これらの引数が省略可能であることを説明したほうがいいでしょう。複数行での表記メソッドが複数の形式で使用されることがあるため、複数の行で記述したい場合があるでしょう。構文の例も、すべての変化形を表示し理解しやすくするために、次のように書き直すことができます。コンストラクターのページでは、取りうる引数の組み合わせが全く異なる形でたくさんあることを示しています。milliseconds]]]]]);ただし前述の通り、角括弧を外し、引数の節で引数が省略可能であることを明確にするべきでしょう。無関係な構文を含めないでください。説明するために次のような形をよく見かけます。メソッド呼び出しを含んでいません。次に、「引数」の項を設置して、それぞれの引数が何であるべきかを説明リストの形で説明してください。複数のメンバーを含むことができるオブジェクトの引数は、入れ子の説明リストで記述し、その中にそれぞれのメンバーが何であるべきかを記述してください。マクロでマークしてください。ブロックの中に含めてください。その機能が何も引数を取らない場合は、「引数」の項を設置する必要はありませんが、中身を「なし」として設置しても構いません。返値の項その次に、「返値」の項を設置して、コンストラクターやメソッドの返値が何であるかを説明してください。例については前述のリンクを参照して下さい。最後に、「例外」の項を設置して、コンストラクターやメソッドの呼び出し時に問題が発生した場合にどの例外が発生するかを説明してください。(例えば、安全なコンテキストで実行する機能を安全でないコンテキストで実行しようとした場合など)、その他の理由であったりする場合などです。メソッドで発生する例外を特定するには、仕様を十分に精査する必要があります。機能がどのように動作するかについて、仕様書の1つ1つの説明を調べると、一般に例外とそれが発生する状況の確実な一覧を得ることができます。例外の名前と説明を説明リストに記述してください。その機能で発生する例外がない場合は「例外」の項を設置する必要はありませんが、中身を「なし」として設置しても構いません。