Diff to HTML by rtfpessoa

Files changed (4) hide show
  1. runtime/doc/options.txt +36 -5
  2. runtime/doc/quickref.txt +2 -1
  3. runtime/doc/version9.txt +7 -1
  4. runtime/doc/windows.txt +2 -1
runtime/doc/options.txt CHANGED
@@ -1,4 +1,4 @@
1
- *options.txt* For Vim version 9.2. Last change: 2026 Feb 25
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -8519,6 +8519,9 @@ A jump table for the options with a short description can be found at |Q_op|.
8519
  applied to StatusLineNC for the statusline of non-current
8520
  windows.
8521
  The number N must be between 1 and 9. See |hl-User1..9|
 
 
 
8522
 
8523
  When displaying a flag, Vim removes the leading comma, if any, when
8524
  that flag comes right after plaintext. This will make a nice display
@@ -8576,6 +8579,34 @@ A jump table for the options with a short description can be found at |Q_op|.
8576
  :function VarExists(var, val)
8577
  : if exists(a:var) | return a:val | else | return '' | endif
8578
  :endfunction
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8579
  <
8580
  *'suffixes'* *'su'*
8581
  'suffixes' 'su' string (default ".bak,~,.o,.h,.info,.swp,.obj")
@@ -8762,11 +8793,11 @@ A jump table for the options with a short description can be found at |Q_op|.
8762
 
8763
  You can use |g:actual_curtabpage| within a function assigned to
8764
  tabpanel. |g:actual_curtabpage| represents current tab's label number.
8765
- The option value can contain "\n" to force line breaks: >
8766
 
8767
  set tabpanel=%!TabPanel()
8768
  function! TabPanel() abort
8769
- return printf("(%2d)\n %%f", g:actual_curtabpage)
8770
  endfunction
8771
  <
8772
  The result is:
@@ -8780,8 +8811,8 @@ A jump table for the options with a short description can be found at |Q_op|.
8780
  | |
8781
  | |
8782
  <
8783
- Note: using "\n" is considered experimental and may change in the
8784
- future; a %-atom may be used instead.
8785
 
8786
  *'tabpanelopt'* *'tplo'*
8787
  'tabpanelopt' 'tplo' string (default "")
 
1
+ *options.txt* For Vim version 9.2. Last change: 2026 Mar 01
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
 
8519
  applied to StatusLineNC for the statusline of non-current
8520
  windows.
8521
  The number N must be between 1 and 9. See |hl-User1..9|
8522
+ *stl-%@*
8523
+ @ - Insert a line break (for the |tabpanel| or when the status line
8524
+ 'statuslineopt' has a "maxheight" value greater than 1).
8525
 
8526
  When displaying a flag, Vim removes the leading comma, if any, when
8527
  that flag comes right after plaintext. This will make a nice display
 
8579
  :function VarExists(var, val)
8580
  : if exists(a:var) | return a:val | else | return '' | endif
8581
  :endfunction
8582
+ <
8583
+ *'statuslineopt'* *'stlo'*
8584
+ 'statuslineopt' 'stlo' string (default "")
8585
+ global
8586
+ {not available when compiled without the |+statusline|
8587
+ feature}
8588
+ Optional settings for |status-line|. It can consist of the following
8589
+ items. All are optional. Items must be separated by a comma.
8590
+
8591
+ maxheight:{n} Set the maximum status line height to {n}.
8592
+ {n} must be 1 or greater.
8593
+ If not present, 1 is used.
8594
+ Check whether {n} is applicable to all windows
8595
+ on all tab pages, and if not, set it to the
8596
+ closest possible value.
8597
+ The option value is updated to the actual
8598
+ applied value. For example, setting
8599
+ maxheight:999 may result in a smaller value
8600
+ depending on the available space.
8601
+ When {n} is set to 2 or more, you can use "@"
8602
+ in 'statusline' to display information on
8603
+ multiple lines in the status line.
8604
+ See |stl-%@|.
8605
+
8606
+ Examples: >
8607
+ :set stlo=
8608
+ :set stlo=maxheight:2
8609
+ :set stlo+=maxheight:3
8610
  <
8611
  *'suffixes'* *'su'*
8612
  'suffixes' 'su' string (default ".bak,~,.o,.h,.info,.swp,.obj")
 
8793
 
8794
  You can use |g:actual_curtabpage| within a function assigned to
8795
  tabpanel. |g:actual_curtabpage| represents current tab's label number.
8796
+ You can use "%@" or "\n" to insert a new line: >
8797
 
8798
  set tabpanel=%!TabPanel()
8799
  function! TabPanel() abort
8800
+ return "(" .. g:actual_curtabpage .. ")%@ %f"
8801
  endfunction
8802
  <
8803
  The result is:
 
8811
  | |
8812
  | |
8813
  <
8814
+ Note: using "\n" is considered experimental and deprecated, prefer
8815
+ the |stl-%@| atom instead.
8816
 
8817
  *'tabpanelopt'* *'tplo'*
8818
  'tabpanelopt' 'tplo' string (default "")
runtime/doc/quickref.txt CHANGED
@@ -1,4 +1,4 @@
1
- *quickref.txt* For Vim version 9.2. Last change: 2026 Feb 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -939,6 +939,7 @@ Short explanation of each option: *option-list*
939
  'splitright' 'spr' new window is put right of the current one
940
  'startofline' 'sol' commands move cursor to first non-blank in line
941
  'statusline' 'stl' custom format for the status line
 
942
  'suffixes' 'su' suffixes that are ignored with multiple match
943
  'suffixesadd' 'sua' suffixes added when searching for a file
944
  'swapfile' 'swf' whether to use a swapfile for a buffer
 
1
+ *quickref.txt* For Vim version 9.2. Last change: 2026 Mar 01
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
 
939
  'splitright' 'spr' new window is put right of the current one
940
  'startofline' 'sol' commands move cursor to first non-blank in line
941
  'statusline' 'stl' custom format for the status line
942
+ 'statuslineopt' 'stlo' additional options for the |status-line|
943
  'suffixes' 'su' suffixes that are ignored with multiple match
944
  'suffixesadd' 'sua' suffixes added when searching for a file
945
  'swapfile' 'swf' whether to use a swapfile for a buffer
runtime/doc/version9.txt CHANGED
@@ -1,4 +1,4 @@
1
- *version9.txt* For Vim version 9.2. Last change: 2026 Feb 25
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -52593,6 +52593,7 @@ Other ~
52593
  - The new |xdg.vim| script for full XDG compatibility is included.
52594
  - |ConPTY| support is considered stable as of Windows 11.
52595
  - Support for "dap" channel mode for the |debug-adapter-protocol|.
 
52596
 
52597
  *changed-9.3*
52598
  Changed~
@@ -52607,6 +52608,11 @@ Autocommands: ~
52607
 
52608
  |SessionLoadPre| before loading a |Session| file
52609
 
 
 
 
 
 
52610
  ==============================================================================
52611
  PATCHES *patches-9.3* *bug-fixes-9.3*
52612
  *patches-after-9.2*
 
1
+ *version9.txt* For Vim version 9.2. Last change: 2026 Mar 01
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
 
52593
  - The new |xdg.vim| script for full XDG compatibility is included.
52594
  - |ConPTY| support is considered stable as of Windows 11.
52595
  - Support for "dap" channel mode for the |debug-adapter-protocol|.
52596
+ - |status-line| can use several lines, see 'statuslineopt'.
52597
 
52598
  *changed-9.3*
52599
  Changed~
 
52608
 
52609
  |SessionLoadPre| before loading a |Session| file
52610
 
52611
+ Options: ~
52612
+
52613
+ 'statuslineopt' Extra options for the 'statusline', e.g. use the
52614
+ "maxheight" suboption to use several lines.
52615
+
52616
  ==============================================================================
52617
  PATCHES *patches-9.3* *bug-fixes-9.3*
52618
  *patches-after-9.2*
runtime/doc/windows.txt CHANGED
@@ -1,4 +1,4 @@
1
- *windows.txt* For Vim version 9.2. Last change: 2026 Feb 24
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -125,6 +125,7 @@ when the last window also has a status line:
125
  You can change the contents of the status line with the 'statusline' option.
126
  This option can be local to the window, so that you can have a different
127
  status line in each window.
 
128
 
129
  Normally, inversion is used to display the status line. This can be changed
130
  with the 's' character in the 'highlight' option. For example, "sb" sets it
 
1
+ *windows.txt* For Vim version 9.2. Last change: 2026 Mar 01
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
 
125
  You can change the contents of the status line with the 'statusline' option.
126
  This option can be local to the window, so that you can have a different
127
  status line in each window.
128
+ You can change the height of the status line with the 'statuslineopt' option.
129
 
130
  Normally, inversion is used to display the status line. This can be changed
131
  with the 's' character in the 'highlight' option. For example, "sb" sets it