| … | |
… | |
| 126 | . ds Ae AE |
126 | . ds Ae AE |
| 127 | .\} |
127 | .\} |
| 128 | .rm #[ #] #H #V #F C |
128 | .rm #[ #] #H #V #F C |
| 129 | .\" ======================================================================== |
129 | .\" ======================================================================== |
| 130 | .\" |
130 | .\" |
| 131 | .IX Title "rxvt 1" |
131 | .IX Title "@@RXVT_NAME@@ 1" |
| 132 | .TH rxvt 1 "2006-07-06" "7.7" "RXVT-UNICODE" |
132 | .TH @@RXVT_NAME@@ 1 "2006-07-06" "7.7" "RXVT-UNICODE" |
| 133 | .SH "NAME" |
133 | .SH "NAME" |
| 134 | rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) |
134 | rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) |
| 135 | .SH "SYNOPSIS" |
135 | .SH "SYNOPSIS" |
| 136 | .IX Header "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
| 137 | \&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]] |
137 | \&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]] |
| … | |
… | |
| 169 | because the author couldn't get \f(CW\*(C`mlterm\*(C'\fR to use one font for latin1 and |
169 | because the author couldn't get \f(CW\*(C`mlterm\*(C'\fR to use one font for latin1 and |
| 170 | another for japanese. |
170 | another for japanese. |
| 171 | .PP |
171 | .PP |
| 172 | Therefore another design rationale was the use of multiple fonts to |
172 | Therefore another design rationale was the use of multiple fonts to |
| 173 | display characters: The idea of a single unicode font which many other |
173 | display characters: The idea of a single unicode font which many other |
| 174 | programs force onto it's users never made sense to me: You should be able |
174 | programs force onto its users never made sense to me: You should be able |
| 175 | to choose any font for any script freely. |
175 | to choose any font for any script freely. |
| 176 | .PP |
176 | .PP |
| 177 | Apart from that, rxvt-unicode is also much better internationalised than |
177 | Apart from that, rxvt-unicode is also much better internationalised than |
| 178 | it's predecessor, supports things such as \s-1XFT\s0 and \s-1ISO\s0 14755 that are handy |
178 | its predecessor, supports things such as \s-1XFT\s0 and \s-1ISO\s0 14755 that are handy |
| 179 | in i18n\-environments, is faster, and has a lot less bugs than the original |
179 | in i18n\-environments, is faster, and has a lot less bugs than the original |
| 180 | rxvt. This all in addition to dozens of other small improvements. |
180 | rxvt. This all in addition to dozens of other small improvements. |
| 181 | .PP |
181 | .PP |
| 182 | It is still faithfully following the original rxvt idea of being lean |
182 | It is still faithfully following the original rxvt idea of being lean |
| 183 | and nice on resources: for example, you can still configure rxvt-unicode |
183 | and nice on resources: for example, you can still configure rxvt-unicode |
| 184 | without most of it's features to get a lean binary. It also comes with |
184 | without most of its features to get a lean binary. It also comes with |
| 185 | a client/daemon pair that lets you open any number of terminal windows |
185 | a client/daemon pair that lets you open any number of terminal windows |
| 186 | from within a single process, which makes startup time very fast and |
186 | from within a single process, which makes startup time very fast and |
| 187 | drastically reduces memory usage. See @@RXVT_NAME@@d(1) (daemon) and |
187 | drastically reduces memory usage. See @@RXVT_NAME@@d(1) (daemon) and |
| 188 | @@RXVT_NAME@@c(1) (client). |
188 | @@RXVT_NAME@@c(1) (client). |
| 189 | .PP |
189 | .PP |
| … | |
… | |
| 292 | that are checked in order when trying to find glyphs for characters. The |
292 | that are checked in order when trying to find glyphs for characters. The |
| 293 | first font defines the cell size for characters; other fonts might be |
293 | first font defines the cell size for characters; other fonts might be |
| 294 | smaller, but not (in general) larger. A (hopefully) reasonable default |
294 | smaller, but not (in general) larger. A (hopefully) reasonable default |
| 295 | font list is always appended to it. See resource \fBfont\fR for more details. |
295 | font list is always appended to it. See resource \fBfont\fR for more details. |
| 296 | .Sp |
296 | .Sp |
| 297 | In short, to specify an X11 core font, just specify it's name or prefix it |
297 | In short, to specify an X11 core font, just specify its name or prefix it |
| 298 | with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \f(CW\*(C`xft:\*(C'\fR, |
298 | with \f(CW\*(C`x:\*(C'\fR. To specify an XFT\-font, you need to prefix it with \f(CW\*(C`xft:\*(C'\fR, |
| 299 | e.g.: |
299 | e.g.: |
| 300 | .Sp |
300 | .Sp |
| 301 | .Vb 2 |
301 | .Vb 2 |
| 302 | \& @@RXVT_NAME@@ \-fn "xft:Bitstream Vera Sans Mono:pixelsize=15" |
302 | \& @@RXVT_NAME@@ \-fn "xft:Bitstream Vera Sans Mono:pixelsize=15" |
| … | |
… | |
| 493 | .IP "\fB\-keysym.\fR\fIsym\fR \fIstring\fR" 4 |
493 | .IP "\fB\-keysym.\fR\fIsym\fR \fIstring\fR" 4 |
| 494 | .IX Item "-keysym.sym string" |
494 | .IX Item "-keysym.sym string" |
| 495 | Remap a key symbol. See resource \fBkeysym\fR. |
495 | Remap a key symbol. See resource \fBkeysym\fR. |
| 496 | .IP "\fB\-embed\fR \fIwindowid\fR" 4 |
496 | .IP "\fB\-embed\fR \fIwindowid\fR" 4 |
| 497 | .IX Item "-embed windowid" |
497 | .IX Item "-embed windowid" |
| 498 | Tells @@RXVT_NAME@@ to embed it's windows into an already-existing window, |
498 | Tells @@RXVT_NAME@@ to embed its windows into an already-existing window, |
| 499 | which enables applications to easily embed a terminal. |
499 | which enables applications to easily embed a terminal. |
| 500 | .Sp |
500 | .Sp |
| 501 | Right now, @@RXVT_NAME@@ will first unmap/map the specified window, so it |
501 | Right now, @@RXVT_NAME@@ will first unmap/map the specified window, so it |
| 502 | shouldn't be a top-level window. @@RXVT_NAME@@ will also reconfigure it |
502 | shouldn't be a top-level window. @@RXVT_NAME@@ will also reconfigure it |
| 503 | quite a bit, so don't expect it to keep some specific state. It's best to |
503 | quite a bit, so don't expect it to keep some specific state. It's best to |
| … | |
… | |
| 1033 | \&\f(CW\*(C`\e000\*(C'\fR: octal number) or verbatim control characters (\f(CW\*(C`^?\*(C'\fR: delete, |
1033 | \&\f(CW\*(C`\e000\*(C'\fR: octal number) or verbatim control characters (\f(CW\*(C`^?\*(C'\fR: delete, |
| 1034 | \&\f(CW\*(C`^@\*(C'\fR: null, \f(CW\*(C`^A\*(C'\fR ...) and may be enclosed with double quotes so that it |
1034 | \&\f(CW\*(C`^@\*(C'\fR: null, \f(CW\*(C`^A\*(C'\fR ...) and may be enclosed with double quotes so that it |
| 1035 | can start or end with whitespace. |
1035 | can start or end with whitespace. |
| 1036 | .Sp |
1036 | .Sp |
| 1037 | Please note that you need to double the \f(CW\*(C`\e\*(C'\fR in resource files, as |
1037 | Please note that you need to double the \f(CW\*(C`\e\*(C'\fR in resource files, as |
| 1038 | Xlib itself does it's own de-escaping (you can use \f(CW\*(C`\e033\*(C'\fR instead of |
1038 | Xlib itself does its own de-escaping (you can use \f(CW\*(C`\e033\*(C'\fR instead of |
| 1039 | \&\f(CW\*(C`\ee\*(C'\fR (and so on), which will work with both Xt and @@RXVT_NAME@@'s own |
1039 | \&\f(CW\*(C`\ee\*(C'\fR (and so on), which will work with both Xt and @@RXVT_NAME@@'s own |
| 1040 | processing). |
1040 | processing). |
| 1041 | .Sp |
1041 | .Sp |
| 1042 | You can define a range of keysyms in one shot by providing a \fIstring\fR |
1042 | You can define a range of keysyms in one shot by providing a \fIstring\fR |
| 1043 | with pattern \fBlist/PREFIX/MIDDLE/SUFFIX\fR, where the delimeter `/' |
1043 | with pattern \fBlist/PREFIX/MIDDLE/SUFFIX\fR, where the delimeter `/' |
| … | |
… | |
| 1274 | This mode lets you input characters representing the keycap symbols of |
1274 | This mode lets you input characters representing the keycap symbols of |
| 1275 | your keyboard, if representable in the current locale encoding. |
1275 | your keyboard, if representable in the current locale encoding. |
| 1276 | .Sp |
1276 | .Sp |
| 1277 | Start by pressing \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR together, then releasing |
1277 | Start by pressing \f(CW\*(C`Control\*(C'\fR and \f(CW\*(C`Shift\*(C'\fR together, then releasing |
| 1278 | them. The next special key (cursor keys, home etc.) you enter will not |
1278 | them. The next special key (cursor keys, home etc.) you enter will not |
| 1279 | invoke it's usual function but instead will insert the corresponding |
1279 | invoke its usual function but instead will insert the corresponding |
| 1280 | keycap symbol. The symbol will only be entered when the key has been |
1280 | keycap symbol. The symbol will only be entered when the key has been |
| 1281 | released, otherwise pressing e.g. \f(CW\*(C`Shift\*(C'\fR would enter the symbol for |
1281 | released, otherwise pressing e.g. \f(CW\*(C`Shift\*(C'\fR would enter the symbol for |
| 1282 | \&\f(CW\*(C`ISO Level 2 Switch\*(C'\fR, although your intention might have been to enter a |
1282 | \&\f(CW\*(C`ISO Level 2 Switch\*(C'\fR, although your intention might have been to enter a |
| 1283 | reverse tab (Shift\-Tab). |
1283 | reverse tab (Shift\-Tab). |
| 1284 | .IP "\(bu" 4 |
1284 | .IP "\(bu" 4 |
| … | |
… | |
| 1414 | Set to the terminfo directory iff @@RXVT_NAME@@ was configured with |
1414 | Set to the terminfo directory iff @@RXVT_NAME@@ was configured with |
| 1415 | \&\f(CW\*(C`\-\-with\-terminfo=PATH\*(C'\fR. |
1415 | \&\f(CW\*(C`\-\-with\-terminfo=PATH\*(C'\fR. |
| 1416 | .IP "\fB\s-1DISPLAY\s0\fR" 4 |
1416 | .IP "\fB\s-1DISPLAY\s0\fR" 4 |
| 1417 | .IX Item "DISPLAY" |
1417 | .IX Item "DISPLAY" |
| 1418 | Used by @@RXVT_NAME@@ to connect to the display and set to the correct |
1418 | Used by @@RXVT_NAME@@ to connect to the display and set to the correct |
| 1419 | display in it's child processes. |
1419 | display in its child processes. |
| 1420 | .IP "\fB\s-1SHELL\s0\fR" 4 |
1420 | .IP "\fB\s-1SHELL\s0\fR" 4 |
| 1421 | .IX Item "SHELL" |
1421 | .IX Item "SHELL" |
| 1422 | The shell to be used for command execution, defaults to \f(CW\*(C`/bin/sh\*(C'\fR. |
1422 | The shell to be used for command execution, defaults to \f(CW\*(C`/bin/sh\*(C'\fR. |
| 1423 | .IP "\fB\s-1RXVT_SOCKET\s0\fR" 4 |
1423 | .IP "\fB\s-1RXVT_SOCKET\s0\fR" 4 |
| 1424 | .IX Item "RXVT_SOCKET" |
1424 | .IX Item "RXVT_SOCKET" |
