Merge pull request #1705 from gemmaro/arrange/para

Remove redundant paragraphs, split one, and others

Author: k-takata

doc/builtin.jax

@@ -3102,16 +3102,6 @@ filter({expr1}, {expr2})					*filter()*
 		|Vim9| script では結果が true、false、0もしくは1になる。
 		それ以外の値では結果が型エラーになる。
 
-		この操作はその場で(in-place)行われる。リストや辞書を変更したく
-		ない場合は最初にコピーを作ること: >
-			:let l = filter(copy(mylist), 'v:val =~ "KEEP"')
-
-<		{expr1}のリスト |List|、|Blob|、 または辞書 |Dictionary| をフ
-		ィルターした結果を返す。{expr2}を評価している最中にエラーが発
-		生した場合は、{expr1}内のそれ以降の要素の処理は行われない。
-		{expr2}が関数参照の場合、関数が "abort" フラグつきで定義されて
-		いない限り、関数内のエラーは無視される。
-
 		リストや辞書でのこの操作はその場で(in-place)行われる。変更した
 		くない場合は最初にコピーを作ること: >
 			:let l = filter(copy(mylist), 'v:val =~ "KEEP"')
@@ -4826,10 +4816,6 @@ getregionpos({pos1}, {pos2} [, {opts}])            *getregionpos()*
 					対して "col" 値 0 が使用される。
 					(デフォルト: |FALSE|)
 
-		'virtualedit' が使用されない限り、"off" の数値はゼロである。次
-		に、それは文字の先頭からの画面桁のオフセットになる。例えば、
-		<Tab> 内または最後の文字の後の位置である。
-
 		|method| としても使用できる: >
 			getpos('.')->getregionpos(getpos("'a"))
 <
@@ -4996,11 +4982,6 @@ gettagstack([{winnr}])					*gettagstack()*
 
 gettext({text} [, {package}])				*gettext()*
 		可能であれば文字列 {text} を翻訳する。
-		これは主に配布する Vim script で使う。
-		メッセージの翻訳を生成するときに {text} が xgettext によって抽
-		出され、翻訳者が .po ファイルで翻訳済みメッセージを追加でき
-		Vim は gettext() が呼ばれた時に翻訳を検索する。
-
 		これは Vim script で使用するためのものである。メッセージの翻訳
 		を生成するときに、{text} は `xgettext` によって抽出され、翻訳
 		者は翻訳されたメッセージを .po ファイルに追加することができ、

doc/fold.jax

@@ -77,14 +77,14 @@
 同じ事(「段落」を折り畳みに)をする別の表現: >
     :set foldexpr=getline(v:lnum-1)=~'^\\s*$'&&getline(v:lnum)=~'\\S'?'>1':1
 
-最も効果的なのはコンパイル済み関数を引数なしで呼ぶ: >
-	:set foldexpr=MyFoldLevel()
-関数は v:lnum を使用しなくてはいけない。|expr-option-function| を参照。
-
 バックスラッシュ(日本では \ 記号)が ":set" の流儀で、通常とは異なるキャラクタ
 (空白文字、バックスラッシュ、ダブルクォート、その他、詳細は|option-backslash|
 参照)をエスケープしていることに注意。
 
+最も効果的なのはコンパイル済み関数を引数なしで呼ぶ: >
+	:set foldexpr=MyFoldLevel()
+関数は v:lnum を使用しなくてはいけない。|expr-option-function| を参照。
+
 式が評価される際の前提条件は以下の通り:
 - その行について現在のバッファとウィンドウが常に存在している。
 - 変数 "v:lnum" には評価対象となる行番号が設定されている。

doc/syntax.jax

@@ -3661,9 +3661,6 @@ syntax/tex.vimにそのパッケージを対応させてほしいと思うだろ
 変数 "starform" が真ならば、あなたが作ったmathグループがアスタリスクつきの形を
 もつことを意味する(例. eqnarray*)。
 
-LOCALMATHをあなたが決めた新しいmathグループに書き換える必要がある。そしてこれ
-を.vim/after/syntax/tex.vimに加えること。
-
 					*tex-style* *b:tex_stylish*
  Tex: 新しいスタイルを始めるには ~
 
@@ -5106,11 +5103,13 @@ Note: "*/" を含む文字列で行をまたぐものがあると、Cコメン
 			同様に、'packpath' 内の全てのプラグインを検索し、それ
 			ぞれについて "start" 内、"opt" 内の順で検索する。
 
-再帰的な読み込みはされない。つまりカラースキームスクリプト中で ":colorscheme"
-を使うことはできない。カラースキームのカスタマイズには2つの選択肢がある。特定
-の色の見栄えを変えるため、カラースキームを読み込む前にカラー名を再定義すること
-ができる。desert スキームは、カーソルに khaki 色が使用されている。同じ色のより
-暗いバリエーションを使用する場合: >
+			再帰的な読み込みはされない。つまりカラースキームスクリ
+			プト中で ":colorscheme"を使うことはできない。
+
+カラースキームのカスタマイズには2つの選択肢がある。特定の色の見栄えを変えるた
+め、カラースキームを読み込む前にカラー名を再定義することができる。desert スキー
+ムは、カーソルに khaki 色が使用されている。同じ色のより暗いバリエーションを使
+用する場合: >
 
 	let v:colornames['khaki'] = '#bdb76b'
 	colorscheme desert

doc/usr_51.jax

@@ -276,10 +276,6 @@ Note: 28 行目では ":noremap" を使って、他のマップでトラブル
 れます。そして、同じスクリプトが再読み込みされると、再び同じ変数が使われます。
 |s:var|
 
-スクリプト変数は、同じスクリプトの中で定義された関数、自動コマンド、ユーザー定
-義コマンドでも使えます。我々の例に、修正の数を数えるための数行のコードを追加し
-ます
-
 |Vim9| script の良いところは、変数がデフォルトでスクリプトローカルであるという
 ことです。必要に応じて "s:" を前に付けることができますが、そうする必要はありま
 せん。また、スクリプト内の関数も、プリフィックスなしでスクリプト変数を使用する

doc/vim9.jax

@@ -1990,10 +1990,6 @@ export された項目は、別のスクリプトで import することがで
 の変数ではなく、コピーが変更されるからです。ドットを含む完全な名前を使用する必
 要があります。
 
-`:import` は旧来の Vim script でも使用することができます。"s:" というプリフィ
-ックスが与えられていない場合でも、import された項目はスクリプトローカルとなり
-ます。
-
 関数内で `:import` を使用することはできません。import された項目はスクリプトレ
 ベルに存在し、一度だけ import されることを意図しています。