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

1 名前：デフォルトの名無しさん [2008/10/23(木) 02:28:25 ] 無能な誰かが日本語のソースのコメントを書き込んだら、 有能な俺が英語でコメントを書き直してくれるスレッドです。 ちなみに、TOEIC300点台なので、あまり期待しないでください。 （すいません。。orz） 英語はプログラマの必須スキルだ！ 日本語でコメント書いてるやつなんでクズだ！ 今日から君も甘えてないで、英語でコメントを書こう！ 307 名前：デフォルトの名無しさん mailto:sage [2008/12/15(月) 11:11:13 ] // how long does it continue? 308 名前：デフォルトの名無しさん mailto:sage [2008/12/15(月) 12:14:43 ] // never ending 309 名前：デフォルトの名無しさん mailto:sage [2008/12/15(月) 13:16:59 ] // This is an infinite loop in every respect. Thank you very much. 310 名前：デフォルトの名無しさん mailto:sage [2008/12/15(月) 21:06:26 ] // Not Today, Not Tomorrow :P 311 名前：デフォルトの名無しさん mailto:sage [2008/12/16(火) 01:05:39 ] >>303 どっちでもよくない。 以下超マジレス。 まず、 "the next" の後ろに省略されてる名詞が自明じゃない。 いきなり "the next" と言われると、プログラムが配列を順番にいじるような処理をしていて、 現在見ているところの次のことを指すのかな、とか想像してしまう。 "the next code" と書いていれば多分OKだが、 「下記に述べるもの」を指す "the following" という慣用句があるのでそれが一番すっきりする。 しかしそもそも、コメントが直下の部分のことを指しているのは自明なので 単に >>289 や >>291 のようにずばっと書いてしまってよい。 # あと >>288 の "processing" という用語の使い方も何か変だな。 # 文の主語であるコード片は「処理そのもの」じゃなくて「処理のやり方を記述したもの」なので # 289や291のように workaround とか implementation とかいう単語を対応させないとおかしい。 312 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 00:03:33 ] レベルたけぇなこのスレ。 英語勉強したいんだが、技術英語をてっとりばやくマスターする方法でお勧めの方法はありますか？ 313 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 01:21:47 ] 英語の技術書を10,000ページくらい読めばいいんじゃないかなぁ 314 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 01:23:52 ] それだけだと読めるだけになる（俺がそう）なんで、 それに加えて英語のMLとか掲示板に入り浸るといいと思う（もちろん書けよ）。 315 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 02:47:21 ] コメントに関してはJavaDocの英語版を文例集として使うことかなぁ。 316 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 02:50:19 ] なんとも恥ずかしいなこのスレは 317 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 03:09:11 ] 何を今更 >>1からそうだっただろ 318 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 03:50:33 ] ネタスレなんだからあたり前 319 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 03:51:47 ] >>318は>>316宛てﾈ 320 名前：デフォルトの名無しさん [2008/12/17(水) 04:09:28 ] ＞レベルたけぇなこのスレ。 どこがだよ！ｗｗｗ せいぜい、TOEIC５００点レベルじゃねえか？ プログラマの英語スキルなんて糞みたいなものだからな。 あ、俺は糞ということか、、、 321 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 04:16:38 ] 俺はこのスレがいつ.>>112のサイトに載って笑いものにされるか楽しみでしょうがなくもない。 322 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 10:20:26 ] どうせ日本語で書いたって他人に理解されるかどうかは大して変わらないっしょ フランス語とかいうとアレなんで俺はいつもなんちゃって英語でコメント書く 323 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 10:48:45 ] アメリカ人、インド人と共同のプロジェクトなんで、英語でコメント書かざるを得ない。 324 名前：デフォルトの名無しさん mailto:sage [2008/12/17(水) 11:30:36 ] //　　this is a pen. //　　　　　↑ｗｗｗｗｗｗｗｗｗｗｗｗｗｗｗ //　　mean what you say? //　　お前らコメントで会話すんなニコ厨かよ //　　↑当人 function specify() { 325 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 01:14:05 ] ログインって英語でなんていうんだろ // 以下の処理でログインのチェックをしています。ユーザがログインしていない場合、ログインページに飛ばされます。 飛ばされるって表現もどうすりゃいいのか ということでお願いします。 326 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 01:50:24 ] // The following process is to check the login status. If user is not logged in, will be transferred to a login page. 327 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 03:07:23 ] なんとも恥ずかしいなこのスレは 328 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 03:45:11 ] 高校くらいまでまじめに行っとけばこんなスレ要らんだろう 329 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 03:49:36 ] 高校までまじめに行ってない奴が多いからこんなスレがあるんだろう 330 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 08:21:49 ] // Shut up your mouth if you don't know. It's just annoying. 331 名前：デフォルトの名無しさん [2008/12/18(木) 08:34:07 ] >>325 // check if logged in. if not, open the login page. 332 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 10:17:44 ] 文の先頭に動詞の原形を置くと命令文になるから気をつけろ、って中学で習わなかったのかねえ・・・ 333 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 10:21:43 ] そう言う場合は3単現のsをつけとくといいね 334 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 10:27:48 ] なんで三単現のsっていう機械的理解なんだよ 主語がルーチンなんだよ （このメソッド/クラス/関数）はログインチェックを行う、という文章にさせるんだよ // Login Ckeck だけでいいと思うけどね 最初から長々と文章書かれても読みにくいだけ 335 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 10:31:03 ] >>329 高校でまじめに英語やっててもこの手の文章は書けない 高校生が新聞英語読み書きできんのといっしょだ 336 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 10:36:46 ] >最初から長々と文章書かれても読みにくいだけ 337 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 10:55:55 ] >最初から長々と文章書かれても読みにくいだけ 338 名前：デフォルトの名無しさん [2008/12/18(木) 11:12:22 ] >>332 ・いちいち The following code checks ... なんていう主語は普通書かない。 // check ... // validate .. // set ... というように動詞の原形で書き始めるのはごく当たり前。 ・javadocやdoxygen用のコメントは少し真面目に大文字で書き始めたりsを つけたりすることが多い。 /** * Gets ... */ これ常識だから、そんなことも知らないような素人はロムっててね。 339 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 13:14:50 ] いや>>332->>333は普通に check　→　checks と代えろといってるだけだろ >>326 is to checkはいかにも日本語を直訳しました的だな checksでいいじゃん 340 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 19:19:02 ] >>335 ソースのコメントと新聞英語はだいぶ違うよ。 あ、同じに見える人ですか。 341 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 21:40:11 ] なにが違うの？ 342 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 21:41:42 ] >>340 新聞英語が高校生の教科書の英語と同じに見える人？ 新聞読んでないと新聞英語読み書きできないのと同じことだろ ソースコードコメントの英語はソースコードコメント特有の文法や表現にまみれている 343 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 21:53:14 ] >>340 >>335は、ソースのコメントと新聞英語が同じとは一言も書いてないが。 あ、日本語が不自由な人ですか。 344 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 22:53:13 ] よく釣られる方達ですね 345 名前：デフォルトの名無しさん mailto:sage [2008/12/18(木) 22:55:36 ] >>342 >>340は、新聞英語が高校生の教科書の英語と同じとは一言も書いてないが。 あ、日本語が不自由な人ですか。 346 名前：デフォルトの名無しさん [2008/12/19(金) 01:06:59 ] >>331 ＞// check if logged in. if not, open the login page. ログインって英語でlogged inなんですねー ログインって和製英語だったのか、知らなかった。。 347 名前：デフォルトの名無しさん mailto:sage [2008/12/19(金) 01:38:24 ] >>346 何故後半を見ない。 348 名前：デフォルトの名無しさん mailto:sage [2008/12/19(金) 17:08:30 ] メソッド名は 349 名前：デフォルトの名無しさん mailto:sage [2008/12/19(金) 17:09:48 ] ↑誤爆 メソッド名が getSource() なのに コメントで Get source とか書くのっておかしい？ 350 名前：デフォルトの名無しさん mailto:sage [2008/12/19(金) 18:11:00 ] 斜め上のレス。 コメントでgetはあまり使わない。 351 名前：デフォルトの名無しさん [2008/12/20(土) 03:28:56 ] >>349 getSource()がpublicのmethodならば「Get Source」だけでは説明不足。 これでは何のsourceが返るのかソースコードを読まないとわからない。 そもそもmethod名から推測できるもの以上の情報が得られないから コメントを書く意味が無い。 また、初期条件は何なのか、nullが返される場合があるのか、 例外は投げられるのか、など説明すべきことが他にもあるのでは。 352 名前：デフォルトの名無しさん mailto:sage [2008/12/20(土) 04:04:32 ] アメリカ人ってobtain好きだよね〜 353 名前：デフォルトの名無しさん mailto:sage [2008/12/20(土) 10:24:29 ] 日本人の get 好きも異常 数年前に流行った（？）「ゲットする」って表現は何ソレと思ったものだ。 354 名前：デフォルトの名無しさん mailto:sage [2008/12/20(土) 10:27:19 ] それは日本人としてどうかと思う 355 名前：デフォルトの名無しさん mailto:sage [2008/12/20(土) 19:07:30 ] setするよりgetしたい文化なんだよ 356 名前：デフォルトの名無しさん mailto:sage [2008/12/20(土) 21:44:21 ] よし。次行くぞ、次次！ 357 名前：デフォルトの名無しさん mailto:sage [2008/12/20(土) 22:06:40 ] このコメントは英語でどう書いたらいいですか? わたしはこのような村は好きではありません。 わたしは東京へ行きます。 東京についたら農耕用の牛を飼うつもりです。 358 名前：デフォルトの名無しさん mailto:sage [2008/12/20(土) 22:11:03 ] どいうプログラムなんですか？ 359 名前：デフォルトの名無しさん mailto:sage [2008/12/20(土) 22:21:32 ] 昭和歌謡史に残る和製ラップです 360 名前：デフォルトの名無しさん mailto:sage [2008/12/20(土) 22:35:16 ] I don't like a village like this. I will go to Tokyo. I will keep an ox for farming. 361 名前：デフォルトの名無しさん mailto:sage [2008/12/23(火) 00:31:21 ] >>360 willは意思を表す。 この場合は予定なので、be going to じゃね？ 362 名前：デフォルトの名無しさん [2008/12/23(火) 09:00:22 ] willとbe going toの使い分けはそんな単純じゃない。 be going toもコンテキストによってはwillよりも強い意思を表す。 「誰が何と言おうと、そうすると決めてんだよ」みたいな。 363 名前：デフォルトの名無しさん mailto:sage [2008/12/23(火) 12:46:26 ] するのが決定してる、もしくはすぐ後でするようなときにはbe going toだよね 364 名前：デフォルトの名無しさん mailto:sage [2008/12/23(火) 14:44:25 ] web2.uvcs.uvic.ca/elc/studyzone/330/grammar/gofut.htm >something is already planned or definit なるほどなー 365 名前：デフォルトの名無しさん [2008/12/23(火) 22:12:08 ] 「ニューヨークへ行きたいかー！」を訳すると、 Are you going to NewYork? だっけ？ Will you go to NewYork? になる？ willとgoing to の使い分けは日本人には難しいよねぇ 366 名前：デフォルトの名無しさん mailto:sage [2008/12/23(火) 22:24:43 ] (ﾉ∀`)ｱﾁｬｰ 367 名前：デフォルトの名無しさん mailto:sage [2008/12/23(火) 22:59:57 ] 今日このスレ見つけて１から流し読みしてたけど。 >>28のレス見て大爆笑した12月23日の俺。 368 名前：デフォルトの名無しさん mailto:sage [2008/12/23(火) 23:42:49 ] wanna(want to) go to NYじゃないのか? 369 名前：デフォルトの名無しさん mailto:sage [2008/12/24(水) 00:56:41 ] もういいよ。 次だ、次！ 370 名前：デフォルトの名無しさん mailto:sage [2008/12/24(水) 00:59:18 ] // I have had enough. // next one please!! 371 名前：デフォルトの名無しさん mailto:sage [2008/12/24(水) 02:46:12 ] // already good. // is next, next! 372 名前：デフォルトの名無しさん mailto:sage [2008/12/24(水) 08:16:21 ] Enough is enough. Go next. 373 名前：デフォルトの名無しさん mailto:sage [2008/12/24(水) 09:20:16 ] // Cow goo you! // Next that, next! 374 名前：デフォルトの名無しさん mailto:sage [2008/12/25(木) 18:45:20 ] // そして誰もいなくなった・・・ 375 名前：デフォルトの名無しさん mailto:sage [2008/12/25(木) 20:40:12 ] // いや、つまんないから 376 名前：デフォルトの名無しさん mailto:sage [2008/12/25(木) 20:45:27 ] // then no one comes here... 377 名前：デフォルトの名無しさん mailto:sage [2008/12/25(木) 20:46:00 ] // nope, you are boring. 378 名前：デフォルトの名無しさん [2008/12/27(土) 04:50:46 ] お願いします // お正月も仕事です。（T_T 379 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 05:01:40 ] // I will be die. 380 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 09:29:25 ] /// \warning I'll be mad. 381 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 09:33:13 ] // Happy new year. X-( 382 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 11:25:33 ] // Hown many night do I sleep till Oh show guts two? 383 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 11:42:49 ] // You shall die ;-p 384 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 12:44:50 ] // Show guts. 385 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 15:33:54 ] I have work even on New Year's Day. 386 名前：おねがいします mailto:sage [2008/12/27(土) 19:02:44 ] オーバーロード スクリプトは暴走しました。 ページを読み込み直すか、ブラウザを閉じてください。 387 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 19:09:48 ] それは同時にすべきではない。 複雑すぎる処理は死を招く！ 388 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 19:37:48 ] Overload: The script hangs. Reflesh page or close your browser. 389 名前：Excite様 mailto:sage [2008/12/27(土) 19:39:04 ] It should not be done at the same time. Too complex processing causes the death. 390 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 20:42:06 ] >>388-389 ありがとうございます！ さっそくエラー表示、書き換えてきます q･т･;p 391 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 20:59:37 ] 工ｴｴｪｪ(´д`)ｪｪｴｴ工 392 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 22:57:31 ] スクリプト実行が許可されてる時、次ページに移らないよう 注意を促す警告文です。 anti s: I warn in advance for crisis evasion. Before advancing, please stop the script. これで意味は通じますか？ 393 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 22:59:31 ] Stop script execution before proceeding to the next page. 394 名前：デフォルトの名無しさん mailto:sage [2008/12/27(土) 23:01:26 ] crisisよりはdisaesterかなー、と思いつつも両方大げさな希ガス。 to avoid unexpected behavior くらい? 395 名前：デフォルトの名無しさん [2008/12/28(日) 14:17:20 ] >>392 英語でコメントを書くとき、コメントの読者はネイティブだけではない ということを意識しなければならない。evasionという単語は滅多に 使わないから非ネイティブの一部には通じない可能性が高い。 また、警告メッセージで「I」とか「crisis」という言い回しは見たことがない。 警告メッセージを出すのはシステムであって「I」ではない。 crisisなんていうとハードウェアが爆発するぐらいの印象を受ける。 anti s:は何？　タイトルならば「WARNING:」が適切だと思う。 396 名前：デフォルトの名無しさん mailto:sage [2008/12/28(日) 14:26:22 ] catastropheだとパソコンが爆発して町が消し飛ぶぐらいの印象？ 397 名前：デフォルトの名無しさん mailto:sage [2008/12/28(日) 15:51:18 ] そもそも、evasionじゃ意味が合わない。 evasionは税金、義務、法律、運命などから逃れることで、 evasion of law　(脱法), evasion of responsibility (責任逃れ)のように使う。 crisis evasion で、危険の回避というつもりだったんだろうが、 和英辞典で調べた単語をつないでもネイティブには通じない。 398 名前：デフォルトの名無しさん mailto:sage [2008/12/28(日) 16:06:45 ] 英辞郎様は「危機回避はcrisis prevention」と仰っておりまする 399 名前：デフォルトの名無しさん mailto:sage [2008/12/28(日) 17:02:33 ] >398 危機とcrisisのカバーする範囲がどの程度重なるかを想像しよう。 400 名前：デフォルトの名無しさん mailto:sage [2008/12/29(月) 01:29:42 ] 沢山の回答、ありがとうございます！ >>395 ちょっとした理由がありスクリプトが有効な場合 別ページ(どこにも属さない一時的な)が開いて ーーーーー タイトルがWARNING 何のエラーに引っかかったか: 何を警告する為のページか どうすれば回避可能か ーーーーーーー みたいな Iがロボットの事務的な自動回答みたいで 結構、個人的に気に入ってたのですが｡･ﾟ･(ﾉД`)･ﾟ･｡ >>397 すみません 本人、英語が全く読み書きできなかったもので 日英相互翻訳器でそれらしい文を作って 逆翻訳で似た意味になってそうか 適当に試しただけなものでorz これでホントに意味が通じるかな？と 個人的にも半信半疑だったので プロの皆様方の目から、いかがなものかと ちょっと質問させていただきました 401 名前：デフォルトの名無しさん mailto:sage [2008/12/29(月) 01:46:25 ] >>400 こんなこというのもあれだけど このスレ頼るよりもっと他当たったほうがいいよ 402 名前：デフォルトの名無しさん mailto:sage [2008/12/29(月) 02:00:07 ] >>394 ありがとうございます(^∧^) 意味的にも「予期せぬ動作を避けるため」 の方があってる気がするので こちらに書き換えようかと この場合、説明があって→推奨される対策と続く方がよいでしょうか？ それとも指示があって→なぜそうしないといけないか？ と続く方がよいでしょうか？ >>393 ありがとうございます(^∧^) せっかく頂いたのですが頼りの翻訳器では多分 元の文の意味とは全く違うだろうなという 文字化け(？)記号列が数カ所orz ちょっと文が長いようなので 改行で区切って載せようかと考えたのですが 英語センス０のワタクシめには どこで区切ればよいのかも｡･ﾟ･(ﾉД`)･ﾟ･｡ 403 名前：デフォルトの名無しさん mailto:sage [2008/12/29(月) 04:49:53 ] 多分あんたに英語メッセージは5年ほど早いので諦めるがよい 基本的には自動翻訳なんてまったくアテにしてはいけない ちなみに >>393 はそれなりに自然な英語 >>392 の元の文は英語としてだいぶ不自然 404 名前：デフォルトの名無しさん mailto:sage [2008/12/29(月) 05:06:54 ] >402が何を言っているのか意味不明だけど、>393についてちょいと質問。 止める対象のscriptははっきりしているのだから"stop the script execution"になるってことはない? 405 名前：デフォルトの名無しさん mailto:sage [2008/12/29(月) 05:22:52 ] >>404 その the は execution にかかるので、スクリプトが特定できるかどうかは関係ないな そこに the が必要かどうかの判断は難しい （要らないんじゃないかという気はするが論理的には説明できん） それが気持ち悪いなら 　　Stop the script before ... とか 　　Stop running the script before ... とかで逃げる手はある 406 名前：デフォルトの名無しさん mailto:sage [2008/12/29(月) 10:56:50 ] >>395 > ということを意識しなければならない。evasionという単語は滅多に > 使わないから非ネイティブの一部には通じない可能性が高い。 おれ、英語圏で3年仕事してたけど、evasionなんて単語知らなかったよ… 初心者は簡単な単語をとりあえず繋げるところから始めた方が 意図を誤解されなくて済むと思う。って既出？（スレ全部読むのはツラい） メソッドとかのコメントって主語を省略して三単現の動詞で始める パターンが多いとか、そういうソースのコメントならではのネタも欲しい。 ↓こんなの。 /** * Retrieves configuration variables from the config file. */ 407 名前：デフォルトの名無しさん mailto:sage [2008/12/29(月) 11:34:50 ] >>406 the入れたくなるけど、不必要なんかな？ Retrieves THE configuration variables from the config file.

---

---

[ 続きを読む ] / [ 携帯版 ]

read.cgi ver5.27 [feat.BBS2 +1.6] / e.0.2 (02/09/03) / eucaly.net products.
担当:undef