Tue, Mar 15, 2005

ちょっと仕事。ぶっちゃけてしまうと、海外の開発者に指示するCのコーディング規約をMさんがまとめ、それをレビューしてちまちま直している。どこの国にも「オレ流」もあれば「うちの国内じゃメジャー」な、こっちはよく知らんルールもあって(そう簡単に「GNUで」「BSDで」なんてそうそう通らねえ)、vi対emacsみたいな宗教論争臭もプンプンの話。その上アジア、ヨーロッパ、アメリカをまたぐんだぜ。ありえねえよ。そんなルール林立しまくりモメモメのくっだらねえ議論を、ついにMさんが制覇するのだ(任せました!)。わはは。

MさんがIndian HillやらGNUやらBSDやらSunやらScott Amblerやら、K&RだK&PだPragprogだCodeReadingsだc2.comに溜まってるアレだと、そういう海を片っ端から泳いで拾い集めた「まあだいたいこれかな」というのを、「『いいと思う』じゃなくて『やれ』って書かないとやらないよ」「こことここ、くどいから、こう」「**の命名規則が無いので、こうですか」と、サポートという名前の下に「もういやだー」と溺れているMさんに石を投げる。双方半泣きである。熱血漫画のようである。立て、立つんだMさん。家にはボトムズのガレキが待っている。

骨子は3年くらい前にはできて、規約も2年前に同じ事をしてできていた。でもオレが壊れてから誰もレビューすらしないで放置されてたわけで。泣けるなあ実際。だって全然たいしたもんじゃないんだよ。こんなカンジ。いいでしょ、出したってさ。こういうWWW上の情報に支えられてやってきたんだし。>Mさん

ISO-C準拠で、インデンテーションやカッコはK&Rで。だってさー、地球1周してLinuxマニヤやBSDフリークをいちいち説得して歩くのは面倒臭いんだもん。ィヨコハマシミンとしてはさ。K&Rなら良いのも悪いのも知ってるし、ほぼ同等にツールサポートもあるでしょ。
そういう訳で、関数やtypedefのシグニチャは小文字+アンダースコアのみで。定数は代わりに大文字ね。
Windows用やLinux用のドライバ等があれば、それは別ディレクトリなどに分けて、それぞれのルールに準拠。camelCaseなどはこっちでやってよ。C標準ライブラリも同様に、それはそれで従うってことで。
Cだとネームスペースがないから、上記に準拠のmodule prefixを適宜付けて代用してね。
(ここは英語嫌いのニホンジン用)関数名は原型動詞+適宜目的語でひとつ。大抵、目的語はそのまま引数名になるんだけども。関数コメントの主語は省略していいよ。"It"でも"This function"でもさ(ただし三単現で書けよ)。コメントと関数名が"s"以外同じになるなら、コメントは不要か、別の情報を書くべき(このへん重要)。アンダースコアで区切ってるからスペルチェッカを使うのも簡単。このあたりはJava/javadocから。英語嫌いにはいいルールだと思うんだよ、これ。なぜか英語嫌いほど理解しないけれども。
変数や定数は可能なかぎり形容詞と名詞で。ここも英語嫌い用。ハンガリアンは当然(Windowsモジュール以外)禁止。
看板コメント(あの"*"を並べて枠作る、意味わかんねえアレ)書いたら罰金いちまんえーん。コメント修正して枠の位置直してるのを見付けたら、にまんえん。これマジ(うそ)。
コメント書くならdoxygen/javadocで。自動生成もできるしさ。
略称は良く知られている範囲で。ローカル変数は慣例の範囲で。わざわざそれぞれの一覧を作るMさんよ。えらい。
えーっと、コメント、は、英語でおねまいします。化けるしさ。

拍子抜けするくらい、普通でしょ。ルールってのはそれくらいがちょうどいいから、最初からそうしたの。に、「符号付8bitの変数名は最初に"s8"を付けて」とか言うヤツが出るんだな。

まあともかくだ、これを決めて、あちこちにばら撒くと言うからMさんとオレのヘタレ英語で書いとる訳だったのだが、これをそもそも「早急で頼む」と持ってきた上司に聞いたら

海外サイトに「コーディング規約を更新します」言ったところ、「チーム再編成やプロジェクト変更もあるのに、そこまで対応しきれません。まずニホンでやった結果をいただけませんか」といわれちゃったので、まずニホンサイトでやります。

だと。向こうさんにとっちゃ当然至極の返答。しっかし、「ああ、やっぱりガイジンに言われるとまじドン引きかますよな、このオヤジ世代」と、もうわかっているのにブルーになる2人。

ここまで書いて思ったが、各地で「オレはそう思わねえ」的な揉めが(当然)あると思うのですけど、これってMさん行脚で地球1周?いやオレだとさ、来日してくれた分は引き受けるけども、たぶん現地で半笑いの日本人オヤジ見てたら今の状態だと本気で殴るから、行くのはちょっと。まずいでしょ「オヤジ狩り」輸出は。暴力反対の賛成。たぶん、輪島フックっぽいの出すよ。後日相談しましょう。