diff --git a/runtime/doc/diff.txt b/runtime/doc/diff.txt index dd93338578..b92f52c48a 100644 --- a/runtime/doc/diff.txt +++ b/runtime/doc/diff.txt @@ -30,9 +30,9 @@ By default an internal diff library will be used. When 'diffopt' or 'diffexpr' has been set an external "diff" command will be used. This only works when such a diff program is available. -Diffs are local to the current tab page |tabpage|. You can't see diffs with -a window in another tab page. This does make it possible to have several -diffs at the same time, each in their own tab page. +Diffs are local to the current |tabpage|. You can't see diffs with a window +in another tabpage. This does make it possible to have several diffs at the +same time, each in their own tabpage. What happens is that Nvim opens a window for each of the files. This is like using the |-O| argument. This uses vertical splits, but if you prefer @@ -118,7 +118,7 @@ file for a moment and come back to the same file and be in diff mode again. options also when 'diff' was not set. :diffo[ff]! Switch off diff mode for the current window and in all windows - in the current tab page where 'diff' is set. Resetting + in the current tabpage where 'diff' is set. Resetting related options only happens in a window that has 'diff' set, if the current window does not have 'diff' set then no options in it are changed. diff --git a/runtime/doc/editing.txt b/runtime/doc/editing.txt index 4e2abf0478..46f14e9afd 100644 --- a/runtime/doc/editing.txt +++ b/runtime/doc/editing.txt @@ -1145,9 +1145,9 @@ The names can be in upper- or lowercase. and Vim refuses to |abandon| the current buffer, and when the last file in the argument list has not been edited. - If there are other tab pages and quitting the last - window in the current tab page the current tab page is - closed |tabpage|. + If there are other tabpages and quitting the last + window in the current |tabpage|, the current tabpage is + closed. Triggers the |QuitPre| autocommand event. See |CTRL-W_q| for quitting another window. diff --git a/runtime/doc/index.txt b/runtime/doc/index.txt index f7b0edaf04..0a6b99e0d0 100644 --- a/runtime/doc/index.txt +++ b/runtime/doc/index.txt @@ -551,7 +551,7 @@ Tag Command Normal-mode action ~ |CTRL-W_P| CTRL-W P go to preview window |CTRL-W_R| CTRL-W R rotate windows upwards N times |CTRL-W_S| CTRL-W S same as "CTRL-W s" -|CTRL-W_T| CTRL-W T move current window to a new tab page +|CTRL-W_T| CTRL-W T move current window to a new tabpage |CTRL-W_W| CTRL-W W go to N previous window (wrap around) |CTRL-W_]| CTRL-W ] split window and jump to tag under cursor |CTRL-W_^| CTRL-W ^ split current window and edit alternate @@ -573,12 +573,12 @@ Tag Command Normal-mode action ~ under cursor |CTRL-W_g}| CTRL-W g } do a |:ptjump| to the tag under the cursor |CTRL-W_gf| CTRL-W g f edit file name under the cursor in a new - tab page + tabpage |CTRL-W_gF| CTRL-W g F edit file name under the cursor in a new - tab page and jump to the line number + tabpage and jump to the line number following the file name. -|CTRL-W_gt| CTRL-W g t same as `gt`: go to next tab page -|CTRL-W_gT| CTRL-W g T same as `gT`: go to previous tab page +|CTRL-W_gt| CTRL-W g t same as `gt`: go to next tabpage +|CTRL-W_gT| CTRL-W g T same as `gT`: go to previous tabpage |CTRL-W_g| CTRL-W g same as |g|: go to last accessed tab page |CTRL-W_h| CTRL-W h go to Nth left window (stop at first window) @@ -743,7 +743,7 @@ Tag Char Note Normal-mode action ~ cursor N times, leave the cursor after it |gQ| gQ switch to "Ex" mode with Vim editing |gR| gR 2 enter Virtual Replace mode -|gT| gT go to the previous tab page +|gT| gT go to the previous tabpage |gU| gU{motion} 2 make Nmove text uppercase |gV| gV don't reselect the previous Visual area when executing a mapping or menu in Select @@ -783,7 +783,7 @@ Tag Char Note Normal-mode action ~ |gq| gq{motion} 2 format Nmove text |gr| gr{char} 2 virtual replace N chars with {char} |gs| gs go to sleep for N seconds (default 1) -|gt| gt go to the next tab page +|gt| gt go to the next tabpage |gu| gu{motion} 2 make Nmove text lowercase |gv| gv reselect the previous Visual area |gw| gw{motion} 2 format Nmove text and keep cursor @@ -797,7 +797,7 @@ Tag Char Note Normal-mode action ~ |g| g same as g same as |g| g same as -|g| g go to last accessed tab page +|g| g go to last accessed tabpage |g| g 1 same as "gk" ============================================================================== @@ -1624,25 +1624,25 @@ Tag Command Action ~ |:syncbind| :sync[bind] sync scroll binding |:t| :t same as ":copy" |:tNext| :tN[ext] jump to previous matching tag -|:tabNext| :tabN[ext] go to previous tab page -|:tabclose| :tabc[lose] close current tab page -|:tabdo| :tabd[o] execute command in each tab page -|:tabedit| :tabe[dit] edit a file in a new tab page -|:tabfind| :tabf[ind] find file in 'path', edit it in a new tab page -|:tabfirst| :tabfir[st] go to first tab page -|:tablast| :tabl[ast] go to last tab page -|:tabmove| :tabm[ove] move tab page to other position -|:tabnew| :tabnew edit a file in a new tab page -|:tabnext| :tabn[ext] go to next tab page -|:tabonly| :tabo[nly] close all tab pages except the current one -|:tabprevious| :tabp[revious] go to previous tab page -|:tabrewind| :tabr[ewind] go to first tab page -|:tabs| :tabs list the tab pages and what they contain +|:tabNext| :tabN[ext] go to previous tabpage +|:tabclose| :tabc[lose] close current tabpage +|:tabdo| :tabd[o] execute command in each tabpage +|:tabedit| :tabe[dit] edit a file in a new tabpage +|:tabfind| :tabf[ind] find file in 'path', edit it in a new tabpage +|:tabfirst| :tabfir[st] go to first tabpage +|:tablast| :tabl[ast] go to last tabpage +|:tabmove| :tabm[ove] move tabpage to other position +|:tabnew| :tabnew edit a file in a new tabpage +|:tabnext| :tabn[ext] go to next tabpage +|:tabonly| :tabo[nly] close all tabpages except the current one +|:tabprevious| :tabp[revious] go to previous tabpage +|:tabrewind| :tabr[ewind] go to first tabpage +|:tabs| :tabs list the tabpages and what they contain |:tab| :tab create new tab when opening new window |:tag| :ta[g] jump to tag |:tags| :tags show the contents of the tag stack -|:tcd| :tc[d] change directory for tab page -|:tchdir| :tch[dir] change directory for tab page +|:tcd| :tc[d] change directory for tabpage +|:tchdir| :tch[dir] change directory for tabpage |:terminal| :te[rminal] open a terminal buffer |:tfirst| :tf[irst] jump to first matching tag |:throw| :th[row] throw an exception diff --git a/runtime/doc/map.txt b/runtime/doc/map.txt index 47f0672864..991cef7b05 100644 --- a/runtime/doc/map.txt +++ b/runtime/doc/map.txt @@ -1521,7 +1521,7 @@ specified. *:command-addr* It is possible that the special characters in the range like `.`, `$` or `%` which by default correspond to the current line, last line and the whole buffer, -relate to arguments, (loaded) buffers, windows or tab pages. +relate to arguments, (loaded) buffers, windows or tabpages. Possible values are (second column is the short name used in listing): -addr=lines Range of lines (the default for -range) @@ -1529,7 +1529,7 @@ Possible values are (second column is the short name used in listing): -addr=buffers buf Range for buffers (also not loaded buffers) -addr=loaded_buffers load Range for loaded buffers -addr=windows win Range for windows - -addr=tabs tab Range for tab pages + -addr=tabs tab Range for tabpages -addr=quickfix qf Range for quickfix entries -addr=other ? Other kind of range; can use ".", "$" and "%" as with "lines" (the default for -count) diff --git a/runtime/doc/news-0.11.txt b/runtime/doc/news-0.11.txt index 4902fd32fe..2f5f842d83 100644 --- a/runtime/doc/news-0.11.txt +++ b/runtime/doc/news-0.11.txt @@ -308,7 +308,7 @@ OPTIONS • 'completeopt' flag "preinsert" highlights text to be inserted. • 'wildmode' flag "noselect" shows 'wildmenu' without selecting an entry. • 'messagesopt' configures |:messages| and |hit-enter| prompt. -• 'tabclose' controls which tab page to focus when closing a tab page. +• 'tabclose' controls which tabpage to focus when closing a tabpage. • 'eventignorewin' to persistently ignore events in a window. • 'winborder' sets the default border for |floating-windows|. diff --git a/runtime/doc/quickref.txt b/runtime/doc/quickref.txt index 9fc8770dd3..f446333b8e 100644 --- a/runtime/doc/quickref.txt +++ b/runtime/doc/quickref.txt @@ -738,8 +738,8 @@ Short explanation of each option: *option-list* 'guifont' 'gfn' GUI: Name(s) of font(s) to be used 'guifontwide' 'gfw' list of font names for double-wide characters 'guioptions' 'go' GUI: Which components and options are used -'guitablabel' 'gtl' GUI: custom label for a tab page -'guitabtooltip' 'gtt' GUI: custom tooltip for a tab page +'guitablabel' 'gtl' GUI: custom label for a tabpage +'guitabtooltip' 'gtt' GUI: custom tooltip for a tabpage 'helpfile' 'hf' full path name of the main help file 'helpheight' 'hh' minimum height of a new help window 'helplang' 'hlg' preferred help languages @@ -867,7 +867,7 @@ Short explanation of each option: *option-list* 'showfulltag' 'sft' show full tag pattern when completing tag 'showmatch' 'sm' briefly jump to matching bracket if insert one 'showmode' 'smd' message on status line to show current mode -'showtabline' 'stal' tells when the tab pages line is displayed +'showtabline' 'stal' tells when the tabpages line is displayed 'sidescroll' 'ss' minimum number of columns to scroll horizontal 'sidescrolloff' 'siso' min. nr. of columns to left and right of cursor 'signcolumn' 'scl' when and how to display the sign column @@ -894,9 +894,9 @@ Short explanation of each option: *option-list* 'switchbuf' 'swb' sets behavior when switching to another buffer 'synmaxcol' 'smc' maximum column to find syntax items 'syntax' 'syn' syntax to be loaded for current buffer -'tabclose' 'tcl' which tab page to focus when closing a tab -'tabline' 'tal' custom format for the console tab pages line -'tabpagemax' 'tpm' maximum number of tab pages for |-p| and "tab all" +'tabclose' 'tcl' which tabpage to focus when closing a tab +'tabline' 'tal' custom format for the console tabpages line +'tabpagemax' 'tpm' maximum number of tabpages for |-p| and "tab all" 'tabstop' 'ts' number of columns between two tab stops 'tagbsearch' 'tbs' use binary searching in tags files 'tagcase' 'tc' how to handle case when searching in tags files diff --git a/runtime/doc/starting.txt b/runtime/doc/starting.txt index d619e3141c..49ffeaf05d 100644 --- a/runtime/doc/starting.txt +++ b/runtime/doc/starting.txt @@ -315,10 +315,10 @@ argument. the command line determines how the windows will be split. *-p* --p[N] Open N tab pages. If [N] is not given, one tab page is opened +-p[N] Open N tabpages. If [N] is not given, one tabpage is opened for every file given as argument. The maximum is set with - 'tabpagemax' pages (default 50). If there are more tab pages - than arguments, the last few tab pages will be editing an + 'tabpagemax' pages (default 50). If there are more tabpages + than arguments, the last few tabpages will be editing an empty file. Also see |tabpage|. *-d* -d Start in |diff-mode|. @@ -554,7 +554,7 @@ accordingly, proceeding as follows: 18. Open all windows. - When |-o| was given, windows will be opened (but not displayed yet). - - When |-p| was given, tab pages will be created (but not displayed yet). + - When |-p| was given, tabpages will be created (but not displayed yet). - When switching screens, it happens now. Redrawing starts. - If |-q| was given, the first error is jumped to. - Buffers for all windows will be loaded, without triggering |BufAdd|. @@ -806,8 +806,8 @@ resulting file, when executed with a ":source" command: "options". Script-local mappings will not be written. 2. Restores global variables that start with an uppercase letter and contain at least one lowercase letter, if 'sessionoptions' contains "globals". -3. Closes all windows in the current tab page, except the current one; closes - all tab pages except the current one (this results in currently loaded +3. Closes all windows in the current tabpage, except the current one; closes + all tabpages except the current one (this results in currently loaded buffers to be unloaded, some may become hidden if 'hidden' is set or otherwise specified); wipes out the current buffer, if it is empty and unnamed. @@ -839,7 +839,7 @@ An example mapping: > :nmap :waexe "mksession! " .. v:this_session:so ~/sessions/ This saves the current Session, and starts off the command to load another. -A session includes all tab pages, unless "tabpages" was removed from +A session includes all tabpages, unless "tabpages" was removed from 'sessionoptions'. |tabpage| The |SessionLoadPre| autocmd event is triggered before a session file is diff --git a/runtime/doc/syntax.txt b/runtime/doc/syntax.txt index dc8b3f99c5..3cd635bfb4 100644 --- a/runtime/doc/syntax.txt +++ b/runtime/doc/syntax.txt @@ -5476,11 +5476,11 @@ StatusLineTerm Status line of |terminal| window. StatusLineTermNC Status line of non-current |terminal| windows. *hl-TabLine* -TabLine Tab pages line, not active tab page label. +TabLine Tabpages line, not active tabpage label. *hl-TabLineFill* -TabLineFill Tab pages line, where there are no labels. +TabLineFill Tabpages line, where there are no labels. *hl-TabLineSel* -TabLineSel Tab pages line, active tab page label. +TabLineSel Tabpages line, active tabpage label. *hl-Title* Title Titles for output from ":set all", ":autocmd" etc. *hl-Visual* diff --git a/runtime/doc/tabpage.txt b/runtime/doc/tabpage.txt index ed607123ba..8f578de3f0 100644 --- a/runtime/doc/tabpage.txt +++ b/runtime/doc/tabpage.txt @@ -4,33 +4,33 @@ VIM REFERENCE MANUAL by Bram Moolenaar -Editing with windows in multiple tab pages. *tab-page* *tabpage* +Editing with windows in multiple tabpages. *tab-page* *tabpage* -The commands which have been added to use multiple tab pages are explained +The commands which have been added to use multiple tabpages are explained here. Additionally, there are explanations for commands that work differently -when used in combination with more than one tab page. +when used in combination with more than one tabpage. Type |gO| to see the table of contents. ============================================================================== 1. Introduction *tabpage-intro* -A tab page holds one or more windows. You can easily switch between tab +A tabpage holds one or more windows. You can easily switch between tab pages, so that you have several collections of windows to work on different things. Usually you will see a list of labels at the top of the Vim window, one for -each tab page. With the mouse you can click on the label to jump to that tab -page. There are other ways to move between tab pages, see below. +each tabpage. With the mouse you can click on the label to jump to that tab +page. There are other ways to move between tabpages, see below. -Most commands work only in the current tab page. That includes the |CTRL-W| +Most commands work only in the current tabpage. That includes the |CTRL-W| commands, |:windo|, |:all| and |:ball| (when not using the |:tab| modifier). -The commands that are aware of other tab pages than the current one are +The commands that are aware of other tabpages than the current one are mentioned below. -Tab pages are also a nice way to edit a buffer temporarily without changing -the current window layout. Open a new tab page, do whatever you want to do -and close the tab page. +Tabpages are also a nice way to edit a buffer temporarily without changing +the current window layout. Open a new tabpage, do whatever you want to do +and close the tabpage. *tab-ID* *tabid* *tabpageid* Each tabpage has an unique identifier which will not change, even after @@ -46,32 +46,32 @@ converts a tab-id to a tab number. ============================================================================== 2. Commands *tabpage-commands* -OPENING A NEW TAB PAGE: +OPENING A NEW TABPAGE: When starting Vim "vim -p filename ..." opens each file argument in a separate -tab page (up to 'tabpagemax'). See |-p| +tabpage (up to 'tabpagemax'). See |-p| -A double click with the mouse in the non-GUI tab pages line opens a new, empty -tab page. It is placed left of the position of the click. The first click -may select another tab page first, causing an extra screen update. +A double click with the mouse in the non-GUI tabpages line opens a new, empty +tabpage. It is placed left of the position of the click. The first click +may select another tabpage first, causing an extra screen update. This also works in a few GUI versions, esp. Win32. But only when clicking right of the labels. -In the GUI tab pages line you can use the right mouse button to open menu. +In the GUI tabpages line you can use the right mouse button to open menu. |tabline-menu|. For the related autocommands see |tabnew-autocmd|. :[count]tabe[dit] *:tabe* *:tabedit* *:tabnew* :[count]tabnew - Open a new tab page with an empty window, after the current - tab page. If [count] is given the new tab page appears after - the tabpage [count] otherwise the new tab page will appear + Open a new tabpage with an empty window, after the current + tabpage. If [count] is given the new tabpage appears after + the tabpage [count] otherwise the new tabpage will appear after the current one. > :tabnew " opens tabpage after the current one :.tabnew " as above - :+tabnew " opens tabpage after the next tab page + :+tabnew " opens tabpage after the next tabpage " note: it is one further than :tabnew :-tabnew " opens tabpage before the current :0tabnew " opens tabpage before the first one @@ -79,78 +79,78 @@ For the related autocommands see |tabnew-autocmd|. :[count]tabe[dit] [++opt] [+cmd] {file} :[count]tabnew [++opt] [+cmd] {file} - Open a new tab page and edit {file}, like with |:edit|. + Open a new tabpage and edit {file}, like with |:edit|. For [count] see |:tabnew| above. :[count]tabf[ind] [++opt] [+cmd] {file} *:tabf* *:tabfind* - Open a new tab page and edit {file} in 'path', like with + Open a new tabpage and edit {file} in 'path', like with |:find|. For [count] see |:tabnew| above. :[count]tab {cmd} *:tab* Execute {cmd} and when it opens a new window open a new tab page instead. Doesn't work for |:diffsplit|, |:diffpatch|, |:execute| and |:normal|. - If [count] is given the new tab page appears after the tab - page [count] otherwise the new tab page will appear after the + If [count] is given the new tabpage appears after the tab + page [count] otherwise the new tabpage will appear after the current one. Examples: > - :tab split " opens current buffer in new tab page - :tab help gt " opens tab page with help for "gt" + :tab split " opens current buffer in new tabpage + :tab help gt " opens tabpage with help for "gt" :.tab help gt " as above - :+tab help " opens tab page with help after the next - " tab page - :-tab help " opens tab page with help before the + :+tab help " opens tabpage with help after the next + " tabpage + :-tab help " opens tabpage with help before the " current one - :0tab help " opens tab page with help before the + :0tab help " opens tabpage with help before the " first one - :$tab help " opens tab page with help after the last + :$tab help " opens tabpage with help after the last " one -CTRL-W gf Open a new tab page and edit the file name under the cursor. +CTRL-W gf Open a new tabpage and edit the file name under the cursor. See |CTRL-W_gf|. -CTRL-W gF Open a new tab page and edit the file name under the cursor +CTRL-W gF Open a new tabpage and edit the file name under the cursor and jump to the line number following the file name. See |CTRL-W_gF|. -CLOSING A TAB PAGE: +CLOSING A TABPAGE: -Closing the last window of a tab page closes the tab page too, unless there is -only one tab page. +Closing the last window of a tabpage closes the tabpage too, unless there is +only one tabpage. -Using the mouse: If the tab page line is displayed you can click in the "X" at -the top right to close the current tab page. A custom 'tabline' may show +Using the mouse: If the tabpage line is displayed you can click in the "X" at +the top right to close the current tabpage. A custom 'tabline' may show something else. *:tabc* *:tabclose* -:tabc[lose][!] Close current tab page. +:tabc[lose][!] Close current tabpage. This command fails when: - - There is only one tab page on the screen. *E784* + - There is only one tabpage on the screen. *E784* - When 'hidden' is not set, [!] is not used, a buffer has changes, and there is no other window on this buffer. Changes to the buffer are not written and won't get lost, so this is a "safe" command. > - :tabclose " close the current tab page + :tabclose " close the current tabpage :{count}tabc[lose][!] :tabc[lose][!] {count} - Close tab page {count}. Fails in the same way as `:tabclose` + Close tabpage {count}. Fails in the same way as `:tabclose` above. > - :-tabclose " close the previous tab page - :+tabclose " close the next tab page - :1tabclose " close the first tab page - :$tabclose " close the last tab page - :tabclose -2 " close the 2nd previous tab page - :tabclose + " close the next tab page - :tabclose 3 " close the third tab page - :tabclose $ " close the last tab page - :tabclose # " close the last accessed tab page + :-tabclose " close the previous tabpage + :+tabclose " close the next tabpage + :1tabclose " close the first tabpage + :$tabclose " close the last tabpage + :tabclose -2 " close the 2nd previous tabpage + :tabclose + " close the next tabpage + :tabclose 3 " close the third tabpage + :tabclose $ " close the last tabpage + :tabclose # " close the last accessed tabpage -When a tab page is closed the next tab page will become the current one. This +When a tabpage is closed the next tabpage will become the current one. This behaviour can be customized using the 'tabclose' option. *:tabo* *:tabonly* -:tabo[nly][!] Close all other tab pages. +:tabo[nly][!] Close all other tabpages. When the 'hidden' option is set, all buffers in closed windows become hidden. When 'hidden' is not set, and the 'autowrite' option is set, @@ -158,146 +158,146 @@ behaviour can be customized using the 'tabclose' option. buffers that are modified are not removed, unless the [!] is given, then they become hidden. But modified buffers are never abandoned, so changes cannot get lost. > - :tabonly " close all tab pages except the current one + :tabonly " close all tabpages except the current one :tabo[nly][!] {count} - Close all tab pages except {count} one. > + Close all tabpages except {count} one. > :.tabonly " as above - :-tabonly " close all tab pages except the previous + :-tabonly " close all tabpages except the previous " one - :+tabonly " close all tab pages except the next one - :1tabonly " close all tab pages except the first one - :$tabonly " close all tab pages except the last one - :tabonly - " close all tab pages except the previous + :+tabonly " close all tabpages except the next one + :1tabonly " close all tabpages except the first one + :$tabonly " close all tabpages except the last one + :tabonly - " close all tabpages except the previous " one - :tabonly +2 " close all tab pages except the two next + :tabonly +2 " close all tabpages except the two next " one - :tabonly 1 " close all tab pages except the first one - :tabonly $ " close all tab pages except the last one - :tabonly # " close all tab pages except the last + :tabonly 1 " close all tabpages except the first one + :tabonly $ " close all tabpages except the last one + :tabonly # " close all tabpages except the last " accessed one -SWITCHING TO ANOTHER TAB PAGE: +SWITCHING TO ANOTHER TABPAGE: -Using the mouse: If the tab page line is displayed you can click in a tab page -label to switch to that tab page. Click where there is no label to go to the -next tab page. 'tabline' +Using the mouse: If the tabpage line is displayed you can click in a tabpage +label to switch to that tabpage. Click where there is no label to go to the +next tabpage. 'tabline' :tabn[ext] *:tabn* *:tabnext* *gt* *CTRL-* ** gt *i_CTRL-* *i_* - Go to the next tab page. Wraps around from the last to the + Go to the next tabpage. Wraps around from the last to the first one. :{count}tabn[ext] :tabn[ext] {count} - Go to tab page {count}. The first tab page has number one. > - :-tabnext " go to the previous tab page - :+tabnext " go to the next tab page - :+2tabnext " go to the two next tab page - :1tabnext " go to the first tab page - :$tabnext " go to the last tab page + Go to tabpage {count}. The first tabpage has number one. > + :-tabnext " go to the previous tabpage + :+tabnext " go to the next tabpage + :+2tabnext " go to the two next tabpage + :1tabnext " go to the first tabpage + :$tabnext " go to the last tabpage :tabnext $ " as above - :tabnext # " go to the last accessed tab page - :tabnext - " go to the previous tab page + :tabnext # " go to the last accessed tabpage + :tabnext - " go to the previous tabpage :tabnext -1 " as above - :tabnext + " go to the next tab page + :tabnext + " go to the next tabpage :tabnext +1 " as above {count} -{count}gt Go to tab page {count}. The first tab page has number one. +{count}gt Go to tabpage {count}. The first tabpage has number one. :tabp[revious] *:tabp* *:tabprevious* *gT* *:tabN* :tabN[ext] *:tabNext* *CTRL-* ** *i_CTRL-* *i_* -gT Go to the previous tab page. Wraps around from the first one +gT Go to the previous tabpage. Wraps around from the first one to the last one. :tabp[revious] {count} :tabN[ext] {count} {count} -{count}gT Go {count} tab pages back. Wraps around from the first one +{count}gT Go {count} tabpages back. Wraps around from the first one to the last one. Note that the use of {count} is different - from |:tabnext|, where it is used as the tab page number. + from |:tabnext|, where it is used as the tabpage number. :tabr[ewind] *:tabfir* *:tabfirst* *:tabr* *:tabrewind* -:tabfir[st] Go to the first tab page. +:tabfir[st] Go to the first tabpage. *:tabl* *:tablast* -:tabl[ast] Go to the last tab page. +:tabl[ast] Go to the last tabpage. *CTRL-* ** g *g* *CTRL-W_g* -CTRL-W g Go to the last accessed tab page. +CTRL-W g Go to the last accessed tabpage. Other commands: *:tabs* -:tabs List the tab pages and the windows they contain. +:tabs List the tabpages and the windows they contain. Shows a ">" for the current window. Shows a "+" for modified buffers. For example: - Tab page 1 ~ + Tabpage 1 ~ + tabpage.txt ~ ex_docmd.c ~ - Tab page 2 ~ + Tabpage 2 ~ > main.c ~ -REORDERING TAB PAGES: +REORDERING TABPAGES: :tabm[ove] [N] *:tabm* *:tabmove* :[N]tabm[ove] - Move the current tab page to after tab page N. Use zero to - make the current tab page the first one. N is counted before - the move, thus if the second tab page is the current one, + Move the current tabpage to after tabpage N. Use zero to + make the current tabpage the first one. N is counted before + the move, thus if the second tabpage is the current one, `:tabmove 1` and `:tabmove 2` have no effect. - Without N the tab page is made the last one. > + Without N the tabpage is made the last one. > :.tabmove " do nothing - :-tabmove " move the tab page to the left - :+tabmove " move the tab page to the right - :0tabmove " move the tab page to the first + :-tabmove " move the tabpage to the left + :+tabmove " move the tabpage to the right + :0tabmove " move the tabpage to the first :tabmove 0 " as above - :tabmove " move the tab page to the last + :tabmove " move the tabpage to the last :$tabmove " as above :tabmove $ " as above - :tabmove # " move the tab page after the last accessed - " tab page + :tabmove # " move the tabpage after the last accessed + " tabpage :tabm[ove] +[N] :tabm[ove] -[N] - Move the current tab page N places to the right (with +) or to + Move the current tabpage N places to the right (with +) or to the left (with -). > - :tabmove - " move the tab page to the left + :tabmove - " move the tabpage to the left :tabmove -1 " as above - :tabmove + " move the tab page to the right + :tabmove + " move the tabpage to the right :tabmove +1 " as above -Note that although it is possible to move a tab page behind the N-th one by +Note that although it is possible to move a tabpage behind the N-th one by using :Ntabmove. And move it by N places by using :+Ntabmove. For clarification what +N means in this context see |[range]|. -LOOPING OVER TAB PAGES: +LOOPING OVER TABPAGES: *:tabd* *:tabdo* :[range]tabd[o] {cmd} - Execute {cmd} in each tab page or, if [range] is given, only - in tabpages which tab page number is in the [range]. It works + Execute {cmd} in each tabpage or, if [range] is given, only + in tabpages which tabpage number is in the [range]. It works like doing this: > :tabfirst :{cmd} :tabnext :{cmd} etc. -< This only operates in the current window of each tab page. - When an error is detected on one tab page, further tab pages +< This only operates in the current window of each tabpage. + When an error is detected on one tabpage, further tabpages will not be visited. - The last tab page (or where an error occurred) becomes the - current tab page. + The last tabpage (or where an error occurred) becomes the + current tabpage. {cmd} can contain '|' to concatenate several commands. - {cmd} must not open or close tab pages or reorder them. + {cmd} must not open or close tabpages or reorder them. Also see |:windo|, |:argdo|, |:bufdo|, |:cdo|, |:ldo|, |:cfdo| and |:lfdo|. @@ -305,38 +305,38 @@ LOOPING OVER TAB PAGES: 3. Other items *tabpage-other* *tabline-menu* -The GUI tab pages line has a popup menu. It is accessed with a right click. +The GUI tabpages line has a popup menu. It is accessed with a right click. The entries are: - Close Close the tab page under the mouse pointer. The + Close Close the tabpage under the mouse pointer. The current one if there is no label under the mouse pointer. - New Tab Open a tab page, editing an empty buffer. It appears + New Tab Open a tabpage, editing an empty buffer. It appears to the left of the mouse pointer. Open Tab... Like "New Tab" and additionally use a file selector to select a file to edit. -Diff mode works per tab page. You can see the diffs between several files -within one tab page. Other tab pages can show differences between other +Diff mode works per tabpage. You can see the diffs between several files +within one tabpage. Other tabpages can show differences between other files. -Variables local to a tab page start with "t:". |tabpage-variable| +Variables local to a tabpage start with "t:". |tabpage-variable| -Currently there is only one option local to a tab page: 'cmdheight'. +Currently there is only one option local to a tabpage: 'cmdheight'. *tabnew-autocmd* The TabLeave and TabEnter autocommand events can be used to do something when -switching from one tab page to another. The exact order depends on what you -are doing. When creating a new tab page this works as if you create a new +switching from one tabpage to another. The exact order depends on what you +are doing. When creating a new tabpage this works as if you create a new window on the same buffer and then edit another buffer. Thus ":tabnew" triggers: WinLeave leave current window - TabLeave leave current tab page - WinEnter enter window in new tab page - TabEnter enter new tab page + TabLeave leave current tabpage + WinEnter enter window in new tabpage + TabEnter enter new tabpage BufLeave leave current buffer BufEnter enter new empty buffer -When switching to another tab page the order is: +When switching to another tabpage the order is: BufLeave WinLeave TabLeave @@ -344,27 +344,27 @@ When switching to another tab page the order is: TabEnter BufEnter -When entering a new tab page (|:tabnew|), TabNew is triggered before TabEnter +When entering a new tabpage (|:tabnew|), TabNew is triggered before TabEnter and after WinEnter. ============================================================================== 4. Setting 'tabline' *setting-tabline* -The 'tabline' option specifies what the line with tab pages labels looks like. +The 'tabline' option specifies what the line with tabpages labels looks like. It is only used when there is no GUI tab line. You can use the 'showtabline' option to specify when you want the line with -tab page labels to appear: never, when there is more than one tab page or +tabpage labels to appear: never, when there is more than one tabpage or always. -The highlighting of the tab pages line is set with the groups TabLine +The highlighting of the tabpages line is set with the groups TabLine TabLineSel and TabLineFill. |hl-TabLine| |hl-TabLineSel| |hl-TabLineFill| -A "+" will be shown for a tab page that has a modified window. The number of +A "+" will be shown for a tabpage that has a modified window. The number of windows in a tabpage is also shown. Thus "3+" means three windows and one of them has a modified buffer. -The 'tabline' option allows you to define your preferred way to tab pages +The 'tabline' option allows you to define your preferred way to tabpages labels. This isn't easy, thus an example will be given here. For basics see the 'statusline' option. The same items can be used in the @@ -375,9 +375,9 @@ Since the number of tab labels will vary, you need to use an expression for the whole option. Something like: > :set tabline=%!MyTabLine() -Then define the MyTabLine() function to list all the tab pages labels. A +Then define the MyTabLine() function to list all the tabpages labels. A convenient method is to split it in two parts: First go over all the tab -pages and define labels for them. Then get the label for each tab page. > +pages and define labels for them. Then get the label for each tabpage. > function MyTabLine() let s = '' @@ -389,17 +389,17 @@ pages and define labels for them. Then get the label for each tab page. > let s ..= '%#TabLine#' endif - " set the tab page number (for mouse clicks) + " set the tabpage number (for mouse clicks) let s ..= '%' .. (i + 1) .. 'T' " the label is made by MyTabLabel() let s ..= ' %{MyTabLabel(' .. (i + 1) .. ')} ' endfor - " after the last tab page fill with TabLineFill and reset tab page nr + " after the last tabpage fill with TabLineFill and reset tabpage nr let s ..= '%#TabLineFill#%T' - " right-align the label to close the current tab page + " right-align the label to close the current tabpage if tabpagenr('$') > 1 let s ..= '%=%#TabLine#%999Xclose' endif @@ -407,7 +407,7 @@ pages and define labels for them. Then get the label for each tab page. > return s endfunction -Now the MyTabLabel() function is called for each tab page to get its label. > +Now the MyTabLabel() function is called for each tabpage to get its label. > function MyTabLabel(n) let buflist = tabpagebuflist(a:n) @@ -415,7 +415,7 @@ Now the MyTabLabel() function is called for each tab page to get its label. > return bufname(buflist[winnr - 1]) endfunction -This is just a simplistic example that results in a tab pages line that +This is just a simplistic example that results in a tabpages line that resembles the default, but without adding a + for a modified buffer or truncating the names. You will want to reduce the width of labels in a clever way when there is not enough room. Check the 'columns' option for the @@ -424,9 +424,9 @@ space available. ============================================================================== 5. Setting 'guitablabel' *setting-guitablabel* -When the GUI tab pages line is displayed, 'guitablabel' can be used to -specify the label to display for each tab page. Unlike 'tabline', which -specifies the whole tab pages line at once, 'guitablabel' is used for each +When the GUI tabpages line is displayed, 'guitablabel' can be used to +specify the label to display for each tabpage. Unlike 'tabline', which +specifies the whole tabpages line at once, 'guitablabel' is used for each label separately. 'guitabtooltip' is very similar and is used for the tooltip of the same label. @@ -435,25 +435,25 @@ usually is longer. Only supported on some systems though. See the 'statusline' option for the format of the value. -The "%N" item can be used for the current tab page number. The |v:lnum| +The "%N" item can be used for the current tabpage number. The |v:lnum| variable is also set to this number when the option is evaluated. -The items that use a file name refer to the current window of the tab page. +The items that use a file name refer to the current window of the tabpage. Note that syntax highlighting is not used for the option. The %T and %X items are also ignored. -A simple example that puts the tab page number and the buffer name in the +A simple example that puts the tabpage number and the buffer name in the label: > :set guitablabel=%N\ %f An example that resembles the default 'guitablabel': Show the number of -windows in the tab page and a '+' if there is a modified buffer: > +windows in the tabpage and a '+' if there is a modified buffer: > function GuiTabLabel() let label = '' let bufnrlist = tabpagebuflist(v:lnum) - " Add '+' if one of the buffers in the tab page is modified + " Add '+' if one of the buffers in the tabpage is modified for bufnr in bufnrlist if getbufvar(bufnr, "&modified") let label = '+' @@ -461,7 +461,7 @@ windows in the tab page and a '+' if there is a modified buffer: > endif endfor - " Append the number of windows in the tab page if more than one + " Append the number of windows in the tabpage if more than one let wincount = tabpagewinnr(v:lnum, '$') if wincount > 1 let label ..= wincount @@ -481,8 +481,8 @@ you get an error message for the function not being known. If you want to fall back to the default label, return an empty string. -If you want to show something specific for a tab page, you might want to use a -tab page local variable. |t:var| +If you want to show something specific for a tabpage, you might want to use a +tabpage local variable. |t:var| vim:tw=78:ts=8:noet:ft=help:norl: diff --git a/runtime/doc/usr_08.txt b/runtime/doc/usr_08.txt index 9d90e332b3..0f4d17109c 100644 --- a/runtime/doc/usr_08.txt +++ b/runtime/doc/usr_08.txt @@ -19,7 +19,7 @@ side by side. All this is possible with split windows. |08.6| Commands for all windows |08.7| Viewing differences with diff mode |08.8| Various -|08.9| Tab pages +|08.9| Tabpages Next chapter: |usr_09.txt| Using the GUI Previous chapter: |usr_07.txt| Editing more than one file @@ -511,12 +511,12 @@ window is to appear: ============================================================================== -*08.9* Tab pages +*08.9* Tabpages You will have noticed that windows never overlap. That means you quickly run -out of screen space. The solution for this is called Tab pages. +out of screen space. The solution for this is called Tabpages. -Assume you are editing "thisfile". To create a new tab page use this command: > +Assume you are editing "thisfile". To create a new tabpage use this command: > :tabedit thatfile @@ -534,7 +534,7 @@ window. And you will notice a bar at the top with the two file names: | | +----------------------------------+ < -You now have two tab pages. The first one has a window for "thisfile" and the +You now have two tabpages. The first one has a window for "thisfile" and the second one a window for "thatfile". It's like two pages that are on top of each other, with a tab sticking out of each page showing the file name. @@ -551,15 +551,15 @@ Now use the mouse to click on "thisfile" in the top line. The result is | | +----------------------------------+ < -Thus you can switch between tab pages by clicking on the label in the top +Thus you can switch between tabpages by clicking on the label in the top line. If you don't have a mouse or don't want to use it, you can use the "gt" command. Mnemonic: Goto Tab. -Now let's create another tab page with the command: > +Now let's create another tabpage with the command: > :tab split -This makes a new tab page with one window that is editing the same buffer as +This makes a new tabpage with one window that is editing the same buffer as the window we were in: > +-------------------------------------+ @@ -574,27 +574,27 @@ the window we were in: +-------------------------------------+ < You can put ":tab" before any Ex command that opens a window. The window will -be opened in a new tab page. Another example: > +be opened in a new tabpage. Another example: > :tab help gt -Will show the help text for "gt" in a new tab page. +Will show the help text for "gt" in a new tabpage. -A few more things you can do with tab pages: +A few more things you can do with tabpages: - click with the mouse in the space after the last label - The next tab page will be selected, like with "gt". + The next tabpage will be selected, like with "gt". - click with the mouse on the "X" in the top right corner - The current tab page will be closed. Unless there are unsaved - changes in the current tab page. + The current tabpage will be closed. Unless there are unsaved + changes in the current tabpage. - double click with the mouse in the top line - A new tab page will be created. + A new tabpage will be created. - the "tabonly" command - Closes all tab pages except the current one. Unless there are unsaved - changes in other tab pages. + Closes all tabpages except the current one. Unless there are unsaved + changes in other tabpages. For more information about tabpages see |tabpage|. diff --git a/runtime/doc/usr_22.txt b/runtime/doc/usr_22.txt index 8e20bff2ee..8c51e77a45 100644 --- a/runtime/doc/usr_22.txt +++ b/runtime/doc/usr_22.txt @@ -205,15 +205,15 @@ directory, it will go back to using the shared directory. TAB LOCAL DIRECTORY -When you open a new tab page, it uses the directory of the window in the -previous tab page from which the new tab page was opened. You can change the -directory of the current tab page using the `:tcd` command. All the windows -in a tab page share this directory except for windows with a window-local -directory. Any new windows opened in this tab page will use this directory as -the current working directory. Using a `:cd` command in a tab page will not -change the working directory of tab pages which have a tab local directory. +When you open a new tabpage, it uses the directory of the window in the +previous tabpage from which the new tabpage was opened. You can change the +directory of the current tabpage using the `:tcd` command. All the windows +in a tabpage share this directory except for windows with a window-local +directory. Any new windows opened in this tabpage will use this directory as +the current working directory. Using a `:cd` command in a tabpage will not +change the working directory of tabpages which have a tab local directory. When the global working directory is changed using the `:cd` command in a tab -page, it will also change the current tab page working directory. +page, it will also change the current tabpage working directory. ============================================================================== diff --git a/runtime/doc/vim_diff.txt b/runtime/doc/vim_diff.txt index e104336bca..94a63e4943 100644 --- a/runtime/doc/vim_diff.txt +++ b/runtime/doc/vim_diff.txt @@ -679,7 +679,7 @@ Vimscript compatibility: Working directory (Vim implemented some of these after Nvim): - |DirChanged| and |DirChangedPre| can be triggered when switching to another window or tab. -- |getcwd()| and |haslocaldir()| may throw errors if the tab page or window +- |getcwd()| and |haslocaldir()| may throw errors if the tabpage or window cannot be found. *E5000* *E5001* *E5002* - |haslocaldir()| checks for tab-local directory if and only if -1 is passed as window number, and its only possible returns values are 0 and 1. diff --git a/runtime/doc/vimfn.txt b/runtime/doc/vimfn.txt index 58cc0b7241..8e100af32e 100644 --- a/runtime/doc/vimfn.txt +++ b/runtime/doc/vimfn.txt @@ -187,7 +187,7 @@ arglistid([{winnr} [, {tabnr}]]) *arglistid()* Returns -1 if the arguments are invalid. Without arguments use the current window. - With {winnr} only use this window in the current tab page. + With {winnr} only use this window in the current tabpage. With {winnr} and {tabnr} use the window in the specified tab page. {winnr} can be the window number or the |window-ID|. @@ -767,7 +767,7 @@ bufwinid({buf}) *bufwinid()* echo "A window containing buffer 1 is " .. (bufwinid(1)) < - Only deals with the current tab page. See |win_findbuf()| for + Only deals with the current tabpage. See |win_findbuf()| for finding more. Parameters: ~ @@ -1100,14 +1100,14 @@ chdir({dir} [, {scope}]) *chdir()* changed to the scope of the current directory: - If the window local directory (|:lcd|) is set, it changes the current working directory for that scope. - - Otherwise, if the tab page local directory (|:tcd|) is + - Otherwise, if the tabpage local directory (|:tcd|) is set, it changes the current directory for that scope. - Otherwise, changes the global directory for that scope. If {scope} is present, changes the current working directory for the specified scope: "window" Changes the window local directory. |:lcd| - "tabpage" Changes the tab page local directory. |:tcd| + "tabpage" Changes the tabpage local directory. |:tcd| "global" Changes the global directory. |:cd| {dir} must be a String. @@ -3878,7 +3878,7 @@ getjumplist([{winnr} [, {tabnr}]]) *getjumplist()* Returns the |jumplist| for the specified window. Without arguments use the current window. - With {winnr} only use this window in the current tab page. + With {winnr} only use this window in the current tabpage. {winnr} can also be a |window-ID|. With {winnr} and {tabnr} use the window in the specified tab page. If {winnr} or {tabnr} is invalid, an empty list is @@ -4513,16 +4513,16 @@ getstacktrace() *getstacktrace()* gettabinfo([{tabnr}]) *gettabinfo()* If {tabnr} is not specified, then information about all the - tab pages is returned as a |List|. Each List item is a - |Dictionary|. Otherwise, {tabnr} specifies the tab page + tabpages is returned as a |List|. Each List item is a + |Dictionary|. Otherwise, {tabnr} specifies the tabpage number and information about that one is returned. If the tab page does not exist an empty List is returned. Each List item is a |Dictionary| with the following entries: - tabnr tab page number. + tabnr |tabpage-number| variables a reference to the dictionary with tabpage-local variables - windows List of |window-ID|s in the tab page. + windows List of |window-ID|s in the tabpage. Parameters: ~ • {tabnr} (`integer?`) @@ -4533,7 +4533,7 @@ gettabinfo([{tabnr}]) *gettabinfo()* gettabvar({tabnr}, {varname} [, {def}]) *gettabvar()* Lua: Prefer |nvim_tabpage_get_var()| or |vim.t|. - Get the value of a tab-local variable {varname} in tab page + Get the value of a tab-local variable {varname} in tabpage {tabnr}. |t:var| Tabs are numbered starting with one. The {varname} argument is a string. When {varname} is empty a @@ -4556,7 +4556,7 @@ gettabwinvar({tabnr}, {winnr}, {varname} [, {def}]) *gettabwinvar()* |nvim_get_option_value()| or |vim.wo|. Get the value of window-local variable {varname} in window - {winnr} in tab page {tabnr}. + {winnr} in tabpage {tabnr}. The {varname} argument is a string. When {varname} is empty a dictionary with all window-local variables is returned. When {varname} is equal to "&" get the values of all @@ -4649,7 +4649,7 @@ getwininfo([{winid}]) *getwininfo()* exist the result is an empty list. Without {winid} information about all the windows in all the - tab pages is returned. + tabpages is returned. Each List item is a |Dictionary| with the following entries: botline last complete displayed buffer line @@ -4660,7 +4660,7 @@ getwininfo([{winid}]) *getwininfo()* loclist 1 if showing a location list quickfix 1 if quickfix or location list window status_height status lines height (0 or 1) - tabnr tab page number + tabnr |tabpage-number| terminal 1 if a terminal window textoff number of columns occupied by any 'foldcolumn', 'signcolumn' and line @@ -9801,7 +9801,7 @@ setreg({regname}, {value} [, {options}]) *setreg()* settabvar({tabnr}, {varname}, {val}) *settabvar()* Lua: Prefer |nvim_tabpage_set_var()| or |vim.t|. - Set tab-local variable {varname} to {val} in tab page {tabnr}. + Set tab-local variable {varname} to {val} in tabpage {tabnr}. |t:var| The {varname} argument is a string. Note that the variable name without "t:" must be used. @@ -9891,7 +9891,7 @@ setwinvar({nr}, {varname}, {val}) *setwinvar()* Lua: Prefer |nvim_win_set_var()| or |vim.w| after resolving {nr} to a winid; option names use |nvim_set_option_value()|. - Like |settabwinvar()| for the current tab page. + Like |settabwinvar()| for the current tabpage. Examples: >vim call setwinvar(1, "&list", 0) call setwinvar(2, "myvar", "foobar") @@ -11734,9 +11734,9 @@ tabpagebuflist([{arg}]) *tabpagebuflist()* returning 0. Returns a |List| of buffer numbers, one for each window in - the specified tab page. - {arg} specifies the number of the tab page to be used. When - omitted the current tab page is used. + the specified tabpage. + {arg} specifies the number of the tabpage to be used. When + omitted the current tabpage is used. When {arg} is invalid the number zero is returned. To get a list of all buffers in all tabs use this: >vim let buflist = [] @@ -11756,15 +11756,12 @@ tabpagenr([{arg}]) *tabpagenr()* |nvim_get_current_tabpage()| for the current tab, or `#vim.api.nvim_list_tabpages()` for "$"; "#" differs. - Returns the number of the current tab page. The first tab - page has number 1. + Returns the current |tabpage-number|. The optional argument {arg} supports the following values: - $ the number of the last tab page (the tab page - count). - # the number of the last accessed tab page - (where |g| goes to). If there is no - previous tab page, 0 is returned. + $ the last |tabpage-number| (the tabpage count). + # the last-accessed |tabpage-number| (where |g| + goes to), or 0 if there is no previous tabpage. The number can be used with the |:tab| command. Returns zero on error. @@ -11781,16 +11778,16 @@ tabpagewinnr({tabarg} [, {arg}]) *tabpagewinnr()* of |nvim_tabpage_list_wins()| for "$"; "#" and invalid-tab behavior differ. - Like |winnr()| but for tab page {tabarg}. - {tabarg} specifies the number of tab page to be used. + Like |winnr()| but for tabpage {tabarg}. + {tabarg} specifies the |tabpage-number| to be used. {arg} is used like with |winnr()|: - When omitted the current window number is returned. This is - the window which will be used when going to this tab page. + the window which will be used when going to this tabpage. - When "$" the number of windows is returned. - When "#" the previous window nr is returned. Useful examples: >vim - tabpagewinnr(1) " current window of tab page 1 - tabpagewinnr(4, '$') " number of windows in tab page 4 + tabpagewinnr(1) " current window of tabpage 1 + tabpagewinnr(4, '$') " number of windows in tabpage 4 < When {tabarg} is invalid zero is returned. Parameters: ~ @@ -12618,7 +12615,7 @@ win_move_separator({nr}, {offset}) *win_move_separator()* FALSE otherwise. This will fail for the rightmost window and a full-width window, since it has no separator on the right. - Only works for the current tab page. *E1308* + Only works for the current tabpage. *E1308* Parameters: ~ • {nr} (`integer`) @@ -12637,7 +12634,7 @@ win_move_statusline({nr}, {offset}) *win_move_statusline()* magnitude of movement may be smaller than specified (e.g., as a consequence of maintaining 'winminheight'). Returns TRUE if the window can be found and FALSE otherwise. - Only works for the current tab page. + Only works for the current tabpage. Parameters: ~ • {nr} (`integer`) @@ -12670,7 +12667,7 @@ win_splitmove({nr}, {target} [, {options}]) *win_splitmove()* (the |window-ID| of window {nr} is unchanged after the move). Both {nr} and {target} can be window numbers or |window-ID|s. - Both must be in the current tab page. + Both must be in the current tabpage. Returns zero for success, non-zero for failure. @@ -12760,7 +12757,7 @@ winlayout([{tabnr}]) *winlayout()* ["row", [{nested list of windows}]] < Example: >vim - " Only one window in the tab page + " Only one window in the tabpage echo winlayout() < > ['leaf', 1000] @@ -12770,7 +12767,7 @@ winlayout([{tabnr}]) *winlayout()* < > ['col', [['leaf', 1000], ['leaf', 1001]]] < >vim - " The second tab page, with three horizontally split + " The second tabpage, with three horizontally split " windows, with two vertically split windows in the " middle window echo winlayout(2) @@ -12810,7 +12807,7 @@ winnr([{arg}]) *winnr()* count). # the number of the last accessed window (where |CTRL-W_p| goes to). If there is no previous - window or it is in another tab page 0 is + window or it is in another tabpage, 0 is returned. May refer to the current window in some cases (e.g. when evaluating 'statusline' expressions). @@ -12841,7 +12838,7 @@ winnr([{arg}]) *winnr()* winrestcmd() *winrestcmd()* Returns a sequence of |:resize| commands that should restore the current window sizes. Only works properly when no windows - are opened or closed and the current window and tab page is + are opened or closed and the current window and tabpage is unchanged. Example: >vim let cmd = winrestcmd() diff --git a/runtime/doc/windows.txt b/runtime/doc/windows.txt index 2d3a81a572..10bd80e915 100644 --- a/runtime/doc/windows.txt +++ b/runtime/doc/windows.txt @@ -21,7 +21,7 @@ The basics are explained in chapter 7 and 8 of the user manual |usr_07.txt| Summary: A buffer is the in-memory text of a file. A window is a viewport on a buffer. - A tab page is a collection of windows. + A tabpage is a collection of windows. A window is a viewport onto a buffer. You can use multiple windows on one buffer, or several windows on different buffers. @@ -670,7 +670,7 @@ use the `winlayout()` and `getwininfo()` functions. |WinScrolled| and |WinResized| do not trigger when the first autocommand is added, only after the first scroll or resize. They may trigger when switching -to another tab page. +to another tabpage. The commands executed are expected to not cause window size or scroll changes. If this happens anyway, the event will trigger again very soon. In other @@ -736,9 +736,9 @@ can also get to them with the buffer list commands, like ":bnext". Rearrange the screen to open one window for each argument. All other windows are closed. When a count is given, this is the maximum number of windows to open. - With the |:tab| modifier open a tab page for each argument. + With the |:tab| modifier open a tabpage for each argument. When there are more arguments than 'tabpagemax' further ones - become split windows in the last tab page. + become split windows in the last tabpage. When the 'hidden' option is set, all buffers in closed windows become hidden. When 'hidden' is not set, and the 'autowrite' option is set, @@ -800,7 +800,7 @@ can also get to them with the buffer list commands, like ":bnext". The purpose of this command is that it can be used from a program that wants Vim to edit another file, e.g., a debugger. When using the |:tab| modifier each argument is opened in a - tab page. The last window is used if it's empty. + tabpage. The last window is used if it's empty. Also see |++opt| and |+cmd|. ============================================================================== @@ -815,7 +815,7 @@ can also get to them with the buffer list commands, like ":bnext". CTRL-W w :{cmd} etc. -< This only operates in the current tab page. +< This only operates in the current tabpage. When an error is detected on one window, further windows will not be visited. The last window (or where an error occurred) becomes @@ -873,14 +873,14 @@ the buffer. The result is that all buffers will use the 'encoding' encoding :sta[g][!] [tagname] Does ":tag[!] [tagname]" and splits the window for the found tag. Refer to 'switchbuf' to jump to a tag in a vertically - split window or a new tab page. See also |:tag|. + split window or a new tabpage. See also |:tag|. CTRL-W ] *CTRL-W_]* *CTRL-W_CTRL-]* CTRL-W CTRL-] Split current window in two. Use identifier under cursor as a tag and jump to it in the new upper window. In Visual mode uses the Visually selected text as a tag. Make new window N high. Refer to 'switchbuf' to jump to a tag - in a vertically split window or a new tab page. + in a vertically split window or a new tabpage. *CTRL-W_g]* CTRL-W g ] Split current window in two. Use identifier under cursor as a @@ -911,21 +911,21 @@ CTRL-W F *CTRL-W_F* details on how the line number is obtained. CTRL-W gf *CTRL-W_gf* - Open a new tab page and edit the file name under the cursor. - Like "tab split" and "gf", but the new tab page isn't created + Open a new tabpage and edit the file name under the cursor. + Like "tab split" and "gf", but the new tabpage isn't created if the file does not exist. CTRL-W gF *CTRL-W_gF* - Open a new tab page and edit the file name under the cursor + Open a new tabpage and edit the file name under the cursor and jump to the line number following the file name. Like - "tab split" and "gF", but the new tab page isn't created if + "tab split" and "gF", but the new tabpage isn't created if the file does not exist. CTRL-W gt *CTRL-W_gt* - Go to next tab page, same as `gt`. + Go to next tabpage, same as `gt`. CTRL-W gT *CTRL-W_gT* - Go to previous tab page, same as `gT`. + Go to previous tabpage, same as `gT`. Also see |CTRL-W_CTRL-I|: open window for an included file that includes the keyword under the cursor. @@ -937,7 +937,7 @@ The preview window is a special window to show (preview) another file. It is normally a small window used to show an include file or definition of a function. -There can be only one preview window (per tab page). It is created with one +There can be only one preview window (per tabpage). It is created with one of the commands below. The 'previewheight' option can be set to specify the height of the preview window when it's opened. The 'previewwindow' option is set in the preview window to be able to recognize it. The 'winfixheight' diff --git a/runtime/lua/vim/_meta/vimfn.gen.lua b/runtime/lua/vim/_meta/vimfn.gen.lua index 5f616872d4..1f381a7ac8 100644 --- a/runtime/lua/vim/_meta/vimfn.gen.lua +++ b/runtime/lua/vim/_meta/vimfn.gen.lua @@ -154,7 +154,7 @@ function vim.fn.argidx() end --- Returns -1 if the arguments are invalid. --- --- Without arguments use the current window. ---- With {winnr} only use this window in the current tab page. +--- With {winnr} only use this window in the current tabpage. --- With {winnr} and {tabnr} use the window in the specified tab --- page. --- {winnr} can be the window number or the |window-ID|. @@ -670,7 +670,7 @@ function vim.fn.bufnr(buf, create) end --- --- echo "A window containing buffer 1 is " .. (bufwinid(1)) --- < ---- Only deals with the current tab page. See |win_findbuf()| for +--- Only deals with the current tabpage. See |win_findbuf()| for --- finding more. --- --- @param buf any @@ -950,14 +950,14 @@ function vim.fn.charidx(string, idx, countcc, utf16) end --- changed to the scope of the current directory: --- - If the window local directory (|:lcd|) is set, it --- changes the current working directory for that scope. ---- - Otherwise, if the tab page local directory (|:tcd|) is +--- - Otherwise, if the tabpage local directory (|:tcd|) is --- set, it changes the current directory for that scope. --- - Otherwise, changes the global directory for that scope. --- --- If {scope} is present, changes the current working directory --- for the specified scope: --- "window" Changes the window local directory. |:lcd| ---- "tabpage" Changes the tab page local directory. |:tcd| +--- "tabpage" Changes the tabpage local directory. |:tcd| --- "global" Changes the global directory. |:cd| --- --- {dir} must be a String. @@ -3454,7 +3454,7 @@ function vim.fn.getftype(fname) end --- Returns the |jumplist| for the specified window. --- --- Without arguments use the current window. ---- With {winnr} only use this window in the current tab page. +--- With {winnr} only use this window in the current tabpage. --- {winnr} can also be a |window-ID|. --- With {winnr} and {tabnr} use the window in the specified tab --- page. If {winnr} or {tabnr} is invalid, an empty list is @@ -4056,16 +4056,16 @@ function vim.fn.getscriptinfo(opts) end function vim.fn.getstacktrace() end --- If {tabnr} is not specified, then information about all the ---- tab pages is returned as a |List|. Each List item is a ---- |Dictionary|. Otherwise, {tabnr} specifies the tab page +--- tabpages is returned as a |List|. Each List item is a +--- |Dictionary|. Otherwise, {tabnr} specifies the tabpage --- number and information about that one is returned. If the tab --- page does not exist an empty List is returned. --- --- Each List item is a |Dictionary| with the following entries: ---- tabnr tab page number. +--- tabnr |tabpage-number| --- variables a reference to the dictionary with --- tabpage-local variables ---- windows List of |window-ID|s in the tab page. +--- windows List of |window-ID|s in the tabpage. --- --- @param tabnr? integer --- @return any @@ -4073,7 +4073,7 @@ function vim.fn.gettabinfo(tabnr) end --- Lua: Prefer |nvim_tabpage_get_var()| or |vim.t|. --- ---- Get the value of a tab-local variable {varname} in tab page +--- Get the value of a tab-local variable {varname} in tabpage --- {tabnr}. |t:var| --- Tabs are numbered starting with one. --- The {varname} argument is a string. When {varname} is empty a @@ -4091,7 +4091,7 @@ function vim.fn.gettabvar(tabnr, varname, def) end --- Lua: Prefer |nvim_win_get_var()| or |vim.w| after resolving {tabnr} and {winnr} to a winid; option names use |nvim_get_option_value()| or |vim.wo|. --- --- Get the value of window-local variable {varname} in window ---- {winnr} in tab page {tabnr}. +--- {winnr} in tabpage {tabnr}. --- The {varname} argument is a string. When {varname} is empty a --- dictionary with all window-local variables is returned. --- When {varname} is equal to "&" get the values of all @@ -4175,7 +4175,7 @@ function vim.fn.gettext(text) end --- exist the result is an empty list. --- --- Without {winid} information about all the windows in all the ---- tab pages is returned. +--- tabpages is returned. --- --- Each List item is a |Dictionary| with the following entries: --- botline last complete displayed buffer line @@ -4186,7 +4186,7 @@ function vim.fn.gettext(text) end --- loclist 1 if showing a location list --- quickfix 1 if quickfix or location list window --- status_height status lines height (0 or 1) ---- tabnr tab page number +--- tabnr |tabpage-number| --- terminal 1 if a terminal window --- textoff number of columns occupied by any --- 'foldcolumn', 'signcolumn' and line @@ -8889,7 +8889,7 @@ function vim.fn.setreg(regname, value, options) end --- Lua: Prefer |nvim_tabpage_set_var()| or |vim.t|. --- ---- Set tab-local variable {varname} to {val} in tab page {tabnr}. +--- Set tab-local variable {varname} to {val} in tabpage {tabnr}. --- |t:var| --- The {varname} argument is a string. --- Note that the variable name without "t:" must be used. @@ -8967,7 +8967,7 @@ function vim.fn.settagstack(nr, dict, action) end --- Lua: Prefer |nvim_win_set_var()| or |vim.w| after resolving {nr} to a winid; option names use |nvim_set_option_value()|. --- ---- Like |settabwinvar()| for the current tab page. +--- Like |settabwinvar()| for the current tabpage. --- Examples: >vim --- call setwinvar(1, "&list", 0) --- call setwinvar(2, "myvar", "foobar") @@ -10633,9 +10633,9 @@ function vim.fn.systemlist(cmd, input, keepempty) end --- Lua: Prefer |nvim_tabpage_list_wins()| with |nvim_win_get_buf()|; invalid tabpages error instead of returning 0. --- --- Returns a |List| of buffer numbers, one for each window in ---- the specified tab page. ---- {arg} specifies the number of the tab page to be used. When ---- omitted the current tab page is used. +--- the specified tabpage. +--- {arg} specifies the number of the tabpage to be used. When +--- omitted the current tabpage is used. --- When {arg} is invalid the number zero is returned. --- To get a list of all buffers in all tabs use this: >vim --- let buflist = [] @@ -10650,15 +10650,12 @@ function vim.fn.tabpagebuflist(arg) end --- Lua: Prefer |nvim_tabpage_get_number()| with |nvim_get_current_tabpage()| for the current tab, or `#vim.api.nvim_list_tabpages()` for "$"; "#" differs. --- ---- Returns the number of the current tab page. The first tab ---- page has number 1. +--- Returns the current |tabpage-number|. --- --- The optional argument {arg} supports the following values: ---- $ the number of the last tab page (the tab page ---- count). ---- # the number of the last accessed tab page ---- (where |g| goes to). If there is no ---- previous tab page, 0 is returned. +--- $ the last |tabpage-number| (the tabpage count). +--- # the last-accessed |tabpage-number| (where |g| +--- goes to), or 0 if there is no previous tabpage. --- The number can be used with the |:tab| command. --- --- Returns zero on error. @@ -10669,16 +10666,16 @@ function vim.fn.tabpagenr(arg) end --- Lua: Prefer |nvim_win_get_number()| with |nvim_tabpage_get_win()| for the current window, or the length of |nvim_tabpage_list_wins()| for "$"; "#" and invalid-tab behavior differ. --- ---- Like |winnr()| but for tab page {tabarg}. ---- {tabarg} specifies the number of tab page to be used. +--- Like |winnr()| but for tabpage {tabarg}. +--- {tabarg} specifies the |tabpage-number| to be used. --- {arg} is used like with |winnr()|: --- - When omitted the current window number is returned. This is ---- the window which will be used when going to this tab page. +--- the window which will be used when going to this tabpage. --- - When "$" the number of windows is returned. --- - When "#" the previous window nr is returned. --- Useful examples: >vim ---- tabpagewinnr(1) " current window of tab page 1 ---- tabpagewinnr(4, '$') " number of windows in tab page 4 +--- tabpagewinnr(1) " current window of tabpage 1 +--- tabpagewinnr(4, '$') " number of windows in tabpage 4 --- vim ---- " Only one window in the tab page +--- " Only one window in the tabpage --- echo winlayout() --- < > --- ['leaf', 1000] @@ -11528,7 +11525,7 @@ function vim.fn.winheight(nr) end --- < > --- ['col', [['leaf', 1000], ['leaf', 1001]]] --- < >vim ---- " The second tab page, with three horizontally split +--- " The second tabpage, with three horizontally split --- " windows, with two vertically split windows in the --- " middle window --- echo winlayout(2) @@ -11561,7 +11558,7 @@ function vim.fn.winline() end --- count). --- # the number of the last accessed window (where --- |CTRL-W_p| goes to). If there is no previous ---- window or it is in another tab page 0 is +--- window or it is in another tabpage, 0 is --- returned. May refer to the current window in --- some cases (e.g. when evaluating 'statusline' --- expressions). @@ -11589,7 +11586,7 @@ function vim.fn.winnr(arg) end --- Returns a sequence of |:resize| commands that should restore --- the current window sizes. Only works properly when no windows ---- are opened or closed and the current window and tab page is +--- are opened or closed and the current window and tabpage is --- unchanged. --- Example: >vim --- let cmd = winrestcmd() diff --git a/src/nvim/eval.lua b/src/nvim/eval.lua index 5de63e7718..4361f8ab0f 100644 --- a/src/nvim/eval.lua +++ b/src/nvim/eval.lua @@ -227,7 +227,7 @@ M.funcs = { Returns -1 if the arguments are invalid. Without arguments use the current window. - With {winnr} only use this window in the current tab page. + With {winnr} only use this window in the current tabpage. With {winnr} and {tabnr} use the window in the specified tab page. {winnr} can be the window number or the |window-ID|. @@ -898,7 +898,7 @@ M.funcs = { echo "A window containing buffer 1 is " .. (bufwinid(1)) < - Only deals with the current tab page. See |win_findbuf()| for + Only deals with the current tabpage. See |win_findbuf()| for finding more. ]=], @@ -1254,14 +1254,14 @@ M.funcs = { changed to the scope of the current directory: - If the window local directory (|:lcd|) is set, it changes the current working directory for that scope. - - Otherwise, if the tab page local directory (|:tcd|) is + - Otherwise, if the tabpage local directory (|:tcd|) is set, it changes the current directory for that scope. - Otherwise, changes the global directory for that scope. If {scope} is present, changes the current working directory for the specified scope: "window" Changes the window local directory. |:lcd| - "tabpage" Changes the tab page local directory. |:tcd| + "tabpage" Changes the tabpage local directory. |:tcd| "global" Changes the global directory. |:cd| {dir} must be a String. @@ -4284,7 +4284,7 @@ M.funcs = { Returns the |jumplist| for the specified window. Without arguments use the current window. - With {winnr} only use this window in the current tab page. + With {winnr} only use this window in the current tabpage. {winnr} can also be a |window-ID|. With {winnr} and {tabnr} use the window in the specified tab page. If {winnr} or {tabnr} is invalid, an empty list is @@ -4967,16 +4967,16 @@ M.funcs = { base = 1, desc = [=[ If {tabnr} is not specified, then information about all the - tab pages is returned as a |List|. Each List item is a - |Dictionary|. Otherwise, {tabnr} specifies the tab page + tabpages is returned as a |List|. Each List item is a + |Dictionary|. Otherwise, {tabnr} specifies the tabpage number and information about that one is returned. If the tab page does not exist an empty List is returned. Each List item is a |Dictionary| with the following entries: - tabnr tab page number. + tabnr |tabpage-number| variables a reference to the dictionary with tabpage-local variables - windows List of |window-ID|s in the tab page. + windows List of |window-ID|s in the tabpage. ]=], name = 'gettabinfo', @@ -4987,7 +4987,7 @@ M.funcs = { args = { 2, 3 }, base = 1, desc = [=[ - Get the value of a tab-local variable {varname} in tab page + Get the value of a tab-local variable {varname} in tabpage {tabnr}. |t:var| Tabs are numbered starting with one. The {varname} argument is a string. When {varname} is empty a @@ -5007,7 +5007,7 @@ M.funcs = { base = 1, desc = [=[ Get the value of window-local variable {varname} in window - {winnr} in tab page {tabnr}. + {winnr} in tabpage {tabnr}. The {varname} argument is a string. When {varname} is empty a dictionary with all window-local variables is returned. When {varname} is equal to "&" get the values of all @@ -5110,7 +5110,7 @@ M.funcs = { exist the result is an empty list. Without {winid} information about all the windows in all the - tab pages is returned. + tabpages is returned. Each List item is a |Dictionary| with the following entries: botline last complete displayed buffer line @@ -5121,7 +5121,7 @@ M.funcs = { loclist 1 if showing a location list quickfix 1 if quickfix or location list window status_height status lines height (0 or 1) - tabnr tab page number + tabnr |tabpage-number| terminal 1 if a terminal window textoff number of columns occupied by any 'foldcolumn', 'signcolumn' and line @@ -10655,7 +10655,7 @@ M.funcs = { args = 3, base = 3, desc = [=[ - Set tab-local variable {varname} to {val} in tab page {tabnr}. + Set tab-local variable {varname} to {val} in tabpage {tabnr}. |t:var| The {varname} argument is a string. Note that the variable name without "t:" must be used. @@ -10745,7 +10745,7 @@ M.funcs = { args = 3, base = 3, desc = [=[ - Like |settabwinvar()| for the current tab page. + Like |settabwinvar()| for the current tabpage. Examples: >vim call setwinvar(1, "&list", 0) call setwinvar(2, "myvar", "foobar") @@ -12737,9 +12737,9 @@ M.funcs = { base = 1, desc = [=[ Returns a |List| of buffer numbers, one for each window in - the specified tab page. - {arg} specifies the number of the tab page to be used. When - omitted the current tab page is used. + the specified tabpage. + {arg} specifies the number of the tabpage to be used. When + omitted the current tabpage is used. When {arg} is invalid the number zero is returned. To get a list of all buffers in all tabs use this: >vim let buflist = [] @@ -12759,15 +12759,12 @@ M.funcs = { tabpagenr = { args = { 0, 1 }, desc = [=[ - Returns the number of the current tab page. The first tab - page has number 1. + Returns the current |tabpage-number|. The optional argument {arg} supports the following values: - $ the number of the last tab page (the tab page - count). - # the number of the last accessed tab page - (where |g| goes to). If there is no - previous tab page, 0 is returned. + $ the last |tabpage-number| (the tabpage count). + # the last-accessed |tabpage-number| (where |g| + goes to), or 0 if there is no previous tabpage. The number can be used with the |:tab| command. Returns zero on error. @@ -12784,16 +12781,16 @@ M.funcs = { args = { 1, 2 }, base = 1, desc = [=[ - Like |winnr()| but for tab page {tabarg}. - {tabarg} specifies the number of tab page to be used. + Like |winnr()| but for tabpage {tabarg}. + {tabarg} specifies the |tabpage-number| to be used. {arg} is used like with |winnr()|: - When omitted the current window number is returned. This is - the window which will be used when going to this tab page. + the window which will be used when going to this tabpage. - When "$" the number of windows is returned. - When "#" the previous window nr is returned. Useful examples: >vim - tabpagewinnr(1) " current window of tab page 1 - tabpagewinnr(4, '$') " number of windows in tab page 4 + tabpagewinnr(1) " current window of tabpage 1 + tabpagewinnr(4, '$') " number of windows in tabpage 4 vim - " Only one window in the tab page + " Only one window in the tabpage echo winlayout() < > ['leaf', 1000] @@ -13869,7 +13866,7 @@ M.funcs = { < > ['col', [['leaf', 1000], ['leaf', 1001]]] < >vim - " The second tab page, with three horizontally split + " The second tabpage, with three horizontally split " windows, with two vertically split windows in the " middle window echo winlayout(2) @@ -13909,7 +13906,7 @@ M.funcs = { count). # the number of the last accessed window (where |CTRL-W_p| goes to). If there is no previous - window or it is in another tab page 0 is + window or it is in another tabpage, 0 is returned. May refer to the current window in some cases (e.g. when evaluating 'statusline' expressions). @@ -13943,7 +13940,7 @@ M.funcs = { desc = [=[ Returns a sequence of |:resize| commands that should restore the current window sizes. Only works properly when no windows - are opened or closed and the current window and tab page is + are opened or closed and the current window and tabpage is unchanged. Example: >vim let cmd = winrestcmd()