Add ability to float a tiled pane to break-pane, from Dane Jensen.

This commit is contained in:
nicm
2026-06-26 10:02:01 +00:00
parent dd2fef6673
commit d0bf3bf06d
5 changed files with 159 additions and 39 deletions

40
tmux.1
View File

@@ -2690,11 +2690,15 @@ Commands related to windows and panes are as follows:
.Bl -tag -width Ds
.Tg breakp
.It Xo Ic break\-pane
.Op Fl abdP
.Op Fl abdPW
.Op Fl F Ar format
.Op Fl n Ar window\-name
.Op Fl s Ar src\-pane
.Op Fl t Ar dst\-window
.Op Fl x Ar width
.Op Fl y Ar height
.Op Fl X Ar x-position
.Op Fl Y Ar y-position
.Xc
.D1 Pq alias: Ic breakp
Break
@@ -2717,6 +2721,40 @@ By default, it uses the format
.Ql #{session_name}:#{window_index}.#{pane_index}
but a different format may be specified with
.Fl F .
.Pp
If the
.Fl W
option is given,
.Ar src\-pane
is lifted out of the tiled layout and made floating.
The
.Fl x
and
.Fl y
options set the width and height of the floating pane in columns and lines
respectively.
The default is half the window width and a quarter the window height.
The
.Fl X
and
.Fl Y
options set the position of the upper-left corner of the pane.
If omitted, new floating panes are cascaded from the top-left of the window.
.Pp
If the pane had previously been floating, the position and sizes are restored
from the saved values not specified by the
.Fl x ,
.Fl y ,
.Fl X ,
and
.Fl Y
options.
.Pp
If
.Fl d
is given, the active pane is not changed.
The pane must not already be floating or hidden, and the window must not
be zoomed.
.Tg capturep
.It Xo Ic capture\-pane
.Op Fl aeFHLpPqCJMN