Go to file
Thomas Adam 75f5b3dab6 Add subdir-objects to shut automake up
automake 1.14 onwards has started emitting lots of warnings about this
option:

automake: warning: possible forward-incompatibility.
automake: At least a source file is in a subdirectory, but the
'subdir-objects'
automake: automake option hasn't been enabled.  For now, the corresponding
output
automake: object file(s) will be placed in the top-level directory.
However,
automake: this behaviour will change in future Automake versions: they will
automake: unconditionally cause object files to be placed in the same
subdirectory
automake: of the corresponding sources.
automake: You are advised to start using 'subdir-objects' option throughout
your
automake: project, to avoid future incompatibilities.

So enable this in AM_INIT_AUTOMAKE.

This doesn't seem to break older automake versions.
2013-10-05 12:44:09 +01:00
compat +strings.h in compat/. 2013-06-25 09:57:49 +01:00
examples Add wait-for to tmux.vim from Ben Boeckel. 2013-04-10 13:04:19 +01:00
tools Expand the Id keyword. 2011-07-09 09:42:33 +00:00
www www Project Page -> SourceForge Page 2013-02-23 14:51:56 +00:00
.gitignore Amend tmux.1 handling in .gitignore 2013-06-01 10:58:39 +01:00
.mailmap Sanitise additional .mailmap entries 2012-11-08 21:39:35 +00:00
arguments.c Merge branch 'obsd-master' 2013-05-31 21:44:42 +01:00
array.h Sync OpenBSD patchset 1150: 2012-07-11 19:34:16 +00:00
attributes.c Sync OpenBSD patchset 1067: 2012-03-18 02:17:20 +00:00
autogen.sh Only set AUTO{MAKE,CONF}_VERSION on OpenBSD 2013-01-31 00:14:59 +00:00
cfg.c Add some additional debug logging. 2013-03-05 17:17:59 +00:00
CHANGES Trivial typo fixes in changes. 2013-03-27 23:37:05 +00:00
client.c Add support for Cgywin, apparently it is enough just to open the tty again in 2013-07-12 22:21:42 +01:00
clock.c Merge branch 'obsd-master' 2013-04-13 17:05:49 +01:00
cmd-attach-session.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-bind-key.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-break-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-capture-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-choose-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-choose-client.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-choose-list.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-choose-tree.c Merge branch 'master' of ssh://git.code.sf.net/p/tmux/tmux-code 2013-08-21 18:03:07 +01:00
cmd-clear-history.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-clock-mode.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-command-prompt.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-confirm-before.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-copy-mode.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-delete-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-detach-client.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-display-message.c Trivial style and spacing nits. 2013-08-21 18:35:01 +01:00
cmd-display-panes.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-find-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-has-session.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-if-shell.c Make cmdq->client_exit a tristate (-1 means "not set") so that if explicitly 2013-10-01 23:31:09 +01:00
cmd-join-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-kill-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-kill-server.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-kill-session.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-kill-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-link-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-buffers.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-clients.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-commands.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-keys.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-panes.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-sessions.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list-windows.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-list.c Add a command queue to standardize and simplify commands that call other 2013-02-23 22:25:58 +00:00
cmd-load-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-lock-server.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-move-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-new-session.c Support -c for new-session, based on code from J Raynor. 2013-10-01 23:48:03 +01:00
cmd-new-window.c Support -c for new-session, based on code from J Raynor. 2013-10-01 23:48:03 +01:00
cmd-paste-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-pipe-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-queue.c Merge branch 'master' of ssh://git.code.sf.net/p/tmux/tmux-code 2013-10-01 23:50:24 +01:00
cmd-refresh-client.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-rename-session.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-rename-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-resize-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-respawn-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-respawn-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-rotate-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-run-shell.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-save-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-select-layout.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-select-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-select-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-send-keys.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-server-info.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-set-buffer.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-set-environment.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-set-option.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-show-environment.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-show-messages.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-show-options.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-source-file.c Make cmdq->client_exit a tristate (-1 means "not set") so that if explicitly 2013-10-01 23:31:09 +01:00
cmd-split-window.c Merge branch 'master' of ssh://git.code.sf.net/p/tmux/tmux-code 2013-10-01 23:50:24 +01:00
cmd-start-server.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-string.c Add a command queue to standardize and simplify commands that call other 2013-02-23 22:25:58 +00:00
cmd-suspend-client.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-swap-pane.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-swap-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-switch-client.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-unbind-key.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-unlink-window.c Remove the barely-used and unnecessary command check() function. 2013-08-21 18:01:40 +01:00
cmd-wait-for.c Mark flags as optional and mutually exclusive. 2013-08-31 11:16:47 +01:00
cmd.c Support -c for new-session, based on code from J Raynor. 2013-10-01 23:48:03 +01:00
colour.c Merge branch 'obsd-master' 2013-04-13 17:05:49 +01:00
compat.h Add support for Cgywin, apparently it is enough just to open the tty again in 2013-07-12 22:21:42 +01:00
configure.ac Add subdir-objects to shut automake up 2013-10-05 12:44:09 +01:00
control-notify.c Fix compiler warnings, missing #include. From Thomas Adam. 2013-03-26 10:54:48 +00:00
control.c Pass flags into cmdq_guard as an argument since sometimes cmdq->cmd can be 2013-08-01 23:35:03 +01:00
COPYING Add a COPYING file, suggested by Dagobert Michelsen. 2013-05-31 12:59:17 +01:00
environ.c Sync OpenBSD patchset 1150: 2012-07-11 19:34:16 +00:00
FAQ Add entry about smaller clients based on text from Thomas Adam. 2013-08-31 10:42:09 +01:00
format.c First period not last for host_short, from Michael Scholz. 2013-10-01 23:24:39 +01:00
grid-cell.c Rather than having two grids for each pane, one for ASCII and one for 2013-01-18 02:16:21 +00:00
grid-view.c Preserve trailing spaces with capture-pane -J, from George Nachman. 2013-03-04 11:03:03 +00:00
grid.c Trivial style and spacing nits. 2013-08-21 18:35:01 +01:00
input-keys.c Merge branch 'obsd-master' 2013-05-25 11:48:12 +01:00
input.c Accept multiple parameters to SM/RM/DECSET/DECRST, based on a diff from Hayaki 2013-08-19 22:31:38 +01:00
job.c Merge branch 'obsd-master' 2013-04-23 08:26:04 +01:00
key-bindings.c Add resize-pane -Z to temporary zoom the active pane to occupy the full window 2013-02-24 00:25:03 +00:00
key-string.c In terminals with XT, turn on modifyOtherKeys=1 with the escape sequence and 2013-02-17 22:56:12 +00:00
layout-custom.c Fix handling of short (< 4 character) checksums and a bug with parsing 2013-03-10 23:41:59 +00:00
layout-set.c Sync OpenBSD patchset 978: 2011-11-10 21:41:37 +00:00
layout.c mouse-resize-pane: Only resize on border select 2013-10-02 06:53:47 +01:00
log.c Do not use stderr for log file and don't call log_close when not needed. 2012-05-30 15:01:57 +00:00
Makefile.am Use _XPG6 on Solaris with GCC because the headers are insane and don't like GCC 2013-06-25 09:35:42 +01:00
mdoc2man.awk Generate tmux.1 using mdoc2man.awk on Solaris, issue brought up and changes 2013-04-16 11:33:53 +01:00
mode-key.c Merge branch 'obsd-master' 2013-07-06 11:18:49 +01:00
names.c Add automatic-rename-format option allowing automatic rename to use something 2013-08-19 22:16:11 +01:00
notify.c Merge branch 'obsd-master' 2012-09-25 17:05:36 +01:00
options-table.c Add automatic-rename-format option allowing automatic rename to use something 2013-08-19 22:16:11 +01:00
options.c Sync OpenBSD patchset 1150: 2012-07-11 19:34:16 +00:00
osdep-aix.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-darwin.c Use proc_bsdinfo which works on older OS X versions, from OZAKI Kiichi. 2013-04-10 12:46:29 +01:00
osdep-dragonfly.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-freebsd.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-hpux.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-linux.c Set EVENT_NOEPOLL on Linux again. 2013-08-23 15:25:05 +01:00
osdep-netbsd.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-openbsd.c Use open(".")/fchdir() to save and restore current directory rather than 2013-10-05 09:14:11 +01:00
osdep-sunos.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
osdep-unknown.c Use pgrp of pty fd not pid of immediate child when recovering current working 2012-09-24 14:05:38 +01:00
paste.c Merge branch 'obsd-master' 2012-11-27 22:24:00 +00:00
README The visit -> Visit 2013-02-23 15:15:20 +00:00
resize.c Make recalculate_sizes() handle an empty window with no active pane. This can 2013-08-01 23:37:45 +01:00
screen-redraw.c When only two panes in a window, only draw half the separating line as 2013-03-25 11:41:49 +00:00
screen-write.c Merge branch 'obsd-master' 2013-05-25 11:48:12 +01:00
screen.c Merge branch 'obsd-master' 2013-05-25 11:48:12 +01:00
server-client.c Allow the file descriptor received from the client to be -1 - it can be on 2013-08-01 23:42:39 +01:00
server-fn.c Grouped sessions were being leaked on destroy, correctly free them. 2013-08-01 23:38:35 +01:00
server-window.c Add various checks to turn off bits that can't work in control mode (such as 2013-02-17 10:12:55 +00:00
server.c Rename global configuration define. 2013-04-24 10:01:32 +00:00
session.c Renumber windows: Lookup lastw via window not index 2013-08-20 00:04:07 +01:00
signal.c Expand the Id keyword. 2011-07-09 09:42:33 +00:00
status.c Merge branch 'obsd-master' 2013-07-06 11:18:49 +01:00
SYNCING Move NOTES->README, move Vim syntax file documentation to the file itself and 2013-02-19 23:31:04 +00:00
tmux.1 Merge branch 'master' of ssh://git.code.sf.net/p/tmux/tmux-code 2013-10-01 23:50:24 +01:00
tmux.c Fix previous not to lead fd on failure. 2013-10-05 11:40:47 +01:00
tmux.h Support -c for new-session, based on code from J Raynor. 2013-10-01 23:48:03 +01:00
TODO Remove from TODO. 2013-08-21 18:33:34 +01:00
tty-acs.c Expand the Id keyword. 2011-07-09 09:42:33 +00:00
tty-keys.c Assign mouse x/y coords before checking them 2013-08-20 00:02:38 +01:00
tty-term.c Merge branch 'obsd-master' 2013-06-13 18:12:49 +01:00
tty.c Focus events can cause trouble if left on and they can't be turned off 2013-06-28 20:55:16 +01:00
utf8.c Merge branch 'obsd-master' 2013-04-13 17:05:49 +01:00
window-choose.c choose-tree: Reset top when toggling items 2013-08-20 00:05:28 +01:00
window-clock.c No more lint means no more ARGSUSED. 2013-02-17 23:15:38 +00:00
window-copy.c Merge branch 'obsd-master' 2013-07-13 16:57:51 +01:00
window.c Clear window->flags when clearing winlinks 2013-08-20 13:03:53 +01:00
xmalloc.c Sync OpenBSD patchset 1150: 2012-07-11 19:34:16 +00:00
xterm-keys.c In terminals with XT, turn on modifyOtherKeys=1 with the escape sequence and 2013-02-17 22:56:12 +00:00

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).

Since the 1.2 release tmux depends on libevent. Download it from:

	http://www.monkey.org/~provos/libevent/

To build tmux from a release tarball, do:

	$ ./configure && make
	$ sudo make install

To get and build the latest from version control:

	$ git clone git://git.code.sf.net/p/tmux/tmux-code tmux
	$ cd tmux
	$ sh autogen.sh
	$ ./configure && make

For more information see https://sourceforge.net/scm/?type=git&group_id=200378
and http://git-scm.com. Patches should be sent by email to the mailing list at
tmux-users@lists.sourceforge.net.

For documentation on using tmux, see the tmux.1 manpage. It can be viewed from
the source tree with:

	$ nroff -mdoc tmux.1|less

Some common questions are answered in the FAQ file and a more extensive (but
slightly out of date) guide is available in the OpenBSD FAQ at
http://www.openbsd.org/faq/faq7.html#tmux. A rough todo list is in the TODO
file and some example configurations and a Vim syntax file are in the examples
directory.

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:

	tmux-users@lists.sourceforge.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.

-- Nicholas Marriott <nicm@users.sf.net>

$Id$