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 |