Diff to HTML by rtfpessoa

Files changed (7) hide show
  1. runtime/doc/builtin.txt +3 -1
  2. runtime/doc/index.txt +2 -1
  3. runtime/doc/options.txt +82 -2
  4. runtime/doc/syntax.txt +7 -1
  5. runtime/doc/tabpage.txt +73 -5
  6. runtime/doc/various.txt +8 -1
  7. runtime/doc/version9.txt +11 -1
runtime/doc/builtin.txt CHANGED
@@ -1,4 +1,4 @@
1
- *builtin.txt* For Vim version 9.1. Last change: 2025 May 09
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -4730,6 +4730,8 @@ getmousepos() *getmousepos()*
4730
  If not over a window, e.g. when in the command line, then only
4731
  "screenrow" and "screencol" are valid, the others are zero.
4732
 
 
 
4733
  When on the status line below a window or the vertical
4734
  separator right of a window, the "line" and "column" values
4735
  are zero.
1
+ *builtin.txt* For Vim version 9.1. Last change: 2025 May 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
4730
  If not over a window, e.g. when in the command line, then only
4731
  "screenrow" and "screencol" are valid, the others are zero.
4732
 
4733
+ When on the |tabpanel|, "wincol" value is zero.
4734
+
4735
  When on the status line below a window or the vertical
4736
  separator right of a window, the "line" and "column" values
4737
  are zero.
runtime/doc/index.txt CHANGED
@@ -1,4 +1,4 @@
1
- *index.txt* For Vim version 9.1. Last change: 2025 Mar 18
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -1583,6 +1583,7 @@ tag command action ~
1583
  |:redraw| :redr[aw] force a redraw of the display
1584
  |:redrawstatus| :redraws[tatus] force a redraw of the status line(s)
1585
  |:redrawtabline| :redrawt[abline] force a redraw of the tabline
 
1586
  |:registers| :reg[isters] display the contents of registers
1587
  |:resize| :res[ize] change current window height
1588
  |:retab| :ret[ab] change tab size
1
+ *index.txt* For Vim version 9.1. Last change: 2025 May 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
1583
  |:redraw| :redr[aw] force a redraw of the display
1584
  |:redrawstatus| :redraws[tatus] force a redraw of the status line(s)
1585
  |:redrawtabline| :redrawt[abline] force a redraw of the tabline
1586
+ |:redrawtabpanel| :redrawtabp[anel] force a redraw of the tabpanel
1587
  |:registers| :reg[isters] display the contents of registers
1588
  |:resize| :res[ize] change current window height
1589
  |:retab| :ret[ab] change tab size
runtime/doc/options.txt CHANGED
@@ -1,4 +1,4 @@
1
- *options.txt* For Vim version 9.1. Last change: 2025 May 10
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -3657,11 +3657,12 @@ A jump table for the options with a short description can be found at |Q_op|.
3657
  trunc '>' truncated text in the
3658
  |ins-completion-menu|.
3659
  truncrl '<' same as "trunc" in 'rightleft' mode
 
3660
 
3661
  Any one that is omitted will fall back to the default.
3662
 
3663
  Example: >
3664
- :set fillchars=stl:\ ,stlnc:\ ,vert:\|,fold:-,diff:-
3665
  <
3666
  All items support single-byte and multibyte characters. But
3667
  double-width characters are not supported. |E1512|
@@ -7689,6 +7690,20 @@ A jump table for the options with a short description can be found at |Q_op|.
7689
  line.
7690
  See |tab-page| for more information about tab pages.
7691
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
7692
  *'sidescroll'* *'ss'*
7693
  'sidescroll' 'ss' number (default 0)
7694
  global
@@ -8408,6 +8423,71 @@ A jump table for the options with a short description can be found at |Q_op|.
8408
  Maximum number of tab pages to be opened by the |-p| command line
8409
  argument or the ":tab all" command. |tabpage|
8410
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
8411
  *'tabstop'* *'ts'*
8412
  'tabstop' 'ts' number (default 8)
8413
  local to buffer
1
+ *options.txt* For Vim version 9.1. Last change: 2025 May 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
3657
  trunc '>' truncated text in the
3658
  |ins-completion-menu|.
3659
  truncrl '<' same as "trunc" in 'rightleft' mode
3660
+ tpl_vert '|' vertical separators of 'tabpanel'
3661
 
3662
  Any one that is omitted will fall back to the default.
3663
 
3664
  Example: >
3665
+ :set fillchars=stl:\ ,stlnc:\ ,vert:\|,fold:-,diff:-,tpl_vert:\|
3666
  <
3667
  All items support single-byte and multibyte characters. But
3668
  double-width characters are not supported. |E1512|
7690
  line.
7691
  See |tab-page| for more information about tab pages.
7692
 
7693
+ *'showtabpanel'* *'stpl'*
7694
+ 'showtabpanel' 'stpl' number (default 0)
7695
+ global
7696
+ {not in Vi}
7697
+ {not available when compiled without the |+tabpanel|
7698
+ feature}
7699
+ The value of this option specifies when the |tabpanel| with tab page
7700
+ labels will be displayed:
7701
+ 0: never
7702
+ 1: only if there are at least two tab pages
7703
+ 2: always
7704
+ This is for the non-GUI implementation of the tabpanel only.
7705
+ See |tab-page| for more information about tab page labels.
7706
+
7707
  *'sidescroll'* *'ss'*
7708
  'sidescroll' 'ss' number (default 0)
7709
  global
8423
  Maximum number of tab pages to be opened by the |-p| command line
8424
  argument or the ":tab all" command. |tabpage|
8425
 
8426
+ *'tabpanel'* *'tpl'* *g:actual_curtabpage*
8427
+ 'tabpanel' 'tpl' string (default empty)
8428
+ global
8429
+ {not in Vi}
8430
+ When non empty, this option determines the content of the |tabpanel|.
8431
+ The option consists of printf style '%' items interspersed with
8432
+ normal text, similar to the 'statusline' or 'tabline'.
8433
+
8434
+ When changing something that is used in 'tabpanel' that does not
8435
+ trigger it to be updated, use |:redrawtabpanel|.
8436
+ This option cannot be set in a modeline when 'modelineexpr' is off.
8437
+
8438
+ You can use |g:actual_curtabpage| within a function assigned to
8439
+ tabpanel. |g:actual_curtabpage| represents current tab's label number.
8440
+ This option can contain line breaks:
8441
+ >
8442
+ set tabpanel=%!TabPanel()
8443
+ function! TabPanel() abort
8444
+ return printf("(%2d)\n %%f", g:actual_curtabpage)
8445
+ endfunction
8446
+ <
8447
+ The result is:
8448
+ >
8449
+ +-----------+---------------------------------
8450
+ |(1) |
8451
+ | ~/aaa.txt|
8452
+ |(2) |
8453
+ | ~/.vimrc |
8454
+ | |
8455
+ | |
8456
+ | |
8457
+ <
8458
+
8459
+ *'tabpanelopt'* *'tplo'*
8460
+ 'tabpanelopt' 'tplo' string (default "")
8461
+ global
8462
+ {not in Vi}
8463
+ Optional settings for the |tabpanel|, It can consist of the following
8464
+ items. Items must be separated by a comma.
8465
+
8466
+ align:{text} Specified the position of tabpanel.
8467
+ Currently supported positions are:
8468
+
8469
+ left left-aligned
8470
+ right right-aligned
8471
+
8472
+ (default "left")
8473
+
8474
+ columns:{n} Use the size (in char) of tabpanel.
8475
+ The tabpanel is never shown when using zero
8476
+ or less than the size of Vim window.
8477
+ (default 20)
8478
+
8479
+ vert Use a vertical separator for tabpanel.
8480
+ This vertical separator is used "tpl_vert" of
8481
+ 'fillchars'.
8482
+ (default off)
8483
+
8484
+ Examples: >
8485
+ :set tabpanelopt=columns:16,align:right
8486
+ :set tabpanelopt=
8487
+ :set tabpanelopt=vert,align:right
8488
+ :set tabpanelopt=columns:16
8489
+ <
8490
+
8491
  *'tabstop'* *'ts'*
8492
  'tabstop' 'ts' number (default 8)
8493
  local to buffer
runtime/doc/syntax.txt CHANGED
@@ -1,4 +1,4 @@
1
- *syntax.txt* For Vim version 9.1. Last change: 2025 Apr 28
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -5991,6 +5991,12 @@ TabLine Tab pages line, not active tab page label.
5991
  TabLineFill Tab pages line, where there are no labels.
5992
  *hl-TabLineSel*
5993
  TabLineSel Tab pages line, active tab page label.
 
 
 
 
 
 
5994
  *hl-Terminal*
5995
  Terminal |terminal| window (see |terminal-size-color|).
5996
  *hl-Title*
1
+ *syntax.txt* For Vim version 9.1. Last change: 2025 May 10
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
5991
  TabLineFill Tab pages line, where there are no labels.
5992
  *hl-TabLineSel*
5993
  TabLineSel Tab pages line, active tab page label.
5994
+ *hl-TabPanel*
5995
+ TabPanel TabPanel, not active tab page label.
5996
+ *hl-TabPanelFill*
5997
+ TabPanelFill TabPanel, where there are no labels.
5998
+ *hl-TabPanelSel*
5999
+ TabPanelSel TabPanel, active tab page label.
6000
  *hl-Terminal*
6001
  Terminal |terminal| window (see |terminal-size-color|).
6002
  *hl-Title*
runtime/doc/tabpage.txt CHANGED
@@ -1,4 +1,4 @@
1
- *tabpage.txt* For Vim version 9.1. Last change: 2024 Jul 12
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -14,7 +14,8 @@ when used in combination with more than one tab page.
14
  2. Commands |tab-page-commands|
15
  3. Other items |tab-page-other|
16
  4. Setting 'tabline' |setting-tabline|
17
- 5. Setting 'guitablabel' |setting-guitablabel|
 
18
 
19
  {not able to use multiple tab pages when the |+windows| feature was disabled
20
  at compile time}
@@ -364,8 +365,8 @@ The 'tabline' option allows you to define your preferred way to tab pages
364
  labels. This isn't easy, thus an example will be given here.
365
 
366
  For basics see the 'statusline' option. The same items can be used in the
367
- 'tabline' option. Additionally, the |tabpagebuflist()|, |tabpagenr()| and
368
- |tabpagewinnr()| functions are useful.
369
 
370
  Since the number of tab labels will vary, you need to use an expression for
371
  the whole option. Something like: >
@@ -418,7 +419,74 @@ clever way when there is not enough room. Check the 'columns' option for the
418
  space available.
419
 
420
  ==============================================================================
421
- 5. Setting 'guitablabel' *setting-guitablabel*
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
422
 
423
  When the GUI tab pages line is displayed, 'guitablabel' can be used to
424
  specify the label to display for each tab page. Unlike 'tabline', which
1
+ *tabpage.txt* For Vim version 9.1. Last change: 2025 May 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
14
  2. Commands |tab-page-commands|
15
  3. Other items |tab-page-other|
16
  4. Setting 'tabline' |setting-tabline|
17
+ 5. Setting 'tabpanel' |setting-tabpanel|
18
+ 6. Setting 'guitablabel' |setting-guitablabel|
19
 
20
  {not able to use multiple tab pages when the |+windows| feature was disabled
21
  at compile time}
365
  labels. This isn't easy, thus an example will be given here.
366
 
367
  For basics see the 'statusline' option. The same items can be used in the
368
+ 'tabline' and 'tabpanel' option. Additionally, the |tabpagebuflist()|,
369
+ |tabpagenr()| and |tabpagewinnr()| functions are useful.
370
 
371
  Since the number of tab labels will vary, you need to use an expression for
372
  the whole option. Something like: >
419
  space available.
420
 
421
  ==============================================================================
422
+ 5. Setting 'tabpanel' *tabpanel* *setting-tabpanel*
423
+
424
+ The tabpanel is a vertical sidebar that displays tab page labels along the
425
+ side of the window. It looks like this:
426
+ >
427
+ +-----------+----------------------------------
428
+ |(1) |text text text text text text text
429
+ | ~/aaa.txt|text text text text text text text
430
+ |(2) |text text text text text text text
431
+ | ~/.vimrc |text text text text text text text
432
+ |(3) |text text text text text text text
433
+ | ~/bbb.js |text text text text text text text
434
+ | ~/ccc.css|text text text text text text text
435
+ | |text text text text text text text
436
+ | |text text text text text text text
437
+ | |text text text text text text text
438
+ <
439
+ To configure the tabpanel, use following options: 'tabpanel',
440
+ 'showtabpanel', 'tabpanelopt'.
441
+ The 'tabpanel' and 'showtabpanel' options are function similar to the
442
+ 'statusline' or 'tabline'.
443
+
444
+ The "columns:" of 'tabpanelopt' option specifies the width of the tabpanel:
445
+ >
446
+ +------ This width
447
+ |
448
+ <----+----->
449
+ +-----------+----------------------------------
450
+ |(1) |text text text text text text text
451
+ | ~/aaa.txt|text text text text text text text
452
+ |(2) |text text text text text text text
453
+ <
454
+ The "align:" of 'tabpanelopt' option determines whether the tabpanel is
455
+ displayed on the right side of the window:
456
+ >
457
+ +----------------------------------+-----------
458
+ |text text text text text text text|(1)
459
+ |text text text text text text text| ~/aaa.txt
460
+ |text text text text text text text|(2)
461
+ <
462
+ The "wrap" of 'tabpanelopt' option controls whether lines in tabpanel are
463
+ wraped:
464
+ >
465
+ +-----------+----------------------------------
466
+ |(1) |text text text text text text text
467
+ | ~/long_lo|text text text text text text text
468
+ |ng_file_nam|text text text text text text text
469
+ |e.txt |text text text text text text text
470
+ |(2) |text text text text text text text
471
+
472
+ The "vert" of 'tabpanelopt' option defines whether a vertical separator is
473
+ displayed between the tabpanel and the main window:
474
+ >
475
+ +------ This is
476
+ |
477
+ v
478
+ +-----------+----------------------------------
479
+ |(1) |text text text text text text text
480
+ | ~/aaa.txt|text text text text text text text
481
+ |(2) |text text text text text text text
482
+ <
483
+ The vertical separator is used "tpl_vert" of 'fillchars'.
484
+
485
+ You can customize the appearance of the tab page labels using the highlight
486
+ groups: |hl-TabPanel| |hl-TabPanelSel| |hl-TabPanelFill|
487
+
488
+ ==============================================================================
489
+ 6. Setting 'guitablabel' *setting-guitablabel*
490
 
491
  When the GUI tab pages line is displayed, 'guitablabel' can be used to
492
  specify the label to display for each tab page. Unlike 'tabline', which
runtime/doc/various.txt CHANGED
@@ -1,4 +1,4 @@
1
- *various.txt* For Vim version 9.1. Last change: 2025 Apr 21
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -36,6 +36,12 @@ CTRL-L Clear and redraw the screen. The redraw may happen
36
  'tabline' includes an item that doesn't trigger
37
  automatic updating.
38
 
 
 
 
 
 
 
39
  *N<Del>*
40
  <Del> When entering a number: Remove the last digit.
41
  Note: if you like to use <BS> for this, add this
@@ -491,6 +497,7 @@ N *+statusline* Options 'statusline', 'rulerformat' and special
491
  - *+sun_workshop* Removed: |workshop|
492
  N *+syntax* Syntax highlighting |syntax|
493
  *+system()* Unix only: opposite of |+fork|
 
494
  T *+tag_binary* binary searching in tags file |tag-binary-search|
495
  - *+tag_old_static* Removed; method for static tags |tag-old-static|
496
  - *+tag_any_white* Removed; was to allow any white space in tags files
1
+ *various.txt* For Vim version 9.1. Last change: 2025 May 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
36
  'tabline' includes an item that doesn't trigger
37
  automatic updating.
38
 
39
+ *E1547* *:redrawtabp* *:redrawtabpanel*
40
+ :redrawtabp[anel] Redraw the tabline. Useful to update the tabpanel
41
+ when 'tabpanel' includes an item that doesn't trigger
42
+ automatic updating.
43
+
44
+
45
  *N<Del>*
46
  <Del> When entering a number: Remove the last digit.
47
  Note: if you like to use <BS> for this, add this
497
  - *+sun_workshop* Removed: |workshop|
498
  N *+syntax* Syntax highlighting |syntax|
499
  *+system()* Unix only: opposite of |+fork|
500
+ H *+tabpanel* Support for |tabpanel|
501
  T *+tag_binary* binary searching in tags file |tag-binary-search|
502
  - *+tag_old_static* Removed; method for static tags |tag-old-static|
503
  - *+tag_any_white* Removed; was to allow any white space in tags files
runtime/doc/version9.txt CHANGED
@@ -1,4 +1,4 @@
1
- *version9.txt* For Vim version 9.1. Last change: 2025 May 08
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
@@ -41584,6 +41584,8 @@ completion and command-line completion in |ins-completion-menu|, see
41584
 
41585
  Support for the |Tuple| data type in Vim script and Vim9 script.
41586
 
 
 
41587
  *changed-9.2*
41588
  Changed~
41589
  -------
@@ -41732,6 +41734,9 @@ Highlighting: ~
41732
  |hl-PmenuMatch| Popup menu: highlighting of matched text
41733
  |hl-PmenuMatchSel| Popup menu: highlighting of matched text in selected
41734
  line
 
 
 
41735
 
41736
  Commands: ~
41737
 
@@ -41742,6 +41747,7 @@ Ex-Commands: ~
41742
  |:iput| like |:put| but adjust indent
41743
  |:pbuffer| Edit buffer [N] from the buffer list in the preview
41744
  window
 
41745
 
41746
  Options: ~
41747
 
@@ -41757,7 +41763,11 @@ Options: ~
41757
  'lhistory' Size of the location list stack |quickfix-stack|.
41758
  'messagesopt' configure |:messages| and |hit-enter| prompt
41759
  'pummaxwidth' maximum width for the completion popup menu
 
41760
  'tabclose' Which tab page to focus after closing a tab page
 
 
 
41761
  't_xo' Terminal uses XON/XOFF handshaking (e.g. vt420)
41762
  't_CF' Support for alternate font highlighting terminal code
41763
  'winfixbuf' Keep buffer focused in a window
1
+ *version9.txt* For Vim version 9.1. Last change: 2025 May 14
2
 
3
 
4
  VIM REFERENCE MANUAL by Bram Moolenaar
41584
 
41585
  Support for the |Tuple| data type in Vim script and Vim9 script.
41586
 
41587
+ Support for a vertical |tabpanel| window similar to the 'tabline'.
41588
+
41589
  *changed-9.2*
41590
  Changed~
41591
  -------
41734
  |hl-PmenuMatch| Popup menu: highlighting of matched text
41735
  |hl-PmenuMatchSel| Popup menu: highlighting of matched text in selected
41736
  line
41737
+ |hl-TabPanel| |tabpanel|: not active tab page label
41738
+ |hl-TabPanelFill| |tabpanel|: filler space
41739
+ |hl-TabPanelSel| |tabpanel|: active tab page label
41740
 
41741
  Commands: ~
41742
 
41747
  |:iput| like |:put| but adjust indent
41748
  |:pbuffer| Edit buffer [N] from the buffer list in the preview
41749
  window
41750
+ |:redrawtabpanel| Force updating the 'tabpanel'.
41751
 
41752
  Options: ~
41753
 
41763
  'lhistory' Size of the location list stack |quickfix-stack|.
41764
  'messagesopt' configure |:messages| and |hit-enter| prompt
41765
  'pummaxwidth' maximum width for the completion popup menu
41766
+ 'showtabpanel' When to show the |tabpanel|
41767
  'tabclose' Which tab page to focus after closing a tab page
41768
+ 'tabpanel' Optional vertical panel for displaying tabpages
41769
+ |tabpanel|
41770
+ 'tabpanelopt' Optional settings for the |tabpanel|
41771
  't_xo' Terminal uses XON/XOFF handshaking (e.g. vt420)
41772
  't_CF' Support for alternate font highlighting terminal code
41773
  'winfixbuf' Keep buffer focused in a window