1- *options.txt* For Vim version 9.2. Last change: 2026 Feb 25
1+ *options.txt* For Vim version 9.2. Last change: 2026 Mar 01
22
33
44 VIM REFERENCE MANUAL by Bram Moolenaar
@@ -5808,6 +5808,15 @@ A jump table for the options with a short description can be found at |Q_op|.
58085808 ---+---+--XXX ~
58095809 Where "XXX" denotes the first non-blank characters in
58105810 the line.
5811+ *lcs-leadtab*
5812+ leadtab:xy[z]
5813+ Like | lcs-tab | , but only for leading tabs. When
5814+ omitted, the "tab" setting is used for leading tabs.
5815+ | lcs-tab | must also be set for this to work. *E1572*
5816+ You can combine it with "tab:", for example:
5817+ `:set listchars=tab:>-,leadtab:.\ `
5818+ This shows leading tabs as periods(.) and other tabs
5819+ as ">--".
58115820 *lcs-trail*
58125821 trail:c Character to show for trailing spaces. When omitted,
58135822 trailing spaces are blank. Overrides the "space" and
@@ -8519,6 +8528,9 @@ A jump table for the options with a short description can be found at |Q_op|.
85198528 applied to StatusLineNC for the statusline of non-current
85208529 windows.
85218530 The number N must be between 1 and 9. See | hl-User1..9 |
8531+ *stl-%@*
8532+ @ - Insert a line break (for the | tabpanel | or when the status line
8533+ 'statuslineopt' has a "maxheight" value greater than 1).
85228534
85238535 When displaying a flag, Vim removes the leading comma, if any, when
85248536 that flag comes right after plaintext. This will make a nice display
@@ -8576,6 +8588,34 @@ A jump table for the options with a short description can be found at |Q_op|.
85768588 :function VarExists(var, val)
85778589 : if exists(a:var) | return a:val | else | return '' | endif
85788590 :endfunction
8591+ <
8592+ *'statuslineopt'* *'stlo'*
8593+ 'statuslineopt' 'stlo' string (default "")
8594+ global
8595+ {not available when compiled without the | +statusline |
8596+ feature}
8597+ Optional settings for | status-line | . It can consist of the following
8598+ items. All are optional. Items must be separated by a comma.
8599+
8600+ maxheight:{n} Set the maximum status line height to {n} .
8601+ {n} must be 1 or greater.
8602+ If not present, 1 is used.
8603+ Check whether {n} is applicable to all windows
8604+ on all tab pages, and if not, set it to the
8605+ closest possible value.
8606+ The option value is updated to the actual
8607+ applied value. For example, setting
8608+ maxheight:999 may result in a smaller value
8609+ depending on the available space.
8610+ When {n} is set to 2 or more, you can use "@"
8611+ in 'statusline' to display information on
8612+ multiple lines in the status line.
8613+ See | stl-%@ | .
8614+
8615+ Examples: >
8616+ :set stlo=
8617+ :set stlo=maxheight:2
8618+ :set stlo+=maxheight:3
85798619<
85808620 *'suffixes'* *'su'*
85818621'suffixes' 'su' string (default ".bak,~,.o,.h,.info,.swp,.obj")
@@ -8762,11 +8802,11 @@ A jump table for the options with a short description can be found at |Q_op|.
87628802
87638803 You can use | g:actual_curtabpage | within a function assigned to
87648804 tabpanel. | g:actual_curtabpage | represents current tab's label number.
8765- The option value can contain "\n" to force line breaks : >
8805+ You can use "%@" or "\n" to insert a new line : >
87668806
87678807 set tabpanel=%!TabPanel()
87688808 function! TabPanel() abort
8769- return printf("(%2d)\n %%f", g:actual_curtabpage)
8809+ return "(" .. g:actual_curtabpage .. ")%@ %f"
87708810 endfunction
87718811<
87728812 The result is:
@@ -8780,8 +8820,8 @@ A jump table for the options with a short description can be found at |Q_op|.
87808820 | |
87818821 | |
87828822<
8783- Note: using "\n" is considered experimental and may change in the
8784- future; a %-atom may be used instead.
8823+ Note: using "\n" is considered experimental and deprecated, prefer
8824+ the | stl-%@ | atom instead.
87858825
87868826 *'tabpanelopt'* *'tplo'*
87878827'tabpanelopt' 'tplo' string (default "")
0 commit comments