updated for version 7.0206
diff --git a/runtime/doc/usr_08.txt b/runtime/doc/usr_08.txt
index cee90dc..c4212ef 100644
--- a/runtime/doc/usr_08.txt
+++ b/runtime/doc/usr_08.txt
@@ -1,4 +1,4 @@
-*usr_08.txt* For Vim version 7.0aa. Last change: 2005 Apr 01
+*usr_08.txt* For Vim version 7.0aa. Last change: 2006 Feb 24
VIM USER MANUAL - by Bram Moolenaar
@@ -17,6 +17,7 @@
|08.6| Commands for all windows
|08.7| Viewing differences with vimdiff
|08.8| Various
+|08.9| Tab pages
Next chapter: |usr_09.txt| Using the GUI
Previous chapter: |usr_07.txt| Editing more than one file
@@ -504,6 +505,95 @@
:topleft {cmd} at the top or left of the Vim window
:botright {cmd} at the bottom or right of the Vim window
+
+==============================================================================
+*08.9* Tab pages
+
+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.
+
+Assume you are editing "thisfile". To create a new tab page use this command: >
+
+ :tabedit thatfile
+
+This will edit the file "thatfile" in a window that occupies the whole Vim
+window. And you will notice a bar at the top with the two file names:
+
+ +----------------------------------+
+ |_thisfile_| thatfile ____________X|
+ |/* thatfile */ |
+ |that |
+ |that |
+ |~ |
+ |~ |
+ |~ |
+ | |
+ +----------------------------------+
+
+You now have two tab pages. 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
+eachother, with a tab sticking out of each page showing the file name.
+
+Now use the mouse to click on "thisfile" in the top line. The result is
+
+ +----------------------------------+
+ | thisfile |_thatfile_____________X|
+ |/* thisfile */ |
+ |this |
+ |this |
+ |~ |
+ |~ |
+ |~ |
+ | |
+ +----------------------------------+
+
+Thus you can switch between tab pages 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: >
+
+ :tab split
+
+This makes a new tab page with one window that is editing the same buffer as
+the window we were in:
+
+ +-------------------------------------+
+ |_thisfile_| thisfile | _thatfile____X|
+ |/* thisfile */ |
+ |this |
+ |this |
+ |~ |
+ |~ |
+ |~ |
+ | |
+ +-------------------------------------+
+
+You can put ":tab" before any Ex command that opens a window. The window will
+be opened in a new tab page. Another example: >
+
+ :tab help gt
+
+Will show the help text for "gt" in a new tab page.
+
+A few more things you can do with tab pages:
+
+- click with the mouse in the space after the last label
+ The next tab page 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.
+
+- double click with the mouse in the top line
+ A new tab page will be created.
+
+- the "tabonly" command
+ Closes all tab pages except the current one. Unless there are unsaved
+ changes in other tab pages.
+
+For more information about tab pages see |tab-page|.
+
==============================================================================
Next chapter: |usr_09.txt| Using the GUI