From 70dbc2f5b1128eaf7d6a7e2fe609ec6881b0626c Mon Sep 17 00:00:00 2001
From: Tiago Cunha <tcunha@gmx.com>
Date: Fri, 6 Feb 2009 18:38:30 +0000
Subject: [PATCH] - Document find-window. - Document suspend-client. - Document
 window-status-{attr,bg,fg}. - Options without arguments should be listed
 first. - s/Copies/Copy/.

---
 TODO              |  3 ---
 examples/tmux.vim |  8 +++++---
 tmux.1            | 32 +++++++++++++++++++++++++++-----
 3 files changed, 32 insertions(+), 11 deletions(-)

diff --git a/TODO b/TODO
index bf81d0cf..cd1bb503 100644
--- a/TODO
+++ b/TODO
@@ -85,7 +85,4 @@
 (hopefully) for 0.7, in no particular order:
 - key to switch to copy mode from scroll mode
 - attach should have a flag to create session if it doesn't exist
-- document suspend-client
 - document command sequences
-- document find-window
-- document window-status-{fg, bg, attr}
diff --git a/examples/tmux.vim b/examples/tmux.vim
index a6ee1eb6..6cefaac3 100644
--- a/examples/tmux.vim
+++ b/examples/tmux.vim
@@ -1,7 +1,7 @@
 " Vim syntax file
 " Language: tmux(1) configuration file
 " Maintainer: Tiago Cunha <me@tiagocunha.org>
-" Last Change: $Date: 2009-02-03 17:21:19 $
+" Last Change: $Date: 2009-02-06 18:38:30 $
 
 if version < 600
 	syntax clear
@@ -34,7 +34,8 @@ syn keyword tmuxCmds pass set-password saveb save-buffer downp down-pane killp
 syn keyword tmuxCmds kill-pane resizep-down resize-pane-down resizep-up
 syn keyword tmuxCmds resize-pane-up selectp select-pane splitw split-window
 syn keyword tmuxCmds upp up-pane choose-session choose-window loadb load-buffer
-syn keyword tmuxCmds copyb copy-buffer
+syn keyword tmuxCmds copyb copy-buffer suspendc suspend-client findw
+syn keyword tmuxCmds find-window
 
 syn keyword tmuxOptsSet prefix status status-fg status-bg bell-action
 syn keyword tmuxOptsSet default-command history-limit status-left status-right
@@ -46,7 +47,8 @@ syn keyword tmuxOptsSet message-attr status-attr
 syn keyword tmuxOptsSetw monitor-activity aggressive-resize force-width
 syn keyword tmuxOptsSetw force-height remain-on-exit uft8 mode-fg mode-bg
 syn keyword tmuxOptsSetw mode-keys clock-mode-colour clock-mode-style
-syn keyword tmuxOptsSetw xterm-keys mode-attr
+syn keyword tmuxOptsSetw xterm-keys mode-attr window-status-attr
+syn keyword tmuxOptsSetw window-status-bg window-status-fg
 
 syn keyword tmuxTodo FIXME NOTE TODO XXX contained
 
diff --git a/tmux.1 b/tmux.1
index 416d4c84..bab25cc9 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1,4 +1,4 @@
-.\" $Id: tmux.1,v 1.75 2009-02-03 17:21:19 tcunha Exp $
+.\" $Id: tmux.1,v 1.76 2009-02-06 18:38:30 tcunha Exp $
 .\"
 .\" Copyright (c) 2007 Nicholas Marriott <nicm@users.sourceforge.net>
 .\"
@@ -403,11 +403,11 @@ replaced by what is entered at the prompt.
 .Op Fl t Ar dst-session
 .Xc
 .D1 (alias: Ic copyb)
-Copies a session paste buffer to another session. If no sessions are
-specified, the current one is used instead.
+Copy a session paste buffer to another session. If no sessions are specified,
+the current one is used instead.
 .It Xo Ic copy-mode
-.Op Fl t Ar target-window
 .Op Fl u
+.Op Fl t Ar target-window
 .Xc
 Enter copy mode. The
 .Fl u
@@ -432,6 +432,17 @@ Detach the current client if bound to a key, or the specified client with
 .Xc
 .D1 (alias: Ic downp )
 Move down a pane.
+.It Xo Ic find-window
+.Op Fl t Ar target-window
+.Ar match-string
+.Xc
+.D1 (alias: Ic findw )
+Search for
+.Ar match-string
+in window names, titles, and visible content (but not history). If only one
+window is matched, it'll be automatically selected, otherwise a choice list is
+shown. This command only works from inside
+.Nm .
 .It Xo Ic has-session
 .Op Fl t Ar target-session
 .Xc
@@ -673,8 +684,8 @@ The
 .Fl a
 option appends to rather than overwriting the file.
 .It Xo Ic scroll-mode
-.Op Fl t Ar target-window
 .Op Fl u
+.Op Fl t Ar target-window
 .Xc
 Enter scroll mode. The
 .Fl u
@@ -997,6 +1008,12 @@ command.
 Instructs
 .Nm
 to expect UTF-8 sequences to appear in this window.
+.It Ic window-status-attr Ar attributes
+Set status line attributes for a single window.
+.It Ic window-status-bg Ar colour
+Set status line background colour for a single window.
+.It Ic window-status-fg Ar colour
+Set status line foreground colour for a single window.
 .It Xo xterm-keys
 .Op Ic on | Ic off
 .Xc
@@ -1072,6 +1089,11 @@ The panes are indexed from top (0) to bottom, with no numbers skipped.
 Start the
 .Nm
 server, if not already running, without creating any sessions.
+.It Xo Ic suspend-client
+.Op Fl c target-client
+.Xc
+.D1 (alias: Ic suspendc )
+Suspend a client by sending SIGTSTP (tty stop).
 .It Xo Ic swap-window
 .Op Fl d
 .Op Fl s Ar src-window