aboutsummaryrefslogtreecommitdiff
path: root/tmux.1
diff options
context:
space:
mode:
authorTiago Cunha <tcunha@gmx.com>2009-09-07 23:37:48 +0000
committerTiago Cunha <tcunha@gmx.com>2009-09-07 23:37:48 +0000
commit5edc4658028b47d975f8685be63f5876a12a3a4f (patch)
treef5da5d1098fa0a584c84c1437471f9cf56d01632 /tmux.1
parentec195a4e15995eb526015fca10a3a5d226918c0e (diff)
downloadrtmux-5edc4658028b47d975f8685be63f5876a12a3a4f.tar.gz
rtmux-5edc4658028b47d975f8685be63f5876a12a3a4f.tar.bz2
rtmux-5edc4658028b47d975f8685be63f5876a12a3a4f.zip
Sync OpenBSD patchset 317:
Permit embedded colour and attributes in status-left and status-right using new #[] special characters, for example #[fg=red,bg=blue,blink].
Diffstat (limited to 'tmux.1')
-rw-r--r--tmux.124
1 files changed, 21 insertions, 3 deletions
diff --git a/tmux.1 b/tmux.1
index 31c4897c..1408ffa2 100644
--- a/tmux.1
+++ b/tmux.1
@@ -1,4 +1,4 @@
-.\" $Id: tmux.1,v 1.164 2009-09-03 21:02:55 tcunha Exp $
+.\" $Id: tmux.1,v 1.165 2009-09-07 23:37:48 tcunha Exp $
.\"
.\" Copyright (c) 2007 Nicholas Marriott <nicm@users.sourceforge.net>
.\"
@@ -14,7 +14,7 @@
.\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
.\" OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
-.Dd $Mdocdate: September 2 2009 $
+.Dd $Mdocdate: September 7 2009 $
.Dt TMUX 1
.Os
.Sh NAME
@@ -1316,10 +1316,11 @@ will be passed through
before being used.
By default, the session name is shown.
.Ar string
-may contain any of the following special character pairs:
+may contain any of the following special character sequences:
.Bl -column "Character pair" "Replaced with" -offset indent
.It Sy "Character pair" Ta Sy "Replaced with"
.It Li "#(command)" Ta "First line of command's output"
+.It Li "#[attributes]" Ta "Colour or attribute change"
.It Li "#H" Ta "Hostname of local host"
.It Li "#I" Ta "Current window index"
.It Li "#P" Ta "Current pane index"
@@ -1329,6 +1330,23 @@ may contain any of the following special character pairs:
.It Li "##" Ta "A literal" Ql #
.El
.Pp
+The #(command) form executes
+.Ql command
+as a shell command and inserts the first line of its output.
+#[attributes] allows a comma-separated list of attributes to be specified,
+these may be
+.Ql fg=colour
+to set the foreground colour,
+.Ql bg=colour
+to set the background colour, or one of the attributes described under the
+.Ic message-attr
+option.
+Examples are:
+.Bd -literal -offset indent
+#(sysctl vm.loadavg)
+#[fg=yellow,bold]#(apm -l)%%#[default] [#S]
+.Ed
+.Pp
Where appropriate, these may be prefixed with a number to specify the maximum
length, for example
.Ql #24T .