アカウント名:
パスワード:
必要なコメントをまるで書かずソースだけ書くスタイルと、ソースが更新されたのに、コメントの内容が古いままのスタイルだ
それに比べりゃアスタリスクの位置などなんだというのか
もっと許せないのは
//iに1を足すi++;
この手のは書いてる本人がよほどの暇人でないかぎりすぐに治るよ。
コメント書かない奴を矯正するのとは比較にならないほど楽。
コメントをそもそも書かなくなる人もいる。
//削除 start 2016.07.12//iに1を足す//削除 end 2016.07.12i++;
>//削除 start 2016.07.12>//iに1を足す>//削除 end 2016.07.12
これ、バージョン管理してるのにこれを書かないと気が済まない人ってマジでラリっちゃってるとしか思えないんだけど。誰が得するのこのコメント
ソースが読みにくいったりゃありゃしない
チェックイン時のコメントで全てまかなえるわけでもなく。上書きされまくって「いつ変わったのか」が分からなくなって、結局1つ1つ追いかけるハメになる。という苦労があって、バージョンつける(タグつける)段階で消すという運用でないと(時間的にも)やってられない状況になったことはある。
今?
SourceTreeおいしいれす。 (^ω^)※ そこまでの惨劇は稀なので、追いかけるストレスが減ればどうでもよくなった。
あるいは、
ちょっと前、確かgoogleの開発現場が「全部パッチで提供して、全体を把握する1人が入れる」みたいな感じのを目にした記憶があるのだが。今どうなのかね?
> 誰が得するのこのコメント
クライアントからの要請。
必ずしも納品先がバージョン管理してくれてるわけじゃない。差分が意図したものかわかるようにコメント入れろと言われるのはどこでもあること。
まあ慣例なのはわかるし、そういわれりゃやるんだけどさ…いつも思うんだが、俺らが読むの苦労するこのクソコメント付きソースが納品先で読めるのかね
#って思いながらZIPで固めてますよ、はい
むしろバージョン管理システムからエクスポートする時にこの記法にするプラグインがあればバカウケかも
コード読めないからそういう指示になるのさ。
ソース中のコメントとコミットは粒度が違うからな。
CVSからGitに変換して20年くらい履歴が残っているんだが、ログを追いかけてどの案件で変更したのか調べようとしても、時代によってコミットの粒度が変わっていくので大変なんだ。変更箇所のコメントにリリース年と案件名を入れておくのが確実。
そんなのまだまし本当に許せないのはこういうの
//iに1を足すi += 2;
今メンテしてるシステム(15年前に作られて数度の改修の後、10年間放置熟成してたVB6.0クライアントアプリ)に、いたる所で謎の処理があって主に「DBの値を取得してるけど、取得した値を何も使わないで関数を抜ける」やつコメントには「●●の値を取得」って書いてあるけど、だから何がしたいの!って頭かかえてる(DBにトリガーがあるとかそんな高度な仕様ではない)
コメントに書くべきは処理内容より目的にしなさいって声を大にして言いたい!
# やさぐれAC
途中で変わったんだろ
途中で変わったのはわかるけど、マトモなプログラマーなら「DBから値を取得する」「その値を使用して処理をする」という一連のロジックがあって、後者が不要になったら前者も削除するだろうつまりアホがメンテしたから駄目なコードになってるってだけだろうね
コメントなんて信じるな
慧眼。バランスも必要だと思うけど、判で押したような機械的なコメントしか書けない人は結構多いなと感じた。見りゃわかることは書いてるけど必要な内容がないコメントとか、書いた人の股間を全力で蹴り上げたくなる。
炎上プロジェクトで必ずある、コードを日本語で書いただけの奴ですね。♯んな暇あったら最初からコード書けよ
i=i++;
#何だっけ?ソフト名が思い出せない…
n=n++ならnxt [osdn.jp]
ソフト名以前に、これだけだとプログラミング言語が何かも判断できませんね。ちなみにJavaの場合、「Java PUZZLERS」に紹介されているクイズ(=駄目コーディング)の1つです。
#さて、iにはどんな値が入るでしょう?(初期化してないからコンパイルエラーってのはなしで)
指摘コメ [srad.jp]の通りなんですが、「i=i++;」は、「n=n++;」の誤りでした。ここで変数名を間違えるとはツメが甘い…。
で、ちょっとだけ昔話というかネタ解説しときます。昔、UNIXなマルチ環境向けには「ソフトウェアはソースコードで公開し、各自コンパイルして利用する」の当たり前だったころ、確か fj にて、knk と名乗る自称スーパーハッカーが nxt というすごい便利なプログラムを作ったよって公開したんですがCで書かれたそのコード中には「n=n++;」という記述が散見されたため、フルボッコにされる、という出来事があったんです。周りからそれは未定義だとどれだけ指摘されても、これが正しいんだと knk 氏は頑なに間違いを認めなかったので、面白い人物ネタとして広まりました。スラドでも、時々 [srad.jp] ネタに [srad.jp] されてます [srad.jp]。
#といいつつ、私自身細かい内容をすっかり忘れてて間違えて「i=i++;」ってコメントしてしまったわけですが…#「knk」「nxt」のキーワードを思い出せてない状況からは、どれだけググっても正解にたどり着くことができませんでした…
この話は知らなかった…
勉強させていただいてます m(_ _)m
それ、殺伐としたスレに降臨するやつだ
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
日本発のオープンソースソフトウェアは42件 -- ある官僚
もっと許せないコメントスタイルはある (スコア:0)
必要なコメントをまるで書かずソースだけ書くスタイルと、
ソースが更新されたのに、コメントの内容が古いままのスタイルだ
それに比べりゃアスタリスクの位置などなんだというのか
Re:もっと許せないコメントスタイルはある (スコア:0)
もっと許せないのは
//iに1を足す
i++;
Re: (スコア:0)
この手のは書いてる本人がよほどの暇人でないかぎりすぐに治るよ。
コメント書かない奴を矯正するのとは比較にならないほど楽。
Re: (スコア:0)
この手のは書いてる本人がよほどの暇人でないかぎりすぐに治るよ。
コメントをそもそも書かなくなる人もいる。
Re: (スコア:0)
//削除 start 2016.07.12
//iに1を足す
//削除 end 2016.07.12
i++;
Re:もっと許せないコメントスタイルはある (スコア:1)
>//削除 start 2016.07.12
>//iに1を足す
>//削除 end 2016.07.12
これ、バージョン管理してるのにこれを書かないと気が済まない人って
マジでラリっちゃってるとしか思えないんだけど。誰が得するのこのコメント
ソースが読みにくいったりゃありゃしない
Re: (スコア:0)
Re: (スコア:0)
チェックイン時のコメントで全てまかなえるわけでもなく。
上書きされまくって「いつ変わったのか」が分からなくなって、結局1つ1つ追いかけるハメになる。
という苦労があって、バージョンつける(タグつける)段階で消すという運用でないと(時間的にも)やってられない状況になったことはある。
今?
SourceTreeおいしいれす。 (^ω^)
※ そこまでの惨劇は稀なので、追いかけるストレスが減ればどうでもよくなった。
あるいは、
ちょっと前、確かgoogleの開発現場が「全部パッチで提供して、全体を把握する1人が入れる」
みたいな感じのを目にした記憶があるのだが。今どうなのかね?
Re: (スコア:0)
> 誰が得するのこのコメント
クライアントからの要請。
Re: (スコア:0)
ソースが読みにくいのもそうだけどdiffも見にくくなるよね。
メソッド丸ごとコメントアウトしてるのとかホントにもう、勘弁して・・・。
Re: (スコア:0)
必ずしも納品先がバージョン管理してくれてるわけじゃない。
差分が意図したものかわかるようにコメント入れろと言われるのはどこでもあること。
Re: (スコア:0)
まあ慣例なのはわかるし、そういわれりゃやるんだけどさ…
いつも思うんだが、俺らが読むの苦労するこのクソコメント付きソースが
納品先で読めるのかね
#って思いながらZIPで固めてますよ、はい
Re: (スコア:0)
むしろバージョン管理システムからエクスポートする時にこの記法にするプラグインがあればバカウケかも
Re: (スコア:0)
コード読めないからそういう指示になるのさ。
Re: (スコア:0)
ソース中のコメントとコミットは粒度が違うからな。
CVSからGitに変換して20年くらい履歴が残っているんだが、ログを追いかけてどの案件で変更したのか調べようとしても、時代によってコミットの粒度が変わっていくので大変なんだ。
変更箇所のコメントにリリース年と案件名を入れておくのが確実。
Re: (スコア:0)
そんなのまだまし
本当に許せないのはこういうの
//iに1を足す
i += 2;
Re:もっと許せないコメントスタイルはある (スコア:3)
HIRATA Yasuyuki
Re:もっと許せないコメントスタイルはある (スコア:2)
今メンテしてるシステム(15年前に作られて数度の改修の後、10年間
放置熟成してたVB6.0クライアントアプリ)に、いたる所で謎の処理があって主に「DBの値を取得してるけど、取得した値を何も使わないで関数を抜ける」やつ
コメントには「●●の値を取得」って書いてあるけど、だから何がしたいの!って頭かかえてる
(DBにトリガーがあるとかそんな高度な仕様ではない)
コメントに書くべきは処理内容より目的にしなさいって声を大にして言いたい!
# やさぐれAC
Re: (スコア:0)
途中で変わったんだろ
Re: (スコア:0)
途中で変わったのはわかるけど、マトモなプログラマーなら「DBから値を取得する」「その値を使用して処理をする」という一連のロジックがあって、後者が不要になったら前者も削除するだろう
つまりアホがメンテしたから駄目なコードになってるってだけだろうね
Re: (スコア:0)
コメントなんて信じるな
Re: (スコア:0)
慧眼。
バランスも必要だと思うけど、判で押したような機械的なコメントしか書けない人は結構多いなと感じた。
見りゃわかることは書いてるけど必要な内容がないコメントとか、書いた人の股間を全力で蹴り上げたくなる。
Re: (スコア:0)
炎上プロジェクトで必ずある、コードを日本語で書いただけの奴ですね。
♯んな暇あったら最初からコード書けよ
Re:もっと許せないコメントスタイルはある (スコア:1)
i=i++;
#何だっけ?ソフト名が思い出せない…
Re: (スコア:0)
n=n++ならnxt [osdn.jp]
Re: (スコア:0)
ソフト名以前に、これだけだとプログラミング言語が何かも判断できませんね。
ちなみにJavaの場合、「Java PUZZLERS」に紹介されているクイズ(=駄目コーディング)の1つです。
#さて、iにはどんな値が入るでしょう?(初期化してないからコンパイルエラーってのはなしで)
Re:もっと許せないコメントスタイルはある (スコア:1)
指摘コメ [srad.jp]の通りなんですが、「i=i++;」は、「n=n++;」の誤りでした。ここで変数名を間違えるとはツメが甘い…。
で、ちょっとだけ昔話というかネタ解説しときます。
昔、UNIXなマルチ環境向けには「ソフトウェアはソースコードで公開し、各自コンパイルして利用する」の当たり前だったころ、
確か fj にて、knk と名乗る自称スーパーハッカーが nxt というすごい便利なプログラムを作ったよって公開したんですが
Cで書かれたそのコード中には「n=n++;」という記述が散見されたため、フルボッコにされる、という出来事があったんです。
周りからそれは未定義だとどれだけ指摘されても、これが正しいんだと knk 氏は頑なに間違いを認めなかったので、面白い人物ネタとして広まりました。
スラドでも、時々 [srad.jp] ネタに [srad.jp] されてます [srad.jp]。
#といいつつ、私自身細かい内容をすっかり忘れてて間違えて「i=i++;」ってコメントしてしまったわけですが…
#「knk」「nxt」のキーワードを思い出せてない状況からは、どれだけググっても正解にたどり着くことができませんでした…
Re: (スコア:0)
この話は知らなかった…
勉強させていただいてます m(_ _)m
Re: (スコア:0)
それ、殺伐としたスレに降臨するやつだ