| st.1 - st - simple terminal | |
| git clone git://git.suckless.org/st | |
| Log | |
| Files | |
| Refs | |
| README | |
| LICENSE | |
| --- | |
| st.1 (3581B) | |
| --- | |
| 1 .TH ST 1 st\-VERSION | |
| 2 .SH NAME | |
| 3 st \- simple terminal | |
| 4 .SH SYNOPSIS | |
| 5 .B st | |
| 6 .RB [ \-aiv ] | |
| 7 .RB [ \-c | |
| 8 .IR class ] | |
| 9 .RB [ \-f | |
| 10 .IR font ] | |
| 11 .RB [ \-g | |
| 12 .IR geometry ] | |
| 13 .RB [ \-n | |
| 14 .IR name ] | |
| 15 .RB [ \-o | |
| 16 .IR iofile ] | |
| 17 .RB [ \-T | |
| 18 .IR title ] | |
| 19 .RB [ \-t | |
| 20 .IR title ] | |
| 21 .RB [ \-l | |
| 22 .IR line ] | |
| 23 .RB [ \-w | |
| 24 .IR windowid ] | |
| 25 .RB [[ \-e ] | |
| 26 .IR command | |
| 27 .RI [ arguments ...]] | |
| 28 .PP | |
| 29 .B st | |
| 30 .RB [ \-aiv ] | |
| 31 .RB [ \-c | |
| 32 .IR class ] | |
| 33 .RB [ \-f | |
| 34 .IR font ] | |
| 35 .RB [ \-g | |
| 36 .IR geometry ] | |
| 37 .RB [ \-n | |
| 38 .IR name ] | |
| 39 .RB [ \-o | |
| 40 .IR iofile ] | |
| 41 .RB [ \-T | |
| 42 .IR title ] | |
| 43 .RB [ \-t | |
| 44 .IR title ] | |
| 45 .RB [ \-w | |
| 46 .IR windowid ] | |
| 47 .RB \-l | |
| 48 .IR line | |
| 49 .RI [ stty_args ...] | |
| 50 .SH DESCRIPTION | |
| 51 .B st | |
| 52 is a simple terminal emulator. | |
| 53 .SH OPTIONS | |
| 54 .TP | |
| 55 .B \-a | |
| 56 disable alternate screens in terminal | |
| 57 .TP | |
| 58 .BI \-c " class" | |
| 59 defines the window class (default $TERM). | |
| 60 .TP | |
| 61 .BI \-f " font" | |
| 62 defines the | |
| 63 .I font | |
| 64 to use when st is run. | |
| 65 .TP | |
| 66 .BI \-g " geometry" | |
| 67 defines the X11 geometry string. | |
| 68 The form is [=][<cols>{xX}<rows>][{+-}<xoffset>{+-}<yoffset>]. See | |
| 69 .BR XParseGeometry (3) | |
| 70 for further details. | |
| 71 .TP | |
| 72 .B \-i | |
| 73 will fixate the position given with the -g option. | |
| 74 .TP | |
| 75 .BI \-n " name" | |
| 76 defines the window instance name (default $TERM). | |
| 77 .TP | |
| 78 .BI \-o " iofile" | |
| 79 writes all the I/O to | |
| 80 .I iofile. | |
| 81 This feature is useful when recording st sessions. A value of "-" means | |
| 82 standard output. | |
| 83 .TP | |
| 84 .BI \-T " title" | |
| 85 defines the window title (default 'st'). | |
| 86 .TP | |
| 87 .BI \-t " title" | |
| 88 defines the window title (default 'st'). | |
| 89 .TP | |
| 90 .BI \-w " windowid" | |
| 91 embeds st within the window identified by | |
| 92 .I windowid | |
| 93 .TP | |
| 94 .BI \-l " line" | |
| 95 use a tty | |
| 96 .I line | |
| 97 instead of a pseudo terminal. | |
| 98 .I line | |
| 99 should be a (pseudo-)serial device (e.g. /dev/ttyS0 on Linux for serial … | |
| 100 0). | |
| 101 When this flag is given | |
| 102 remaining arguments are used as flags for | |
| 103 .BR stty(1). | |
| 104 By default st initializes the serial line to 8 bits, no parity, 1 stop b… | |
| 105 and a 38400 baud rate. The speed is set by appending it as last argument | |
| 106 (e.g. 'st -l /dev/ttyS0 115200'). Arguments before the last one are | |
| 107 .BR stty(1) | |
| 108 flags. If you want to set odd parity on 115200 baud use for example 'st … | |
| 109 /dev/ttyS0 parenb parodd 115200'. Set the number of bits by using for | |
| 110 example 'st -l /dev/ttyS0 cs7 115200'. See | |
| 111 .BR stty(1) | |
| 112 for more arguments and cases. | |
| 113 .TP | |
| 114 .B \-v | |
| 115 prints version information to stderr, then exits. | |
| 116 .TP | |
| 117 .BI \-e " command " [ " arguments " "... ]" | |
| 118 st executes | |
| 119 .I command | |
| 120 instead of the shell. If this is used it | |
| 121 .B must be the last option | |
| 122 on the command line, as in xterm / rxvt. | |
| 123 This option is only intended for compatibility, | |
| 124 and all the remaining arguments are used as a command | |
| 125 even without it. | |
| 126 .SH SHORTCUTS | |
| 127 .TP | |
| 128 .B Break | |
| 129 Send a break in the serial line. | |
| 130 Break key is obtained in PC keyboards | |
| 131 pressing at the same time control and pause. | |
| 132 .TP | |
| 133 .B Ctrl-Print Screen | |
| 134 Toggle if st should print to the | |
| 135 .I iofile. | |
| 136 .TP | |
| 137 .B Shift-Print Screen | |
| 138 Print the full screen to the | |
| 139 .I iofile. | |
| 140 .TP | |
| 141 .B Print Screen | |
| 142 Print the selection to the | |
| 143 .I iofile. | |
| 144 .TP | |
| 145 .B Ctrl-Shift-Page Up | |
| 146 Increase font size. | |
| 147 .TP | |
| 148 .B Ctrl-Shift-Page Down | |
| 149 Decrease font size. | |
| 150 .TP | |
| 151 .B Ctrl-Shift-Home | |
| 152 Reset to default font size. | |
| 153 .TP | |
| 154 .B Ctrl-Shift-y | |
| 155 Paste from primary selection (middle mouse button). | |
| 156 .TP | |
| 157 .B Ctrl-Shift-c | |
| 158 Copy the selected text to the clipboard selection. | |
| 159 .TP | |
| 160 .B Ctrl-Shift-v | |
| 161 Paste from the clipboard selection. | |
| 162 .SH CUSTOMIZATION | |
| 163 .B st | |
| 164 can be customized by creating a custom config.h and (re)compiling the so… | |
| 165 code. This keeps it fast, secure and simple. | |
| 166 .SH AUTHORS | |
| 167 See the LICENSE file for the authors. | |
| 168 .SH LICENSE | |
| 169 See the LICENSE file for the terms of redistribution. | |
| 170 .SH SEE ALSO | |
| 171 .BR tabbed (1), | |
| 172 .BR utmp (1), | |
| 173 .BR stty (1), | |
| 174 .BR scroll (1) | |
| 175 .SH BUGS | |
| 176 See the TODO file in the distribution. | |
| 177 |