docs: Section headings.

Author: tony

doc/about_tmux.rst

@@ -1,8 +1,8 @@
 .. _about_tmux:
 
-===============
+###############
 The Tao of tmux
-===============
+###############
 
 .. figure:: _static/tao-tmux-screenshot.png
     :scale: 60%
@@ -29,6 +29,7 @@ the text dimension. Inside tmux you can:
 - have multiple windows (window) in the workspace (session)
 - switch between multiple workspaces, like virtual desktops
 
+=============
 Thinking Tmux
 =============
 
@@ -212,6 +213,7 @@ Multitasking. Preserving the thinking you have.
 
 .. _"train of thought": http://en.wikipedia.org/wiki/Train_of_thought
 
+===============
 Installing tmux
 ===============
 
@@ -238,6 +240,7 @@ If **compiling from source**, the dependencies are `libevent`_ and
 .. _Fink: http://fink.thetis.ig42.org/
 .. _Homebrew: http://www.brew.sh
 
+==========
 Using tmux
 ==========
 
@@ -497,15 +500,16 @@ Short cut             Action
 ``"``                 Split the current pane into two, top and bottom.
 ===================   ====================================================
 
-Tmux configuration
-==================
+================
+Configuring Tmux
+================
 
 Tmux can be configured via a configuration at ``~/.tmux.conf``.
 
 Depending on your tmux version, there is different options available.
 
-Vi copypaste
-------------
+Vi-style copy and paste
+-----------------------
 
 .. code-block:: ini
 
@@ -562,6 +566,7 @@ Examples
   uptime stats.
 - Add yours, edit this page on github.
 
+=========
 Reference
 =========
 
@@ -643,8 +648,9 @@ Source: tmux manpage [1]_.
    
        $ nroff -mdoc tmux.1|less
 
+=======
 License
--------
+=======
 
 This page is licensed `Creative Commons BY-NC-ND 3.0 US`_.
 

doc/cli.rst

@@ -7,7 +7,7 @@ Command Line Interface
 .. _bash_completion:
 
 Bash completion
-"""""""""""""""
+---------------
 
 For bash, ``.bashrc``:
 
@@ -33,7 +33,7 @@ For zsh, ``.zshrc``:
 .. _cli_freeze:
 
 Freeze sessions
-"""""""""""""""
+---------------
 
 .. argparse::
     :module: tmuxp.cli
@@ -49,7 +49,7 @@ Freeze sessions
 .. _cli_load:
 
 Load session
-""""""""""""
+------------
 
 .. argparse::
     :module: tmuxp.cli
@@ -76,12 +76,12 @@ Load session
 .. _cli_import:
 
 Import
-""""""
+------
 
 .. _import_teamocil:
 
 From teamocil
-'''''''''''''
+~~~~~~~~~~~~~
 
 .. argparse::
     :module: tmuxp.cli
@@ -92,7 +92,7 @@ From teamocil
 .. _import_tmuxinator:
 
 From tmuxinator
-'''''''''''''''
+~~~~~~~~~~~~~~~
 
 .. argparse::
     :module: tmuxp.cli
@@ -103,7 +103,7 @@ From tmuxinator
 .. _convert_config:
 
 Convert between YAML and JSON
-"""""""""""""""""""""""""""""
+-----------------------------
 
 .. argparse::
     :module: tmuxp.cli
@@ -116,7 +116,7 @@ Convert between YAML and JSON
     ``.json`` to  ``.yaml``.
 
 Other commands
-""""""""""""""
+--------------
 
 .. argparse::
     :module: tmuxp.cli

doc/developing.rst

@@ -74,7 +74,7 @@ If you found a problem or are trying to write a test, you can file an
 .. _test_specific_tests:
 
 Test runner options
-"""""""""""""""""""
+~~~~~~~~~~~~~~~~~~~
 
 .. note::
 
@@ -109,7 +109,7 @@ Multiple can be separated by spaces:
 .. _test_builder_visually:
 
 Visual testing
-''''''''''''''
+~~~~~~~~~~~~~~
 
 You can watch tmux testsuite build sessions visually by keeping a client
 open in a separate terminal.
@@ -128,34 +128,6 @@ Create two terminals:
 Terminal 1 should have flickered and built the session before your eyes.
 tmuxp hides this building from normal users.
 
-Verbosity and logging
-'''''''''''''''''''''
-
-``./run-tests.py`` supports two options, these are *optional* flags that
-may be added to for :ref:`test_specific_tests` and
-:ref:`test_builder_visually`.
-
-1.  log level: ``-l`` aka ``--log-level``, with the options of ``debug``,
-    ``info``, ``warn``, ``error``, ``fatal``. Default is ``INFO``.
-
-    .. code-block:: bash
-
-        $ ./run-tests.py --log-level debug
-
-    short form:
-
-    .. code-block:: bash
-
-        $ ./run-tests.py -l debug
-
-2.  unit test verbosity:
-
-    ``--verbosity`` may be set to ``0``, ``1`` and ``2``.  Default: ``2``.
-
-    .. code-block:: bash
-
-        $ ./run-tests.py --verbosity 0
-
 Run tests on save
 -----------------
 
@@ -188,7 +160,7 @@ To run test where :ref:`test_builder_visually` you may:
 .. _tmuxp developer config:
 
 tmuxp developer config
-""""""""""""""""""""""
+----------------------
 
 .. image:: _static/tmuxp-dev-screenshot.png
     :scale: 100%
@@ -209,7 +181,7 @@ this will load the ``.tmuxp.yaml`` in the root of the project.
 .. _travis:
 
 Travis CI
-"""""""""
+~~~~~~~~~
 
 tmuxp uses `travis-ci`_ for continuous integration / automatic unit
 testing.

doc/examples.rst

@@ -27,13 +27,13 @@ punctual.
         +-------------------+
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/shorthands.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/shorthands.json
     :language: json
@@ -47,13 +47,13 @@ No need to repeat ``pwd`` or a dummy command. A ``null``, ``'blank'``,
 Note ``''`` counts as an empty carriage return.
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/blank-panes.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/blank-panes.json
     :language: json
@@ -76,13 +76,13 @@ JSON
         +-----------------+
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/2-pane-vertical.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/2-pane-vertical.json
     :language: json
@@ -105,13 +105,13 @@ JSON
         +--------+--------+
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/3-pane.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/3-pane.json
     :language: json
@@ -134,13 +134,13 @@ JSON
         +--------+--------+
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/4-pane.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/4-pane.json
     :language: json
@@ -151,13 +151,13 @@ Start Directory
 Equivalent to ``tmux new-window -c <start-directory>``.
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/start-directory.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/start-directory.json
     :language: json
@@ -169,13 +169,13 @@ tmuxp allows ``focus: true`` for assuring windows and panes are attached /
 selected upon loading.
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/focus-window-and-panes.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/focus-window-and-panes.json
     :language: json
@@ -187,13 +187,13 @@ You can specify a window's index using the ``window_index`` property. Windows
 without ``window_index`` will use the lowest available window index.
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/window-index.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/window-index.json
     :language: json
@@ -202,13 +202,13 @@ Automatic Rename
 ----------------
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/automatic-rename.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/automatic-rename.json
     :language: json
@@ -217,13 +217,13 @@ Main pane height
 ----------------
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../examples/main-pane-height.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../examples/main-pane-height.json
     :language: json
@@ -235,13 +235,13 @@ Super-advanced dev environment
     :ref:`tmuxp developer config` in the :ref:`developing` section.
 
 YAML
-""""
+~~~~
 
 .. literalinclude:: ../.tmuxp.yaml
     :language: yaml
 
 JSON
-""""
+~~~~
 
 .. literalinclude:: ../.tmuxp.json
     :language: json