aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJason McIntyre <jmc@openbsd.org>2009-08-06 21:06:35 +0000
committerJason McIntyre <jmc@openbsd.org>2009-08-06 21:06:35 +0000
commit746fe5832a428ac8d74f17c1d463805e51bee0c3 (patch)
tree96bc11ee2dd63dda47dc9e0e5bd12c6a762e6974
parent4027335fa9dd6f6bdce9191695a39529581bfe2a (diff)
downloadrtmux-746fe5832a428ac8d74f17c1d463805e51bee0c3.tar.gz
rtmux-746fe5832a428ac8d74f17c1d463805e51bee0c3.tar.bz2
rtmux-746fe5832a428ac8d74f17c1d463805e51bee0c3.zip
tweak INTRODUCTION; from nicm and myself
-rw-r--r--tmux.152
1 files changed, 32 insertions, 20 deletions
diff --git a/tmux.1 b/tmux.1
index 8264c73f..6f73688f 100644
--- a/tmux.1
+++ b/tmux.1
@@ -31,8 +31,9 @@
.Ek
.Sh DESCRIPTION
.Nm
-is a terminal multiplexer: it enables a number of terminals to be accessed and
-controlled from a single terminal.
+is a terminal multiplexer:
+it enables a number of terminals to be created, accessed, and
+controlled from a single screen.
.Pp
The options are as follows:
.Bl -tag -width "XXXXXXXXXXXX"
@@ -127,30 +128,41 @@ is the PID of the server or client process.
This specifies one of a set of commands used to control
.Nm ,
as described in the following sections.
-If no command and flags are specified, the
+If no commands are specified, the
.Ic new-session
command is assumed.
.El
.Sh INTRODUCTION
+When
.Nm
-runs as a server-client system.
-A server holds a number of
-.Em sessions ,
-each of which may have a number of
-.Em windows
-linked to it.
-A server is started automatically when the first session is created and exits
-when all the sessions it contains are destroyed.
-A window may be split on screen into one or more
-.Em panes ,
-each of which is a separate terminal.
-Any number of
-.Em clients
-may connect to a session, or the server
-may be controlled by issuing commands with
+is started it creates a new
+.Em session
+with a single
+.Em window
+and displays it on screen.
+A status line at the bottom of the screen
+shows information on the current session
+and is used to enter interactive commands.
+.Pp
+A session is a single collection of
+.Em pseudo terminals
+under the management of
.Nm .
-Communication takes place through a socket, by default placed in
-.Pa /tmp .
+Each session has one or more
+windows linked to it.
+A window occupies the entire screen
+and may be split into rectangular panes,
+each of which is a separate pseudo terminal
+(the
+.Xr pty 4
+manual page documents the technical details of pseudo terminals).
+Any number of
+.Nm
+instances may connect to the same session,
+and any number of windows may be present in the same session.
+Once all sessions are killed,
+.Nm
+exits.
.Pp
This is an overview of the sections in this manual page:
.Bl -ohang