Merge pull request #1154 from tsuyoshicho/update/20221009/fold

Update fold.{txt,jax}

Author: k-takata

doc/fold.jax

@@ -1,4 +1,4 @@
-*fold.txt*      For Vim バージョン 9.0.  Last change: 2022 Jan 22
+*fold.txt*      For Vim バージョン 9.0.  Last change: 2022 Oct 01
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -34,7 +34,7 @@
 	marker		テキスト中の印で折り畳みを定義する
 
 
-手動(MANUAL)					*fold-manual*
+☆手動						*fold-manual*
 
 折り畳み領域を定義するためにコマンドを手動で利用する。これはテキスト中の折り畳
 みを行う箇所をスクリプトにより解析するのに使うこともできる。
@@ -46,7 +46,7 @@
 マンドを使用する。後に復元するには|:loadview|を使用する。
 
 
-インデント(INDENT)				*fold-indent*
+☆インデント					*fold-indent*
 
 折り畳みは各行のインデントにより自動的に定義される。
 
@@ -65,20 +65,22 @@
 で、ある行のインデントを取得するのに、関数|indent()|を使うことができる。
 
 
-式(EXPR)					*fold-expr*
+☆式							*fold-expr*
 
 折り畳みは "indent" 方式のように、折り畳みレベルによって自動的に定義される。
 'foldexpr' オプションの値は、各行についてこの折り畳みレベルを計算するためにス
 クリプトとして実行される。例:
 タブで始まる一連の行範囲を1つの折り畳みにまとめる: >
 	:set foldexpr=getline(v:lnum)[0]==\"\\t\"
-折り畳みレベルを計算するのに Vim script の関数を呼び出す: >
-	:set foldexpr=MyFoldLevel(v:lnum)
 空行で仕切られた「段落」を折り畳みとする: >
     :set foldexpr=getline(v:lnum)=~'^\\s*$'&&getline(v:lnum+1)=~'\\S'?'<1':1
 同じ事(「段落」を折り畳みに)をする別の表現: >
     :set foldexpr=getline(v:lnum-1)=~'^\\s*$'&&getline(v:lnum)=~'\\S'?'>1':1
 
+最も効果的なのはコンパイル済み関数を引数なしで呼ぶ: >
+	:set foldexpr=MyFoldLevel()
+関数は v:lnum を使用しなくてはいけない。|expr-option-function| を参照。
+
 バックスラッシュ(日本では \ 記号)が ":set" の流儀で、通常とは異なるキャラクタ
 (空白文字、バックスラッシュ、ダブルクォート、その他、詳細は|option-backslash|
 参照)をエスケープしていることに注意。
@@ -143,7 +145,7 @@ NOTE: 各行について式評価が実行されるので、この折り畳み
 に更新すること。
 
 
-構文(SYNTAX)					*fold-syntax*
+☆構文						*fold-syntax*
 
 折り畳みが "fold" 引数を持つ構文要素によって定義される。 |:syn-fold|
 
@@ -156,7 +158,7 @@ NOTE: 各行について式評価が実行されるので、この折り畳み
 	:syn sync fromstart
 
 
-差分(DIFF)					*fold-diff*
+☆差分						*fold-diff*
 
 テキストの変更された箇所とその近辺以外が自動的に折り畳みとして定義される。
 
@@ -173,7 +175,7 @@ NOTE: 各行について式評価が実行されるので、この折り畳み
 'scrollbind' が設定されているとき、Vimは他のウィンドウと見た目が同じになるよう
 にフォールドを開いた状態に保とうとする。
 
-印(MARKER)					*fold-marker*
+☆印						*fold-marker*
 
 テキスト中の印により折り畳みの開始と終了地点を指定する。これにより明確に折り畳
 みを設定することができる。また誤った行を含むことなく、折り畳みを削除・設定でき
@@ -465,7 +467,7 @@ zk		カーソルより上方の折り畳みへ移動する。閉じられた折
 ==============================================================================
 3. 折り畳みオプション				*fold-options*
 
-色							*fold-colors*
+☆色							*fold-colors*
 
 閉じられた折り畳みの色はFoldedグループによって設定される|hl-Folded|。折り畳み
 表示カラムの色はFoldColumnグループによって設定される|hl-FoldColumn|。
@@ -475,7 +477,7 @@ zk		カーソルより上方の折り畳みへ移動する。閉じられた折
 	:highlight FoldColumn guibg=darkgrey guifg=white
 
 
-折り畳みレベル						*fold-foldlevel*
+☆折り畳みレベル					*fold-foldlevel*
 
 'foldlevel' は数を設定するオプションである: 大きな数を設定するとより多くの折り
 畳みが開かれる。
@@ -490,7 +492,7 @@ zk		カーソルより上方の折り畳みへ移動する。閉じられた折
 ていた折り畳みは開かれない。
 
 
-折り畳みテキスト						*fold-foldtext*
+☆折り畳みテキスト     					*fold-foldtext*
 
 'foldtext' は式を指定する文字列オプションである。この式は閉じられた折り畳みを
 示すテキストを得るために評価実行される。例: >
@@ -499,7 +501,7 @@ zk		カーソルより上方の折り畳みへ移動する。閉じられた折
 
 これは折り畳みの最初の1行を、"/*" と "*/" を追加し "{{{" を削除して表示する。
 多めのバックスラッシュ(\ 記号)はある文字が ":set" コマンドに解釈されてしまうの
-を避けるために使用されている。これは以下のように関数を定義するとより簡単になる:
+を避けるために使用されている。これは以下のように関数を定義すると最も簡単になる:
 >
 
     :set foldtext=MyFoldText()
@@ -509,6 +511,9 @@ zk		カーソルより上方の折り畳みへ移動する。閉じられた折
     :  return v:folddashes .. sub
     :endfunction
 
+引数なしでの関数呼び出しを使用する利点は高速なことである、
+|expr-option-function| を参照のこと。
+
 'foldtext' は|sandbox|環境下で実行評価される。現在のウィンドウはそのラインの属
 するウィンドウへ設定される。コンテキストはオプションを最後に設定したスクリプト
 のものが設定される。
@@ -539,7 +544,7 @@ zk		カーソルより上方の折り畳みへ移動する。閉じられた折
 ブルクォートを使う場合にはバックスラッシュが必要である。 |option-backslash|
 
 
-折り畳み表示カラム						*fold-foldcolumn*
+☆折り畳み表示カラム					*fold-foldcolumn*
 
 'foldcolumn' は、ウィンドウの端に確保される折り畳みを示すカラムの幅を指定する
 数。0 ならば、折り畳み表示カラムは確保されない。通常は4から5が一般的。使い物に

en/fold.txt

@@ -1,4 +1,4 @@
-*fold.txt*      For Vim version 9.0.  Last change: 2022 Jan 22
+*fold.txt*      For Vim version 9.0.  Last change: 2022 Oct 01
 
 
 		  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -74,8 +74,6 @@ method.  The value of the 'foldexpr' option is evaluated to get the foldlevel
 of a line.  Examples:
 This will create a fold for all consecutive lines that start with a tab: >
 	:set foldexpr=getline(v:lnum)[0]==\"\\t\"
-This will call a function to compute the fold level: >
-	:set foldexpr=MyFoldLevel(v:lnum)
 This will make a fold out of paragraphs separated by blank lines: >
 	:set foldexpr=getline(v:lnum)=~'^\\s*$'&&getline(v:lnum+1)=~'\\S'?'<1':1
 This does the same: >
@@ -84,6 +82,10 @@ This does the same: >
 Note that backslashes must be used to escape characters that ":set" handles
 differently (space, backslash, double quote, etc., see |option-backslash|).
 
+The most efficient is to call a compiled function without arguments: >
+	:set foldexpr=MyFoldLevel()
+The function must use v:lnum.  See |expr-option-function|.
+
 These are the conditions with which the expression is evaluated:
 - The current buffer and window are set for the line.
 - The variable "v:lnum" is set to the line number.
@@ -501,7 +503,7 @@ is evaluated to obtain the text displayed for a closed fold.  Example: >
 
 This shows the first line of the fold, with "/*", "*/" and "{{{" removed.
 Note the use of backslashes to avoid some characters to be interpreted by the
-":set" command.  It's simpler to define a function and call that: >
+":set" command.  It is much simpler to define a function and call it: >
 
     :set foldtext=MyFoldText()
     :function MyFoldText()
@@ -510,6 +512,9 @@ Note the use of backslashes to avoid some characters to be interpreted by the
     :  return v:folddashes .. sub
     :endfunction
 
+The advantage of using a function call without arguments is that it is faster,
+see |expr-option-function|.
+
 Evaluating 'foldtext' is done in the |sandbox|.  The current window is set to
 the window that displays the line.  The context is set to the script where the
 option was last set.