Update documentation for tmux

This commit is contained in:
Colin Hebert 2012-04-04 14:22:02 +01:00 committed by Sorin Ionescu
parent 35dcbdb67c
commit 3457ca359a
2 changed files with 18 additions and 21 deletions

View file

@ -1,34 +1,37 @@
tmux Plugin tmux
=========== ====
Plugin enhancing the [tmux](http://tmux.sourceforge.net/) multiplexer. Defines [tmux][1] aliases and provides for auto launching it at start-up.
Aliases Aliases
------- -------
- `ta`, Attach or switch to a tmux session - `ta` attach or switch to a tmux session.
- `tl`, List sessions managed by the tmux server - `tl` list sessions managed by the tmux server.
Settings Settings
-------- --------
### Auto-start ### Auto-start
Start a tmux session automatically when a Zsh session is opened. Start a tmux session automatically when Zsh is launched.
To enable this feature, one line has to be added to the configuration file: To enable this feature, add the following line to *zshrc*:
zstyle ':omz:plugin:tmux' auto-start 'yes' zstyle ':omz:plugin:tmux' auto-start 'yes'
This will automatically create a background session named "#OMZ" and attach every new shell to it. It will create a background session named _#OMZ_ and attach every new shell to
it.
To avoid keeping open sessions, this plugin sets ``destroy-unattached off`` on the background session and ``destroy-unattached on`` on every other session (global setting). To avoid keeping open sessions, this plugin sets `destroy-unattached off` on
the background session and `destroy-unattached on` on every other session
(global setting).
Caveats Caveats
------- -------
For some reasons, tmux seems to cause kernel panics on Mac OS X. tmux is known to cause kernel panics on Mac OS X. A discussion about this and
A discussion about this and OMZ has already been opened [here](http://git.io/jkPqHg). OMZ has already been opened [here][2].
Authors Authors
------- -------
@ -37,3 +40,7 @@ Authors
- [Sorin Ionescu](/sorin-ionescu) - [Sorin Ionescu](/sorin-ionescu)
- [Colin Hebert](/ColinHebert) - [Colin Hebert](/ColinHebert)
[1]: http://tmux.sourceforge.net
[2]: http://git.io/jkPqHg

View file

@ -5,16 +5,6 @@
# Sorin Ionescu <sorin.ionescu@gmail.com> # Sorin Ionescu <sorin.ionescu@gmail.com>
# Colin Hebert <hebert.colin@gmail.com> # Colin Hebert <hebert.colin@gmail.com>
# #
# Usage:
# To auto start it, add the following to zshrc:
#
# # Auto launch tmux at start-up.
# zstyle ':omz:plugin:tmux' auto-start 'yes'
#
# Warning:
# Tmux is known to cause kernel panics on Mac OS X.
# For more information, see http://git.io/jkPqHg.
#
# Aliases # Aliases
alias ta="tmux attach-session" alias ta="tmux attach-session"