docs: add some info about fancy tab bars

docs/changelog.md

@@ -18,7 +18,7 @@ As features stabilize some brief notes about them will accumulate here.
 
 ### 20220101-133340-7edc5b5a
 
-* Fancy Tab Bars are now the default. The default tab bar colors have changed to accommodate the new more native look.  You can turn them off by setting `use_fancy_tab_bar = false`.
+* Fancy Tab Bars are now the default. The default tab bar colors have changed to accommodate the new more native look.  You can turn them off by setting [use_fancy_tab_bar = false](config/lua/config/use_fancy_tab_bar.md).
 * Support for the [Kitty Image Protocol](https://sw.kovidgoyal.net/kitty/graphics-protocol/) is now enabled by default.  Most of the protocol is supported; animation support is not yet implemented. Try the amazing [notcurses](https://notcurses.com/) if you want to see what modern terminal graphics can do! [#986](https://github.com/wez/wezterm/issues/986)
 * unix domains now support an optional `proxy_command` to use in place of a direct unix socket connection. [Read more about multiplexing unix domains](multiplexing.html#unix-domains)
 * [ScrollToTop](config/lua/keyassignment/ScrollToTop.md) and [ScrollToBottom](config/lua/keyassignment/ScrollToBottom.md) key assignments [#1360](https://github.com/wez/wezterm/issues/1360)

docs/config/appearance.md

@@ -155,21 +155,65 @@ $ for scheme in *.sh ; do ; echo $scheme ; \
 
 ### Tab Bar Appearance & Colors
 
+The tab bar has two modes; the default is a native looking style, but
+is is also possible to enable a retro aesthetic.  The configuration
+for the two styles is broadly similar, but there are a few different
+details.
+
+* [use_fancy_tab_bar](lua/config/use_fancy_tab_bar.md) option controls
+  which tab bar style is used.
+* [enable_tab_bar](lua/config/enable_tab_bar.md) option control
+  whether the tab bar is used at all.
+* [hide_tab_bar_if_only_one_tab](lua/config/hide_tab_bar_if_only_one_tab.md) option
+  causes the tab bar to be hidden when there is only a single tab.
+* [tab_bar_at_bottom](lua/config/tab_bar_at_bottom.md) places the tab
+  bar at the bottom of the window instead of the top
+
+#### Native (Fancy) Tab Bar appearance
+
+The following options affect the fancy tab bar:
+
+```lua
+local wezterm = require 'wezterm'
+
+return {
+  window_frame = {
+    -- The font used in the tab bar.
+    -- Roboto Bold is the default; this font is bundled
+    -- with wezterm.
+    -- Whatever font is selected here, it will have the
+    -- main font setting appended to it to pick up any
+    -- fallback fonts you may have used there.
+    font = wezterm.font({family="Roboto", weight="Bold"}),
+
+    -- The size of the font in the tab bar.
+    -- Default to 10. on Windows but 12.0 on other systems
+    font_size = 12.0,
+
+    -- The overall background color of the tab bar when
+    -- the window is focused
+    active_titlebar_bg = "#333333",
+
+    -- The overall background color of the tab bar when
+    -- the window is not focused
+    inactive_titlebar_bg = "#333333",
+  },
+}
+```
+
+In addition, the tab bar colors mentioned below also apply
+to the items displayed in the tab bar.
+
+#### Retro Tab Bar appearance
+
 The following options control the appearance of the tab bar:
 
 ```lua
 return {
-  -- set to false to disable the tab bar completely
-  enable_tab_bar = true,
-
-  -- set to true to hide the tab bar when there is only
-  -- a single tab in the window
-  hide_tab_bar_if_only_one_tab = false,
-
   colors = {
     tab_bar = {
-
       -- The color of the strip that goes along the top of the window
+      -- (does not apply when fancy tab bar is in use)
       background = "#0b0022",
 
       -- The active tab is the one that has focus in the window
@@ -242,7 +286,6 @@ return {
 }
 ```
 
-
 ### Window Padding
 
 You may add padding around the edges of the terminal area.

docs/config/lua/config/enable_tab_bar.md

@@ -0,0 +1,8 @@
+# `enable_tab_bar = true`
+
+Controls whether the tab bar is enabled.
+Set to `false` to disable it.
+
+See also [hide_tab_bar_if_only_one_tab](hide_tab_bar_if_only_one_tab.md)
+
+

docs/config/lua/config/hide_tab_bar_if_only_one_tab.md

@@ -0,0 +1,7 @@
+# `hide_tab_bar_if_only_one_tab = false`
+
+If set to true, when there is only a single tab, the tab bar is
+hidden from the display.  If a second tab is created, the tab
+will be shown.
+
+See also [enable_tab_bar](enable_tab_bar.md)

docs/config/lua/config/use_fancy_tab_bar.md

@@ -0,0 +1,10 @@
+# `use_fancy_tab_bar = true`
+
+*Since: 20220101-133340-7edc5b5a*
+
+When set to `true` (the default), the tab bar is rendered in
+a native style with proportional fonts.
+
+When set to `false`, the tab bar is rendered using a retro
+aesthetic using the main terminal font.
+

docs/install/linux.markdown

@@ -68,7 +68,6 @@ on most Linux systems.
 
 |Distro      | Stable           | Nightly             |
 |------------|------------------|---------------------|
-|CentOS7     |[{{ centos7_rpm_stable_asset }}]({{ centos7_rpm_stable }}) |[{{ centos7_rpm_nightly_asset }}]({{ centos7_rpm_nightly }})|
 |CentOS8     |[{{ centos8_rpm_stable_asset }}]({{ centos8_rpm_stable }}) |[{{ centos8_rpm_nightly_asset }}]({{ centos8_rpm_nightly }})|
 |Fedora33    |[{{ fedora33_rpm_stable_asset }}]({{ fedora33_rpm_stable }}) |[{{ fedora33_rpm_nightly_asset }}]({{ fedora33_rpm_nightly }})|
 |Fedora34    |[{{ fedora34_rpm_stable_asset }}]({{ fedora34_rpm_stable }}) |[{{ fedora34_rpm_nightly_asset }}]({{ fedora34_rpm_nightly }})|