Update starting.{txt,jax}

Author: h-east

doc/starting.jax

@@ -1,4 +1,4 @@
-*starting.txt*  For Vim バージョン 9.1.  Last change: 2023 Oct 20
+*starting.txt*  For Vim バージョン 9.1.  Last change: 2024 Mar 13
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -112,10 +112,10 @@ gvimdiff vim -gd    差分モードで起動|diff-mode|
 "gvim-8" という名前を付けることができる。もちろんその名前で実行可能なファイル
 がなければならない。
 
-UNIXでは通常、Vimという名前の実行可能ファイルが一つあり、それに対して違う名前
+UNIXでは通常、"vim" という名前の実行可能ファイルが一つあり、それに対して違う名前
 のリンクが用意される。使用しているシステムがリンクをサポートせず、実行ファイル
 のコピーを幾つも作りたくないのならば、リンクの代わりにエイリアスを使うこともで
-きる。例: >
+きる。例えば、C シェル系の場合: >
 	alias view   vim -R
 	alias gvim   vim -g
 <
@@ -187,7 +187,7 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 		"-S" 引数は "-c" として同じように数える。
 
 --cmd {command}						*--cmd*
-		vimrcファイルを処理する前に{command}を実行する。それ以外は
+		vimrcファイルを処理する前に{command}を実行する。それ以外は、
 		-c {command} と同じである。"-c" 引数とは別に、10個まで使うこと
 		ができる。
 
@@ -275,8 +275,8 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 
 							*-s-ex*
 -s		サイレント(もしくはバッチ)モード。Vimが "ex" で起動されるか、
-		このオプションよりも先に "-e" が付いていた場合にだけ働く。そう
-		でない場合には|-s|を参照。|-s|として使うときには引数をとる。
+		このオプションよりも先に "-e" が付いていた場合にだけ働く。それ
+		以外は、|-s|を参照。|-s|として使うときには引数をとる。
 		端末の替わりにファイルからExコマンドを実行する場合に使用され
 		る。ほとんどのプロンプトとメッセージは抑制される。警告とエラー
 		のメッセージも抑制される。
@@ -285,12 +285,12 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 			:list
 			:number
 			:set      オプション値を表示するため。
-		'verbose' が0以外のときにはメッセージは抑制されずに標準エラー
+		'verbose' が0以外の場合は、メッセージは抑制されずに標準エラー
 		出力へ表示される(デバッグ用)。
 		'term' と $TERM は考慮されない。
-		Vimが停止しているようだったら "qa!<Enter>" と入力してみてほし
-		い。Vimがユーザーの入力を待っているときでもプロンプトは表示さ
-		れない。
+		Vimが停止しているようだったら、"qa!<Enter>" と入力してみてほし
+		い。Vimがユーザーの入力を待っているときでも、プロンプトは表示
+		されない。
 		初期化処理はスキップされる(このオプションが引数 "-u" と一緒に
 		使われた場合は除く)。
 		例: >
@@ -313,8 +313,8 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 							*-A*
 -A		アラビア語モード。オプション 'arabic' をオンに設定する。
 		{|+arabic|(これは|+rightleft|も含んでいる)が有効なときだけ使用
-		できる。そうでないときにはVimはエラーメッセージを出力して終了
-		する}
+		できる。そうでない場合、Vimはエラーメッセージを出力して終了す
+		る}
 
 							*-F*
 -F		これはFarsi(ペルシア語モード)で使用されていましたが、削除され
@@ -323,8 +323,8 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 							*-H*
 -H		Hebrew(ヘブライ語)モード。オプション 'hkmap' と 'rightleft' を
 		オンに設定する。{|+rightleft|を有効にしてコンパイルした時にだ
-		け使用可。そうでない場合Vimはエラーメッセージを表示して終了す
-		る}
+		け使用可。そうでない場合、Vimはエラーメッセージを表示して終了
+		する}
 
 							*-V* *verbose*
 -V[N]		詳細表示する。オプション 'verbose' を[N]に設定する(Nを省略した
@@ -406,7 +406,7 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 		の編集用として開かれる。
 
 							*-O*
--O[N]		N個のウィンドウを垂直分割して開く。それ以外は|-o|と同じ。
+-O[N]		N個のウィンドウを垂直分割して開く。それ以外は、|-o| と同じ。
 		-oと-Oが両方指定されたときは最後に指定された方を使用する。
 
 							*-p*
@@ -478,8 +478,10 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 
 		これにより特殊なマッピングや設定をした、特殊なモードでVimを起
 		動することができる。これを簡単に使用するにはシェルのエイリア
-		スが使えるだろう。例: >
-			alias vimc vim -u ~/.c_vimrc !*
+		スが使えるだろう。例えば、C シェル系の場合: >
+			alias vimc 'vim -u ~/.c_vimrc \!*'
+<		そして、Bash シェルの場合: >
+			alias vimc='vim -u ~/.c_vimrc'
 <		autocommandを使うことも考慮すべきである。|autocommand|を参照。
 
 		{vimrc}に "NONE" (全て大文字)が指定された時には、設定ファイル
@@ -533,8 +535,9 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 		を取得したり、Xのクリップボードを使ったコピー/ペーストを使用し
 		たりしない。端末エミュレータでVimを使用するときにXサーバーとの
 		通信速度が遅い場合にそれを回避できる。
-		効果があるか確かめるには |--startuptime| を使ってみること。
-		UnixかVMSで|+X11|が有効な場合のみ意味がある。
+		この効果があるか確かめるには |--startuptime| を使ってみること。
+		UnixかVMSでは、|+X11| 機能つきでコンパイルした場合のみ違いがあ
+		る。それ以外は、無視される。
 		特定の端末を使用するときだけ通信を無効にするには、オプション
 		'clipboard' を参照。
 		X11 Session Management Protocol (XSMP) の処理が組み込まれてい
@@ -561,7 +564,7 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 		ル "scriptout" が存在する場合には、そのファイルに追加保存する。
 		|complex-repeat|も参照。
 		{scriptout} は数字で始まってはならない。
-		入力された内容を人間が読めるように記録したい場合は、
+		入力された内容を人間が読める形式で記録したい場合は、
 		|ch_logfile()| を使用することができる。これは "raw key input"
 		行を追加する。
 		|--log| も参照。
@@ -651,7 +654,7 @@ VMSでは全てのオプション引数は小文字であるとみなされる
 だけしか使えないことを意味している。しかし引数 "-v" が与えられれば、Vimは常に
 ノーマルモードで起動する。
 
-unix互換のシステムでX11 GUIサポートが有効ならさらに多くの引数が利用可能であ
+Unix互換のシステムでX11 GUIサポートが有効ならさらに多くの引数が利用可能であ
 る。|gui-resources|を参照。
 
 ==============================================================================
@@ -719,7 +722,7 @@ Evimでは以下のオプションが標準設定から変更される:
 	:set incsearch		検索時、入力途中にマッチ箇所を表示する
 	:set mouse=a		全てのモードでマウスを使う
 	:set hlsearch		検索した文字を強調表示する
-	:set whichwrap+=<,>,[,]  <Left>と<Right>を使った左右の移動で行を跨ぐ
+	:set whichwrap+=<,>,[,]	<Left>と<Right>を使った左右の移動で行を跨ぐ
 	:set guioptions-=a	非Unixのみ。選択時に自動的にコピーしない
 
 キーマッピング:
@@ -812,7 +815,7 @@ Evimでは以下のオプションが標準設定から変更される:
 	化処理がスキップされる。オプション "-u" だけが処理される。
 							*evim.vim*
      a. Vimを|evim|や|eview|として、あるいは|-y|引数を指定して起動すると
-	$VIMRUNTIME/evim.vimが実行される。
+	$VIMRUNTIME/evim.vim が実行される。
 							*system-vimrc*
      b. Unix、MS-Windows、VMS、Macintosh、そしてAmigaでは、システムのvimrcファ
 	イルが初期化のために読み込まれる。このファイルのパスは ":version" コマ
@@ -907,7 +910,7 @@ Evimでは以下のオプションが標準設定から変更される:
 	と 'shellredir' オプションが設定される。つまり自分で設定しなくても、
 	Vimが適切な 'shellpipe' と 'shellredir' の値を設定してくれる。
 
-6. "-n" コマンド引数が使用されていたら、'updatecount' を0に設定する
+6. "-n" コマンド引数が使用されていたら、'updatecount' を0に設定する。
 
 7. バイナリオプションを設定する
 	Vimの起動時に "-b" フラグが与えられた場合、この時点でバイナリ編集用の
@@ -948,7 +951,7 @@ Evimでは以下のオプションが標準設定から変更される:
 
 スタンダードセットアップ:
 全ての編集セッションに有効な、デフォルト設定とキーマッピングを設定するvimrc
-ファイルを作成する。それを既に3bで述べた位置に置く:
+ファイルを作成する。それを既に 3b. で述べた位置に置く:
 	~/.vimrc	(Unix)
 	s:.vimrc	(Amiga)
 	$VIM\_vimrc	(Win32)
@@ -1054,11 +1057,11 @@ skip_defaults_vim を行うと良い。
 							*trojan-horse*
 現在のディレクトリにある "vimrc" や "exrc" を読み込むときに、'secure' オプショ
 ンを設定することで、安全性のために幾つかのコマンドを無効にすることができる。タ
-グファイル内のコマンドを実行する際にも常にこれが行われる。そうでないと他人が作
-成した悪意を持ったコマンドを、偶然実行してしまう可能性がある。使用不可になるコ
-マンドは、シェルを起動するものと、ファイルに書き込むものと、そして ":autocmd"
-である。":map" コマンドは表示され、どのようなマッピングがなされたか確認するこ
-とができる。
+グファイル内のコマンドを実行する際にも常にこれが行われる。それ以外では、他人が
+作成した悪意を持ったコマンドを、偶然実行してしまう可能性がある。使用不可になる
+コマンドは、シェルを起動するものと、ファイルに書き込むものと、そして
+":autocmd" である。":map" コマンドは表示され、どのようなマッピングがなされたか
+確認することができる。
 	ローカルなvimrcファイル内で全てのコマンドを実行したい場合には、EXINIT
 かVIMINIT環境変数か、グローバルな "exrc" もしくは "vimrc" ファイルで 'secure'
 オプションをオフに設定する。現在のディレクトリにある "vimrc" と "exrc" からは、
@@ -1212,9 +1215,10 @@ Vimを再びフォアグラウンドに戻せば、続きの作業を行うこ
 である。この場合、シェルを終了させればVimで続きの作業を行うことができる。
 {訳注: |vim-modes|に何がある?}
 
-X-windowsではVimをサスペンドするとセレクションの所有権が失われる。つまり選択し
-ていた内容を他のアプリケーションにコピーすることができない(そうしないとVimが停
-止しているのでセレクションを得ようとしたプログラムがフリーズしてしまう)。
+X Window システム環境では、Vimをサスペンドするとセレクションの所有権が失われ
+る。つまり選択していた内容を他のアプリケーションにコピーすることができない(そ
+うしないとVimが停止しているのでセレクションを得ようとしたプログラムがフリーズ
+してしまう)。
 
 ==============================================================================
 7. 終了							*exiting*
@@ -1322,8 +1326,8 @@ Note: .vimrcファイルを作成するときにはオプション 'compatible'
 							*:mks* *:mksession*
 :mks[ession][!] [file]	現在のセッションを復元するための Vim script を作成す
 			る。
-			[!]を付けたときはファイルを上書保存する。
-			[file]を省略したときは "Session.vim" に保存する。
+			[!] を付けたときは、ファイルを上書保存する。
+			[file] を省略したときは、"Session.vim" に保存する。
 
 ":mksession" の出力は ":mkvimrc" の出力に似ているが、さらにいくつかのコマンド
 が追加されている。どのコマンドが出力されるかはオプション 'sessionoptions' に依
@@ -1380,7 +1384,7 @@ Note: .vimrcファイルを作成するときにはオプション 'compatible'
 							*:mkvie* *:mkview*
 :mkvie[w][!] [file]	現在のウィンドウの状態を復元するための Vim script を作
 			成する。
-			[!]を付けたときはファイルを上書保存する。
+			[!] を付けたときは、ファイルを上書保存する。
 			[file] を省略したり、1から9の数字を指定したときは、
 			'viewdir' に指定されたディレクトリに適切な名前で保存さ
 			れる。'viewdir' の最後に指定されたパスが存在しないとき
@@ -1396,13 +1400,14 @@ Note: .vimrcファイルを作成するときにはオプション 'compatible'
 
 ":mkview" の出力は次の項目を含んでいる:
 1. ウィンドウで使用している引数リストを復元する。グローバルな引数リストを使っ
-   ているときにはそれが使用される。
+   ているときには、それが使用される。
    引数リストのインデックスも復元される。
 2. ウィンドウで編集していたファイルを開く。編集していたファイルがなければ、空
    のウィンドウが作成される。
 3. 'viewoptions' が "options" か "localoptions" を含んでいるときは、その
    バッファやウィンドウに特有な(ローカルな)、マッピング、短縮(abbreviations)、
-   オプション、を復元する。
+   オプション、を復元する。カレントバッファとカレントウィンドウにローカルなオ
+   プション値だけが復元される。
    セッションの一部としてビューを保存するときに、'sessionoptions' に "options"
    が含まれているときは、オプションのグローバルな値とローカルな値が両方保存さ
    れる。
@@ -1515,7 +1520,8 @@ Vimが終了する時に 'viminfo' が空でなかったら、情報がviminfo
 - ファイルのマーク
 このタイムスタンプ機能自体は Vim 8.0 よりも以前に追加された。Vim 7.4.1131 以降
 の Vim 7.4 では各アイテムにタイムスタンプを記録しているが、使ってはいない。そ
-のため古いVimと新しいVimを混在して使う場合には、常に新しいデータが維持される。
+のため、古い Vim と新しい Vim を混在して使う場合には、常に新しいデータが維持さ
+れる。
 
 Note: Unixにおける注意点:
 - viminfoファイルには入力したテキストや、使用したコマンドが記載されているの
@@ -1527,7 +1533,7 @@ Note: Unixにおける注意点:
   ること！
 - 現在の "本当" のユーザーによって書き込み不能なviminfoファイルは、Vimは決して
   上書きしない。これは "su" でrootユーザーになった時、しかし$HOMEがまだ通常ユー
-  ザーのホームディレクトリのままの時の助けとなる。そうでないとVimはroot所有の、
+  ザーのホームディレクトリのままの時の助けとなる。それ以外は、Vimはroot所有の、
   他の誰にも読めないviminfoファイルを作成してしまう。
 - viminfo ファイルはシンボリックリンクであってはならない。セキュリティ上の問題
   を避けるためである。
@@ -1556,11 +1562,11 @@ Note: Unixにおける注意点:
 
 	vim -c "normal '0"
 
-csh 互換なシェルではエイリアスをこんな風に使用して: >
+C シェル系ではエイリアスをこんな風に使用して: >
 
 	alias lvim vim -c '"'normal "'"0'"'
 
-bash ライクなシェルでは: >
+Bash ライクなシェルでは: >
 
 	alias lvim='vim -c "normal '\''0"'
 
@@ -1602,8 +1608,8 @@ viminfoファイルを手動で読み書きする			*viminfo-read-write*
 viminfoファイルを手動で読み書きするのに2つのコマンドが用意されている。これは同
 時に起動している複数のVim間で、レジスタの内容を交換するのに利用できる: まず片
 方で ":wv" してから、もう片方で ":rv" する。既にレジスタに何かを記憶している場
-合には、":rv!" する必要があることに注意。またこれを行うとコマンドラインの履歴
-を含む全ての情報が、送り側のVimのもので上書きされてしまうことにも注意。
+合には、":rv!" する必要があることに注意。また、これを行うとコマンドラインの履
+歴を含む全ての情報が、送り側のVimのもので上書きされてしまうことにも注意。
 
 viminfoファイル自体を手で編集することもできるが、Vimによって作られる正しい
 フォーマットのviminfoを元にすることを推奨する。一度試してみればどういう構造に
@@ -1646,7 +1652,7 @@ viminfoを上書きしたいのならば、エラーを修正するか、また
 			に設定されている場合は、100個のファイルのマークが書き
 			出される。
 			"E929: Too many viminfo temp files" ("E929: 一時
-			viminfoファイルが多過ぎます!") というエラーが出たとき
+			viminfoファイルが多過ぎます!")、というエラーが出たとき
 			には古い一時ファイル (例えば~/.viminf*) が残っていない
 			ことを確かめ、.viminfoファイルを保存するディレクトリの
 			書込み権限を確認すること。
@@ -1668,7 +1674,7 @@ viminfoを上書きしたいのならば、エラーを修正するか、また
 			ファイルを開く。
 			|press-enter| プロンプトが表示されたときは "q" を押す
 			とファイル番号を入力するプロンプトに戻れる。
-			! をつけると変更中のバッファを破棄する。|abandon|
+			[!] をつけると変更中のバッファを破棄する。|abandon|
 			{tiny でコンパイルされたときは利用できない}
 
  vim:tw=78:ts=8:noet:ft=help:norl: