Quick start section in man page.

pull/1/head
Nicholas Marriott 2007-12-16 17:18:43 +00:00
parent da22fafed5
commit f18ac66185
3 changed files with 53 additions and 3 deletions

1
TODO
View File

@ -68,5 +68,4 @@
-- For 0.2 --------------------------------------------------------------------
- anything which uses cmd_{send,recv}_string will break if the string is
split. string length should be part of the command size
- quick intro section (tmux new/attach/detach) etc
- chmod +x socket when any client is attached (upd in lost/accept)

51
tmux.1
View File

@ -1,4 +1,4 @@
.\" $Id: tmux.1,v 1.20 2007-11-26 20:36:30 nicm Exp $
.\" $Id: tmux.1,v 1.21 2007-12-16 17:18:43 nicm Exp $
.\"
.\" Copyright (c) 2007 Nicholas Marriott <nicm@users.sourceforge.net>
.\"
@ -92,6 +92,55 @@ This specifies one of a set of commands used to control
and described in the following sections.
.Pp
.El
.Sh QUICK START
To create a new tmux session running
.Xr vi :
.Pp
.Dl $ tmux new-session vi
.Pp
Most commands have a shorter form, known as an alias.
For new-session, this is
.Ic new :
.Pp
.Dl $ tmux new vi
.Pp
Alternatively, the shortest unambiguous form of a command is accepted.
If there are several options, they are listed:
.Bd -literal -offset indent
$ tmux n
ambiguous command: n, could be: new-session, new-window, next-window
$
.Ed
.Pp
Within an active session, a new window may be created by typing
.Ql ^B
(ctrl-B, known as the prefix key)
followed by the
.Ql c
key.
.Pp
Windows may be navigated with:
.Ql ^B 0
(to select window 0),
.Ql ^B 1
(to select window 1), and so on;
.Ql ^B n
to select the next window; and
.Ql ^B p
to select the previous window.
.Pp
A session may be detached using
.Ql ^B d
and reattached with:
.Pp
.Dl $ tmux attach-session
.Pp
Typing
.Ql ^B \&?
lists the current key bindings in the current window; up and down may be used
to navigate the list or
.Ql Q
to exit from it.
.Sh KEY BINDINGS
.Nm
may be controlled from an attached client by using a key combination of a

4
tty.c
View File

@ -1,4 +1,4 @@
/* $Id: tty.c,v 1.16 2007-12-10 07:58:00 nicm Exp $ */
/* $Id: tty.c,v 1.17 2007-12-16 17:18:43 nicm Exp $ */
/*
* Copyright (c) 2007 Nicholas Marriott <nicm@users.sourceforge.net>
@ -93,9 +93,11 @@ tty_open(struct tty *tty, char **cause)
if (tcsetattr(tty->fd, TCSANOW, &tio) != 0)
fatal("tcsetattr failed");
#ifdef TIOCFLUSH
what = 0;
if (ioctl(tty->fd, TIOCFLUSH, &what) != 0)
fatal("ioctl(TIOCFLUSH)");
#endif
if (enter_ca_mode != NULL)
tty_puts(tty, enter_ca_mode);