東方中央幻視台

瞼の裏に弾幕が飛び交う程度の能力 - 永夜抄Normalはそれなりに難しい。

目次

Blog 利用状況

ニュース

自己紹介

関連サイト

投稿カレンダー

  • スクリプトをダウンロード!

ブログパーツ

Adsense

書庫

日記カテゴリ

ソースコードの日本語文字

自分自身はコメントですら英語で書きます。
理由としては、Windows版のOsaka-等幅では、日本語の文字が綺麗に表示されない、英語圏のWebプレビューでは文字化けするというのもありますが、何よりコメント自体ほとんど書かないからです。
自分の書いた中にコメントは#regionブロックとXML以外のコメントがないコードも結構あります。

とは言っても、MSDNなんかのサンプルコードなどで日本語のコメントがないとやっぱり苛ってきます。

投稿日時 : 2008年6月1日 8:14

コメントを追加

# re: ソースコードの日本語文字 2008/06/01 10:46 OtanC

わたしの場合、ソース自体は英語が基本で略した変数名はつけません。(C++です)
区分を分ける必要があれば、namespaceつかって分けています。
その上で、ヘッダに関数・変数のコメントを日本語で書いて、ヘッダ=簡易仕様書として使えるようにしています。(JavaDocのイメージですね、HTMLまでは作りませんが・・・)
ただ、海外向けの場合は全部英語(バッタもん)になってます(^^

>とは言っても、MSDNなんかのサンプルコードなどで日本語のコメントがないとやっぱり苛ってきます。
そうですね(^^。
読み手としては、ドキュメントは日本語のほうがわかりやすいです。見ただけで頭に入ってくる「気が」します。英語は音(おん)を辿らないと意味が入ってきません。
それと、MSDNの記載が日本語版と英語版で内容が違うのはやめてほしいですね。

# re: ソースコードの日本語文字 2008/06/01 11:41 やじゅ

個人で開発する分には英語でコメントも
かまわないけど、チーム開発した場合に
英語出来る人ばかりではないから、
その場合は、やはり日本語になるのかな

# re: ソースコードの日本語文字 2008/06/01 11:59 Hirotow

仕事だと再利用可能性ってのがあるから、コメント至上主義的な部分はあるでしょうね。
自分はクラスライブラリにするか、コードをコピペするならむしろコメントは邪魔な人なのですが。

# 名前空間は英語表記? 2008/06/01 12:04 DHJJ [Hatsune's Journal Japan] blog

名前空間は英語表記?

タイトル  
名前  
URL
コメント