mirror of
https://github.com/LukeSmithxyz/st.git
synced 2024-11-25 00:15:46 +01:00
194 lines
4 KiB
Groff
194 lines
4 KiB
Groff
.TH ST 1 st\-VERSION
|
|
.SH NAME
|
|
st \- simple terminal (Luke Smith (https://lukesmith.xyz)'s build)
|
|
.SH SYNOPSIS
|
|
.B st
|
|
.RB [ \-aiv ]
|
|
.RB [ \-c
|
|
.IR class ]
|
|
.RB [ \-f
|
|
.IR font ]
|
|
.RB [ \-g
|
|
.IR geometry ]
|
|
.RB [ \-n
|
|
.IR name ]
|
|
.RB [ \-o
|
|
.IR iofile ]
|
|
.RB [ \-T
|
|
.IR title ]
|
|
.RB [ \-t
|
|
.IR title ]
|
|
.RB [ \-l
|
|
.IR line ]
|
|
.RB [ \-w
|
|
.IR windowid ]
|
|
.RB [[ \-e ]
|
|
.IR command
|
|
.RI [ arguments ...]]
|
|
.PP
|
|
.B st
|
|
.RB [ \-aiv ]
|
|
.RB [ \-c
|
|
.IR class ]
|
|
.RB [ \-f
|
|
.IR font ]
|
|
.RB [ \-g
|
|
.IR geometry ]
|
|
.RB [ \-n
|
|
.IR name ]
|
|
.RB [ \-o
|
|
.IR iofile ]
|
|
.RB [ \-T
|
|
.IR title ]
|
|
.RB [ \-t
|
|
.IR title ]
|
|
.RB [ \-w
|
|
.IR windowid ]
|
|
.RB \-l
|
|
.IR line
|
|
.RI [ stty_args ...]
|
|
.SH DESCRIPTION
|
|
.B st
|
|
is a simple terminal emulator.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-a
|
|
disable alternate screens in terminal
|
|
.TP
|
|
.BI \-c " class"
|
|
defines the window class (default $TERM).
|
|
.TP
|
|
.BI \-f " font"
|
|
defines the
|
|
.I font
|
|
to use when st is run.
|
|
.TP
|
|
.BI \-g " geometry"
|
|
defines the X11 geometry string.
|
|
The form is [=][<cols>{xX}<rows>][{+-}<xoffset>{+-}<yoffset>]. See
|
|
.BR XParseGeometry (3)
|
|
for further details.
|
|
.TP
|
|
.B \-i
|
|
will fixate the position given with the -g option.
|
|
.TP
|
|
.BI \-n " name"
|
|
defines the window instance name (default $TERM).
|
|
.TP
|
|
.BI \-o " iofile"
|
|
writes all the I/O to
|
|
.I iofile.
|
|
This feature is useful when recording st sessions. A value of "-" means
|
|
standard output.
|
|
.TP
|
|
.BI \-T " title"
|
|
defines the window title (default 'st').
|
|
.TP
|
|
.BI \-t " title"
|
|
defines the window title (default 'st').
|
|
.TP
|
|
.BI \-w " windowid"
|
|
embeds st within the window identified by
|
|
.I windowid
|
|
.TP
|
|
.BI \-l " line"
|
|
use a tty
|
|
.I line
|
|
instead of a pseudo terminal.
|
|
.I line
|
|
should be a (pseudo-)serial device (e.g. /dev/ttyS0 on Linux for serial port
|
|
0).
|
|
When this flag is given
|
|
remaining arguments are used as flags for
|
|
.BR stty(1).
|
|
By default st initializes the serial line to 8 bits, no parity, 1 stop bit
|
|
and a 38400 baud rate. The speed is set by appending it as last argument
|
|
(e.g. 'st -l /dev/ttyS0 115200'). Arguments before the last one are
|
|
.BR stty(1)
|
|
flags. If you want to set odd parity on 115200 baud use for example 'st -l
|
|
/dev/ttyS0 parenb parodd 115200'. Set the number of bits by using for
|
|
example 'st -l /dev/ttyS0 cs7 115200'. See
|
|
.BR stty(1)
|
|
for more arguments and cases.
|
|
.TP
|
|
.B \-v
|
|
prints version information to stderr, then exits.
|
|
.TP
|
|
.BI \-e " command " [ " arguments " "... ]"
|
|
st executes
|
|
.I command
|
|
instead of the shell. If this is used it
|
|
.B must be the last option
|
|
on the command line, as in xterm / rxvt.
|
|
This option is only intended for compatibility,
|
|
and all the remaining arguments are used as a command
|
|
even without it.
|
|
.SH SHORTCUTS
|
|
.TP
|
|
.B Alt-j/k or Alt-Up/Down or Alt-Mouse Wheel
|
|
Scroll up/down one line at a time.
|
|
.TP
|
|
.B Alt-u/d or Alt-Page Up/Page Down
|
|
Scroll up/down one screen at a time.
|
|
.TP
|
|
.B Alt-Shift-k/j or Alt-Shift-Page Up/Page Down or Alt-Shift-Mouse Wheel
|
|
Increase or decrease font size.
|
|
.TP
|
|
.B Alt-Home
|
|
Reset to default font size.
|
|
.TP
|
|
.B Shift-Insert or Alt-v
|
|
Paste from clipboard.
|
|
.TP
|
|
.B Alt-c
|
|
Copy to clipboard.
|
|
.TP
|
|
.B Alt-p
|
|
Paste/input primary selection.
|
|
.TP
|
|
.B Alt-l
|
|
Show dmenu menu of all URLs on screen and choose one to open.
|
|
.TP
|
|
.B Alt-y
|
|
Show dmenu menu of all URLs on screen and choose one to copy.
|
|
.TP
|
|
.B Alt-o
|
|
Show dmenu menu of all recently run commands and copy the output of the chosen command to the clipboard.
|
|
.I xclip
|
|
required.
|
|
.TP
|
|
.B Break
|
|
Send a break in the serial line.
|
|
Break key is obtained in PC keyboards
|
|
pressing at the same time control and pause.
|
|
.TP
|
|
.B Ctrl-Print Screen
|
|
Toggle if st should print to the
|
|
.I iofile.
|
|
.TP
|
|
.B Shift-Print Screen
|
|
Print the full screen to the
|
|
.I iofile.
|
|
.TP
|
|
.B Print Screen
|
|
Print the selection to the
|
|
.I iofile.
|
|
.TP
|
|
.B Alt-Ctrl
|
|
Launch dmenu to enter a unicode codepoint and send the corresponding glyph
|
|
to st.
|
|
.SH CUSTOMIZATION
|
|
.B st
|
|
can be customized by creating a custom config.h and (re)compiling the source
|
|
code. This keeps it fast, secure and simple.
|
|
.SH AUTHORS
|
|
See the LICENSE file for the authors.
|
|
.SH LICENSE
|
|
See the LICENSE file for the terms of redistribution.
|
|
.SH SEE ALSO
|
|
.BR tabbed (1),
|
|
.BR utmp (1),
|
|
.BR stty (1)
|
|
.SH BUGS
|
|
See the TODO file in the distribution.
|
|
|