英語マニュアルでよく使われる表現やその特徴を調べてみました。

■ 命令形
Retrieve the xml representation of a function.【出典】PEAR
関数のxml表現を取得します。

Print selected parts of lines from each FILE to standard output. 【出典】man cut
それぞれのファイルから、行を抽出して、標準出力に表示します。

上記に見られるように、完全な文章ではなく特に短文においては命令形での記載をします。

This command retrieve the… としないのは単純に短く表記するためだと思います。


ただし、必ずそうしなければ変かというと、そういうことでもないみたいで、

The mpstat command writes to standard output activities for each
available processor【出典】man mpstat
mpstat コマンドはプロセッサ毎の状態を標準出力に表示します。
と、同じ man の説明でもちゃんと主語を付けてる場合もあります。まあ、長いからなんでしょうね。


■ 「表示する」を表現する単語
これ結構悩みませんか？
上述の mpstat では、

・write
The mpstat command writes to standard output activities for each
available processor
mpstat コマンドはプロセッサ毎の状態を標準出力に表示します。

・report
Report interrupts statistics
割り込みの統計情報を表示します。(報告します、の方が正しいのかもしれませんが)

・show
Show the total number of interrupts received per second by the CPU or CPUs.
CPU の毎秒割込み回数のトータルを表示します。

・print
Print version number then exit
バージョンを表示した後、終了します。

・display
Display five reports of global statistics among all processors at two
second intervals.
2秒間隔で、すべての CPU を合算した統計情報を表示します。


と、使いそうな表現をあらかた使っており、表記ゆれを気にする我ら小日本人のノミの心臓をあざ笑うが如しです・・・。わざといろんな単語を使っているんでしょう。

ちなみに、他には、

・echo
Echo the STRING(s) to standard output
標準出力に文字列を表示します。

・output
output version information and exit
バージョンを表示した後、終了します。

なんかが使われてます。echo
コマンドの例はちょっと微妙かもしれませんが。で、上記の使い分けなんですが、ニュアンスで使い分けているんだろうなあとわかるものもあるのですが、これ別にあんまり考えて使い分けてないだろうなあというのもあって、よくわかりません。

まあこれ全部コンソールへの表示の話なので、GUI だとちょっと違ってくるかもしれません。show, display
あたりを使うことになるんでしょうか。なんか普通の結論になってしまいましたが・・・。

■ 必須項目

Mandatory arguments to long options are mandatory for short options
too.【出典】man sort
ロングオプションの必須項目はショートオプションでも必須です。

Both required and optional parameters are listed.【出典】PEAR
必須なパラメータおよびオプションのパラメータを列挙します。

mandatory は必須という意味で連発される単語です。学校で習いましたっけ？アルクでこの単語のレベルを調べてみたところ、「上級
Level 10　英文雑誌を楽しめる英単語」ということで、習ってない可能性が高いです。知ってないと意味は分からないですね。required
は逆に学校でも習う単語です。ソフトウェアの分野では両方ともよく見かけますね。

ただし、入力フォームなんかではこのような単語を使うよりは、以下のような表現が普通のようです。

Please note that all fields followed by an asterisk must be filled in.
アスタリスクが付いている入力欄はすべて必須項目です。

ちなみに、「項目」の方については、いろんな単語が当てはまりますが、引数、オプションあたりの日本語に対応する単語としては、

・argument
変数、引数
・parameter
引数、パラメーター
・option
オプション

こちらは、argument を使うのが一番普通の用です。コマンドの引数として使い、その引数によって挙動が変わる、という場合には、option
を使うのがしっくりくるでしょう。

argument は半分日本語というか、システム開発業界ではそのまま使われることも多いので、意味は「引数の事だな」とわかると思うのですが、argue
が言い争うみたいな意味なので、他分野の人から見たら？？？になる事請け合いですね。

逆に、よくある方の意味である「論争」っていう意味で、tech 系の文章の中にも現れたりするので、引数と読むと意味が分からなくなります。

Eventually, I find myself at the center of this argument.
結果的に、この手の論争の中心に身を置くことになっている。【出典】CodeWeblog

とかね。


■ 入力
って言ったらなんですか？input？日本では html タグの影響からか、input を使う事が多いそうですが、enter, entry
の方が一般的みたいです。ただこれも結構いろんな単語が使われるんですよね・・・。後は、type とか。上で出てきた必須項目の例文では、fill
in を使ってますね。

・enter
you will have to enter the name servers provided by your ISP.【出典】Gentoo Linux
プロバイダから提供されているネームサーバーを入力する必要があります。

・type
To finish the twm session, type in exit or Ctrl-D in the upcoming
xterms.【出典】Gentoo Linux
twmセッションを終了させるには、xtermにexitと入力するかCtrl-Dを押してください。

・input
Dead keys may be used to input characters in X that are not included
on your keyboard.【出典】Gentoo Linux
deadkeyをキーボードにない文字を入力するために使用するできるかもしれません。


ちなみに、単純に手で入力するっていうんじゃなくて、データベースなんかにデータを入れるっていう意味での「入力」の場合は、seve やら
store やらが出てきますが、これは「保存」ていう意味合いが強いでしょうね。

・store
methods to retrieve/store data are convenience methods that act as
proxy to the model.【出典】PEAR
データを取得/保存するためのメソッドは、モデルへのプロキシとして働きます。

・insert(ion)
as shown here by this example data insertion. 【出典】Gentoo Linux
以下にデータ挿入の例を示します。

・save
Save data, calls either update（） or add（）. 【出典】PEAR
save（$data） update（） あるいはadd（）のいずれかをコールしてデータを保存します。

save は、「節約する」っていう意味の方に取られる場合もあるので、ややこしいかもしれないです。

後は・・・set も使いますかね？set の場合は、設定するっていう意味あいが強いですね。きりがなくなるので例文は割愛しますが・・。


■ 注意してください。
・ Please note that …
… に注意してください。

訳す場合は、わざわざ訳さない場合もありますが、便利な言い回しですよね。

NOTE:

という風に使う場合もあります。

※注意

くらいの意味でしょうか。


ということで割とテーマレスになっちゃいました。これを書くにあたって、man
でいくつかのコマンドを読んでみたのですが、表記揺れがおおくて笑っちゃいました。逆に、日本人（特にプログラマーは？）は使う動詞を統一したがるのですが、外国ではひと固まりの文章中に同じ動詞を使うことを嫌うので、わざといろいろな動詞を使ったりするみたいです。

では、今日はこの辺で。

【関連記事】
読書に最適な透明付箋紙のご紹介
現場で出くわす不適切な和訳たち
コーディング規約の手っ取り早い導入方法
プログラマーのためのソースコードを読む技術 – レビュアー必読書籍
高級タクシー配車サービス Uber を使ってみました！
BootStrap を使ってみました！
電話かけ放題プラン LINE Viber Skype 通話サービスまとめ

Performance Testing With Jmeter 2.9
JMeter バージョン 2.10 について
JMeter バージョン 2.11 について