Linus Torvaldsが許せないコメントスタイルとは? 140
争いの種 部門より
Linus Torvalds氏がLinuxカーネルのネットワークスタックで使われているコメントスタイルについて、「脳が損傷したバカみたいなコメントスタイルだ」として修正を求めている(メーリングリストでのコメント、Register)。
Torvalds氏はバランスのとれた対称的なコメントスタイルに統一すべきだと考えているようで、以下の(a)~(c)をよいコメントスタイルだとしている。また、Linuxカーネルのスタイルではないとしつつ、許容可能なコメントスタイルとして(d)を挙げている。
(a)
/* This is a comment */(b)
/*
* This is also a comment, but it can now be cleanly
* split over multiple lines
*/(c)
// This can be a single line. Or many. Your choice.(d)
/* This is an alternate multi-line format
that isn't horrible, but not kernel style */一方、バランスのとれていない最悪なコメントスタイルとしているのは以下の2つ。
(no)
/* This is disgusting drug-induced
* crap, and should die
*/(no-no-no)
/* This is also very nasty
* and visually unbalanced */さらに、コメントのボックス化を好む人の話を始めるつもりはないとしつつ、ボックス化したコメントはLSDでラリっていれば本当に素晴らしいものだと思えるだろうが、アステリスクの右端が揃っていることを気にする以上に良いことはないと述べている。