Add tags for command aliases

Make ":tnew" work, i.e. bring the reader to the definition of the full
"new-window" command aliased as "new" just like ":tnew-window" would.

OK nicm
This commit is contained in:
kn 2021-10-08 06:37:39 +00:00
parent 5f63181ed5
commit 50a77f4417

75
tmux.1
View File

@ -1027,6 +1027,7 @@ section.
.Pp .Pp
The following commands are available to manage clients and sessions: The following commands are available to manage clients and sessions:
.Bl -tag -width Ds .Bl -tag -width Ds
.Tg attach
.It Xo Ic attach-session .It Xo Ic attach-session
.Op Fl dErx .Op Fl dErx
.Op Fl c Ar working-directory .Op Fl c Ar working-directory
@ -1113,6 +1114,7 @@ If
is used, the is used, the
.Ic update-environment .Ic update-environment
option will not be applied. option will not be applied.
.Tg detach
.It Xo Ic detach-client .It Xo Ic detach-client
.Op Fl aP .Op Fl aP
.Op Fl E Ar shell-command .Op Fl E Ar shell-command
@ -1139,6 +1141,7 @@ With
run run
.Ar shell-command .Ar shell-command
to replace the client. to replace the client.
.Tg has
.It Ic has-session Op Fl t Ar target-session .It Ic has-session Op Fl t Ar target-session
.D1 (alias: Ic has ) .D1 (alias: Ic has )
Report an error and exit with 1 if the specified session does not exist. Report an error and exit with 1 if the specified session does not exist.
@ -1160,6 +1163,7 @@ The
.Fl C .Fl C
flag clears alerts (bell, activity, or silence) in all windows linked to the flag clears alerts (bell, activity, or silence) in all windows linked to the
session. session.
.Tg lsc
.It Xo Ic list-clients .It Xo Ic list-clients
.Op Fl F Ar format .Op Fl F Ar format
.Op Fl t Ar target-session .Op Fl t Ar target-session
@ -1174,6 +1178,7 @@ section.
If If
.Ar target-session .Ar target-session
is specified, list only clients connected to that session. is specified, list only clients connected to that session.
.Tg lscm
.It Xo Ic list-commands .It Xo Ic list-commands
.Op Fl F Ar format .Op Fl F Ar format
.Op Ar command .Op Ar command
@ -1183,6 +1188,7 @@ List the syntax of
.Ar command .Ar command
or - if omitted - of all commands supported by or - if omitted - of all commands supported by
.Nm . .Nm .
.Tg ls
.It Xo Ic list-sessions .It Xo Ic list-sessions
.Op Fl F Ar format .Op Fl F Ar format
.Op Fl f Ar filter .Op Fl f Ar filter
@ -1197,6 +1203,7 @@ Only sessions for which the filter is true are shown.
See the See the
.Sx FORMATS .Sx FORMATS
section. section.
.Tg lockc
.It Ic lock-client Op Fl t Ar target-client .It Ic lock-client Op Fl t Ar target-client
.D1 (alias: Ic lockc ) .D1 (alias: Ic lockc )
Lock Lock
@ -1204,10 +1211,12 @@ Lock
see the see the
.Ic lock-server .Ic lock-server
command. command.
.Tg locks
.It Ic lock-session Op Fl t Ar target-session .It Ic lock-session Op Fl t Ar target-session
.D1 (alias: Ic locks ) .D1 (alias: Ic locks )
Lock all clients attached to Lock all clients attached to
.Ar target-session . .Ar target-session .
.Tg new
.It Xo Ic new-session .It Xo Ic new-session
.Op Fl AdDEPX .Op Fl AdDEPX
.Op Fl c Ar start-directory .Op Fl c Ar start-directory
@ -1327,6 +1336,7 @@ takes the form
.Ql VARIABLE=value .Ql VARIABLE=value
and sets an environment variable for the newly created session; it may be and sets an environment variable for the newly created session; it may be
specified multiple times. specified multiple times.
.Tg refresh
.It Xo Ic refresh-client .It Xo Ic refresh-client
.Op Fl cDlLRSU .Op Fl cDlLRSU
.Op Fl A Ar pane:state .Op Fl A Ar pane:state
@ -1462,6 +1472,7 @@ resets so that the position follows the cursor.
See the See the
.Ic window-size .Ic window-size
option. option.
.Tg rename
.It Xo Ic rename-session .It Xo Ic rename-session
.Op Fl t Ar target-session .Op Fl t Ar target-session
.Ar new-name .Ar new-name
@ -1469,6 +1480,7 @@ option.
.D1 (alias: Ic rename ) .D1 (alias: Ic rename )
Rename the session to Rename the session to
.Ar new-name . .Ar new-name .
.Tg showmsgs
.It Xo Ic show-messages .It Xo Ic show-messages
.Op Fl JT .Op Fl JT
.Op Fl t Ar target-client .Op Fl t Ar target-client
@ -1482,6 +1494,7 @@ server option.
and and
.Fl T .Fl T
show debugging information about jobs and terminals. show debugging information about jobs and terminals.
.Tg source
.It Xo Ic source-file .It Xo Ic source-file
.Op Fl Fnqv .Op Fl Fnqv
.Ar path .Ar path
@ -1508,6 +1521,7 @@ With
the file is parsed but no commands are executed. the file is parsed but no commands are executed.
.Fl v .Fl v
shows the parsed commands and line numbers if possible. shows the parsed commands and line numbers if possible.
.Tg start
.It Ic start-server .It Ic start-server
.D1 (alias: Ic start ) .D1 (alias: Ic start )
Start the Start the
@ -1524,6 +1538,7 @@ For example:
.Bd -literal -offset indent .Bd -literal -offset indent
$ tmux start \\; show -g $ tmux start \\; show -g
.Ed .Ed
.Tg suspendc
.It Xo Ic suspend-client .It Xo Ic suspend-client
.Op Fl t Ar target-client .Op Fl t Ar target-client
.Xc .Xc
@ -1531,6 +1546,7 @@ $ tmux start \\; show -g
Suspend a client by sending Suspend a client by sending
.Dv SIGTSTP .Dv SIGTSTP
(tty stop). (tty stop).
.Tg switchc
.It Xo Ic switch-client .It Xo Ic switch-client
.Op Fl ElnprZ .Op Fl ElnprZ
.Op Fl c Ar target-client .Op Fl c Ar target-client
@ -1921,6 +1937,7 @@ from which the layout was originally defined.
.Pp .Pp
Commands related to windows and panes are as follows: Commands related to windows and panes are as follows:
.Bl -tag -width Ds .Bl -tag -width Ds
.Tg breakp
.It Xo Ic break-pane .It Xo Ic break-pane
.Op Fl abdP .Op Fl abdP
.Op Fl F Ar format .Op Fl F Ar format
@ -1949,6 +1966,7 @@ By default, it uses the format
.Ql #{session_name}:#{window_index}.#{pane_index} .Ql #{session_name}:#{window_index}.#{pane_index}
but a different format may be specified with but a different format may be specified with
.Fl F . .Fl F .
.Tg capturep
.It Xo Ic capture-pane .It Xo Ic capture-pane
.Op Fl aepPqCJN .Op Fl aepPqCJN
.Op Fl b Ar buffer-name .Op Fl b Ar buffer-name
@ -2201,6 +2219,7 @@ specifies the format for each item in the tree.
starts without the option information. starts without the option information.
This command works only if at least one client is attached. This command works only if at least one client is attached.
.It Xo .It Xo
.Tg displayp
.Ic display-panes .Ic display-panes
.Op Fl bN .Op Fl bN
.Op Fl d Ar duration .Op Fl d Ar duration
@ -2241,6 +2260,7 @@ is "select-pane -t '%%'".
With With
.Fl b , .Fl b ,
other commands are not blocked from running until the indicator is closed. other commands are not blocked from running until the indicator is closed.
.Tg findw
.It Xo Ic find-window .It Xo Ic find-window
.Op Fl iCNrTZ .Op Fl iCNrTZ
.Op Fl t Ar target-pane .Op Fl t Ar target-pane
@ -2269,6 +2289,7 @@ The default is
zooms the pane. zooms the pane.
.Pp .Pp
This command works only if at least one client is attached. This command works only if at least one client is attached.
.Tg joinp
.It Xo Ic join-pane .It Xo Ic join-pane
.Op Fl bdfhv .Op Fl bdfhv
.Op Fl l Ar size .Op Fl l Ar size
@ -2298,6 +2319,7 @@ is omitted and a marked pane is present (see
.Ic select-pane .Ic select-pane
.Fl m ) , .Fl m ) ,
the marked pane is used rather than the current pane. the marked pane is used rather than the current pane.
.Tg killp
.It Xo Ic kill-pane .It Xo Ic kill-pane
.Op Fl a .Op Fl a
.Op Fl t Ar target-pane .Op Fl t Ar target-pane
@ -2309,6 +2331,7 @@ The
.Fl a .Fl a
option kills all but the pane given with option kills all but the pane given with
.Fl t . .Fl t .
.Tg killw
.It Xo Ic kill-window .It Xo Ic kill-window
.Op Fl a .Op Fl a
.Op Fl t Ar target-window .Op Fl t Ar target-window
@ -2321,6 +2344,7 @@ The
.Fl a .Fl a
option kills all but the window given with option kills all but the window given with
.Fl t . .Fl t .
.Tg lastp
.It Xo Ic last-pane .It Xo Ic last-pane
.Op Fl deZ .Op Fl deZ
.Op Fl t Ar target-window .Op Fl t Ar target-window
@ -2333,12 +2357,14 @@ keeps the window zoomed if it was zoomed.
enables or enables or
.Fl d .Fl d
disables input to the pane. disables input to the pane.
.Tg last
.It Ic last-window Op Fl t Ar target-session .It Ic last-window Op Fl t Ar target-session
.D1 (alias: Ic last ) .D1 (alias: Ic last )
Select the last (previously selected) window. Select the last (previously selected) window.
If no If no
.Ar target-session .Ar target-session
is specified, select the last window of the current session. is specified, select the last window of the current session.
.Tg link
.It Xo Ic link-window .It Xo Ic link-window
.Op Fl abdk .Op Fl abdk
.Op Fl s Ar src-window .Op Fl s Ar src-window
@ -2369,6 +2395,7 @@ exists, it is killed, otherwise an error is generated.
If If
.Fl d .Fl d
is given, the newly linked window is not selected. is given, the newly linked window is not selected.
.Tg lsp
.It Xo Ic list-panes .It Xo Ic list-panes
.Op Fl as .Op Fl as
.Op Fl F Ar format .Op Fl F Ar format
@ -2397,6 +2424,7 @@ Only panes for which the filter is true are shown.
See the See the
.Sx FORMATS .Sx FORMATS
section. section.
.Tg lsw
.It Xo Ic list-windows .It Xo Ic list-windows
.Op Fl a .Op Fl a
.Op Fl F Ar format .Op Fl F Ar format
@ -2417,6 +2445,7 @@ Only windows for which the filter is true are shown.
See the See the
.Sx FORMATS .Sx FORMATS
section. section.
.Tg movep
.It Xo Ic move-pane .It Xo Ic move-pane
.Op Fl bdfhv .Op Fl bdfhv
.Op Fl l Ar size .Op Fl l Ar size
@ -2426,6 +2455,7 @@ section.
.D1 (alias: Ic movep ) .D1 (alias: Ic movep )
Does the same as Does the same as
.Ic join-pane . .Ic join-pane .
.Tg movew
.It Xo Ic move-window .It Xo Ic move-window
.Op Fl abrdk .Op Fl abrdk
.Op Fl s Ar src-window .Op Fl s Ar src-window
@ -2444,6 +2474,7 @@ all windows in the session are renumbered in sequential order, respecting
the the
.Ic base-index .Ic base-index
option. option.
.Tg neww
.It Xo Ic new-window .It Xo Ic new-window
.Op Fl abdkPS .Op Fl abdkPS
.Op Fl c Ar start-directory .Op Fl c Ar start-directory
@ -2526,9 +2557,11 @@ By default, it uses the format
.Ql #{session_name}:#{window_index} .Ql #{session_name}:#{window_index}
but a different format may be specified with but a different format may be specified with
.Fl F . .Fl F .
.Tg nextl
.It Ic next-layout Op Fl t Ar target-window .It Ic next-layout Op Fl t Ar target-window
.D1 (alias: Ic nextl ) .D1 (alias: Ic nextl )
Move a window to the next layout and rearrange the panes to fit. Move a window to the next layout and rearrange the panes to fit.
.Tg next
.It Xo Ic next-window .It Xo Ic next-window
.Op Fl a .Op Fl a
.Op Fl t Ar target-session .Op Fl t Ar target-session
@ -2538,6 +2571,7 @@ Move to the next window in the session.
If If
.Fl a .Fl a
is used, move to the next window with an alert. is used, move to the next window with an alert.
.Tg pipep
.It Xo Ic pipe-pane .It Xo Ic pipe-pane
.Op Fl IOo .Op Fl IOo
.Op Fl t Ar target-pane .Op Fl t Ar target-pane
@ -2586,11 +2620,13 @@ be toggled with a single key, for example:
.Bd -literal -offset indent .Bd -literal -offset indent
bind-key C-p pipe-pane -o 'cat >>~/output.#I-#P' bind-key C-p pipe-pane -o 'cat >>~/output.#I-#P'
.Ed .Ed
.Tg prevl
.It Xo Ic previous-layout .It Xo Ic previous-layout
.Op Fl t Ar target-window .Op Fl t Ar target-window
.Xc .Xc
.D1 (alias: Ic prevl ) .D1 (alias: Ic prevl )
Move to the previous layout in the session. Move to the previous layout in the session.
.Tg prev
.It Xo Ic previous-window .It Xo Ic previous-window
.Op Fl a .Op Fl a
.Op Fl t Ar target-session .Op Fl t Ar target-session
@ -2600,6 +2636,7 @@ Move to the previous window in the session.
With With
.Fl a , .Fl a ,
move to the previous window with an alert. move to the previous window with an alert.
.Tg renamew
.It Xo Ic rename-window .It Xo Ic rename-window
.Op Fl t Ar target-window .Op Fl t Ar target-window
.Ar new-name .Ar new-name
@ -2609,6 +2646,7 @@ Rename the current window, or the window at
.Ar target-window .Ar target-window
if specified, to if specified, to
.Ar new-name . .Ar new-name .
.Tg resizep
.It Xo Ic resize-pane .It Xo Ic resize-pane
.Op Fl DLMRTUZ .Op Fl DLMRTUZ
.Op Fl t Ar target-pane .Op Fl t Ar target-pane
@ -2653,6 +2691,7 @@ begins mouse resizing (only valid if bound to a mouse key binding, see
.Fl T .Fl T
trims all lines below the current cursor position and moves lines out of the trims all lines below the current cursor position and moves lines out of the
history to replace them. history to replace them.
.Tg resizew
.It Xo Ic resize-window .It Xo Ic resize-window
.Op Fl aADLRU .Op Fl aADLRU
.Op Fl t Ar target-window .Op Fl t Ar target-window
@ -2685,6 +2724,7 @@ the size of the smallest.
This command will automatically set This command will automatically set
.Ic window-size .Ic window-size
to manual in the window options. to manual in the window options.
.Tg respawnp
.It Xo Ic respawn-pane .It Xo Ic respawn-pane
.Op Fl k .Op Fl k
.Op Fl c Ar start-directory .Op Fl c Ar start-directory
@ -2710,6 +2750,7 @@ The
option has the same meaning as for the option has the same meaning as for the
.Ic new-window .Ic new-window
command. command.
.Tg respawnw
.It Xo Ic respawn-window .It Xo Ic respawn-window
.Op Fl k .Op Fl k
.Op Fl c Ar start-directory .Op Fl c Ar start-directory
@ -2735,6 +2776,7 @@ The
option has the same meaning as for the option has the same meaning as for the
.Ic new-window .Ic new-window
command. command.
.Tg rotatew
.It Xo Ic rotate-window .It Xo Ic rotate-window
.Op Fl DUZ .Op Fl DUZ
.Op Fl t Ar target-window .Op Fl t Ar target-window
@ -2746,6 +2788,7 @@ lower) with
or downward (numerically higher). or downward (numerically higher).
.Fl Z .Fl Z
keeps the window zoomed if it was zoomed. keeps the window zoomed if it was zoomed.
.Tg selectl
.It Xo Ic select-layout .It Xo Ic select-layout
.Op Fl Enop .Op Fl Enop
.Op Fl t Ar target-pane .Op Fl t Ar target-pane
@ -2768,6 +2811,7 @@ commands.
applies the last set layout if possible (undoes the most recent layout change). applies the last set layout if possible (undoes the most recent layout change).
.Fl E .Fl E
spreads the current pane and any panes next to it out evenly. spreads the current pane and any panes next to it out evenly.
.Tg selectp
.It Xo Ic select-pane .It Xo Ic select-pane
.Op Fl DdeLlMmRUZ .Op Fl DdeLlMmRUZ
.Op Fl T Ar title .Op Fl T Ar title
@ -2812,6 +2856,7 @@ to
.Ic swap-pane .Ic swap-pane
and and
.Ic swap-window . .Ic swap-window .
.Tg selectw
.It Xo Ic select-window .It Xo Ic select-window
.Op Fl lnpT .Op Fl lnpT
.Op Fl t Ar target-window .Op Fl t Ar target-window
@ -2834,6 +2879,7 @@ If
is given and the selected window is already the current window, is given and the selected window is already the current window,
the command behaves like the command behaves like
.Ic last-window . .Ic last-window .
.Tg splitw
.It Xo Ic split-window .It Xo Ic split-window
.Op Fl bdfhIvPZ .Op Fl bdfhIvPZ
.Op Fl c Ar start-directory .Op Fl c Ar start-directory
@ -2894,6 +2940,7 @@ $ make 2>&1|tmux splitw -dI &
All other options have the same meaning as for the All other options have the same meaning as for the
.Ic new-window .Ic new-window
command. command.
.Tg swapp
.It Xo Ic swap-pane .It Xo Ic swap-pane
.Op Fl dDUZ .Op Fl dDUZ
.Op Fl s Ar src-pane .Op Fl s Ar src-pane
@ -2922,6 +2969,7 @@ is omitted and a marked pane is present (see
.Ic select-pane .Ic select-pane
.Fl m ) , .Fl m ) ,
the marked pane is used rather than the current pane. the marked pane is used rather than the current pane.
.Tg swapw
.It Xo Ic swap-window .It Xo Ic swap-window
.Op Fl d .Op Fl d
.Op Fl s Ar src-window .Op Fl s Ar src-window
@ -2943,6 +2991,7 @@ is omitted and a marked pane is present (see
.Ic select-pane .Ic select-pane
.Fl m ) , .Fl m ) ,
the window containing the marked pane is used rather than the current window. the window containing the marked pane is used rather than the current window.
.Tg unlinkw
.It Xo Ic unlink-window .It Xo Ic unlink-window
.Op Fl k .Op Fl k
.Op Fl t Ar target-window .Op Fl t Ar target-window
@ -3013,6 +3062,7 @@ key will execute for all keys which do not have a more specific binding.
.Pp .Pp
Commands related to key bindings are as follows: Commands related to key bindings are as follows:
.Bl -tag -width Ds .Bl -tag -width Ds
.Tg bind
.It Xo Ic bind-key .It Xo Ic bind-key
.Op Fl nr .Op Fl nr
.Op Fl N Ar note .Op Fl N Ar note
@ -3071,6 +3121,7 @@ attaches a note to the key (shown with
To view the default bindings and possible commands, see the To view the default bindings and possible commands, see the
.Ic list-keys .Ic list-keys
command. command.
.Tg lsk
.It Xo Ic list-keys .It Xo Ic list-keys
.Op Fl 1aN .Op Fl 1aN
.Op Fl P Ar prefix-string Fl T Ar key-table .Op Fl P Ar prefix-string Fl T Ar key-table
@ -3106,6 +3157,7 @@ specifies a prefix to print before each key and
lists only the first matching key. lists only the first matching key.
.Fl a .Fl a
lists the command for keys that do not have a note rather than skipping them. lists the command for keys that do not have a note rather than skipping them.
.Tg send
.It Xo Ic send-keys .It Xo Ic send-keys
.Op Fl FHlMRX .Op Fl FHlMRX
.Op Fl N Ar repeat-count .Op Fl N Ar repeat-count
@ -3157,6 +3209,7 @@ expands formats in arguments where appropriate.
Send the prefix key, or with Send the prefix key, or with
.Fl 2 .Fl 2
the secondary prefix key, to a window as if it was pressed. the secondary prefix key, to a window as if it was pressed.
.Tg unbind
.It Xo Ic unbind-key .It Xo Ic unbind-key
.Op Fl anq .Op Fl anq
.Op Fl T Ar key-table .Op Fl T Ar key-table
@ -3252,6 +3305,7 @@ abc123
.Pp .Pp
Commands which set options are as follows: Commands which set options are as follows:
.Bl -tag -width Ds .Bl -tag -width Ds
.Tg set
.It Xo Ic set-option .It Xo Ic set-option
.Op Fl aFgopqsuUw .Op Fl aFgopqsuUw
.Op Fl t Ar target-pane .Op Fl t Ar target-pane
@ -3326,6 +3380,7 @@ blue foreground.
Without Without
.Fl a , .Fl a ,
the result would be the default background and a blue foreground. the result would be the default background and a blue foreground.
.Tg show
.It Xo Ic show-options .It Xo Ic show-options
.Op Fl AgHpqsvw .Op Fl AgHpqsvw
.Op Fl t Ar target-pane .Op Fl t Ar target-pane
@ -5303,6 +5358,7 @@ section).
.Pp .Pp
Commands to alter and view the environment are: Commands to alter and view the environment are:
.Bl -tag -width Ds .Bl -tag -width Ds
.Tg setenv
.It Xo Ic set-environment .It Xo Ic set-environment
.Op Fl Fhgru .Op Fl Fhgru
.Op Fl t Ar target-session .Op Fl t Ar target-session
@ -5328,6 +5384,7 @@ indicates the variable is to be removed from the environment before starting a
new process. new process.
.Fl h .Fl h
marks the variable as hidden. marks the variable as hidden.
.Tg showenv
.It Xo Ic show-environment .It Xo Ic show-environment
.Op Fl hgs .Op Fl hgs
.Op Fl t Ar target-session .Op Fl t Ar target-session
@ -5412,6 +5469,7 @@ session option.
.Pp .Pp
Commands related to the status line are as follows: Commands related to the status line are as follows:
.Bl -tag -width Ds .Bl -tag -width Ds
.Tg clrphist
.It Xo Ic clear-prompt-history .It Xo Ic clear-prompt-history
.Op Fl T Ar prompt-type .Op Fl T Ar prompt-type
.Xc .Xc
@ -5534,6 +5592,7 @@ With
.Fl b , .Fl b ,
the prompt is shown in the background and the invoking client does not exit the prompt is shown in the background and the invoking client does not exit
until it is dismissed. until it is dismissed.
.Tg confirm
.It Xo Ic confirm-before .It Xo Ic confirm-before
.Op Fl b .Op Fl b
.Op Fl p Ar prompt .Op Fl p Ar prompt
@ -5556,6 +5615,7 @@ With
.Fl b , .Fl b ,
the prompt is shown in the background and the invoking client does not exit the prompt is shown in the background and the invoking client does not exit
until it is dismissed. until it is dismissed.
.Tg menu
.It Xo Ic display-menu .It Xo Ic display-menu
.Op Fl O .Op Fl O
.Op Fl c Ar target-client .Op Fl c Ar target-client
@ -5647,6 +5707,7 @@ The following keys are also available:
.It Li "Down" Ta "Select next item" .It Li "Down" Ta "Select next item"
.It Li "q" Ta "Exit menu" .It Li "q" Ta "Exit menu"
.El .El
.Tg display
.It Xo Ic display-message .It Xo Ic display-message
.Op Fl aINpv .Op Fl aINpv
.Op Fl c Ar target-client .Op Fl c Ar target-client
@ -5688,6 +5749,7 @@ lists the format variables and their values.
.Fl I .Fl I
forwards any input read from stdin to the empty pane given by forwards any input read from stdin to the empty pane given by
.Ar target-pane . .Ar target-pane .
.Tg popup
.It Xo Ic display-popup .It Xo Ic display-popup
.Op Fl BCE .Op Fl BCE
.Op Fl c Ar target-client .Op Fl c Ar target-client
@ -5735,6 +5797,7 @@ does not surround the popup by a border.
The The
.Fl C .Fl C
flag closes any popup on the client. flag closes any popup on the client.
.Tg showphist
.It Xo Ic show-prompt-history .It Xo Ic show-prompt-history
.Op Fl T Ar prompt-type .Op Fl T Ar prompt-type
.Xc .Xc
@ -5864,14 +5927,17 @@ a format for each shortcut key; both are evaluated once for each line.
.Fl N .Fl N
starts without the preview. starts without the preview.
This command works only if at least one client is attached. This command works only if at least one client is attached.
.Tg clearhist
.It Ic clear-history Op Fl t Ar target-pane .It Ic clear-history Op Fl t Ar target-pane
.D1 (alias: Ic clearhist ) .D1 (alias: Ic clearhist )
Remove and free the history for the specified pane. Remove and free the history for the specified pane.
.Tg deleteb
.It Ic delete-buffer Op Fl b Ar buffer-name .It Ic delete-buffer Op Fl b Ar buffer-name
.D1 (alias: Ic deleteb ) .D1 (alias: Ic deleteb )
Delete the buffer named Delete the buffer named
.Ar buffer-name , .Ar buffer-name ,
or the most recently added automatically named buffer if not specified. or the most recently added automatically named buffer if not specified.
.Tg lsb
.It Xo Ic list-buffers .It Xo Ic list-buffers
.Op Fl F Ar format .Op Fl F Ar format
.Op Fl f Ar filter .Op Fl f Ar filter
@ -5892,6 +5958,7 @@ section.
.Op Fl t Ar target-client .Op Fl t Ar target-client
.Ar path .Ar path
.Xc .Xc
.Tg loadb
.D1 (alias: Ic loadb ) .D1 (alias: Ic loadb )
Load the contents of the specified paste buffer from Load the contents of the specified paste buffer from
.Ar path . .Ar path .
@ -5902,6 +5969,7 @@ is given, the buffer is also sent to the clipboard for
using the using the
.Xr xterm 1 .Xr xterm 1
escape sequence, if possible. escape sequence, if possible.
.Tg pasteb
.It Xo Ic paste-buffer .It Xo Ic paste-buffer
.Op Fl dpr .Op Fl dpr
.Op Fl b Ar buffer-name .Op Fl b Ar buffer-name
@ -5926,6 +5994,7 @@ If
.Fl p .Fl p
is specified, paste bracket control codes are inserted around the is specified, paste bracket control codes are inserted around the
buffer if the application has requested bracketed paste mode. buffer if the application has requested bracketed paste mode.
.Tg saveb
.It Xo Ic save-buffer .It Xo Ic save-buffer
.Op Fl a .Op Fl a
.Op Fl b Ar buffer-name .Op Fl b Ar buffer-name
@ -5941,6 +6010,7 @@ option appends to rather than overwriting the file.
.Op Fl aw .Op Fl aw
.Op Fl b Ar buffer-name .Op Fl b Ar buffer-name
.Op Fl t Ar target-client .Op Fl t Ar target-client
.Tg setb
.Op Fl n Ar new-buffer-name .Op Fl n Ar new-buffer-name
.Ar data .Ar data
.Xc .Xc
@ -5961,6 +6031,7 @@ The
.Fl n .Fl n
option renames the buffer to option renames the buffer to
.Ar new-buffer-name . .Ar new-buffer-name .
.Tg showb
.It Xo Ic show-buffer .It Xo Ic show-buffer
.Op Fl b Ar buffer-name .Op Fl b Ar buffer-name
.Xc .Xc
@ -5972,6 +6043,7 @@ Miscellaneous commands are as follows:
.Bl -tag -width Ds .Bl -tag -width Ds
.It Ic clock-mode Op Fl t Ar target-pane .It Ic clock-mode Op Fl t Ar target-pane
Display a large clock. Display a large clock.
.Tg if
.It Xo Ic if-shell .It Xo Ic if-shell
.Op Fl bF .Op Fl bF
.Op Fl t Ar target-pane .Op Fl t Ar target-pane
@ -6003,11 +6075,13 @@ is given,
.Ar shell-command .Ar shell-command
is not executed but considered success if neither empty nor zero (after formats is not executed but considered success if neither empty nor zero (after formats
are expanded). are expanded).
.Tg lock
.It Ic lock-server .It Ic lock-server
.D1 (alias: Ic lock ) .D1 (alias: Ic lock )
Lock each client individually by running the command specified by the Lock each client individually by running the command specified by the
.Ic lock-command .Ic lock-command
option. option.
.Tg run
.It Xo Ic run-shell .It Xo Ic run-shell
.Op Fl bC .Op Fl bC
.Op Fl d Ar delay .Op Fl d Ar delay
@ -6041,6 +6115,7 @@ specified by
.Fl t .Fl t
or the current pane if omitted) after the command finishes. or the current pane if omitted) after the command finishes.
If the command fails, the exit status is also displayed. If the command fails, the exit status is also displayed.
.Tg wait
.It Xo Ic wait-for .It Xo Ic wait-for
.Op Fl L | S | U .Op Fl L | S | U
.Ar channel .Ar channel