aboutsummaryrefslogtreecommitdiff
path: root/tmux.1
diff options
context:
space:
mode:
authorThomas Adam <thomas@xteddy.org>2015-05-27 16:01:22 +0100
committerThomas Adam <thomas@xteddy.org>2015-05-27 16:01:22 +0100
commitbeffdf6575454f5f99ed45222cdef6dbea65ec58 (patch)
treefb8d6c73254fd94bac56953306321b75af537e09 /tmux.1
parentf538f2ae9ba4c5705718e8f7dda32921419685ba (diff)
parent379400cfa69f8df9ac13b070c60d5f8a282ddf6e (diff)
downloadrtmux-beffdf6575454f5f99ed45222cdef6dbea65ec58.tar.gz
rtmux-beffdf6575454f5f99ed45222cdef6dbea65ec58.tar.bz2
rtmux-beffdf6575454f5f99ed45222cdef6dbea65ec58.zip
Merge branch 'obsd-master'
Diffstat (limited to 'tmux.1')
-rw-r--r--tmux.132
1 files changed, 17 insertions, 15 deletions
diff --git a/tmux.1 b/tmux.1
index a987693e..be79e273 100644
--- a/tmux.1
+++ b/tmux.1
@@ -2666,25 +2666,10 @@ will be expanded.
It may also 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 "#(shell-command)" Ta "First line of the command's output"
.It Li "#[attributes]" Ta "Colour or attribute change"
.It Li "##" Ta "A literal" Ql #
.El
.Pp
-The #(shell-command) form executes
-.Ql shell-command
-and inserts the first line of its output.
-Note that shell commands are only executed once at the interval specified by
-the
-.Ic status-interval
-option: if the status line is redrawn in the meantime, the previous result is
-used.
-Shell commands are executed with the
-.Nm
-global environment set (see the
-.Sx ENVIRONMENT
-section).
-.Pp
For details on how the names and titles can be set see the
.Sx "NAMES AND TITLES"
section.
@@ -3249,6 +3234,23 @@ a number and a colon, so
.Ql #{=10:pane_title}
will include at most the first 10 characters of the pane title.
.Pp
+In addition, the first line of a shell command's output may be inserted using
+.Ql #() .
+For example,
+.Ql #(uptime)
+will insert the system's uptime.
+When constructing formats,
+.Nm
+does not wait for
+.Ql #()
+commands to finish; instead, the previous result from running the same command is used,
+or a placeholder if the command has not been run before.
+Commands are executed with the
+.Nm
+global environment set (see the
+.Sx ENVIRONMENT
+section).
+.Pp
The following variables are available, where appropriate:
.Bl -column "XXXXXXXXXXXXXXXXXXX" "XXXXX"
.It Sy "Variable name" Ta Sy "Alias" Ta Sy "Replaced with"