アカウント名:
パスワード:
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
ソースを見ろ -- ある4桁UID
コメント部分 (スコア:1)
doxygen などで出力するために詳しく書いていますから。
コメント行数 > 関数行数、なんてのも多数。
#この話題での行数ってステップカウント換算なのかしら?
Re:コメント部分 (スコア:0)
C/C++の場合、ヘッダファイルとソース、コメントはどっちに書きますか?
ヘッダを見る利用者のためにヘッダに書くべきだ、という意見もわかるし、ヘッダの見通しが悪くなると全体が把握しづらくなるのでソースに書くべきだっていうのも同意できる。doxygenなんかは、ヘッダに短いコメント、ソースに詳細なコメントなんかをサポートしててそれは前者と後者を両立させてるとは思うんだけど、同じような内容を二度書くのはちょっと面倒だし、修正したときに片方のコメントの修正を忘れることもしばしば・・・。
なんかいい指針ないかな?
Re:コメント部分 (スコア:2, 興味深い)
昔からの指針だと思います。実装についてのコメントは実装本体へ、
利用者向けのドキュメントは別ファイルへ。
Re:コメント部分 (スコア:0)
そういう視点で考えるとヘッダとソース以外にも、基本クラスはヘッダ寄りに、派生クラスではソース寄りにコメントを配置するとか考えられてすっきりしますね。
レスしてくれたお二方どうもありがとう!