mirror of
				https://github.com/tmux/tmux.git
				synced 2025-10-26 12:27:15 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			97 lines
		
	
	
		
			4.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			97 lines
		
	
	
		
			4.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| Welcome to tmux!
 | |
| 
 | |
| tmux is a "terminal multiplexer", it enables a number of terminals (or windows)
 | |
| to be accessed and controlled from a single terminal. tmux is intended to be a
 | |
| simple, modern, BSD-licensed alternative to programs such as GNU screen.
 | |
| 
 | |
| This release runs on OpenBSD, FreeBSD, NetBSD, Linux and OS X and may still
 | |
| run on Solaris and AIX (although they haven't been tested in a while). It is
 | |
| usable, although there remain a number of missing features and some remaining
 | |
| bugs are expected.
 | |
| 
 | |
| If upgrading from 1.0, PLEASE NOTE:
 | |
| - The internal locking mechanism has gone, so the set-password command and -U
 | |
|   command line option have been removed.
 | |
| - The -d command line flag was dropped. It will now automatically detect the
 | |
|   default colours by using op/AX. Nevertheless, if needed, the
 | |
|   terminal-overrides session option can replace it.
 | |
| 
 | |
| Since the 1.2 release that tmux depends on libevent. Download the stable
 | |
| version from:
 | |
| 
 | |
| 	http://www.monkey.org/~provos/libevent/
 | |
| 
 | |
| tmux consists of a server part and multiple clients. The server is created when
 | |
| required and runs continuously unless killed by the user. Clients access the
 | |
| server through a socket in /tmp. Multiple sessions may be created on a single
 | |
| server and attached to a number of clients. Each session may then have a number
 | |
| of windows and windows may be linked to a number of sessions. Commands are
 | |
| available to create, rename and destroy windows and sessions; to attach and
 | |
| detach sessions from client terminals; to set configuration options; to split
 | |
| windows into several simultaneously displayed panes; and to bind and unbind
 | |
| command keys (invoked preceded by a prefix key, by default ctrl-b). Please see
 | |
| the tmux(1) man page for further information.
 | |
| 
 | |
| The following is a summary of major features implemented in this version:
 | |
| 
 | |
| - Basic multiplexing, window switching, attaching and detaching.
 | |
| - Window listing and renaming.
 | |
| - Key binding.
 | |
| - Handling of client terminal resize.
 | |
| - Terminal emulation sufficient to handle most curses applications.
 | |
| - A optional status line (enabled by default).
 | |
| - Window history and copy and paste.
 | |
| - Support for VT100 line drawing characters.
 | |
| - A large command set.
 | |
| - Vertical window splitting and layout.
 | |
| - Automatic server locking on inactivity by running an external command.
 | |
| - A configuration file.
 | |
| - UTF-8 support.
 | |
| 
 | |
| A more extensive, but rough, todo list is included in the TODO file.
 | |
| 
 | |
| tmux also depends on several features of the client terminal (TERM), if these
 | |
| are missing it may refuse to run, or not behave correctly.
 | |
| 
 | |
| tmux supports UTF-8. To use it, the utf8 option must be set on each window;
 | |
| this may be turned on for all windows by setting it as a global option, see
 | |
| tmux(1) and the FAQ file. As of 0.9, tmux attempts to autodetect a
 | |
| UTF-8-capable terminal by checking the LC_ALL, LC_CTYPE and LANG environment
 | |
| variables. list-clients may be used to check if this is detected correctly; if
 | |
| not, the -u command-line flag may be specified.
 | |
| 
 | |
| A Vim syntax file is available in the examples directory. To install it:
 | |
| 
 | |
| - Drop the file in the syntax directory in your runtimepath (such as
 | |
|   ~/.vim/syntax/tmux.vim).
 | |
| - Make the filetype recognisable by adding the following to filetype.vim
 | |
|   in your runtimepath (~/.vim/filetype.vim):
 | |
| 
 | |
| 	augroup filetypedetect
 | |
| 		au BufNewFile,BufRead .tmux.conf*,tmux.conf* setf tmux
 | |
| 	augroup END
 | |
| 
 | |
| - Switch on syntax highlighting by adding "syntax enable" to your vimrc file.
 | |
| 
 | |
| For debugging, running tmux with -v or -vv will generate server and client log
 | |
| files in the current directory.
 | |
| 
 | |
| tmux mailing lists are available; visit:
 | |
| 
 | |
| 	https://sourceforge.net/mail/?group_id=200378
 | |
| 
 | |
| Bug reports, feature suggestions and especially code contributions are most
 | |
| welcome. Please send by email to:
 | |
| 
 | |
| 	nicm@users.sf.net
 | |
| 
 | |
| This file and the CHANGES, FAQ and TODO files are licensed under the ISC
 | |
| license. Files under examples/ remain copyright their authors unless otherwise
 | |
| stated in the file but permission has been received to distribute them with
 | |
| tmux. All other files have a license and copyright notice at their
 | |
| start. Please contact me with any queries.
 | |
| 
 | |
| -- Nicholas Marriott <nicm@users.sf.net>
 | |
| 
 | |
| $Id: NOTES,v 1.52 2009-11-08 22:51:34 tcunha Exp $
 | 
