mirror of
https://github.com/tmux/tmux.git
synced 2026-03-26 13:16:37 +00:00
Update tmux.1 man page to add new-pane floating pane section.
This commit is contained in:
78
tmux.1
78
tmux.1
@@ -298,6 +298,8 @@ Prompt for a window index to select.
|
|||||||
Switch the attached client to the previous session.
|
Switch the attached client to the previous session.
|
||||||
.It \&)
|
.It \&)
|
||||||
Switch the attached client to the next session.
|
Switch the attached client to the next session.
|
||||||
|
.It *
|
||||||
|
Create a new floating pane.
|
||||||
.It ,
|
.It ,
|
||||||
Rename the current window.
|
Rename the current window.
|
||||||
.It -
|
.It -
|
||||||
@@ -3265,6 +3267,76 @@ 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 newp
|
||||||
|
.It Xo Ic new-pane
|
||||||
|
.Op Fl bdefIPZ
|
||||||
|
.Op Fl c Ar start-directory
|
||||||
|
.Op Fl e Ar environment
|
||||||
|
.Op Fl F Ar format
|
||||||
|
.Op Fl h Ar height
|
||||||
|
.Op Fl k
|
||||||
|
.Op Fl l Ar size
|
||||||
|
.Op Fl m Ar message
|
||||||
|
.Op Fl p Ar percentage
|
||||||
|
.Op Fl t Ar target-pane
|
||||||
|
.Op Fl w Ar width
|
||||||
|
.Op Fl x Ar x-position
|
||||||
|
.Op Fl y Ar y-position
|
||||||
|
.Op Ar shell-command Op Ar argument ...
|
||||||
|
.Xc
|
||||||
|
.D1 Pq alias: Ic newp
|
||||||
|
Create a new floating pane.
|
||||||
|
The
|
||||||
|
.Fl w ,
|
||||||
|
.Fl h ,
|
||||||
|
.Fl x ,
|
||||||
|
and
|
||||||
|
.Fl y
|
||||||
|
options set the width, height, and position of the pane; if not given,
|
||||||
|
the pane is sized to half the window dimensions and offset from the
|
||||||
|
previous floating pane.
|
||||||
|
The
|
||||||
|
.Fl l
|
||||||
|
and
|
||||||
|
.Fl p
|
||||||
|
options set the size in lines or as a percentage.
|
||||||
|
The
|
||||||
|
.Fl f
|
||||||
|
option uses the full window dimensions.
|
||||||
|
.Pp
|
||||||
|
If
|
||||||
|
.Fl d
|
||||||
|
is given, the session does not make the new pane the current pane.
|
||||||
|
.Fl Z
|
||||||
|
zooms if the window is not zoomed.
|
||||||
|
.Pp
|
||||||
|
.Fl k
|
||||||
|
keeps the pane open after the shell command exits and waits for a
|
||||||
|
keypress (any non-mouse key) before closing it.
|
||||||
|
The message shown is controlled by the
|
||||||
|
.Ic remain-on-exit-format
|
||||||
|
option.
|
||||||
|
.Fl m Ar message
|
||||||
|
is equivalent to
|
||||||
|
.Fl k
|
||||||
|
but also sets the
|
||||||
|
.Ic remain-on-exit-format
|
||||||
|
option for this pane to
|
||||||
|
.Ar message .
|
||||||
|
.Pp
|
||||||
|
An empty
|
||||||
|
.Ar shell-command
|
||||||
|
(\[aq]\[aq]) will create a pane with no command running in it.
|
||||||
|
The
|
||||||
|
.Fl I
|
||||||
|
flag (if
|
||||||
|
.Ar shell-command
|
||||||
|
is not specified or empty)
|
||||||
|
will create an empty pane and forward any output from stdin to it.
|
||||||
|
.Pp
|
||||||
|
All other options have the same meaning as for the
|
||||||
|
.Ic new-window
|
||||||
|
command.
|
||||||
.Tg nextl
|
.Tg nextl
|
||||||
.It Ic next-layout Op Fl t Ar target-window
|
.It Ic next-layout Op Fl t Ar target-window
|
||||||
.D1 Pq alias: Ic nextl
|
.D1 Pq alias: Ic nextl
|
||||||
@@ -5571,13 +5643,17 @@ uses when the colour with that index is requested.
|
|||||||
The index may be from zero to 255.
|
The index may be from zero to 255.
|
||||||
.Pp
|
.Pp
|
||||||
.It Xo Ic remain-on-exit
|
.It Xo Ic remain-on-exit
|
||||||
.Op Ic on | off | failed
|
.Op Ic on | off | failed | keypress
|
||||||
.Xc
|
.Xc
|
||||||
A pane with this flag set is not destroyed when the program running in it
|
A pane with this flag set is not destroyed when the program running in it
|
||||||
exits.
|
exits.
|
||||||
If set to
|
If set to
|
||||||
.Ic failed ,
|
.Ic failed ,
|
||||||
then only when the program exit status is not zero.
|
then only when the program exit status is not zero.
|
||||||
|
If set to
|
||||||
|
.Ic keypress ,
|
||||||
|
the pane stays open and closes when the user presses any key (other than
|
||||||
|
a mouse button or paste).
|
||||||
The pane may be reactivated with the
|
The pane may be reactivated with the
|
||||||
.Ic respawn-pane
|
.Ic respawn-pane
|
||||||
command.
|
command.
|
||||||
|
|||||||
Reference in New Issue
Block a user