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

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

411:406
08/12/29 17:49:05
>>408
個人的な感覚ですまんが、メソッドのコメントは大体三単現な気がする。
で、メソッドの中のコメントには"s"が付いてないのが多い気がする。
メソッドの中のコメントは命令形なのかな～と勝手に解釈してたけど、
誰か詳しい人教えて。

例えば
/**
* Sends an email to the given recipient.
*/
public void sendEmail (Address recipient) {
//Check if the address is valid or not.
//（↑これって「アドレスが正しいかどうかチェック汁！」って事？）
}

ま、s があってもなくても意味が通じるし、とりあえずあまり拘らなくてもいいか。

>>410
なんつーか例が悪くてごめん。
設定ファイルから複数の設定値を取ってくるメソッドってあまりないよね。
Retrieves ALL THE configuration variables from the config file.
Retrieves A configuration variable of the given key from the config file.
とかなら大丈夫かな。

次ページ

続きを表示

1を表示