From f18ac661854f08404d12a32e012afef09d31c814 Mon Sep 17 00:00:00 2001
From: Nicholas Marriott <nicholas.marriott@gmail.com>
Date: Sun, 16 Dec 2007 17:18:43 +0000
Subject: [PATCH] Quick start section in man page.

---
 TODO   |  1 -
 tmux.1 | 51 ++++++++++++++++++++++++++++++++++++++++++++++++++-
 tty.c  |  4 +++-
 3 files changed, 53 insertions(+), 3 deletions(-)

diff --git a/TODO b/TODO
index 75c3715b..5e9cf9df 100644
--- a/TODO
+++ b/TODO
@@ -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)
diff --git a/tmux.1 b/tmux.1
index c795b2d4..56aada7c 100644
--- a/tmux.1
+++ b/tmux.1
@@ -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
diff --git a/tty.c b/tty.c
index 13940040..e8d54764 100644
--- a/tty.c
+++ b/tty.c
@@ -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);