Diff to HTML by rtfpessoa

Files changed (5) hide show
  1. runtime/doc/eval.txt +3 -2
  2. runtime/doc/options.txt +49 -8
  3. runtime/doc/quickref.txt +2 -1
  4. runtime/doc/syntax.txt +3 -2
  5. runtime/doc/version9.txt +3 -1
runtime/doc/eval.txt CHANGED
@@ -1,4 +1,4 @@
1
- *eval.txt* For Vim version 9.1. Last change: 2024 Jul 28
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -2223,7 +2223,8 @@ v:fcs_choice What should happen after a |FileChangedShell| event was
2223
 
2224
  *v:fname* *fname-variable*
2225
  v:fname When evaluating 'includeexpr': the file name that was
2226
- detected. Empty otherwise.
 
2227
 
2228
  *v:fname_in* *fname_in-variable*
2229
  v:fname_in The name of the input file. Valid while evaluating:
1
+ *eval.txt* For Vim version 9.1. Last change: 2024 Oct 22
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
2223
 
2224
  *v:fname* *fname-variable*
2225
  v:fname When evaluating 'includeexpr': the file name that was
2226
+ detected. When evaluating 'findexpr': the argument passed to
2227
+ the |:find| command. Empty otherwise.
2228
 
2229
  *v:fname_in* *fname_in-variable*
2230
  v:fname_in The name of the input file. Valid while evaluating:
runtime/doc/options.txt CHANGED
@@ -1,4 +1,4 @@
1
- *options.txt* For Vim version 9.1. Last change: 2024 Oct 16
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -3403,7 +3403,7 @@ A jump table for the options with a short description can be found at |Q_op|.
3403
 
3404
  *'fileformat'* *'ff'*
3405
  'fileformat' 'ff' string (MS-Windows default: "dos",
3406
- Unix, macOS default: "unix")
3407
  local to buffer
3408
  This gives the <EOL> of the current buffer, which is used for
3409
  reading/writing the buffer from/to a file:
@@ -3426,7 +3426,7 @@ A jump table for the options with a short description can be found at |Q_op|.
3426
  *'fileformats'* *'ffs'*
3427
  'fileformats' 'ffs' string (default:
3428
  Vim+Vi MS-Windows: "dos,unix",
3429
- Vim Unix, macOS: "unix,dos",
3430
  Vi Cygwin: "unix,dos",
3431
  Vi others: "")
3432
  global
@@ -3552,6 +3552,51 @@ A jump table for the options with a short description can be found at |Q_op|.
3552
  eob EndOfBuffer |hl-EndOfBuffer|
3553
  lastline NonText |hl-NonText|
3554
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
3555
  *'fixendofline'* *'fixeol'* *'nofixendofline'* *'nofixeol'*
3556
  'fixendofline' 'fixeol' boolean (default on)
3557
  local to buffer
@@ -4917,7 +4962,7 @@ A jump table for the options with a short description can be found at |Q_op|.
4917
  set and to the Vim default value when 'compatible' is reset.
4918
 
4919
  *'isprint'* *'isp'*
4920
- 'isprint' 'isp' string (default for Win32 and macOS:
4921
  "@,~-255"; otherwise: "@,161-255")
4922
  global
4923
  The characters given by this option are displayed directly on the
@@ -6742,9 +6787,6 @@ A jump table for the options with a short description can be found at |Q_op|.
6742
  $VIMRUNTIME,
6743
  $VIM/vimfiles/after,
6744
  $HOME/vimfiles/after"
6745
- macOS: "$VIM:vimfiles,
6746
- $VIMRUNTIME,
6747
- $VIM:vimfiles:after"
6748
  Haiku: "$BE_USER_SETTINGS/vim,
6749
  $VIM/vimfiles,
6750
  $VIMRUNTIME,
@@ -9057,7 +9099,6 @@ A jump table for the options with a short description can be found at |Q_op|.
9057
  for Win32: "$HOME/vimfiles/view",
9058
  for Unix: "$HOME/.vim/view" or
9059
  "$XDG_CONFIG_HOME/vim/view"
9060
- for macOS: "$VIM/vimfiles/view",
9061
  for VMS: "sys$login:vimfiles/view")
9062
  global
9063
  {not available when compiled without the |+mksession|
1
+ *options.txt* For Vim version 9.1. Last change: 2024 Oct 22
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
3403
 
3404
  *'fileformat'* *'ff'*
3405
  'fileformat' 'ff' string (MS-Windows default: "dos",
3406
+ Unix default: "unix")
3407
  local to buffer
3408
  This gives the <EOL> of the current buffer, which is used for
3409
  reading/writing the buffer from/to a file:
3426
  *'fileformats'* *'ffs'*
3427
  'fileformats' 'ffs' string (default:
3428
  Vim+Vi MS-Windows: "dos,unix",
3429
+ Vim Unix: "unix,dos",
3430
  Vi Cygwin: "unix,dos",
3431
  Vi others: "")
3432
  global
3552
  eob EndOfBuffer |hl-EndOfBuffer|
3553
  lastline NonText |hl-NonText|
3554
 
3555
+ *'findexpr'* *'fexpr'*
3556
+ 'findexpr' 'fexpr' string (default "")
3557
+ global or local to buffer |global-local|
3558
+ {not available when compiled without the |+eval|
3559
+ feature}
3560
+ Expression that is evaluated to obtain the filename(s) for the |:find|
3561
+ command. When this option is empty, the internal |file-searching|
3562
+ mechanism is used.
3563
+
3564
+ While evaluating the expression, the |v:fname| variable is set to the
3565
+ argument of the |:find| command.
3566
+
3567
+ The expression is evaluated only once per |:find| command invocation.
3568
+ The expression can process all the directories specified in 'path'.
3569
+
3570
+ If a match is found, the expression should return a |List| containing
3571
+ one or more file names. If a match is not found, the expression
3572
+ should return an empty List.
3573
+
3574
+ If any errors are encountered during the expression evaluation, an
3575
+ empty List is used as the return value.
3576
+
3577
+ Using a function call without arguments is faster |expr-option-function|
3578
+
3579
+ It is not allowed to change text or jump to another window while
3580
+ evaluating 'findexpr' |textlock|.
3581
+
3582
+ This option cannot be set from a |modeline| or in the |sandbox|, for
3583
+ security reasons.
3584
+
3585
+ Examples:
3586
+ >
3587
+ " Use glob()
3588
+ func FindExprGlob()
3589
+ return glob(v:fname, v:false, v:true)
3590
+ endfunc
3591
+ set findexpr=FindExprGlob()
3592
+
3593
+ " Use the 'git ls-files' output
3594
+ func FindGitFiles()
3595
+ let fnames = systemlist('git ls-files')
3596
+ return fnames->filter('v:val =~? v:fname')
3597
+ endfunc
3598
+ set findexpr=FindGitFiles()
3599
+ <
3600
  *'fixendofline'* *'fixeol'* *'nofixendofline'* *'nofixeol'*
3601
  'fixendofline' 'fixeol' boolean (default on)
3602
  local to buffer
4962
  set and to the Vim default value when 'compatible' is reset.
4963
 
4964
  *'isprint'* *'isp'*
4965
+ 'isprint' 'isp' string (default for Win32 and VMS:
4966
  "@,~-255"; otherwise: "@,161-255")
4967
  global
4968
  The characters given by this option are displayed directly on the
6787
  $VIMRUNTIME,
6788
  $VIM/vimfiles/after,
6789
  $HOME/vimfiles/after"
 
 
 
6790
  Haiku: "$BE_USER_SETTINGS/vim,
6791
  $VIM/vimfiles,
6792
  $VIMRUNTIME,
9099
  for Win32: "$HOME/vimfiles/view",
9100
  for Unix: "$HOME/.vim/view" or
9101
  "$XDG_CONFIG_HOME/vim/view"
 
9102
  for VMS: "sys$login:vimfiles/view")
9103
  global
9104
  {not available when compiled without the |+mksession|
runtime/doc/quickref.txt CHANGED
@@ -1,4 +1,4 @@
1
- *quickref.txt* For Vim version 9.1. Last change: 2024 Mar 03
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -707,6 +707,7 @@ Short explanation of each option: *option-list*
707
  'fileignorecase' 'fic' ignore case when using file names
708
  'filetype' 'ft' type of file, used for autocommands
709
  'fillchars' 'fcs' characters to use for displaying special items
 
710
  'fixendofline' 'fixeol' make sure last line in file has <EOL>
711
  'fkmap' 'fk' obsolete option for Farsi
712
  'foldclose' 'fcl' close a fold when the cursor leaves it
1
+ *quickref.txt* For Vim version 9.1. Last change: 2024 Oct 22
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
707
  'fileignorecase' 'fic' ignore case when using file names
708
  'filetype' 'ft' type of file, used for autocommands
709
  'fillchars' 'fcs' characters to use for displaying special items
710
+ 'findexpr' 'fexpr' expression to evaluate for |:find|
711
  'fixendofline' 'fixeol' make sure last line in file has <EOL>
712
  'fkmap' 'fk' obsolete option for Farsi
713
  'foldclose' 'fcl' close a fold when the cursor leaves it
runtime/doc/syntax.txt CHANGED
@@ -1,4 +1,4 @@
1
- *syntax.txt* For Vim version 9.1. Last change: 2024 Oct 20
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -6142,7 +6142,8 @@ This will set the "w:current_syntax" variable to "foo". The value of
6142
  restoring "b:current_syntax", since the syntax files do set
6143
  "b:current_syntax". The value set by the syntax file is assigned to
6144
  "w:current_syntax".
6145
- Note: This resets the 'spell', 'spellcapcheck' and 'spellfile' options.
 
6146
 
6147
  Once a window has its own syntax, syntax commands executed from other windows
6148
  on the same buffer (including :syntax clear) have no effect. Conversely,
1
+ *syntax.txt* For Vim version 9.1. Last change: 2024 Oct 22
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
6142
  restoring "b:current_syntax", since the syntax files do set
6143
  "b:current_syntax". The value set by the syntax file is assigned to
6144
  "w:current_syntax".
6145
+ Note: This resets the 'spell', 'spellcapcheck', 'spellfile' and 'spelloptions'
6146
+ options.
6147
 
6148
  Once a window has its own syntax, syntax commands executed from other windows
6149
  on the same buffer (including :syntax clear) have no effect. Conversely,
runtime/doc/version9.txt CHANGED
@@ -1,4 +1,4 @@
1
- *version9.txt* For Vim version 9.1. Last change: 2024 Oct 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -41649,6 +41649,8 @@ Options: ~
41649
 
41650
  'completeitemalign' Order of |complete-items| in Insert mode completion
41651
  popup
 
 
41652
  'winfixbuf' Keep buffer focused in a window
41653
  'tabclose' Which tab page to focus after closing a tab page
41654
  't_xo' Terminal uses XON/XOFF handshaking (e.g. vt420)
1
+ *version9.txt* For Vim version 9.1. Last change: 2024 Oct 22
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
41649
 
41650
  'completeitemalign' Order of |complete-items| in Insert mode completion
41651
  popup
41652
+ 'findexpr' Vim expression to obtain the results for a |:find|
41653
+ command
41654
  'winfixbuf' Keep buffer focused in a window
41655
  'tabclose' Which tab page to focus after closing a tab page
41656
  't_xo' Terminal uses XON/XOFF handshaking (e.g. vt420)