=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/tmux/tmux.1,v retrieving revision 1.48 retrieving revision 1.49 diff -u -r1.48 -r1.49 --- src/usr.bin/tmux/tmux.1 2009/07/28 07:03:32 1.48 +++ src/usr.bin/tmux/tmux.1 2009/07/28 17:05:10 1.49 @@ -1,4 +1,4 @@ -.\" $OpenBSD: tmux.1,v 1.48 2009/07/28 07:03:32 nicm Exp $ +.\" $OpenBSD: tmux.1,v 1.49 2009/07/28 17:05:10 nicm Exp $ .\" .\" Copyright (c) 2007 Nicholas Marriott .\" @@ -352,7 +352,10 @@ used in copy and scroll modes. The tables may be viewed with the .Ic list-keys -command. +command and keys modified or removed with +.Ic bind-key +and +.Ic unbind-key . .Pp The paste buffer key pastes the first line from the top paste buffer on the stack. @@ -637,7 +640,8 @@ will attempt to start it; this will fail unless sessions are created in the configuration file. .It Xo Ic bind-key -.Op Fl nr +.Op Fl cnr +.Op Fl t Ar key-table .Ar key Ar command Op Ar arguments .Xc .D1 (alias: Ic bind ) @@ -652,7 +656,11 @@ for Ctrl keys, or .Ql M- for Alt (meta) keys. -If +.Pp +By default (without +.Fl t ) +the primary key bindings are modified (those normally activated with the prefix +key); in this case, if .Fl n is specified, it is not necessary to use the prefix key, .Ar command @@ -664,6 +672,19 @@ flag indicates this key may repeat, see the .Ic repeat-time option. +.Pp +If +.Fl t +is present, +.Ar key +is bound in +.Ar key-table : +the binding for command mode with +.Fl c +or for normal mode without. +To view the default bindings and possible commands, see the +.Ic list-keys +command. .It Xo Ic break-pane .Op Fl d .Op Fl p Ar pane-index @@ -866,7 +887,7 @@ List the syntax of all commands supported by .Nm . .It Xo Ic list-keys -.Op Ar Fl t Ar key-table +.Op Fl t Ar key-table .Xc .D1 (alias: Ic lsk ) List all key bindings. @@ -1665,17 +1686,30 @@ to .Ar target-session . .It Xo Ic unbind-key -.Op Fl n +.Op Fl cn +.Op Fl t Ar key-table .Ar key .Xc .D1 (alias: Ic unbind ) Unbind the command bound to .Ar key . -If +Without +.Fl t +the primary key bindings are modified; in this case, if .Fl n is specified, the command bound to .Ar key without a prefix (if any) is removed. +.Pp +If +.Fl t +is present, +.Ar key +in +.Ar key-table +is unbound: the binding for command mode with +.Fl c +or for normal mode without. .It Xo Ic unlink-window .Op Fl k .Op Fl t Ar target-window