Diff to HTML by rtfpessoa

Files changed (3) hide show
  1. runtime/doc/options.txt +46 -1
  2. runtime/doc/various.txt +2 -1
  3. runtime/doc/version9.txt +3 -1
runtime/doc/options.txt CHANGED
@@ -1,4 +1,4 @@
1
- *options.txt* For Vim version 9.2. Last change: 2026 Apr 07
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -8624,6 +8624,51 @@ A jump table for the options with a short description can be found at |Q_op|.
8624
  @ - Inserts a newline. This only takes effect when the "maxheight"
8625
  value of 'statuslineopt' is greater than 1, or for |tabpanel|.
8626
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8627
  When displaying a flag, Vim removes the leading comma, if any, when
8628
  that flag comes right after plaintext. This will make a nice display
8629
  when flags are used like in the examples below.
 
1
+ *options.txt* For Vim version 9.2. Last change: 2026 Apr 09
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
 
8624
  @ - Inserts a newline. This only takes effect when the "maxheight"
8625
  value of 'statuslineopt' is greater than 1, or for |tabpanel|.
8626
 
8627
+ *stl-%[FuncName]*
8628
+ %[ defines clickable regions in the statusline. When the user clicks
8629
+ on a region with the mouse, the specified function is called.
8630
+
8631
+ %[FuncName] Start of a clickable region. "FuncName" is the name
8632
+ of a Vim function to call when the region is clicked.
8633
+ %[] End of the clickable region. If omitted, the region
8634
+ extends to the end of the statusline or to the start
8635
+ of the next clickable region.
8636
+
8637
+ A {minwid} value can be used to pass an identifier to the callback:
8638
+ %3[FuncName] Starts a clickable region with minwid 3.
8639
+
8640
+ The function receives a single |Dictionary| argument with these
8641
+ entries:
8642
+ "minwid" The minwid value from %N[Func] (0 if not specified).
8643
+ "nclicks" Number of clicks: 1, 2, or 3.
8644
+ "button" Mouse button: "l" (left), "m" (middle), "r" (right).
8645
+ "mods" Modifier keys: combination of "s" (shift), "c" (ctrl),
8646
+ "a" (alt). Empty string if no modifiers.
8647
+ "winid" |window-ID| of the window whose statusline was clicked.
8648
+
8649
+ If the function returns non-zero, the statusline is redrawn.
8650
+ Dragging the statusline to resize the window still works even when
8651
+ click handlers are defined.
8652
+
8653
+ Example: >
8654
+ func! ClickFile(info)
8655
+ if a:info.button ==# 'l' && a:info.nclicks == 2
8656
+ browse edit
8657
+ endif
8658
+ return 0
8659
+ endfunc
8660
+ set statusline=%[ClickFile]%f%[]\ %l:%c
8661
+ < This makes the filename in the statusline clickable. Double-clicking
8662
+ it opens the file browser.
8663
+
8664
+ Use `has('statusline_click')` to check if this feature is available.
8665
+ This is useful for backward compatibility: >
8666
+ if has('statusline_click')
8667
+ set statusline=%[ClickFile]%f%[]\ %l:%c
8668
+ else
8669
+ set statusline=%f\ %l:%c
8670
+ endif
8671
+ <
8672
  When displaying a flag, Vim removes the leading comma, if any, when
8673
  that flag comes right after plaintext. This will make a nice display
8674
  when flags are used like in the examples below.
runtime/doc/various.txt CHANGED
@@ -1,4 +1,4 @@
1
- *various.txt* For Vim version 9.2. Last change: 2026 Feb 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -496,6 +496,7 @@ N *+spell* spell checking support, see |spell|
496
  N *+startuptime* |--startuptime| argument
497
  N *+statusline* Options 'statusline', 'rulerformat' and special
498
  formats of 'titlestring' and 'iconstring'
 
499
  - *+sun_workshop* Removed: |workshop|
500
  N *+syntax* Syntax highlighting |syntax|
501
  *+system()* Unix only: opposite of |+fork|
 
1
+ *various.txt* For Vim version 9.2. Last change: 2026 Apr 06
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
 
496
  N *+startuptime* |--startuptime| argument
497
  N *+statusline* Options 'statusline', 'rulerformat' and special
498
  formats of 'titlestring' and 'iconstring'
499
+ N *+statusline_click* Click handlers in 'statusline' |stl-%[FuncName]|
500
  - *+sun_workshop* Removed: |workshop|
501
  N *+syntax* Syntax highlighting |syntax|
502
  *+system()* Unix only: opposite of |+fork|
runtime/doc/version9.txt CHANGED
@@ -1,4 +1,4 @@
1
- *version9.txt* For Vim version 9.2. Last change: 2026 Apr 07
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -52613,6 +52613,8 @@ Other ~
52613
  pairs individually (e.g. 'listchars', 'fillchars', 'diffopt').
52614
  - |system()| and |systemlist()| functions accept a list as first argument,
52615
  bypassing the shell completely.
 
 
52616
 
52617
  Platform specific ~
52618
  -----------------
 
1
+ *version9.txt* For Vim version 9.2. Last change: 2026 Apr 09
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
 
52613
  pairs individually (e.g. 'listchars', 'fillchars', 'diffopt').
52614
  - |system()| and |systemlist()| functions accept a list as first argument,
52615
  bypassing the shell completely.
52616
+ - Allow mouse clickable regions in the |status-line| using the
52617
+ |stl-%[FuncName]| atom.
52618
 
52619
  Platform specific ~
52620
  -----------------