Diff to HTML by rtfpessoa

Files changed (6) hide show
  1. runtime/doc/builtin.txt +16 -0
  2. runtime/doc/eval.txt +14 -5
  3. runtime/doc/index.txt +1 -1
  4. runtime/doc/usr_41.txt +3 -2
  5. runtime/doc/version9.txt +3 -0
  6. runtime/doc/windows.txt +2 -2
runtime/doc/builtin.txt CHANGED
@@ -279,6 +279,7 @@ getregionpos({pos1}, {pos2} [, {opts}])
279
  List get a list of positions for a region
280
  getregtype([{regname}]) String type of a register
281
  getscriptinfo([{opts}]) List list of sourced scripts
 
282
  gettabinfo([{expr}]) List list of tab pages
283
  gettabvar({nr}, {varname} [, {def}])
284
  any variable {varname} in tab {nr} or {def}
@@ -4997,6 +4998,21 @@ getscriptinfo([{opts}]) *getscriptinfo()*
4997
  Return type: list<dict<any>>
4998
 
4999
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
5000
  gettabinfo([{tabnr}]) *gettabinfo()*
5001
  If {tabnr} is not specified, then information about all the
5002
  tab pages is returned as a |List|. Each List item is a
279
  List get a list of positions for a region
280
  getregtype([{regname}]) String type of a register
281
  getscriptinfo([{opts}]) List list of sourced scripts
282
+ getstacktrace() List get current stack trace of Vim scripts
283
  gettabinfo([{expr}]) List list of tab pages
284
  gettabvar({nr}, {varname} [, {def}])
285
  any variable {varname} in tab {nr} or {def}
4998
  Return type: list<dict<any>>
4999
 
5000
 
5001
+ getstacktrace() *getstacktrace()*
5002
+ Returns the current stack trace of Vim scripts.
5003
+ Stack trace is a |List|, of which each item is a |Dictionary|
5004
+ with the following items:
5005
+ funcref The funcref if the stack is at the function,
5006
+ otherwise this item is not exist.
5007
+ event The string of the event description if the
5008
+ stack is at autocmd event, otherwise this item
5009
+ is not exist.
5010
+ lnum The line number of the script on the stack.
5011
+ filepath The file path of the script on the stack.
5012
+
5013
+ Return type: list<dict<any>>
5014
+
5015
+
5016
  gettabinfo([{tabnr}]) *gettabinfo()*
5017
  If {tabnr} is not specified, then information about all the
5018
  tab pages is returned as a |List|. Each List item is a
runtime/doc/eval.txt CHANGED
@@ -1,4 +1,4 @@
1
- *eval.txt* For Vim version 9.1. Last change: 2024 Dec 23
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1953,7 +1953,8 @@ variables for each buffer. Use local buffer variables instead |b:var|.
1953
 
1954
  PREDEFINED VIM VARIABLES *vim-variable* *v:var* *v:*
1955
  *E963* *E1063*
1956
- Some variables can be set by the user, but the type cannot be changed.
 
1957
 
1958
  *v:argv* *argv-variable*
1959
  v:argv The command line arguments Vim was invoked with. This is a
@@ -2172,7 +2173,8 @@ v:event Dictionary containing information about the current
2172
  <
2173
  *v:exception* *exception-variable*
2174
  v:exception The value of the exception most recently caught and not
2175
- finished. See also |v:throwpoint| and |throw-variables|.
 
2176
  Example: >
2177
  :try
2178
  : throw "oops"
@@ -2548,6 +2550,12 @@ v:sizeofpointer Number of bytes in a pointer. Depends on how Vim was compiled.
2548
  This is only useful for deciding whether a test will give the
2549
  expected result.
2550
 
 
 
 
 
 
 
2551
  *v:statusmsg* *statusmsg-variable*
2552
  v:statusmsg Last given status message. It's allowed to set this variable.
2553
 
@@ -2676,7 +2684,7 @@ v:this_session Full filename of the last loaded or saved session file. See
2676
  *v:throwpoint* *throwpoint-variable*
2677
  v:throwpoint The point where the exception most recently caught and not
2678
  finished was thrown. Not set when commands are typed. See
2679
- also |v:exception| and |throw-variables|.
2680
  Example: >
2681
  :try
2682
  : throw "oops"
@@ -3856,7 +3864,8 @@ in the variable |v:exception|: >
3856
  : echo "Number thrown. Value is" v:exception
3857
 
3858
  You may also be interested where an exception was thrown. This is stored in
3859
- |v:throwpoint|. Note that "v:exception" and "v:throwpoint" are valid for the
 
3860
  exception most recently caught as long it is not finished.
3861
  Example: >
3862
 
1
+ *eval.txt* For Vim version 9.1. Last change: 2025 Jan 02
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
1953
 
1954
  PREDEFINED VIM VARIABLES *vim-variable* *v:var* *v:*
1955
  *E963* *E1063*
1956
+ Most variables are read-only, when a variable can be set by the user, it will
1957
+ be mentioned at the variable description below. The type cannot be changed.
1958
 
1959
  *v:argv* *argv-variable*
1960
  v:argv The command line arguments Vim was invoked with. This is a
2173
  <
2174
  *v:exception* *exception-variable*
2175
  v:exception The value of the exception most recently caught and not
2176
+ finished. See also |v:stacktrace|, |v:throwpoint|, and
2177
+ |throw-variables|.
2178
  Example: >
2179
  :try
2180
  : throw "oops"
2550
  This is only useful for deciding whether a test will give the
2551
  expected result.
2552
 
2553
+ *v:stacktrace* *stacktrace-variable*
2554
+ v:stacktrace The stack trace of the exception most recently caught and
2555
+ not finished. Refer to |getstacktrace()| for the structure of
2556
+ stack trace. See also |v:exception|, |v:throwpoint|, and
2557
+ |throw-variables|.
2558
+
2559
  *v:statusmsg* *statusmsg-variable*
2560
  v:statusmsg Last given status message. It's allowed to set this variable.
2561
 
2684
  *v:throwpoint* *throwpoint-variable*
2685
  v:throwpoint The point where the exception most recently caught and not
2686
  finished was thrown. Not set when commands are typed. See
2687
+ also |v:exception|, |v:stacktrace|, and |throw-variables|.
2688
  Example: >
2689
  :try
2690
  : throw "oops"
3864
  : echo "Number thrown. Value is" v:exception
3865
 
3866
  You may also be interested where an exception was thrown. This is stored in
3867
+ |v:throwpoint|. And you can obtain the stack trace from |v:stacktrace|.
3868
+ Note that "v:exception", "v:stacktrace" and "v:throwpoint" are valid for the
3869
  exception most recently caught as long it is not finished.
3870
  Example: >
3871
 
runtime/doc/index.txt CHANGED
@@ -1386,7 +1386,7 @@ tag command action ~
1386
  |:highlight| :hi[ghlight] specify highlighting methods
1387
  |:hide| :hid[e] hide current buffer for a command
1388
  |:history| :his[tory] print a history list
1389
- |:horizontal| :ho[rizontal] following window command work horizontally
1390
  |:insert| :i[nsert] insert text
1391
  |:iabbrev| :ia[bbrev] like ":abbrev" but for Insert mode
1392
  |:iabclear| :iabc[lear] like ":abclear" but for Insert mode
1386
  |:highlight| :hi[ghlight] specify highlighting methods
1387
  |:hide| :hid[e] hide current buffer for a command
1388
  |:history| :his[tory] print a history list
1389
+ |:horizontal| :hor[izontal] following window command work horizontally
1390
  |:insert| :i[nsert] insert text
1391
  |:iabbrev| :ia[bbrev] like ":abbrev" but for Insert mode
1392
  |:iabclear| :iabc[lear] like ":abclear" but for Insert mode
runtime/doc/usr_41.txt CHANGED
@@ -1,4 +1,4 @@
1
- *usr_41.txt* For Vim version 9.1. Last change: 2024 Dec 30
2
 
3
  VIM USER MANUAL - by Bram Moolenaar
4
 
@@ -1399,7 +1399,8 @@ Various: *various-functions*
1399
  eventhandler() check if invoked by an event handler
1400
  getcellpixels() get List of cell pixel size
1401
  getpid() get process ID of Vim
1402
- getscriptinfo() get list of sourced vim scripts
 
1403
  getimstatus() check if IME status is active
1404
  interrupt() interrupt script execution
1405
  windowsversion() get MS-Windows version
1
+ *usr_41.txt* For Vim version 9.1. Last change: 2025 Jan 02
2
 
3
  VIM USER MANUAL - by Bram Moolenaar
4
 
1399
  eventhandler() check if invoked by an event handler
1400
  getcellpixels() get List of cell pixel size
1401
  getpid() get process ID of Vim
1402
+ getscriptinfo() get list of sourced Vim scripts
1403
+ getstacktrace() get current stack trace of Vim scripts
1404
  getimstatus() check if IME status is active
1405
  interrupt() interrupt script execution
1406
  windowsversion() get MS-Windows version
runtime/doc/version9.txt CHANGED
@@ -41623,6 +41623,8 @@ Changed~
41623
  for the ghostty terminal emulator (using kitty protocol)
41624
  - |complete_info()| returns the list of matches shown in the poppu menu via
41625
  the "matches" key
 
 
41626
 
41627
  *added-9.2*
41628
  Added ~
@@ -41642,6 +41644,7 @@ Functions: ~
41642
  |getcmdprompt()| get prompt for input()/confirm()
41643
  |getregion()| get a region of text from a buffer
41644
  |getregionpos()| get a list of positions for a region
 
41645
  |id()| get unique identifier for a Dict, List, Object,
41646
  Channel or Blob variable
41647
  |matchbufline()| all the matches of a pattern in a buffer
41623
  for the ghostty terminal emulator (using kitty protocol)
41624
  - |complete_info()| returns the list of matches shown in the poppu menu via
41625
  the "matches" key
41626
+ - |v:stacktrace| The stack trace of the exception most recently caught and
41627
+ not finished
41628
 
41629
  *added-9.2*
41630
  Added ~
41644
  |getcmdprompt()| get prompt for input()/confirm()
41645
  |getregion()| get a region of text from a buffer
41646
  |getregionpos()| get a list of positions for a region
41647
+ |getstacktrace()| get current stack trace of Vim scripts
41648
  |id()| get unique identifier for a Dict, List, Object,
41649
  Channel or Blob variable
41650
  |matchbufline()| all the matches of a pattern in a buffer
runtime/doc/windows.txt CHANGED
@@ -263,8 +263,8 @@ and 'winminwidth' are relevant.
263
  will be equalized only vertically.
264
  Doesn't work for |:execute| and |:normal|.
265
 
266
- *:ho* *:horizontal*
267
- :ho[rizontal] {cmd}
268
  Execute {cmd}. Currently only makes a difference for
269
  `horizontal wincmd =`, which will equalize windows only
270
  horizontally.
263
  will be equalized only vertically.
264
  Doesn't work for |:execute| and |:normal|.
265
 
266
+ *:hor* *:horizontal*
267
+ :hor[izontal] {cmd}
268
  Execute {cmd}. Currently only makes a difference for
269
  `horizontal wincmd =`, which will equalize windows only
270
  horizontally.