version 1.430, 2015/05/12 15:29:29 |
version 1.431, 2015/05/27 13:28:04 |
|
|
It may also contain any of the following special character sequences: |
It may also contain any of the following special character sequences: |
.Bl -column "Character pair" "Replaced with" -offset indent |
.Bl -column "Character pair" "Replaced with" -offset indent |
.It Sy "Character pair" Ta Sy "Replaced with" |
.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 "#[attributes]" Ta "Colour or attribute change" |
.It Li "##" Ta "A literal" Ql # |
.It Li "##" Ta "A literal" Ql # |
.El |
.El |
.Pp |
.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 |
For details on how the names and titles can be set see the |
.Sx "NAMES AND TITLES" |
.Sx "NAMES AND TITLES" |
section. |
section. |
|
|
a number and a colon, so |
a number and a colon, so |
.Ql #{=10:pane_title} |
.Ql #{=10:pane_title} |
will include at most the first 10 characters of the 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 |
.Pp |
The following variables are available, where appropriate: |
The following variables are available, where appropriate: |
.Bl -column "XXXXXXXXXXXXXXXXXXX" "XXXXX" |
.Bl -column "XXXXXXXXXXXXXXXXXXX" "XXXXX" |