X-Git-Url: https://jasonwoof.com/gitweb/?p=st.git;a=blobdiff_plain;f=st.1;h=a9fec15b21365baa62c556c9b12ff43cd1c74730;hp=4d00d2f6e139e4a463e1f0c8df1f774ecb8c7c63;hb=d945d7093d1822bf249e2e38ce97e5b37f695fdb;hpb=2080dfebeaf82c6426c9ec2708ec8d96a7af76bb diff --git a/st.1 b/st.1 index 4d00d2f..a9fec15 100644 --- a/st.1 +++ b/st.1 @@ -1,21 +1,116 @@ -.TH ST 1 st-VERSION +.TH ST 1 st\-VERSION .SH NAME st \- simple terminal .SH SYNOPSIS .B st -.RB [ \-e " "] -.RB [ \-t " "] +.RB [ \-a ] +.RB [ \-c +.IR class ] +.RB [ \-f +.IR font ] +.RB [ \-g +.IR geometry ] +.RB [ \-i ] +.RB [ \-o +.IR file ] +.RB [ \-t +.IR title ] +.RB [ \-w +.IR windowid ] .RB [ \-v ] +.RB [ \-e +.IR command ...] .SH DESCRIPTION .B st is a simple terminal emulator. .SH OPTIONS .TP -.B \-e <cmd> -Execute cmd instead of the shell +.B \-a +disable alternate screens in terminal .TP -.B \-t <title> -Overrides the default title (st) +.BI \-c " class" +defines the window class (default $TERM). .TP -.BI \-v -Prints version information to standard output, then exits. +.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 \-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 \-w " windowid" +embeds st within the window identified by +.I windowid +.TP +.B \-v +prints version information to stderr, then exits. +.TP +.BI \-e " program " [ " arguments " "... ]" +st executes +.I program +instead of the shell. If this is used it +.B must be the last option +on the command line, as in xterm / rxvt. +.SH SHORTCUTS +.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-Shift-Page Up +Increase font size. +.TP +.B Alt-Shift-Page Down +Decrease font size. +.TP +.B Alt-Shift-Home +Reset to default font size. +.TP +.B Shift-Insert +Paste from primary selection (middle mouse button). +.TP +.B Alt-Shift-Insert +Paste from clipboard selection. +.TP +.B Alt-Shift-c +Copy the selected text to the clipboard selection. +.TP +.B Alt-Shift-v +Paste from the clipboard selection. +.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) +.SH BUGS +See the TODO file in the distribution. +