From 4c01bce7d482d1f509f89e5b8304564007947a24 Mon Sep 17 00:00:00 2001
From: mitchell <70453897+667e-11@users.noreply.github.com>
Date: Thu, 7 Nov 2013 22:59:13 -0500
Subject: Added support for tabs.

---
 doc/03_UserInterface.md    |   8 ++++++++
 doc/04_WorkingWithFiles.md |  12 ++++--------
 doc/08_Preferences.md      |   4 ++++
 doc/images/splitviews.png  | Bin 127798 -> 124605 bytes
 4 files changed, 16 insertions(+), 8 deletions(-)

(limited to 'doc')

diff --git a/doc/03_UserInterface.md b/doc/03_UserInterface.md
index d51101ef..6f232d37 100644
--- a/doc/03_UserInterface.md
+++ b/doc/03_UserInterface.md
@@ -20,6 +20,14 @@ key bindings.
 [key preferences]: 08_Preferences.html#Key.Bindings
 [complete list]: api/textadept.keys.html#Key.Bindings
 
+## Tab Bar
+
+The tab bar displays all of Textadept's open buffers, although it's only visible
+when two or more buffers are open. While only the GUI version supports tabs,
+Textadept's [buffer browser][] is always available and far more powerful.
+
+[buffer browser]: 04_WorkingWithFiles.html#Buffers
+
 ## Editor View
 
 Most of your time spent with Textadept is in the editor view. The GUI version
diff --git a/doc/04_WorkingWithFiles.md b/doc/04_WorkingWithFiles.md
index 4a941a40..6f61d1da 100644
--- a/doc/04_WorkingWithFiles.md
+++ b/doc/04_WorkingWithFiles.md
@@ -2,14 +2,10 @@
 
 ## Buffers
 
-One of the first things notably absent when opening multiple files in Textadept
-is the lack of a tab bar showing the open files. This design decision allowed
-Textadept to support unlimited split views from the very beginning. Having a
-single tab bar for multiple views causes confusion and having one tab bar per
-view clutters the interface.
-
-Instead of having tabs, Textadept has the buffer browser. Press `Ctrl+B` (`⌘B`
-on Mac OSX | `M-B` or `M-S-B` in curses) to open it.
+Despite the fact that Textadept can display multiple buffers with a tab bar, the
+buffer browser is usually a faster way to switch between buffers or quickly
+assess which files are open. Press `Ctrl+B` (`⌘B` on Mac OSX | `M-B` or `M-S-B`
+in curses) to display this browser.
 
 ![Buffer Browser](images/bufferbrowser.png)
 
diff --git a/doc/08_Preferences.md b/doc/08_Preferences.md
index 36bab575..e4fbe4cf 100644
--- a/doc/08_Preferences.md
+++ b/doc/08_Preferences.md
@@ -37,6 +37,10 @@ your *~/.textadept/init.lua*:
     textadept.editing.TYPEOVER_CHARS = false
     textadept.editing.STRIP_TRAILING_SPACES = false
 
+To always hide the tab bar:
+
+    ui.tabs = false
+
 Now suppose you want to load all of Textadept's default modules except for the
 menu. You cannot do this after-the-fact from *~/.textadept/init.lua*. Instead
 you need Textadept to load your own module rather than the default one. Copy the
diff --git a/doc/images/splitviews.png b/doc/images/splitviews.png
index 9108a995..d9a4060d 100644
Binary files a/doc/images/splitviews.png and b/doc/images/splitviews.png differ
-- 
cgit v1.2.3