ソースのコメントを英語で書くスレ

1 ：08/10/23 〜 最終レス ：12/02/27

無能な誰かが日本語のソースのコメントを書き込んだら、
有能な俺が英語でコメントを書き直してくれるスレッドです。
ちなみに、TOEIC300点台なので、あまり期待しないでください。
（すいません。。orz）
英語はプログラマの必須スキルだ！
日本語でコメント書いてるやつなんでクズだ！
今日から君も甘えてないで、英語でコメントを書こう！

2 ：

// you need not understand below.

3 ：

if someone incompetent write a comment of source in Japanese,
competent I rewrite it in English, that is this thread.
英語添削スレじゃないんですか？

4 ：

//hey yo

5 ：

// this is a comment.

6 ：

>>3
＞英語添削スレじゃないんですか？
逆も需要がありそうですよね。
別スレッド立てるのもあれなので、このスレッドでやりましょう。

7 ：

//electrical love

8 ：

//This function makes all your base be belong to us

9 ：

// This thread is created by an intelligent chimpanzee "ai-chan" for linguistic training.
// This thread is used for communicating between ai and research staffs, so please refrain from commenting.

10 ：

まず日本語で書いて、エキサイトで翻訳する
これが俺のやり方

11 ：

日本人なら日本語でok

12 ：

「日本語でok」自体がjaplish

13 ：

むしろ変数すら日本語にすべき

14 ：

変数名にユニコードが使える言語って何があるっけ？Java とか .net なら OK ?

15 ：

中国系とプロジェクト投げ合ってたとき
壊れた日本語書かれるより
壊れた英語の方がまだ通じた

16 ：

大阪弁で書けばいいよ。

17 ：

最初に
//speak Japanese or die, white fag.
って書いとけばよくない？

18 ：

いや、つまんないから

19 ：

アルファベットを使って日本語を書く手法もあるよ

20 ：

翻訳お願いします！
// もし、下のコメントを外したら、このプログラムは動かなくなるでしょう

21 ：

若干意訳
Uncommenting following lines will make the entire program unfunctionable.

22 ：

基本的に先に言いたいことを書く方がおk
DO NOT UNCOMMENT BELOW OR IT WON'T WORK

23 ：

動く=workは簡潔でいいですね。

24 ：

>>20
// I am UNKO

25 ：

>>20
// FIXME

26 ：

//( ^ω^ )

27 ：

//this project Delete ok

28 ：

// oh very warosu.

29 ：

/* You are not expected to translate this. */

30 ：

お願いします。
// 変数hogeは、1または2または3のどれかでなければなりません。これ以外の場合プログラムはアボートします。

31 ：

// if(hoge >= 1 && hoge <= 3) return 0;
// else abode

32 ：

// the change number is 1 or 2 or 3 not alone.
if other number , then this program is aboon.

33 ：

// Variable hoge must be 1, 2, or 3.
// Otherwise, this program should be down.

34 ：

>>30
激しく意訳したけど。
//Without setting 1, 2 or 3 to variable "hoge",
//this program will abort.
再訳すると、
//1,2または3を変数"hoge"に設定しないと、
//このプログラムはアボートします。
こんな感じ。前置詞とか合ってるのかは知らん。

35 ：

// This program will abort, if variable hoge=1 or hoge=2 or hoge=3
結果を先に書くのが英語のスタンスだよ。
仮定の話なのでwillを使うところがポイント。

36 ：

墜ちる条件逆転してない？
それにこの場合、一番言いたいことは hoge に設定すべき値で、墜ちるってことじゃないでしょ。

37 ：

先に言うべきなのは結果ではなく結論。
正しい値を入れていれば発生しない現象なのだから、
極論を言えば「プログラムがおちる」なんて記述はなくてもいい。
>>36の言う通り、「設定するべき値」が最初。
そして「でなければいけない」なのだから「must」を使うべき。

38 ：

べきはshould

39 ：

海外に発注したら、日本語と英語が混じったのが送られてきた。

40 ：

mustもshouldもいいかたがきつい感じがするので、mayでおｋ。

41 ：

名前欄にトエイックの点数書いてくれないとどれを信じていいかわからない

42 ：

虚偽申告の可能性は？

43 ：

>>31->>38
ありがとうございます。いろいろ表現があるんですねぇ、、
勉強になります。

44 ：

お願いします。関数の説明になります。
// この関数は処理が正常の場合、1以上がリターンされます。処理が異常の場合、0以下がリターンされます。
// リターン値の意味は以下のとおりです。
// 1の場合、処理が正常に行われたことを意味します
// 2の場合、処理するデータがなかったことを意味します
// 0の場合、指定されたパラメタに問題があります
// -1の場合、設定ファイルのhoge.iniの設定値に誤りがあります。
// -2の場合、予期せぬエラーが発生しました。
//
// この関数をよんで0以下がリターンされた場合は、システムログにその理由を書き込んでください。
長文すいません。

45 ：

>>44
// Do It Yourself

46 ：

そもそも
#define SUCCESS 1とかpublic static final int SUCCESS = 1;とかして
return SUCCESS;
とでもしろよ

47 ：

>>44
When processing is normal as for this function, it is returned more than 1.
When processing is abnormal, it is returned less than 0.
The meaning of the return value is as follows.
In the case of 1, there is a problem in Para meta appointed
in the case of 0 meaning that there were not data to handle
in the case of 2 meaning that processing was performed normally
In the case of -1, there is an error in a set point of hoge.ini of the preference.
In the case of -2, an unexpected error occurred.

I call this function, and less than 0 please write in the reason at system log when it was returned.
長文はつかれるぜ、、

48 ：

"Para meta"、"more than"、"return value"ｗｗｗｗｗｗｗ
センス良いなｗ

49 ：

>>47
TOEIC400点レベルか

50 ：

がんばったな

51 ：

ダメだこりゃ。

52 ：

Sorry, Japanese only.

53 ：

I am a pen.

54 ：

wtf

55 ：

If this function succeeds, it returns positive value, or returns less than 0.
We have to write the reason why it failed to system log, when the return value is less than 0.
@retval 1 succeeds
@retval 2 no data to process
@retval 0 invalid parameter
@retval -1 invalid setting(s) in hoge.ini
@retval -2 unexpected error occurred

56 ：

>>55
神光臨！
ありがとうございます。

57 ：

このスレは地味に伸びる

58 ：

日本語では暗黙だった主語を英語にする場合、
１．主語をYouにする
２．主語をWeにする
３．受動形にして目的語だったものを主語に持ってくる
などの手法があると思いますが、
ソースのコメントとしてふさわしいのはどれでしょうか？

59 ：

>>58
適材適所。
臨機応変。

60 ：

>>55
> If this function succeeds, it returns positive value, or returns less than 0.
0 が入っていないよ!!
それはそうと、positive value と less than 0 ってのはバランスが悪い。
もとの日本語の「1以上」「0以下」をそのまま訳したほうがいいんじゃない?

61 ：

>>47
パラメタってparameterだと思ってたんだが、"Para meta"という単語もあるの？

62 ：

ベンゼン環への原子の塊のくっつきかたで、オルト・メタ・パラという
のを習った記憶がある。無関係だが。

63 ：

>>62
ちょｗｗｗ
>>61
たぶん>>>47のはexcite翻訳したんじゃあるまいか。
パラメタはparameterでいい気がす。

64 ：

>>63
>When processing is normality, it is ..one or more.. return. this functionWhen processing is
>abnormality, it is ..0 or less.. return.
>The meaning of the return value is as follows.
>There is a problem in the specified parameter in case of 0 that means there was no processed data
>in case of two that means processing was normally done in case of one.
>-The mistake is found in a set value of hoge.ini of the configuration file in
>case of one.
>-The unexpected error was generated in case of two.
>
>This function must be called and 0 or less must write the reason in the system log when it
>is a return.
エキサイト翻訳馬鹿にすんな！

65 ：

エキサイトは語彙が多い。
ヤフーは文法が強いが、言い訳がましい。
単語熟語は信用しないほうがいいね。
ということで、
技術系はエキサイトを辞書代わりに使ったほうがいいね。
あとの組み立ては自分のスキルでカバー。

66 ：

This function returns positive integer in normal cases;
0 or negative integer abnormal cases. Exact values are:
1 --- the data were processed normally.
2 --- there were no data to process.
0 --- there was some ploblem in specified paramters.
-1 --- something's wrong in configuration file hoge.ini.
-2 --- there was an unexpected error.
When 0 or minus values were returned, please record
the situation onto the system log.

67 ：

Fly(); // if I were a bird.

68 ：

つまり飛ばないと

69 ：

>>65
100へぇ
知らんかった。今日からexcite使おうorzorz

70 ：

なでしこでコメントを英語にするって背徳行為ですか

71 ：

前に移民系フランス人が書いたソース読んだら、英語とフランス語が交じってた。
コメントだけじゃなくて関数名も、スペル忘れたけど、セ・イクス(英語)=CX;みたいに
フランス語の発音を英語に当てた変数名だったり。
それで、つい最近安い仕事が入ったので、俺もコメントと変数の2番目の単語だけイタリア語で
書いてやった。何年後かに、誰かがソース読んで笑ってくれたらいいな。
2ch住民なら、なお良いねw

72 ：

向こうから見たらこんな感じか
getZahyou() // gets the coordinates.

73 ：

専門用語とか社内用語ありまくりの仕様だと、下手に翻訳すると
別途（用語<->日本語<->英語<->変数名）の対応表が必要になったりして
可読性が大幅に下がるので、結局
　get＜用語＞
　process＜用語＞By＜フロー名＞
みたいになったりするな。

74 ：

関数名はいいからコメントについて語ってください

75 ：

set("ans", add(1,2)); // ans = 1 + 2

76 ：

いや、日本語でいいと思う。というかコメントいらねぇ。
お前らが日本語覚えろと。
さもなくば、日本語で質問して自分でコメント入れろと。
暇ねぇよ。コメント料払え。１字１０円くらいで。

77 ：

set("ans", add(1,2)); // ans = 3

78 ：

/*

79 ：

>>78
throw new NullPointerException();
*/

80 ：

/*
>>79
got!
*/

81 ：

外人もエキサイト翻訳みたいなの使って日本のサイト読んでるらしいよ

82 ：

お願いします！
// この関数は、"20081001"のような形式の文字列を、"08/10/01"に変換します

83 ：

*/

84 ：

>>82
// This function converts a string in the format like "20081001" to "08/10/01".
つかここそういうスレだっけか

85 ：

ごめ、これじゃ変な意味になるな、意訳するか分割した方がいいかも
誰かよろしく

86 ：

// This function converts date string formats: "YYYYMMDD" -> "YY/MM/DD"
だめ？ｗ

87 ：

メソッドを説明するコメントつけるとき主語は何？
全部にThis method gets 〜ってつけると冗長だし
かといってGet〜ってすると命令形になるし

88 ：

>>87
主語が何かは明白だから、省略してもたぶん問題ない。
あと、主語(メソッド)に合わせて、動詞を-sで活用する。
以下一例として置いておきますね。
http://msdn.microsoft.com/en-us/library/bw00b1dc.aspx
WebRequest.Create (String)
Intitializes a new WebRequest instance
for the specified URI scheme.

89 ：

述語的なやつの説明で、
Returns true 条件, false otherwise.
というパターンを最近愛用中。
条件はon XXXとかwhen(if) YYYY is ZZZとか。

90 ：

haskellっぽくこう書いてみるとか
f x,y... = | cond1 -> return1
| cond2 -> return2

91 ：

地味に良スレの予感（　´∀｀）

92 ：

いいえ

93 ：

>>84
>>86
ありがとー

94 ：

>>84
つかここそういうスレだっけか
を
つ　かここそういうスレだっけか
と脳内で解釈して、一瞬意味がわからなかったｗ
2chのやりすぎだなorz

95 ：

>>84は知らないのかもしらないけれど、2chにおいて、"つ"はドラえもんの手を意味するんだよ。
文章の先頭に"つ"があると、間違えやすいので、気をつけたほうがいい。

96 ：

>>68
// In 2channel, a "つ" in the beginning of a line means a hand of Doraemon.
// Don't forget that.

97 ：

つNIHONGO DE OK

98 ：

>>96
you msitake!!
NOT >>68, YES >>84

99 ：

>>98
>>96 is enormously pertinent, because >>68 also starts with "つ".

100read 1read

1read 100read

TOP カテ一覧 スレ一覧 2ch元 削除依頼 ▲

wide studioについて (540)
COBOL vs Java 2戦目 (951)
Visual Studio 2008 Part 21 (623)
C++/TemplateMetaProgramming (466)
スレを勃てるまでもないC/C++の質問はここで 20 (965)
C#,C＃の宿題片付けます。 (772)
--log9.info------------------
■■Ｆ Ｕ Ｚ Ｚ ■■ fuzz ファズ 16期 (517)
ライブ50回目の女ベーシストだけど質問ある？ (288)
なじょっ子と一緒に筒美京平を語ろう (885)
slash's thread　スラッシュ　part4 (372)
けいおん！を見て楽器を始めた奴の挫折を防ぐスレ50 (485)
ルーパー・セレクター・スイッチャー総合スレ 2 (482)
ヘタクソなのに機材だけはいっちょまえな奴ｗｗｗ 2 (425)
【George】G&L総合 Part6【Leo】 (614)
ベーシストがベースについて語るスレ (445)
豪華家具調カスタム手工ハイエンドベース (988)
【RC】ループマシン ディレイ総合スレ part5【DL4】 (351)
おまえらのギターの画像を貼らないか (584)
歪み系エフェクター総合スレ 56台目 (776)
【PRS】Paul Reed Smith 46 【ポールリードスミス】 (523)
自作エフェクター42 (511)
エフェクターケースの中身を見せ合うスレ56 (308)
--log55.com------------------
激増するチョッパリの性犯罪を警戒する奥様 ★46
日本の民度落ちた　バカウヨR！ Part.12
【激務】コールセンターで働く奥様 part4【高時給】
【悲報】持ち家の隣人ガチャでハズレを引いた結果が悲惨すぎる　これは賃貸の方がマシだわ…★5
☆★★　占い好きの奥様　★★★part.4
イオンのムカつく店員晒すスレ
横浜の奥様 part12
何で引きこもりクソニートは毎日、嫌いな韓国の事を考えてるの？ 2