数年前、私はコメントの数を数えるための小さなユーティリティを書きました。 私が取り組んでいるプロジェクト、およびその後の大規模なオープンソースプロジェクトでコメントを計算および分析することは非常に興味深いことでした。 この記事では、一般的なオープンソースプロジェクトで得られた結果を示します。
結果テーブルは以下に提供され、次の列で構成されます。
1.プロジェクト名とバージョン。
2.コードの文字数。
3.コードの総量に対するコメントの3％。
4.コメントの数に対するコードの行数の比率。
5.単語数todo + fixme。 プロジェクトでどれくらいの量がファイナライズされるかを示すインジケーター。
| タイトルとバージョン | コード量 | ％コメント | コード行/
コメント | Todo +修正プログラム |
|---|
| Apache OpenOffice 3.4.1 | 279 m | 16.3％ | 3.3 | 6557 |
| Mozilla Firefox 14.0.1 | 163 M | 25.5％ | 4.5 | 1338 |
| Qt 4.6.4 | 57 M | 19.9％ | 7.0 | 395 |
| ブレンダー2.63 | 71 M | 10.9％ | 6.0 | 1477 |
| Gimp 2.8.2 | 33 M | 7.7％ | 10.6 | 227 |
| OGRE 1.9.0 | 23 M | 23.5％ | 3.5 | 421 |
| Inkscape 0.48.2 | 1900万 | 18.7％ | 5.0 | 1556 |
| VLCメディアプレーヤー2.1.0 | 20メートル | 14.7％ | 6.3 | 1155 |
| PHP 5.4.6 | 45 M | 10.6％ | 6.2 | 277 |
| Mediawiki 1.19.1 | 15メートル | 14.8％ | 5.0 | 546 |
| 7-zip 920 | 420万 | 5.9％ | 25.6 | 0 |
| Zlib 1.2.7 | 694 K | 40.9％ | 4.0 | 0 |
分析ノート：
Zlibはcontribディレクトリを除くすべてのファイルを解析しました。
Qtでは、サードパーティを除き、qt-everywhere-opensource-src-4.6.4 \ srcフォルダーが分析されました。
ウィキメディアでは、言語を除くすべてのフォルダーが分析されました（ヒントをありがとう）。
OgreはSamplesフォルダーを除外しました。
ファイルの最初のコメントを計算する際に、著作権である可能性が高いため、考慮されていないことに注意してください。 上記の結果から、コメントの数は平均で約15％であることがわかります。 もちろん、OpenOfficeは6557 fixme + todoで際立っています。 これらのコメントから：
- 50個のコメントは、「TODO：check overflow！」のようになります。
- 10頃：「TODO TODO TODO：このO（n）検索は本当にひどい...」
- 「取り除く」のような68のコメント。
- 「TODO文書化」に対する94件のコメント
このテストを自分で実行する場合は、ユーティリティへのリンク：
unick-soft.ru/soft/commentCounter.zipVBartのサービス
www.ohloh.netへのリンクに感謝します。ここでは、多数のオープンソースプロジェクトを見つけることができます。 さらに、サービスは、コメントの数に関する統計を表示します。