「Linus Torvaldsが許せないコメントスタイルとは？」記事へのコメント

うちの社内ルール

[Anonymous Coward]

何の問題もない

// コメント

/* コメント*/

まあ許される

/*
  * コメント
  */

/**********
  * コメント
  **********/

だが一方で、Linusは許せる(b)案や(d)案は許されない。
無論、Linusが許せないコメントの書き方の方も許されない。

なんでも、行頭から2文字目がアスタリスクであることを前提に抜き出して整形してくれるシステムを使ってるから、らしい。
なので、Linusが許せないコメントの書き方でも

/* コメント
  */

/************
  * コメント */

とか書けば多分通る。気持ち悪いけど。

Re:

[Anonymous Coward]

ecodeってスペース二文字分入るのか…
失敗した。

Re:

[Anonymous Coward]

まさにその、コメントを箱型に収めるのをLinusが嫌ってるようだから。
箱に収めるのに命かけてきた日本のワープロの使い方が英語圏に理解されないように、
それは言っても仕方ないと思うよ。

Re:

[Anonymous Coward]

箱は右側にもアスタリスクがある奴で、左側だけにある奴は許容してる(b)。

/*
  * アスタリスクの位置は揃えたくなる。
  */

Re:

[Anonymous Coward]

整形っていうか、プログラム仕様書をソースのコメントから生成するシステムとかにそういう制約多いですよね。

本末転倒な上にソース見れば分かるような内容をわざわざコメントにしないといけなくて手間増えるのに、出力された文書を誰も読まないという・・・
顧客へ納入する書類が適当でもまずまず体裁が整うという意味では省力化なのかもしれないけど、やっぱ本末転倒だよな〜。

Re:

[Anonymous Coward]

ソース見れば分かるようなコメントはソースから自動生成すればいいじゃん
そんなものシコシコ書いて手間かけてるようじゃプログラマ失格