Tellur52の日記: 鬱積するコメントの怪 1
日記 by
Tellur52
ちょいと昔のとある社内プロジェクトのCのソースを、
戯れに眺めてみたら、
/* BUG FIX 356 start 2003.09.16 hogeyama */
/* BUG FIX 421 start 2003.11.01 boekawa */
#if 0
/* BUG FIX 421 end */
c = foo(d, e);
/* BUG FIX 271 start 2001.12.07 muhada */
if (c) {
return -1;
}
/* BUG FIX 421 start 2003.11.01 boekawa */
#endif
/* BUG FIX 421 end */
/* BUG FIX 271 end */
bar(c, g);
/* BUG FIX 356 end */
みたいに、コメントが堆積しているコードがわらわら。
いやー、これは読みにくいなー、ていうか、日付が既に二十一世紀なんだから、
バージョン管理システム使えよー、と激しく叫びたいところ。
しかし、コードをきれいにするにはあまりにも単体テスト環境が貧弱だったりして。
うーん、機能仕様書が不足している部分があるから、
やろうとしていることを理解しておくために目を通したいだけなんだけど。
よくあるねー (スコア:2)
C ではないですが、ややこしいコメントになる場合は関数ごと全てコメントアウトして新規に書くことがあります
#以前のみたけりゃコメントミロってことでw