about tmux updates

Author: tony

doc/about_tmux.rst

@@ -41,10 +41,9 @@ Text-based window manager
 ------------------- ---------------------- -------------------------------
 Multiplexer         Multi-tasking          Multiple applications
                                            simulataneously.
-Session             Desktop                Applications are visible here
+Sessio              Desktop                Applications are visible here
 Window              Virtual Desktop or     A desktop that stores it own
-                                           applications
-                    screen
+                    applications           screen
 Pane                Application            Performs operations
 =================== ====================== ===============================
 
@@ -153,15 +152,15 @@ sandwich, and re-(attach), all applications are still running!
 .. aafig::
    :textual:
 
-   +--------+--------+                    
-   | $ bash | $ bash |                    
-   |        |        |                    
+   +--------+--------+
+   | $ bash | $ bash |
+   |        |        |
    |        |        |     /------------\ 
    +--------+--------+ --> |   detach   | 
    | $ vim  | $ bash |     | 'Ctrl-b b' |     
    |        |        |     \------------/     
-   |        |        |            |           
-   +--------+--------+            |           
+   |        |        |            |
+   +--------+--------+            |
                /------------------/
                |
                v
@@ -174,20 +173,20 @@ sandwich, and re-(attach), all applications are still running!
    |                       |
    |                       |
    +-----------------------+
-               v
-               |
-               v
-   +-----------------------+                   
-   | $ [screen detached]   |                   
-   | $ tmux attach         |                   
+              v
+              |
+              v
+   +-----------------------+
+   | $ [screen detached]   |
+   | $ tmux attach         |
    |                       |     /------------\
    |                       | --> | attaching  |
    |                       |     \------------/
-   |                       |           |
-   |                       |           |
-   +-----------------------+           |
-                                      /
-            /-------------------------
+   |                       |            |
+   |                       |            |
+   +-----------------------+            |
+                                        /
+            /---------------------------
             |
             v
    +--------+--------+
@@ -214,12 +213,41 @@ Multitasking. Preserving the thinking you have.
 
 .. _"train of thought": http://en.wikipedia.org/wiki/Train_of_thought
 
-First steps with tmux
-=====================
+Installing tmux
+---------------
+
+Tmux is a common package / port on most Linux and BSD systems.
+
+Instead of creating a page for how to install tmux on every distro in the
+world, using google for "How to install tmux on <my distro>" may suit your
+purpose as package names and directions change when distributions release
+a new version.
+
+It's best that you use the latest stable release of tmux available. This
+can been seen on `tmux homepage`_.
+
+**Mac OS X** users may install that latest stable version of tmux through
+`MacPorts`_, `fink`_ or `Homebrew`_ (aka brew).
+
+If **compiling from source**, the dependencies are `libevent`_ and
+`ncurses`_.
+
+.. _tmux homepage: http://tmux.sourceforge.net/
+.. _libevent: http://www.monkey.org/~provos/libevent/
+.. _ncurses: http://invisible-island.net/ncurses/
+.. _MacPorts: http://www.macports.org/
+.. _Fink: http://fink.thetis.ig42.org/
+.. _Homebrew: http://www.brew.sh
 
 Start a new session
 -------------------
 
+.. code-block:: bash
+
+    $ tmux
+
+That's all it takes to launch yourself into a tmux session.
+
 .. tip:: Common pitfall
 
     Running ``$ tmux list-sessions`` or any other command for listing tmux
@@ -233,6 +261,92 @@ Start a new session
           this will rarely happen)
         - tmux has not be launched yet at all.
 
+Tmux hotkeys
+------------
+
+.. note::
+
+    The **prefix** key is a known stumbling block for new tmux users,
+    please pay attention!
+
+    Tmux hot keys have to be pressed in a special way. **Read this
+    carefully**, then try it yourself.
+
+    First, you press the *prefix* key. This is ``C-a`` by default.
+
+    Release. Then pause. For less than second. Then type what's next.
+
+    ``C-b o`` means: Press ``Ctrl`` and ``b`` at the same time. Then
+    press ``o``.
+
+
+**Remember, prefix + short cut!**. ``C`` is ``Ctrl`` key.
+
+===================   ====================================================
+Short cut             Action    
+-------------------   ----------------------------------------------------
+``C-b``               Send the prefix key (C-b) through to the
+                      application.
+``C-o``               Rotate the panes in the current window forwards.
+``C-z``               Suspend the tmux client.
+``!``                 Break the current pane out of the window.
+``"``                 Split the current pane into two, top and bottom.
+``#``                 List all paste buffers.
+``$``                 Rename the current session.
+``%``                 Split the current pane into two, left and right.
+``&``                 Kill the current window.
+``'``                 Prompt for a window index to select.
+``,``                 Rename the current window.
+``-``                 Delete the most recently copied buffer of text.
+``.``                 Prompt for an index to move the current window.
+``0 to 9``            Select windows 0 to 9.
+``:``                 Enter the tmux command prompt.
+``;``                 Move to the previously active pane.
+``=``                 Choose which buffer to paste interactively from a
+                      list.
+``?``                 List all key bindings.
+``D``                 Choose a client to detach.
+``[``                 Enter copy mode to copy text or view the history.
+``]``                 Paste the most recently copied buffer of text.
+``c``                 Create a new window.
+``d``                 Detach the current client.
+``f``                 Prompt to search for text in open windows.
+``i``                 Display some information about the current window.
+``l``                 Move to the previously selected window.
+``n``                 Change to the next window.
+``o``                 Select the next pane in the current window.
+``p``                 Change to the previous window.
+``q``                 Briefly display pane indexes.
+``r``                 Force redraw of the attached client.
+``s``                 Select a new session for the attached client
+                      interactively.
+``L``                 Switch the attached client back to the last session.
+``t``                 Show the time.
+``w``                 Choose the current window interactively.
+``x``                 Kill the current pane.
+``{``                 Swap the current pane with the previous pane.
+``}``                 Swap the current pane with the next pane.
+``~``                 Show previous messages from tmux, if any.
+``Page Up``           Enter copy mode and scroll one page up.
+``Up, Down``          Change to the pane above, below, to the left, or to
+``Left, Right``       the right of the current pane.
+``M-1 to M-5``        Arrange panes in one of the five preset layouts:
+                      even-horizontal, even-vertical, main-horizontal,
+                      main-vertical, or tiled.
+``M-n``               Move to the next window with a bell or activity
+                      marker.
+``M-o``               Rotate the panes in the current window backwards.
+``M-p``               Move to the previous window with a bell or activity
+                      marker.
+``C-Up, C-Down``      Resize the current pane in steps of one cell. 
+``C-Left, C-Right``
+                 
+``M-Up, M-Down``      Resize the current pane in steps of five cells.
+``M-Left, M-Right``
+===================   ====================================================
+
+Source: tmux manpage.
+
 License
 -------