Merge pull request #201 from vim-jp/usr_02

みんなでちょっとずつ usr_02.jax を翻訳していくスレ

Author: koron

doc/usr_02.jax

@@ -498,190 +498,191 @@ Vim にはオプションがたくさんあり、それを設定することで
 
 概要:						*help-summary*  >
 
-1) Use Ctrl-D after typing a topic and let Vim show all available topics.
-   Or press Tab to complete: >
+1) トピックをタイプした後、あり得るトピック全てを表示させるには
+   Ctrl-D を使います。もしくはタブで補完します: >
     	:help some<Tab>
-<   More information on how to use the help: >
+<   help の使い方に関するより詳しい情報については: >
 	:help helphelp
 
-2) Follow the links in bars to related help.  You can go from the detailed
-   help to the user documentation, which describes certain commands more from
-   a user perspective and less detailed.  E.g. after: >
+2) バーで囲まれた関連ヘルプへのリンクを辿ってみて下さい。ヘルプの詳細から
+   ユーザー視点のコマンド説明で、あまり詳しすぎないユーザードキュメントへ移動
+   出来ます。例えば: >
    	:help pattern.txt
-<   You can see the user guide topics |03.9| and |usr_27.txt| in the
-   introduction.
+<   を見るとイントロダクション部分にユーザーガイドのトピック |03.9| や
+   |usr_27.txt| があるのが分かります。
 
-3) Options are enclosed in single apostrophes.  To go to the help topic for the
-   list option: >
+3) オプションは単一のアポストロフィで囲まれます。list オプションに関するヘル
+   プへ行くには: >
 	:help 'list'
-<   If you only know you are looking for a certain option, you can also do: >
+<   もし特定のオプションを探していないのであれば、以下でも可能です: >
 	:help options.txt
-<   to open the help page which describes all option handling and then search
-   using regular expressions, e.g. textwidth.
-   Certain options have their own namespace, e.g.: >
+<   正規表現を使って記載された全てのオプションを検索し textwidth 等のヘルプの
+   ページを見つけ出します。
+   特定のオプションには特有のネームスペースが付きます。例: >
    	:help cpo-<letter>
-<   for the corresponding flag of the 'cpoptions' settings, substitute <letter>
-   by a specific flag, e.g.: >
+<   は設定 'cpoptions' のフラグに対応します。<letter> は個別のフラグに置き換えて
+   下さい。例: >
   	:help cpo-;
-<   And for the guioption flags: >
+<   さらに guioption のフラグであれば: >
   	:help go-<letter>
 
-4) Normal mode commands do not have a prefix. To go to the help page for the
-   "gt" command: >
+4) ノーマルモードのコマンドにはプレフィックスはありません。"gt" コマンドのヘル
+   プへ行くには: >
    	:help gt
 
-5) Insert mode commands start with i_.  Help for deleting a word: >
+5) 挿入モードのコマンドは i_ で始まります。単語の削除に関するヘルプであれば: >
    	:help i_CTRL-W
 
-6) Visual mode commands start with v_.  Help for jumping to the other side of
-   the Visual area: >
+6) ビジュアルモードのコマンドは v_ で始まります。ビジュアル領域のもう片方へ
+   ジャンプする方法のヘルプであれば: >
    	:help v_o
 
-7) Command line editing and arguments start with c_.  Help for using the
-   command argument %: >
+7) コマンドラインの編集や引数は c_ で始まります。引数の % の使用方法の
+   ヘルプであれば: >
    	:help c_%
 
-8) Ex-commands always start with ":", so to go to the :s command help: >
+8) Exコマンドは常に ":" で始まります。よって :s コマンドのヘルプに
+   移動するには: >
 	:help :s
 
-9) Commands specifically for debugging start with ">".  To go to to the help
-   for the "cont" debug command: >
+9) デバッグに関するコマンドは ">" で始まります。
+   デバッグコマンドの "cont" のヘルプに移動するには: >
 	:help >cont
 
-10) Key combinations.  They usually start with a single letter indicating
-    the mode for which they can be used.  E.g.: >
+10) キーの組み合わせは通常、使用できるモードを表す1文字から始まります。
+    例えば: >
    	:help i_CTRL-X
-<    takes you to the family of Ctrl-X commands for insert mode which can be
-    used to auto complete different things.  Note, that certain keys will
-    always be written the same, e.g. Control will always be CTRL.
-    For normal mode commands there is no prefix and the topic is available at
-    :h CTRL-<Letter>. E.g.  >
+<    は挿入モードでそれぞれ異なるものを補完するCtrl-X 系コマンドに移動します。
+    Note いくつかのキーは常に同様に記載されています。
+    例えばコントロールキーは常に CTRL と記載されます。
+    ノーマルモードのコマンドはプレフィックスを持たず、項目は :h CTRL-<char>
+    により参照可能です。例えば >
    	:help CTRL-W
-<    In contrast >
+<    に対して >
 	:help c_CTRL-R
-<    will describe what the Ctrl-R does when entering commands in the Command
-    line and >
+<    はコマンドラインに入ったときの CTRL-R が行うことを説明しています。また >
    	:help v_Ctrl-A
-<    talks about incrementing numbers in visual mode and >
+<    はビジュアルモードでの数値のインクリメントを説明し >
 	:help g_CTRL-A
-<    talks about the g<C-A> command (e.g. you have to press "g" then <Ctrl-A>).
-    Here the "g" stand for the normal command "g" which always expects a second
-    key before doing something similar to the commands starting with "z"
+<    は g<C-A> コマンドについて述べています (これには "g" を押して <Ctrl-A>
+    を押す必要があります)。
 
-11) Regexp items always start with /.  So to get help for the "\+" quantifier
-    in Vim regexes: >
+11) 正規表現の項目は常に / で始まります。
+    よってVimの正規表現の "\+" 量化子のヘルプに移動するには: >
    	:help /\+
-<    If you need to know everything about regular expressions, start reading
-    at: >
+<    もし正規表現の全てに関して知りたいのなら、以下を参照してください: >
    	:help pattern.txt
 
-12) Registers always start with "quote". To find out about the special ":"
-    register: >
+12) レジスタは常に "quote" で始まります。特殊なレジスタ ":" について調べるので
+    あれば: >
    	:help quote:
 
-13) Vim Script (VimL) is available at >
+13) Vimスクリプト (VimL) は以下を参照。 >
 	:help eval.txt
-<   Certain aspects of the language are available at :h expr-X where "X" is a
-   single letter. E.g.  >
+<   Vimスクリプトのいくつかの側面については :h expr-X ("X" は1文字) に
+   記載されています。例えば >
    	:help expr-!
-<   will take you to the topic describing the "!" (Not) operator for
-   VimScript.
-   Also important is >
+<   はVimスクリプトの "!" (否定)演算子の説明の項目に移動します。
+   さらに重要なのが >
    	:help function-list
-<   to find a short description of all functions available.  Help topics for
-   VimL functions always include the "()", so: >
+<   にはすべての関数の簡潔な説明が記載されています。
+   ヘルプ項目のVimスクリプトの関数はすべて "()" を含みます。よって: >
    	:help append()
-<   talks about the append VimL function rather than how to append text in the
-   current buffer.
+<   は現在のバッファのテキストを append する方法ではなく
+   append 関数についての説明に移動します。
+   {訳注: |:append| ではなく |append()| に移動するという意味だと思われます。}
 
-14) Mappings are talked about in the help page :h |map.txt|. Use >
+14) マッピングについては :h |map.txt| で述べられています。 >
     	:help mapmode-i
-<    to find out about the |:imap| command.  Also use :map-topic
-    to find out about certain subtopics particular for mappings.  e.g: >
+<    |:imap| コマンドについて調べるなら上記を使用してください。
+    またマッピング固有のある項目を調べるには :map-topic
+    {訳注: "topic" は項目名} も使用できます。例えば: >
     	:help :map-local
-<    for buffer-local mappings or >
+<    はバッファローカルなマッピングに関する項目です。または >
 	:help map-bar
-<    for how the '|' is handled in mappings.
+<    は '|' がどのようにマッピングで処理されるかに関する項目です。
 
-15) Command definitions are talked about :h command-topic, so use >
+15) コマンド定義は :h command-topic で記載されます。カスタムコマンドの '!' 引
+     数については >
 	:help command-bar
-<    to find out about the '!' argument for custom commands.
+<    で見つける事ができます。
 
-16) Window management commands always start with CTRL-W, so you find the
-    corresponding help at :h CTRL-W_letter.  E.g. >
+16) ウィンドウの制御コマンドは常に CTRL-W で始まります。:h CTRL-W_文字 で該当
+    のヘルプが見つかります。例えば: >
    	:help CTRL-W_p
-<    for moving the previous accessed window.  You can also access >
+<    で一つ前のウィンドウへの移動のヘルプにアクセスできます。また自分のペースで
+    ウィンドウ操作コマンド群を眺めたいならば >
 	:help windows.txt
-<    and read your way through if you are looking for window handling
-    commands.
+<    でアクセスできます。
 
-17) Use |:helpgrep| to search in all help pages (and also of any installed
-    plugins).  See |:helpgrep| for how to use it.
-    To search for a topic: >
+17) 全てのヘルプ (とインストールしたプラグイン) のページを検索するには
+    |:helpgrep| を使用してください。使用法については |:helpgrep| を参照してください。
+    項目を検索するには {訳注: "topic" は項目名}: >
     	:helpgrep topic
-<    This takes you to the first match.  To go to the next one: >
+<    これにより最初にマッチした項目に移動します。次の項目に移動するには: >
 	:cnext
-<    All matches are available in the quickfix window which can be opened
-    with: >
+<    全てのマッチした項目は以下のコマンドで開くことできる QuickFix ウィンドウで
+    参照可能です: >
     	:copen
-<    Move around to the match you like and press Enter to jump to that help.
+<    好きな項目に移動し、 Enter を押すとそのヘルプにジャンプすることができます。
 
-18) The user manual.  This describes help topics for beginners in a rather
-    friendly way.  Start at |usr_toc.txt| to find the table of content (as you
-    might have guessed): >
+18) ユーザーマニュアルは初心者にとってより親しみやすい項目について
+    説明しています。(おそらくあなたの想像通り) |usr_toc.txt| でその目次を
+    見つけることができます: >
     	:help usr_toc.txt
-<    Skim over the contents to find interesting topics. The "Digraphs" and
-    "Entering special characters" items are in chapter 24, so to go to that
-    particular help page: >
+<    興味を持った項目を探すようにざっと眺めてみてください。
+    "ダイグラフ (Digraph)" と "特殊な文字を入力する" の項目は24章です。
+    そのページに移動するには: >
     	:help usr_24.txt
-<    Also if you want to access a certain chapter in the help, the chapter
-    number can be accessed directly like this: >
+<    また特定の章に直接アクセスしたければ、このように章番号でもアクセス
+    可能です: >
     	:help 10.1
-<    goes to chapter 10.1 in |usr_10.txt| and talks about recording macros.
+<    上記で |usr_10.txt| の10.1章に移動し、マクロの記録の解説が見れます。
 
-19) Highlighting groups.  Always start with hl-groupname.  E.g. >
+19) ハイライトグループは常に hl- から始まります。例えば >
     	:help hl-WarningMsg
-<    talks about the WarningMsg highlighting group.
+<    には WarningMsg ハイライトグループについて書かれています。
 
-20) Syntax highlighting is namespaced to :syn-topic e.g. >
+20) 構文ハイライトは :syn-トピック という形式になっています。例えば >
 	:help :syn-conceal
-<    talks about the conceal argument for the :syn command.
+<    には :syn コマンドの Conceal 引数について書かれています。
 
-21) Quickfix commands usually start with :c while location list commands
-    usually start with :l
+21) QuickFix コマンドは大体 :c から始まり、ロケーションリストコマンドは大体 :l
+    から始まります。
 
-22) Autocommand events can be found by their name: >
+22) Autocommand イベントはそれらの名前で見つける事ができます: >
      	:help BufWinLeave
-<    To see all possible events: >
+<    全てのイベントを見るには: >
 	:help autocommands-events
 
-23) Command-line switches always start with "-".  So for the help of the -f
-    command switch of Vim use: >
+23) コマンドラインスイッチは常に "-" から始まります。Vim のコマンドスイッチ -f
+    に関するヘルプであれば: >
     	:help -f
 
-24) Optional features always start with "+".  To find out about the
-    conceal feature use: >
+24) オプションの機能は常に "+" から始まります。 conceal 機能の使い方について調
+    べるのであれば: >
     	:help +conceal
 
-25) Documentation for included filetype specific functionality is usually
-    available  in the form ft-<filetype>-<functionality>.  So >
+25) ファイルタイプ特有の機能が含まれるドキュメントは通常
+    ft-<filetype>-<functionality> に存在します。よってCのシンタックスファイル
+    とそこで提供されているオプションについては以下に記載されます。 >
     	:help ft-c-syntax
-<    talks about the C syntax file and the option it provides.  Sometimes,
-    additional sections for omni completion >
+<    オムニ補完に関するセクションは >
     	:help ft-php-omni
-<    or filetype plugins >
+<    で、ファイルタイププラグインに関しては >
 	:help ft-tex-plugin
-<    are available.
+<    で提供されている事があります。 >
 
-26) Error and Warning codes can be looked up directly in the help.  So >
+26) エラーと警告のコードはhelpで直接引くことができます。よって >
 	:help E297
-<    takes you exactly to the description of the swap error message and >
+<    はスワップエラーメッセージの説明に移動し、また >
 	:help W10
-<    talks about the warning "Changing a readonly file".
-    Sometimes however, those error codes are not described, but rather are
-    listed at the Vim command that usually causes this.  So: >
+<    は "Changing a readonly file" の警告について述べます。
+    しかし時々エラーコードの説明が存在しない場合がありますが、
+    どちらかといえば大抵それを引き起こしたVimのコマンドの方に記載されている
+    でしょう。よって: >
     	:help E128
-<    takes you to the |:function| command
+<    は |:function| コマンドに飛びます。
 
 
 ==============================================================================