From 5bd33f5f7f2e082a2e558d3e9e9b8d517ec2c63d Mon Sep 17 00:00:00 2001 From: Tiago Cunha Date: Thu, 15 Jan 2009 21:24:03 +0000 Subject: [PATCH] Document default-path, and update set/setw with the -u flag. From nicm and me. --- TODO | 4 ---- examples/tmux.vim | 4 ++-- tmux.1 | 33 ++++++++++++++++++++++----------- 3 files changed, 24 insertions(+), 17 deletions(-) diff --git a/TODO b/TODO index a1210dbc..557a6556 100644 --- a/TODO +++ b/TODO @@ -76,10 +76,6 @@ then convert the return idx back into pointer and select the item for 0.6: -- document OPTIONS section in man page with description of new option handling -- document default-path - document pane stuff: up-/down-/select-/kill-pane, split-window -- document password/locking commands -- document update set/setw in man page with -g and -u flags - document xterm-keys - document repeat-time diff --git a/examples/tmux.vim b/examples/tmux.vim index 27e6e51b..414b2b90 100644 --- a/examples/tmux.vim +++ b/examples/tmux.vim @@ -1,7 +1,7 @@ " Vim syntax file " Language: tmux(1) configuration file " Maintainer: Tiago Cunha -" Last Change: $Date: 2009-01-12 21:53:18 $ +" Last Change: $Date: 2009-01-15 21:24:03 $ if version < 600 syntax clear @@ -36,7 +36,7 @@ syn keyword tmuxOptsSet prefix status status-fg status-bg bell-action syn keyword tmuxOptsSet default-command history-limit status-left status-right syn keyword tmuxOptsSet status-interval set-titles display-time buffer-limit syn keyword tmuxOptsSet status-left-length status-right-length message-fg -syn keyword tmuxOptsSet message-bg lock-after-time +syn keyword tmuxOptsSet message-bg lock-after-time default-path syn keyword tmuxOptsSetw monitor-activity aggressive-resize force-width syn keyword tmuxOptsSetw force-height remain-on-exit uft8 mode-fg mode-bg diff --git a/tmux.1 b/tmux.1 index 294007bc..43495881 100644 --- a/tmux.1 +++ b/tmux.1 @@ -1,4 +1,4 @@ -.\" $Id: tmux.1,v 1.60 2009-01-14 18:47:19 nicm Exp $ +.\" $Id: tmux.1,v 1.61 2009-01-15 21:24:03 tcunha Exp $ .\" .\" Copyright (c) 2007 Nicholas Marriott .\" @@ -648,7 +648,7 @@ Show server information and terminal details. Set the contents of the specified buffer to .Ar data . .It Xo Ic set-option -.Op Fl g +.Op Fl gu .Op Fl t Ar target-session .Ar option Ar value .Xc @@ -656,8 +656,17 @@ Set the contents of the specified buffer to Set an option. If .Fl g -is specified, the option is set globally (it becomes the default inherited by -all sessions unless overridden) is set; otherwise it is set on the session +is specified, the option is set as a global option. Global options apply to all +sessions which don't have the option explicitly set. +If +.Fl g +is not used, the option applies only to +.Ar target-session . +The +.Fl u +flag unsets an option, so a session inherits the option from the global +options - it is not possible to unset a global option. +.Pp Possible options are: .Bl -tag -width Ds .It Xo Ic bell-action @@ -676,11 +685,15 @@ Set the number of buffers kept for each session; as new buffers are added to the top of the stack, old ones are removed from the bottom if necessary to maintain this maximum length. .It Ic default-command Ar command -Sets the command used for new windows (if not specified when the window is +Set the command used for new windows (if not specified when the window is created) to .Ar command . The default is .Dq exec $SHELL . +.It Ic default-path Ar path +Set the default working directory for processes created from keys, or +interactively from the prompt. +The default is the current working directory when the server is started. .It Ic history-limit Ar lines Set the maximum number of lines held in window history. This setting applies only to new windows - existing window histories are not @@ -790,16 +803,14 @@ command). To prevent variable expansion when an encrypted password is read from a configuration file, enclose it in single quotes ('). .It Xo Ic set-window-option -.Op Fl g +.Op Fl gu .Op Fl t Ar target-window .Ar option Ar value .Xc .D1 (alias: Ic setw ) -Set a window-specific option. -If -.Fl g -is specified the option is set globally (see -.Ic set-option ) . +Set a window-specific option. The -g and -u flags work similarly to the +.Ic set-option +command. .Pp Supported options are: .Bl -tag -width Ds