Adjustment from feedback and slight touchups.

This commit is contained in:
Dane Jensen
2026-04-14 12:40:59 -07:00
parent f992c68fd8
commit 1bc85cb59e
4 changed files with 74 additions and 70 deletions

58
tmux.1
View File

@@ -3330,34 +3330,39 @@ but a different format may be specified with
.Op Fl H Ar height
.Op Fl l Ar size
.Op Fl m Ar message
.Op Fl M Ar mode
.Op Fl p Ar percentage
.Op Fl R Ar inactive-border-style
.Op Fl s Ar style
.Op Fl S Ar active-border-style
.Op Fl t Ar target-pane
.Op Fl T Ar type
.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 pane. The new pane may be floating by specifying the
.Ar type
with
.Fl Tf
/
.Fl Tfloating ,
or tiled into the layout by splitting an existing pane with
.Fl Tt
/
.Fl Ttiled .
Create a new pane.
A
.Ar mode
may be specified with the
.Fl M
option and must be followed by one of the following special values:
.Bl -column "XXXXX" -offset indent
.It Sy "Value" Ta Sy "Meaning"
.It Li "f" Ta "floating pane above the current layout"
.It Li "t" Ta "tiled into the layout by splitting a pane"
.El
.Pp
If no
.Ar mode
is specified,
.Ic f
is assumed.
When creating a tiled pane, a target pane may be specified with
.Fl t .
Note that some options are related to dimensions/layout. Those options will
only affect one creation
.Ar type
and will be in their own sections.
Note that some options will only affect one
.Ar mode .
.Pp
If
.Fl d
@@ -3374,8 +3379,8 @@ sets the border style when the pane is inactive (see
.Fl k
keeps the pane open after the optional
.Ar shell-command
exits and waits for a keypress (any non-mouse key) before closing it. The
message shown is controlled by the
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
@@ -3393,24 +3398,26 @@ The
flag (if
.Ar shell-command
is not specified or empty)
will create an empty pane and forward any output from stdin to it. For example:
will create an empty pane and forward any output from stdin to it.
For example:
.Bd -literal -offset indent
$ make 2>&1|tmux splitw \-dI &
.Ed
.Pp
For floating panes, the following flags are availible:
For floating panes, the following options are availible:
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. These four options may be followed by '%' to specify
a percentage of the current window dimensions.
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.
These four options may be followed by '%' to specify a percentage of the
current window dimensions.
.Pp
For tiled panes, the following flags are availible:
For tiled panes, the following options are availible:
.Fl h
does a horizontal split and
.Fl v
@@ -3783,7 +3790,8 @@ the command behaves like
.Op Ar shell-command Op Ar argument ...
.Xc
.D1 Pq alias: Ic splitw
Creates a new pane. Default behavior is to split the pane in a tiled layout.
Creates a new pane.
Default behavior is to split the pane in a tiled layout.
Shares behavior with
.Ic new-pane .
.Pp