src/usr.bin/tmux/tmux.1 - diff

Return to tmux.1 CVS log

Up to [local] / src / usr.bin / tmux

Diff for /src/usr.bin/tmux/tmux.1 between version 1.430 and 1.431

-version 1.430, 2015/05/12 15:29:29
+version 1.431, 2015/05/27 13:28:04
 Line 2662
 Line 2662
 Line 2662
  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.
-Line 3244
+Line 3229
 Line 3244
 Line 3229
  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"