Mercurial > vim

comparison runtime/doc/tabpage.txt @ 1118:2b8ff9e3c520

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
updated for version 7.1a
author vimboss
date Sat, 05 May 2007 17:10:09 +0000
parents 4bac29d27e2f
children 2de44d8f2cf1
comparison
equal deleted inserted replaced
1117:a13e4b242735 1118:2b8ff9e3c520
1 *tabpage.txt* For Vim version 7.0. Last change: 2006 May 02 1 *tabpage.txt* For Vim version 7.1a. Last change: 2007 Mar 11
2 2
3 3
4 VIM REFERENCE MANUAL by Bram Moolenaar 4 VIM REFERENCE MANUAL by Bram Moolenaar
5 5
6 6
72 {not available when the |+file_in_path| feature was disabled 72 {not available when the |+file_in_path| feature was disabled
73 at compile time} 73 at compile time}
74 74
75 :[count]tab {cmd} *:tab* 75 :[count]tab {cmd} *:tab*
76 Execute {cmd} and when it opens a new window open a new tab 76 Execute {cmd} and when it opens a new window open a new tab
77 page instead. Doesn't work for |:diffsplit| or |:diffpatch|. 77 page instead. Doesn't work for |:diffsplit|, |:diffpatch|,
78 |:execute| and |:normal|.
78 When [count] is omitted the tab page appears after the current 79 When [count] is omitted the tab page appears after the current
79 one. When [count] is specified the new tab page comes after 80 one. When [count] is specified the new tab page comes after
80 tab page [count]. Use ":0tab cmd" to get the new tab page as 81 tab page [count]. Use ":0tab cmd" to get the new tab page as
81 the first one. Examples: > 82 the first one. Examples: >
82 :tab split " opens current buffer in new tab page 83 :tab split " opens current buffer in new tab page
127 Using the mouse: If the tab page line is displayed you can click in a tab page 128 Using the mouse: If the tab page line is displayed you can click in a tab page
128 label to switch to that tab page. Click where there is no label to go to the 129 label to switch to that tab page. Click where there is no label to go to the
129 next tab page. |'tabline'| 130 next tab page. |'tabline'|
130 131
131 :tabn[ext] *:tabn* *:tabnext* *gt* 132 :tabn[ext] *:tabn* *:tabnext* *gt*
132 gt *CTRL-<PageDown>* *<C-PageDown>* 133 <C-PageDown> *CTRL-<PageDown>* *<C-PageDown>*
133 <C-PageDown> *i_CTRL-<PageDown>* *i_<C-PageDown>* 134 gt *i_CTRL-<PageDown>* *i_<C-PageDown>*
134 Go to the next tab page. Wraps around from the last to the 135 Go to the next tab page. Wraps around from the last to the
135 first one. 136 first one.
136 137
137 :tabn[ext] {count} *CTRL-<PageUp>* *<C-PageUp>* 138 :tabn[ext] {count}
138 {count}gt *i_CTRL-<PageUp>* *i_<C-PageUp>* 139 {count}<C-PageDown>
139 <C-PageUp> Go to tab page {count}. The first tab page has number one. 140 {count}gt Go to tab page {count}. The first tab page has number one.
140 141
141 142
142 :tabp[revious] *:tabp* *:tabprevious* *gT* 143 :tabp[revious] *:tabp* *:tabprevious* *gT* *:tabN*
143 :tabN[ext] *:tabN* *:tabNext* 144 :tabN[ext] *:tabNext* *CTRL-<PageUp>*
145 <C-PageUp> *<C-PageUp>* *i_CTRL-<PageUp>* *i_<C-PageUp>*
144 gT Go to the previous tab page. Wraps around from the first one 146 gT Go to the previous tab page. Wraps around from the first one
145 to the last one. 147 to the last one.
146 148
147 :tabp[revious] {count} 149 :tabp[revious] {count}
148 :tabN[ext] {count} 150 :tabN[ext] {count}
151 {count}<C-PageUp>
149 {count}gT Go {count} tab pages back. Wraps around from the first one 152 {count}gT Go {count} tab pages back. Wraps around from the first one
150 to the last one. 153 to the last one.
151 154
152 :tabr[ewind] *:tabfir* *:tabfirst* *:tabr* *:tabrewind* 155 :tabr[ewind] *:tabfir* *:tabfirst* *:tabr* *:tabrewind*
153 :tabfir[st] Go to the first tab page. 156 :tabfir[st] Go to the first tab page.
201 Close Close the tab page under the mouse pointer. The 204 Close Close the tab page under the mouse pointer. The
202 current one if there is no label under the mouse 205 current one if there is no label under the mouse
203 pointer. 206 pointer.
204 New Tab Open a tab page, editing an empty buffer. It appears 207 New Tab Open a tab page, editing an empty buffer. It appears
205 to the left of the mouse pointer. 208 to the left of the mouse pointer.
206 Open Tab... Like "New Tab" and additionaly use a file selector to 209 Open Tab... Like "New Tab" and additionally use a file selector to
207 select a file to edit. 210 select a file to edit.
208 211
209 Diff mode works per tab page. You can see the diffs between several files 212 Diff mode works per tab page. You can see the diffs between several files
210 within one tab page. Other tab pages can show differences between other 213 within one tab page. Other tab pages can show differences between other
211 files. 214 files.
245 always. 248 always.
246 249
247 The highlighting of the tab pages line is set with the groups TabLine 250 The highlighting of the tab pages line is set with the groups TabLine
248 TabLineSel and TabLineFill. |hl-TabLine| |hl-TabLineSel| |hl-TabLineFill| 251 TabLineSel and TabLineFill. |hl-TabLine| |hl-TabLineSel| |hl-TabLineFill|
249 252
253 A "+" will be shown for a tab page that has a modified window. The number of
254 windows in a tabpage is also shown. Thus "3+" means three windows and one of
255 them has a modified buffer.
256
250 The 'tabline' option allows you to define your preferred way to tab pages 257 The 'tabline' option allows you to define your preferred way to tab pages
251 labels. This isn't easy, thus an example will be given here. 258 labels. This isn't easy, thus an example will be given here.
252 259
253 For basics see the 'statusline' option. The same items can be used in the 260 For basics see the 'statusline' option. The same items can be used in the
254 'tabline' option. Additionally, the |tabpagebuflist()|, |tabpagenr()| and 261 'tabline' option. Additionally, the |tabpagebuflist()|, |tabpagenr()| and
255 |tabpagewinnr()| functions are useful. 262 |tabpagewinnr()| functions are useful.
256 263
257 Since the number of tab labels will vary, you need to use an expresion for the 264 Since the number of tab labels will vary, you need to use an expression for
258 whole option. Something like: > 265 the whole option. Something like: >
259 :set tabline=%!MyTabLine() 266 :set tabline=%!MyTabLine()
260 267
261 Then define the MyTabLine() function to list all the tab pages labels. A 268 Then define the MyTabLine() function to list all the tab pages labels. A
262 convenient method is to split it in two parts: First go over all the tab 269 convenient method is to split it in two parts: First go over all the tab
263 pages and define labels for them. Then get the label for each tab page. > 270 pages and define labels for them. Then get the label for each tab page. >
298 return bufname(buflist[winnr - 1]) 305 return bufname(buflist[winnr - 1])
299 endfunction 306 endfunction
300 307
301 This is just a simplistic example that results in a tab pages line that 308 This is just a simplistic example that results in a tab pages line that
302 resembles the default, but without adding a + for a modified buffer or 309 resembles the default, but without adding a + for a modified buffer or
303 trunctating the names. You will want to reduce the width of labels in a 310 truncating the names. You will want to reduce the width of labels in a
304 clever way when there is not enough room. Check the 'columns' option for the 311 clever way when there is not enough room. Check the 'columns' option for the
305 space available. 312 space available.
306 313
307 ============================================================================== 314 ==============================================================================
308 5. Setting 'guitablabel' *setting-guitablabel* 315 5. Setting 'guitablabel' *setting-guitablabel*
328 A simple example that puts the tab page number and the buffer name in the 335 A simple example that puts the tab page number and the buffer name in the
329 label: > 336 label: >
330 :set guitablabel=%N\ %f 337 :set guitablabel=%N\ %f
331 338
332 An example that resembles the default 'guitablabel': Show the number of 339 An example that resembles the default 'guitablabel': Show the number of
333 windows in the tab page and a '+' if there is a modifed buffer: > 340 windows in the tab page and a '+' if there is a modified buffer: >
334 341
335 function GuiTabLabel() 342 function GuiTabLabel()
336 let label = '' 343 let label = ''
337 let bufnrlist = tabpagebuflist(v:lnum) 344 let bufnrlist = tabpagebuflist(v:lnum)
338 345