質問: C++関係ないのかもしれませんが、最近コメント文で///とスラッシュを三つ使ったものをよく見ます。 VS2015で///を使うと//や/**/より濃い緑色になるのにも最近気が付きました。 そこで質問なのですが、///ってどういうときに使うものなのでしょうか? なにか特別なことをコメントに残すときに使うのでしょうか?
回答: 既にVisualStudioに関して話が出ていますが、似たようなツールで昔からDoxygenというソフトウェアがあります。 例えば、lenyaさんのサンプルをお借りして、Doxygen風に書くと、 ``` /// @brief 概要 /// @param[in] hoge 変数の意味 /// @return 戻り値の説明 public void test(int hoge) ``` のようになります。 もしくは簡単に、 ``` /// 概要 public void test(int hoge) ``` なんて書き方もあります。 また、doxygenはある程度書き方があって、「@brief」が「\brief」だったり、「///」が「//!」だったりします。 こんな感じでコメントを書いておけば、doxygenでこんな感じのドキュメントを生成する事ができます。 doxygenはオープンソースで、マルチプラットフォームで動作するので、オープンソースプロジェクトや、VisualStudioを使わない開発環境でのプロジェクトでは、よく見るコメントの書き方ですね。