]> git.ipfire.org Git - thirdparty/vim.git/commitdiff
runtime(doc): Fix style in fold.txt
authorh-east <h.east.727@gmail.com>
Tue, 17 Dec 2024 19:48:42 +0000 (20:48 +0100)
committerChristian Brabandt <cb@256bit.org>
Tue, 17 Dec 2024 19:48:42 +0000 (20:48 +0100)
closes: #16236

Co-authored-by: zeertzjq <zeertzjq@outlook.com>
Signed-off-by: h-east <h.east.727@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>
runtime/doc/fold.txt

index cf9208936f8e461948b8c7f5b110df4886590d3d..b6cb2a44091a28f53383631f50609333f91ec094 100644 (file)
@@ -1,4 +1,4 @@
-*fold.txt*      For Vim version 9.1.  Last change: 2024 Dec 16
+*fold.txt*      For Vim version 9.1.  Last change: 2024 Dec 17
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -106,7 +106,8 @@ The result of foldexpr then determines the fold level as follows:
   "<1", "<2", ..       a fold with this level ends at this line
   ">1", ">2", ..       a fold with this level starts at this line
 
-The result values "=", "s" and "a" are more expensive, please see |fold-expr-slow|.
+The result values "=", "s" and "a" are more expensive, please see
+|fold-expr-slow|.
 
 It is not required to mark the start (end) of a fold with ">1" ("<1"), a fold
 will also start (end) when the fold level is higher (lower) than the fold
@@ -122,7 +123,7 @@ For debugging the 'debug' option can be set to "msg", the error messages will
 be visible then.
 
 If the 'foldexpr' expression starts with s: or |<SID>|, then it is replaced
-with the script ID (|local-function|). Examples: >
+with the script ID (|local-function|).  Examples: >
                set foldexpr=s:MyFoldExpr()
                set foldexpr=<SID>SomeFoldExpr()
 <
@@ -146,7 +147,7 @@ end in that line.
 It may happen that folds are not updated properly.  You can use |zx| or |zX|
 to force updating folds.
 
-Minimizing Computational Cost                               *fold-expr-slow*
+MINIMIZING COMPUTATIONAL COST                          *fold-expr-slow*
 
 Due to its computational cost, this fold method can make Vim unresponsive,
 especially when the fold level of all lines have to be initially computed.
@@ -154,13 +155,15 @@ Afterwards, after each change, Vim restricts the computation of foldlevels
 to those lines whose fold level was affected by it (and reuses the known
 foldlevels of all the others).
 
-The fold expression should therefore strive to minimize the number of dependent
-lines needed for the computation of a given line: For example, try to avoid the
-"=", "a" and "s" return values, because these will require the evaluation of the
-fold levels on previous lines until an independent fold level is found.
+The fold expression should therefore strive to minimize the number of
+dependent lines needed for the computation of a given line: For example, try
+to avoid the "=", "a" and "s" return values, because these will require the
+evaluation of the fold levels on previous lines until an independent fold
+level is found.
 
-If this proves difficult, the next best thing could be to cache all fold levels
-in a buffer-local variable (b:foldlevels) that is only updated on |b:changedtick|:
+If this proves difficult, the next best thing could be to cache all fold
+levels in a buffer-local variable (b:foldlevels) that is only updated on
+|b:changedtick|:
 >vim
   vim9script
   def MyFoldFunc(): number
@@ -174,8 +177,9 @@ in a buffer-local variable (b:foldlevels) that is only updated on |b:changedtick
   enddef
   set foldexpr=s:MyFoldFunc()
 <
-In above example further speedup was gained by using a precompiled Vim9script
-function without arguments (that must still use v:lnum). See |expr-option-function|.
+In above example further speedup was gained by using a precompiled Vim9 script
+function without arguments (that must still use v:lnum).  See
+|expr-option-function|.
 
 SYNTAX                                         *fold-syntax*
 
@@ -412,8 +416,8 @@ zX          Undo manually opened and closed folds: re-apply 'foldlevel'.
                Also forces recomputing folds, like |zx|.
 
                                                        *zm*
-zm             Fold more: Subtract |v:count1| from 'foldlevel'.  If 'foldlevel' was
-               already zero nothing happens.
+zm             Fold more: Subtract |v:count1| from 'foldlevel'.  If
+               'foldlevel' was already zero nothing happens.
                'foldenable' will be set.
 
                                                        *zM*
@@ -477,7 +481,7 @@ zk          Move upwards to the end of the previous fold.  A closed fold
 
 EXECUTING COMMANDS ON FOLDS ~
 
-:[range]foldd[oopen] {cmd}                     *:foldd* *:folddo* *:folddoopen*
+:[range]foldd[oopen] {cmd}             *:foldd* *:folddo* *:folddoopen*
                Execute {cmd} on all lines that are not in a closed fold.
                When [range] is given, only these lines are used.
                Each time {cmd} is executed the cursor is positioned on the
@@ -567,7 +571,7 @@ When there is room after the text, it is filled with the character specified
 by 'fillchars'.
 
 If the 'foldtext' expression starts with s: or |<SID>|, then it is replaced
-with the script ID (|local-function|). Examples: >
+with the script ID (|local-function|).  Examples: >
                set foldtext=s:MyFoldText()
                set foldtext=<SID>SomeFoldText()
 <