X-Git-Url: https://jasonwoof.com/gitweb/?p=st.git;a=blobdiff_plain;f=st.1;h=a9fec15b21365baa62c556c9b12ff43cd1c74730;hp=f1f41a7bc30923c8834f8101576f72d540d5d685;hb=d945d7093d1822bf249e2e38ce97e5b37f695fdb;hpb=86c5cb6de6644aeea3c480f66bdeb5e685aab86f diff --git a/st.1 b/st.1 index f1f41a7..a9fec15 100644 --- a/st.1 +++ b/st.1 @@ -1,32 +1,116 @@ -.TH ST 1 st-VERSION +.TH ST 1 st\-VERSION .SH NAME st \- simple terminal .SH SYNOPSIS .B st +.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 cmd ] +.IR command ...] .SH DESCRIPTION .B st is a simple terminal emulator. .SH OPTIONS .TP -.B \-t title -Overrides the default title (st) +.B \-a +disable alternate screens in terminal .TP -.B \-c class -Overrides the default class ($TERM) +.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 [=][{xX}][{+-}{+-}]. 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 standard output, then exits. +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 \-e cmd [arguments] -Execute cmd instead of the shell. Type your command as you would on your -shell. If this option is used, it -.BI "must be the last" -on the command-line. This is the same behaviour as xterm/rxvt. +.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.