created manual
This commit is contained in:
parent
1f143f00ad
commit
21bd6f40ca
1 changed files with 167 additions and 0 deletions
167
man/remux.1
Normal file
167
man/remux.1
Normal file
|
|
@ -0,0 +1,167 @@
|
|||
.Dd $Mdocdate$
|
||||
.Dt REMUX 1
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm remux
|
||||
.Nd a command shortener for
|
||||
.Xr tmux 1
|
||||
.Sh SYNOPSIS
|
||||
.Nm remux
|
||||
.Op Fl dhnqrtv
|
||||
.Op command
|
||||
.Op args...
|
||||
.Sh DESCRIPTION
|
||||
.Nm
|
||||
is a wrapper and command shortener for
|
||||
.Xr tmux 1 ,
|
||||
primarily focused on improving the ergonomics of using named sessions.
|
||||
.Pp
|
||||
If no command is provided, remux will use the context action. Inside a repository, remux will attach or create. If in a session or outside a repository, remux will list sessions.
|
||||
.Sh COMMANDS
|
||||
.Nm remux
|
||||
commands are split into two categories: global commands, which can be used anywhere, and session commands, which can only be used from inside a session.
|
||||
.Ss GLOBAL COMMANDS
|
||||
.Bl -tag -width Ds
|
||||
.It Xo Ic attach
|
||||
.Op Fl dnr
|
||||
.Op Ar title
|
||||
.Op Ar window
|
||||
.Xc
|
||||
.Bd -literal -compact
|
||||
aliases: a
|
||||
Attaches to an existing session.
|
||||
.Ed
|
||||
.Pp
|
||||
.Bl -tag -width Ds -compact
|
||||
.It Fl d , Fl -detach
|
||||
Detach all other connections to the session.
|
||||
.It Fl n , Fl -nest
|
||||
Allow nesting (attaching a session from inside another session).
|
||||
.It Fl r , Fl -read-only
|
||||
Attach the session in read-only mode.
|
||||
.It Ar title
|
||||
The title of the target session. If not given, remux will try to use the name of the repository containing the current directory.
|
||||
.It Ar window
|
||||
The name of the window to attach to.
|
||||
.El
|
||||
.It Xo Ic detach
|
||||
.Op Ar title
|
||||
.Xc
|
||||
.Bd -literal -compact
|
||||
aliases: d
|
||||
Detaches all clients from the target session.
|
||||
.Ed
|
||||
.It Xo Ic has
|
||||
.Op Fl q
|
||||
.Op Ar title
|
||||
.Xc
|
||||
.Bd -literal -compact
|
||||
aliases: h
|
||||
Checks whether or not a session exists.
|
||||
.Ed
|
||||
.Pp
|
||||
.Bl -tag -width Ds -compact
|
||||
.It Fl q , Fl -quiet
|
||||
Run silently without printing to standard output.
|
||||
.It Ar title
|
||||
The title of the target session. If not given, remux will attempt to use the name of the repository containing the current directory.
|
||||
.El
|
||||
.It Ic list
|
||||
.Bd -literal -compact
|
||||
aliases: l, ls
|
||||
Pretty-prints a list of tmux sessions.
|
||||
.Ed
|
||||
.It Xo Ic new
|
||||
.Op Fl dn
|
||||
.Op Fl t\ |\ --target Ar path
|
||||
.Op Ar title
|
||||
.Op Ar command
|
||||
.Xc
|
||||
.Bd -literal -compact
|
||||
aliases: n
|
||||
Creates a new session.
|
||||
.Ed
|
||||
.Pp
|
||||
.Bl -tag -width Ds -compact
|
||||
.It Fl d , Fl -detach
|
||||
Creates the session without attaching.
|
||||
.It Fl n , Fl -nest
|
||||
Allow nesting (attaching a session from inside another session).
|
||||
.It Fl t , Fl -target Ar path
|
||||
Sets the session path to the provided directory.
|
||||
.It Ar title
|
||||
Create the session with the given title. If not given, remux will attempt to use the name of the repository containing the current directory.
|
||||
.El
|
||||
.El
|
||||
.Ss SESSION COMMANDS
|
||||
.Bl -tag -width Ds
|
||||
.It Ic path
|
||||
.Bd -literal -compact
|
||||
aliases: p
|
||||
Prints the session path.
|
||||
.Ed
|
||||
.It Xo Ic switch
|
||||
.Op Fl r , Fl -read-only
|
||||
.Ar title
|
||||
.Xc
|
||||
.Bd -literal -compact
|
||||
aliases: s
|
||||
Switches from the current session to the target.
|
||||
.Ed
|
||||
.Pp
|
||||
.Bl -tag -width Ds -compact
|
||||
.It Fl r , Fl -read-only
|
||||
Switch to the target session in read-only mode.
|
||||
.It Ar title
|
||||
The title of the session to switch to.
|
||||
.El
|
||||
.It Ic title
|
||||
.Bd -literal -compact
|
||||
aliases: t, which
|
||||
Prints the session title.
|
||||
.El
|
||||
.Sh ENVIRONMENT
|
||||
.Bl -tag -width Ds
|
||||
.It Ev REMUX_ATTACH_SYMBOL
|
||||
Changes the symbol displayed for attached sessions in the
|
||||
.Ic list
|
||||
command.
|
||||
Default: '*'
|
||||
.It Ev REMUX_CURRENT_SYMBOL
|
||||
Changes the symbol displayed for the current session in the
|
||||
.Ic list
|
||||
command.
|
||||
Default: '>'
|
||||
.It Ev REMUX_NEW_WINDOW
|
||||
Provides a default windows name when creating a new session. Unused if empty.
|
||||
Default: (unset)
|
||||
.El
|
||||
.Sh EXIT STATUS
|
||||
.Bl -tag -Width Ds
|
||||
.It 1
|
||||
Unmatched command name.
|
||||
.It 2
|
||||
Unmatched target session.
|
||||
.It 3
|
||||
Unmatched help topic.
|
||||
.It 4
|
||||
Missing or invalid target; target was not given or is the same as the current session.
|
||||
.It 5
|
||||
.Nm remux
|
||||
is not running from within a terminal.
|
||||
.It 6
|
||||
Nesting error; nest flag is missing or inappropriate.
|
||||
.It 7
|
||||
A session command was attempted outside a session.
|
||||
.Sh EXAMPLES
|
||||
Use
|
||||
.Ic path
|
||||
to navigate to the session path:
|
||||
.Pp
|
||||
.Dl $ cd `remux p`
|
||||
.Pp
|
||||
.Sh SEE ALSO
|
||||
.Xr tmux 1
|
||||
.Sh AUTHORS
|
||||
.An -nosplit
|
||||
.An Valerie Wolfe Aq Mt sleeplessval@gmail.com
|
||||
Loading…
Reference in a new issue