1 | .\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) |
1 | .\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) |
2 | .\" |
2 | .\" |
3 | .\" Standard preamble: |
3 | .\" Standard preamble: |
4 | .\" ======================================================================== |
4 | .\" ======================================================================== |
5 | .de Sp \" Vertical space (when we can't use .PP) |
5 | .de Sp \" Vertical space (when we can't use .PP) |
6 | .if t .sp .5v |
6 | .if t .sp .5v |
… | |
… | |
36 | .el\{\ |
36 | .el\{\ |
37 | . ds -- \|\(em\| |
37 | . ds -- \|\(em\| |
38 | . ds PI \(*p |
38 | . ds PI \(*p |
39 | . ds L" `` |
39 | . ds L" `` |
40 | . ds R" '' |
40 | . ds R" '' |
41 | . ds C` |
|
|
42 | . ds C' |
|
|
43 | 'br\} |
41 | 'br\} |
44 | .\" |
42 | .\" |
45 | .\" Escape single quotes in literal strings from groff's Unicode transform. |
43 | .\" Escape single quotes in literal strings from groff's Unicode transform. |
46 | .ie \n(.g .ds Aq \(aq |
44 | .ie \n(.g .ds Aq \(aq |
47 | .el .ds Aq ' |
45 | .el .ds Aq ' |
48 | .\" |
46 | .\" |
49 | .\" If the F register is turned on, we'll generate index entries on stderr for |
47 | .\" If the F register is turned on, we'll generate index entries on stderr for |
50 | .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index |
48 | .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index |
51 | .\" entries marked with X<> in POD. Of course, you'll have to process the |
49 | .\" entries marked with X<> in POD. Of course, you'll have to process the |
52 | .\" output yourself in some meaningful fashion. |
50 | .\" output yourself in some meaningful fashion. |
53 | .\" |
51 | .ie \nF \{\ |
54 | .\" Avoid warning from groff about undefined register 'F'. |
|
|
55 | .de IX |
52 | . de IX |
|
|
53 | . tm Index:\\$1\t\\n%\t"\\$2" |
56 | .. |
54 | .. |
57 | .nr rF 0 |
55 | . nr % 0 |
58 | .if \n(.g .if rF .nr rF 1 |
56 | . rr F |
59 | .if (\n(rF:(\n(.g==0)) \{ |
57 | .\} |
60 | . if \nF \{ |
58 | .el \{\ |
61 | . de IX |
59 | . de IX |
62 | . tm Index:\\$1\t\\n%\t"\\$2" |
|
|
63 | .. |
60 | .. |
64 | . if !\nF==2 \{ |
|
|
65 | . nr % 0 |
|
|
66 | . nr F 2 |
|
|
67 | . \} |
|
|
68 | . \} |
|
|
69 | .\} |
61 | .\} |
70 | .rr rF |
|
|
71 | .\" |
62 | .\" |
72 | .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
63 | .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). |
73 | .\" Fear. Run. Save yourself. No user-serviceable parts. |
64 | .\" Fear. Run. Save yourself. No user-serviceable parts. |
74 | . \" fudge factors for nroff and troff |
65 | . \" fudge factors for nroff and troff |
75 | .if n \{\ |
66 | .if n \{\ |
… | |
… | |
131 | .\} |
122 | .\} |
132 | .rm #[ #] #H #V #F C |
123 | .rm #[ #] #H #V #F C |
133 | .\" ======================================================================== |
124 | .\" ======================================================================== |
134 | .\" |
125 | .\" |
135 | .IX Title "@@RXVT_NAME@@ 7" |
126 | .IX Title "@@RXVT_NAME@@ 7" |
136 | .TH @@RXVT_NAME@@ 7 "2014-12-26" "@@RXVT_VERSION@@" "RXVT-UNICODE" |
127 | .TH @@RXVT_NAME@@ 7 "2014-12-31" "@@RXVT_VERSION@@" "RXVT-UNICODE" |
137 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
128 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
138 | .\" way too many mistakes in technical documents. |
129 | .\" way too many mistakes in technical documents. |
139 | .if n .ad l |
130 | .if n .ad l |
140 | .nh |
131 | .nh |
141 | .SH "NAME" |
132 | .SH "NAME" |
… | |
… | |
152 | \& # set window title |
143 | \& # set window title |
153 | \& printf \*(Aq\e33]2;%s\e007\*(Aq "new window title" |
144 | \& printf \*(Aq\e33]2;%s\e007\*(Aq "new window title" |
154 | .Ve |
145 | .Ve |
155 | .SH "DESCRIPTION" |
146 | .SH "DESCRIPTION" |
156 | .IX Header "DESCRIPTION" |
147 | .IX Header "DESCRIPTION" |
157 | This document contains the \s-1FAQ,\s0 the \s-1RXVT TECHNICAL REFERENCE\s0 documenting |
148 | This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting |
158 | all escape sequences, and other background information. |
149 | all escape sequences, and other background information. |
159 | .PP |
150 | .PP |
160 | The newest version of this document is also available on the World Wide Web at |
151 | The newest version of this document is also available on the World Wide Web at |
161 | <http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.7.pod>. |
152 | http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.7.pod <http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod>. |
162 | .PP |
153 | .PP |
163 | The main manual page for @@RXVT_NAME@@ itself is available at |
154 | The main manual page for @@RXVT_NAME@@ itself is available at |
164 | <http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.1.pod>. |
155 | http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.1.pod <http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod>. |
165 | .SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" |
156 | .SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" |
166 | .IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" |
157 | .IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" |
167 | .SS "Meta, Features & Commandline Issues" |
158 | .SS "Meta, Features & Commandline Issues" |
168 | .IX Subsection "Meta, Features & Commandline Issues" |
159 | .IX Subsection "Meta, Features & Commandline Issues" |
169 | \fIMy question isn't answered here, can I ask a human?\fR |
160 | \fIMy question isn't answered here, can I ask a human?\fR |
170 | .IX Subsection "My question isn't answered here, can I ask a human?" |
161 | .IX Subsection "My question isn't answered here, can I ask a human?" |
171 | .PP |
162 | .PP |
172 | Before sending me mail, you could go to \s-1IRC: \s0\f(CW\*(C`irc.freenode.net\*(C'\fR, |
163 | Before sending me mail, you could go to \s-1IRC:\s0 \f(CW\*(C`irc.freenode.net\*(C'\fR, |
173 | channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be |
164 | channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be |
174 | interested in learning about new and exciting problems (but not FAQs :). |
165 | interested in learning about new and exciting problems (but not FAQs :). |
175 | .PP |
166 | .PP |
176 | \fII use Gentoo, and I have a problem...\fR |
167 | \fII use Gentoo, and I have a problem...\fR |
177 | .IX Subsection "I use Gentoo, and I have a problem..." |
168 | .IX Subsection "I use Gentoo, and I have a problem..." |
… | |
… | |
255 | existing daemon. |
246 | existing daemon. |
256 | .PP |
247 | .PP |
257 | \fIHow do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc.\fR |
248 | \fIHow do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc.\fR |
258 | .IX Subsection "How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc." |
249 | .IX Subsection "How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc." |
259 | .PP |
250 | .PP |
260 | The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\*(R",\s0 |
251 | The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", |
261 | so you can check and see if that is set. Note that several programs, \s-1JED,\s0 |
252 | so you can check and see if that is set. Note that several programs, \s-1JED\s0, |
262 | slrn, Midnight Commander automatically check this variable to decide |
253 | slrn, Midnight Commander automatically check this variable to decide |
263 | whether or not to use colour. |
254 | whether or not to use colour. |
264 | .PP |
255 | .PP |
265 | \fIHow do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?\fR |
256 | \fIHow do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?\fR |
266 | .IX Subsection "How do I set the correct, full IP address for the DISPLAY variable?" |
257 | .IX Subsection "How do I set the correct, full IP address for the DISPLAY variable?" |
267 | .PP |
258 | .PP |
268 | If you've compiled rxvt-unicode with \s-1DISPLAY_IS_IP\s0 and have enabled |
259 | If you've compiled rxvt-unicode with \s-1DISPLAY_IS_IP\s0 and have enabled |
269 | insecure mode then it is possible to use the following shell script |
260 | insecure mode then it is possible to use the following shell script |
270 | snippets to correctly set the display. If your version of rxvt-unicode |
261 | snippets to correctly set the display. If your version of rxvt-unicode |
271 | wasn't also compiled with \s-1ESCZ_ANSWER \s0(as assumed in these snippets) then |
262 | wasn't also compiled with \s-1ESCZ_ANSWER\s0 (as assumed in these snippets) then |
272 | the \s-1COLORTERM\s0 variable can be used to distinguish rxvt-unicode from a |
263 | the \s-1COLORTERM\s0 variable can be used to distinguish rxvt-unicode from a |
273 | regular xterm. |
264 | regular xterm. |
274 | .PP |
265 | .PP |
275 | Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script |
266 | Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script |
276 | snippets: |
267 | snippets: |
… | |
… | |
328 | encoding tables, which, if unused, take up disk space but nothing else |
319 | encoding tables, which, if unused, take up disk space but nothing else |
329 | and can be compiled out unless you rely on X11 core fonts that use those |
320 | and can be compiled out unless you rely on X11 core fonts that use those |
330 | encodings. The \s-1BSS\s0 size comes from the 64k emergency buffer that my c++ |
321 | encodings. The \s-1BSS\s0 size comes from the 64k emergency buffer that my c++ |
331 | compiler allocates (but of course doesn't use unless you are out of |
322 | compiler allocates (but of course doesn't use unless you are out of |
332 | memory). Also, using an xft font instead of a core font immediately adds a |
323 | memory). Also, using an xft font instead of a core font immediately adds a |
333 | few megabytes of \s-1RSS.\s0 Xft indeed is responsible for a lot of \s-1RSS\s0 even when |
324 | few megabytes of \s-1RSS\s0. Xft indeed is responsible for a lot of \s-1RSS\s0 even when |
334 | not used. |
325 | not used. |
335 | .PP |
326 | .PP |
336 | Of course, due to every character using two or four bytes instead of one, |
327 | Of course, due to every character using two or four bytes instead of one, |
337 | a large scrollback buffer will ultimately make rxvt-unicode use more |
328 | a large scrollback buffer will ultimately make rxvt-unicode use more |
338 | memory. |
329 | memory. |
… | |
… | |
358 | domain sockets, which are all less portable than \*(C+ itself. |
349 | domain sockets, which are all less portable than \*(C+ itself. |
359 | .PP |
350 | .PP |
360 | Regarding the bloat, see the above question: It's easy to write programs |
351 | Regarding the bloat, see the above question: It's easy to write programs |
361 | in C that use gobs of memory, and certainly possible to write programs in |
352 | in C that use gobs of memory, and certainly possible to write programs in |
362 | \&\*(C+ that don't. \*(C+ also often comes with large libraries, but this is |
353 | \&\*(C+ that don't. \*(C+ also often comes with large libraries, but this is |
363 | not necessarily the case with \s-1GCC.\s0 Here is what rxvt links against on my |
354 | not necessarily the case with \s-1GCC\s0. Here is what rxvt links against on my |
364 | system with a minimal config: |
355 | system with a minimal config: |
365 | .PP |
356 | .PP |
366 | .Vb 4 |
357 | .Vb 4 |
367 | \& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) |
358 | \& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) |
368 | \& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) |
359 | \& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) |
… | |
… | |
555 | color0\-7 are the low-intensity colours. |
546 | color0\-7 are the low-intensity colours. |
556 | .PP |
547 | .PP |
557 | color8\-15 are the corresponding high-intensity colours. |
548 | color8\-15 are the corresponding high-intensity colours. |
558 | .PP |
549 | .PP |
559 | \fII don't like the screen colours. How do I change them?\fR |
550 | \fII don't like the screen colours. How do I change them?\fR |
560 | .IX Subsection "I don't like the screen colours. How do I change them?" |
551 | .IX Subsection "I don't like the screen colours. How do I change them?" |
561 | .PP |
552 | .PP |
562 | You can change the screen colours at run-time using \fI~/.Xdefaults\fR |
553 | You can change the screen colours at run-time using \fI~/.Xdefaults\fR |
563 | resources (or as long-options). |
554 | resources (or as long-options). |
564 | .PP |
555 | .PP |
565 | Here are values that are supposed to resemble a \s-1VGA\s0 screen, |
556 | Here are values that are supposed to resemble a \s-1VGA\s0 screen, |
… | |
… | |
711 | \&\fBperl-ext-common\fR resource to the empty string, which also keeps |
702 | \&\fBperl-ext-common\fR resource to the empty string, which also keeps |
712 | rxvt-unicode from initialising perl, saving memory. |
703 | rxvt-unicode from initialising perl, saving memory. |
713 | .PP |
704 | .PP |
714 | If you only want to disable specific features, you first have to |
705 | If you only want to disable specific features, you first have to |
715 | identify which perl extension is responsible. For this, read the section |
706 | identify which perl extension is responsible. For this, read the section |
716 | \&\fB\s-1PREPACKAGED EXTENSIONS\s0\fR in the @@URXVT_NAME@@\fIperl\fR\|(3) manpage. For |
707 | \&\fB\s-1PREPACKAGED\s0 \s-1EXTENSIONS\s0\fR in the @@URXVT_NAME@@\fIperl\fR\|(3) manpage. For |
717 | example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify |
708 | example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify |
718 | this \fBperl-ext-common\fR resource: |
709 | this \fBperl-ext-common\fR resource: |
719 | .PP |
710 | .PP |
720 | .Vb 1 |
711 | .Vb 1 |
721 | \& URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup |
712 | \& URxvt.perl\-ext\-common: default,\-selection\-popup,\-option\-popup |
… | |
… | |
776 | .PP |
767 | .PP |
777 | If it still doesn't work, then maybe your input method doesn't support |
768 | If it still doesn't work, then maybe your input method doesn't support |
778 | compose sequences \- to fall back to the built-in one, make sure you don't |
769 | compose sequences \- to fall back to the built-in one, make sure you don't |
779 | specify an input method via \f(CW\*(C`\-im\*(C'\fR or \f(CW\*(C`XMODIFIERS\*(C'\fR. |
770 | specify an input method via \f(CW\*(C`\-im\*(C'\fR or \f(CW\*(C`XMODIFIERS\*(C'\fR. |
780 | .PP |
771 | .PP |
781 | \fII cannot type \f(CI\*(C`Ctrl\-Shift\-2\*(C'\fI to get an \s-1ASCII NUL\s0 character due to \s-1ISO 14755\s0\fR |
772 | \fII cannot type \f(CI\*(C`Ctrl\-Shift\-2\*(C'\fI to get an \s-1ASCII\s0 \s-1NUL\s0 character due to \s-1ISO\s0 14755\fR |
782 | .IX Subsection "I cannot type Ctrl-Shift-2 to get an ASCII NUL character due to ISO 14755" |
773 | .IX Subsection "I cannot type Ctrl-Shift-2 to get an ASCII NUL character due to ISO 14755" |
783 | .PP |
774 | .PP |
784 | Either try \f(CW\*(C`Ctrl\-2\*(C'\fR alone (it often is mapped to \s-1ASCII NUL\s0 even on |
775 | Either try \f(CW\*(C`Ctrl\-2\*(C'\fR alone (it often is mapped to \s-1ASCII\s0 \s-1NUL\s0 even on |
785 | international keyboards) or simply use \s-1ISO 14755\s0 support to your |
776 | international keyboards) or simply use \s-1ISO\s0 14755 support to your |
786 | advantage, typing <Ctrl\-Shift\-0> to get a \s-1ASCII NUL.\s0 This works for other |
777 | advantage, typing <Ctrl\-Shift\-0> to get a \s-1ASCII\s0 \s-1NUL\s0. This works for other |
787 | codes, too, such as \f(CW\*(C`Ctrl\-Shift\-1\-d\*(C'\fR to type the default telnet escape |
778 | codes, too, such as \f(CW\*(C`Ctrl\-Shift\-1\-d\*(C'\fR to type the default telnet escape |
788 | character and so on. |
779 | character and so on. |
789 | .PP |
780 | .PP |
790 | \fIMouse cut/paste suddenly no longer works.\fR |
781 | \fIMouse cut/paste suddenly no longer works.\fR |
791 | .IX Subsection "Mouse cut/paste suddenly no longer works." |
782 | .IX Subsection "Mouse cut/paste suddenly no longer works." |
… | |
… | |
837 | \&\s-1GNU\s0 Emacs (and Emacs-like editors) use ^H for help. |
828 | \&\s-1GNU\s0 Emacs (and Emacs-like editors) use ^H for help. |
838 | .PP |
829 | .PP |
839 | Perhaps someday this will all be resolved in a consistent manner. |
830 | Perhaps someday this will all be resolved in a consistent manner. |
840 | .PP |
831 | .PP |
841 | \fII don't like the key-bindings. How do I change them?\fR |
832 | \fII don't like the key-bindings. How do I change them?\fR |
842 | .IX Subsection "I don't like the key-bindings. How do I change them?" |
833 | .IX Subsection "I don't like the key-bindings. How do I change them?" |
843 | .PP |
834 | .PP |
844 | There are some compile-time selections available via configure. Unless |
835 | There are some compile-time selections available via configure. Unless |
845 | you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can |
836 | you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can |
846 | use the `keysym' resource to alter the keystrings associated with keysyms. |
837 | use the `keysym' resource to alter the keystrings associated with keysyms. |
847 | .PP |
838 | .PP |
… | |
… | |
1314 | .IX Subsection "I have problems getting my input method working." |
1305 | .IX Subsection "I have problems getting my input method working." |
1315 | .PP |
1306 | .PP |
1316 | Try a search engine, as this is slightly different for every input method server. |
1307 | Try a search engine, as this is slightly different for every input method server. |
1317 | .PP |
1308 | .PP |
1318 | Here is a checklist: |
1309 | Here is a checklist: |
1319 | .IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS.\s0" 4 |
1310 | .IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS\s0." 4 |
1320 | .IX Item "- Make sure your locale and the imLocale are supported on your OS." |
1311 | .IX Item "- Make sure your locale and the imLocale are supported on your OS." |
1321 | Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS.\s0 |
1312 | Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS\s0. |
1322 | .IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM.\s0" 4 |
1313 | .IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM\s0." 4 |
1323 | .IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM." |
1314 | .IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM." |
1324 | For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use |
1315 | For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use |
1325 | \&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent. |
1316 | \&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent. |
1326 | .IP "\- Make sure your \s-1XIM\s0 server is actually running." 4 |
1317 | .IP "\- Make sure your \s-1XIM\s0 server is actually running." 4 |
1327 | .IX Item "- Make sure your XIM server is actually running." |
1318 | .IX Item "- Make sure your XIM server is actually running." |
… | |
… | |
1336 | .Sp |
1327 | .Sp |
1337 | .Vb 1 |
1328 | .Vb 1 |
1338 | \& xprop \-root XIM_SERVERS |
1329 | \& xprop \-root XIM_SERVERS |
1339 | .Ve |
1330 | .Ve |
1340 | .PP |
1331 | .PP |
1341 | \fIMy input method wants <some encoding> but I want \s-1UTF\-8,\s0 what can I do?\fR |
1332 | \fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR |
1342 | .IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?" |
1333 | .IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?" |
1343 | .PP |
1334 | .PP |
1344 | You can specify separate locales for the input method and the rest of the |
1335 | You can specify separate locales for the input method and the rest of the |
1345 | terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: |
1336 | terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: |
1346 | .PP |
1337 | .PP |
… | |
… | |
1364 | crashes cannot be completely avoided even if both sides cooperate. |
1355 | crashes cannot be completely avoided even if both sides cooperate. |
1365 | .PP |
1356 | .PP |
1366 | So the only workaround is not to kill your Input Method Servers. |
1357 | So the only workaround is not to kill your Input Method Servers. |
1367 | .SS "Operating Systems / Package Maintaining" |
1358 | .SS "Operating Systems / Package Maintaining" |
1368 | .IX Subsection "Operating Systems / Package Maintaining" |
1359 | .IX Subsection "Operating Systems / Package Maintaining" |
1369 | \fII am maintaining rxvt-unicode for distribution/OS \s-1XXX,\s0 any recommendation?\fR |
1360 | \fII am maintaining rxvt-unicode for distribution/OS \s-1XXX\s0, any recommendation?\fR |
1370 | .IX Subsection "I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?" |
1361 | .IX Subsection "I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?" |
1371 | .PP |
1362 | .PP |
1372 | You should build one binary with the default options. \fIconfigure\fR |
1363 | You should build one binary with the default options. \fIconfigure\fR |
1373 | now enables most useful options, and the trend goes to making them |
1364 | now enables most useful options, and the trend goes to making them |
1374 | runtime-switchable, too, so there is usually no drawback to enabling them, |
1365 | runtime-switchable, too, so there is usually no drawback to enabling them, |
… | |
… | |
1385 | If you can/want build more binaries, I recommend building a minimal |
1376 | If you can/want build more binaries, I recommend building a minimal |
1386 | one with \f(CW\*(C`\-\-disable\-everything\*(C'\fR (very useful) and a maximal one with |
1377 | one with \f(CW\*(C`\-\-disable\-everything\*(C'\fR (very useful) and a maximal one with |
1387 | \&\f(CW\*(C`\-\-enable\-everything\*(C'\fR (less useful, it will be very big due to a lot of |
1378 | \&\f(CW\*(C`\-\-enable\-everything\*(C'\fR (less useful, it will be very big due to a lot of |
1388 | encodings built-in that increase download times and are rarely used). |
1379 | encodings built-in that increase download times and are rarely used). |
1389 | .PP |
1380 | .PP |
1390 | \fII need to make it setuid/setgid to support utmp/ptys on my \s-1OS,\s0 is this safe?\fR |
1381 | \fII need to make it setuid/setgid to support utmp/ptys on my \s-1OS\s0, is this safe?\fR |
1391 | .IX Subsection "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?" |
1382 | .IX Subsection "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?" |
1392 | .PP |
1383 | .PP |
1393 | It should be, starting with release 7.1. You are encouraged to properly |
1384 | It should be, starting with release 7.1. You are encouraged to properly |
1394 | install urxvt with privileges necessary for your \s-1OS\s0 now. |
1385 | install urxvt with privileges necessary for your \s-1OS\s0 now. |
1395 | .PP |
1386 | .PP |
… | |
… | |
1419 | .PP |
1410 | .PP |
1420 | However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and |
1411 | However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and |
1421 | \&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR). |
1412 | \&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR). |
1422 | .PP |
1413 | .PP |
1423 | \&\f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support multi-language |
1414 | \&\f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support multi-language |
1424 | apps in an \s-1OS,\s0 as using a locale-dependent (and non-standardized) |
1415 | apps in an \s-1OS\s0, as using a locale-dependent (and non-standardized) |
1425 | representation of \fBwchar_t\fR makes it impossible to convert between |
1416 | representation of \fBwchar_t\fR makes it impossible to convert between |
1426 | \&\fBwchar_t\fR (as used by X11 and your applications) and any other encoding |
1417 | \&\fBwchar_t\fR (as used by X11 and your applications) and any other encoding |
1427 | without implementing OS-specific-wrappers for each and every locale. There |
1418 | without implementing OS-specific-wrappers for each and every locale. There |
1428 | simply are no APIs to convert \fBwchar_t\fR into anything except the current |
1419 | simply are no APIs to convert \fBwchar_t\fR into anything except the current |
1429 | locale encoding. |
1420 | locale encoding. |
… | |
… | |
1612 | .IX Item "ESC o" |
1603 | .IX Item "ESC o" |
1613 | Invoke the G3 Character Set (\s-1LS3\s0) |
1604 | Invoke the G3 Character Set (\s-1LS3\s0) |
1614 | .ie n .IP "\fB\fB""ESC ( C""\fB\fR" 4 |
1605 | .ie n .IP "\fB\fB""ESC ( C""\fB\fR" 4 |
1615 | .el .IP "\fB\f(CBESC ( C\fB\fR" 4 |
1606 | .el .IP "\fB\f(CBESC ( C\fB\fR" 4 |
1616 | .IX Item "ESC ( C" |
1607 | .IX Item "ESC ( C" |
1617 | Designate G0 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR. |
1608 | Designate G0 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR. |
1618 | .ie n .IP "\fB\fB""ESC ) C""\fB\fR" 4 |
1609 | .ie n .IP "\fB\fB""ESC ) C""\fB\fR" 4 |
1619 | .el .IP "\fB\f(CBESC ) C\fB\fR" 4 |
1610 | .el .IP "\fB\f(CBESC ) C\fB\fR" 4 |
1620 | .IX Item "ESC ) C" |
1611 | .IX Item "ESC ) C" |
1621 | Designate G1 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR. |
1612 | Designate G1 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR. |
1622 | .ie n .IP "\fB\fB""ESC * C""\fB\fR" 4 |
1613 | .ie n .IP "\fB\fB""ESC * C""\fB\fR" 4 |
1623 | .el .IP "\fB\f(CBESC * C\fB\fR" 4 |
1614 | .el .IP "\fB\f(CBESC * C\fB\fR" 4 |
1624 | .IX Item "ESC * C" |
1615 | .IX Item "ESC * C" |
1625 | Designate G2 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR. |
1616 | Designate G2 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR. |
1626 | .ie n .IP "\fB\fB""ESC + C""\fB\fR" 4 |
1617 | .ie n .IP "\fB\fB""ESC + C""\fB\fR" 4 |
1627 | .el .IP "\fB\f(CBESC + C\fB\fR" 4 |
1618 | .el .IP "\fB\f(CBESC + C\fB\fR" 4 |
1628 | .IX Item "ESC + C" |
1619 | .IX Item "ESC + C" |
1629 | Designate G3 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR. |
1620 | Designate G3 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR. |
1630 | .ie n .IP "\fB\fB""ESC $ C""\fB\fR" 4 |
1621 | .ie n .IP "\fB\fB""ESC $ C""\fB\fR" 4 |
1631 | .el .IP "\fB\f(CBESC $ C\fB\fR" 4 |
1622 | .el .IP "\fB\f(CBESC $ C\fB\fR" 4 |
1632 | .IX Item "ESC $ C" |
1623 | .IX Item "ESC $ C" |
1633 | Designate Kanji Character Set |
1624 | Designate Kanji Character Set |
1634 | .Sp |
1625 | .Sp |
… | |
… | |
1644 | C = K German character set unimplemented |
1635 | C = K German character set unimplemented |
1645 | .TE |
1636 | .TE |
1646 | .PP |
1637 | .PP |
1647 | |
1638 | |
1648 | .IX Xref "CSI" |
1639 | .IX Xref "CSI" |
1649 | .SS "\s-1CSI \s0(Command Sequence Introducer) Sequences" |
1640 | .SS "\s-1CSI\s0 (Command Sequence Introducer) Sequences" |
1650 | .IX Subsection "CSI (Command Sequence Introducer) Sequences" |
1641 | .IX Subsection "CSI (Command Sequence Introducer) Sequences" |
1651 | .ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4 |
1642 | .ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4 |
1652 | .el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4 |
1643 | .el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4 |
1653 | .IX Item "ESC [ Ps @" |
1644 | .IX Item "ESC [ Ps @" |
1654 | Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0) |
1645 | Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0) |
… | |
… | |
2020 | .TS |
2011 | .TS |
2021 | l l . |
2012 | l l . |
2022 | h Send Mouse X & Y on button press. |
2013 | h Send Mouse X & Y on button press. |
2023 | l No mouse reporting. |
2014 | l No mouse reporting. |
2024 | .TE |
2015 | .TE |
2025 | .ie n .IP "\fB\fB""Pm = 12""\fB\fR (\s-1AT&T 610,\s0 XTerm)" 4 |
2016 | .ie n .IP "\fB\fB""Pm = 12""\fB\fR (\s-1AT&T\s0 610, XTerm)" 4 |
2026 | .el .IP "\fB\f(CBPm = 12\fB\fR (\s-1AT&T 610,\s0 XTerm)" 4 |
2017 | .el .IP "\fB\f(CBPm = 12\fB\fR (\s-1AT&T\s0 610, XTerm)" 4 |
2027 | .IX Item "Pm = 12 (AT&T 610, XTerm)" |
2018 | .IX Item "Pm = 12 (AT&T 610, XTerm)" |
2028 | .TS |
2019 | .TS |
2029 | l l . |
2020 | l l . |
2030 | h Blinking cursor (cvvis) |
2021 | h Blinking cursor (cvvis) |
2031 | l Steady cursor (cnorm) |
2022 | l Steady cursor (cnorm) |
… | |
… | |
2280 | .IX Subsection "XTerm Operating System Commands" |
2271 | .IX Subsection "XTerm Operating System Commands" |
2281 | .ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4 |
2272 | .ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4 |
2282 | .el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 |
2273 | .el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 |
2283 | .IX Item "ESC ] Ps;Pt ST" |
2274 | .IX Item "ESC ] Ps;Pt ST" |
2284 | Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b, |
2275 | Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b, |
2285 | 0x5c), backwards compatible terminator \s-1BEL \s0(0x07) is also accepted. any |
2276 | 0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any |
2286 | \&\fBoctet\fR can be escaped by prefixing it with \s-1SYN \s0(0x16, ^V). |
2277 | \&\fBoctet\fR can be escaped by prefixing it with \s-1SYN\s0 (0x16, ^V). |
2287 | .TS |
2278 | .TS |
2288 | l l . |
2279 | l l . |
2289 | Ps = 0 Change Icon Name and Window Title to Pt |
2280 | Ps = 0 Change Icon Name and Window Title to Pt |
2290 | Ps = 1 Change Icon Name to Pt |
2281 | Ps = 1 Change Icon Name to Pt |
2291 | Ps = 2 Change Window Title to Pt |
2282 | Ps = 2 Change Window Title to Pt |
… | |
… | |
2318 | Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). |
2309 | Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). |
2319 | Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). |
2310 | Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). |
2320 | .TE |
2311 | .TE |
2321 | .SH "BACKGROUND IMAGE" |
2312 | .SH "BACKGROUND IMAGE" |
2322 | .IX Header "BACKGROUND IMAGE" |
2313 | .IX Header "BACKGROUND IMAGE" |
2323 | For the \s-1BACKGROUND IMAGE\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR the value |
2314 | For the \s-1BACKGROUND\s0 \s-1IMAGE\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR the value |
2324 | of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be one of the following commands: |
2315 | of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be one of the following commands: |
2325 | .ie n .IP "\fB\fB""?""\fB\fR" 4 |
2316 | .ie n .IP "\fB\fB""?""\fB\fR" 4 |
2326 | .el .IP "\fB\f(CB?\fB\fR" 4 |
2317 | .el .IP "\fB\f(CB?\fB\fR" 4 |
2327 | .IX Item "?" |
2318 | .IX Item "?" |
2328 | display scale and position in the title |
2319 | display scale and position in the title |
… | |
… | |
2493 | jp_ext rarely used but big japanese encodings |
2484 | jp_ext rarely used but big japanese encodings |
2494 | kr korean encodings |
2485 | kr korean encodings |
2495 | .TE |
2486 | .TE |
2496 | .IP "\-\-enable\-xim (default: on)" 4 |
2487 | .IP "\-\-enable\-xim (default: on)" 4 |
2497 | .IX Item "--enable-xim (default: on)" |
2488 | .IX Item "--enable-xim (default: on)" |
2498 | Add support for \s-1XIM \s0(X Input Method) protocol. This allows using |
2489 | Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using |
2499 | alternative input methods (e.g. kinput2) and will also correctly |
2490 | alternative input methods (e.g. kinput2) and will also correctly |
2500 | set up the input for people using dead keys or compose keys. |
2491 | set up the input for people using dead keys or compose keys. |
2501 | .IP "\-\-enable\-unicode3 (default: off)" 4 |
2492 | .IP "\-\-enable\-unicode3 (default: off)" 4 |
2502 | .IX Item "--enable-unicode3 (default: off)" |
2493 | .IX Item "--enable-unicode3 (default: off)" |
2503 | Recommended to stay off unless you really need non-BMP characters. |
2494 | Recommended to stay off unless you really need non-BMP characters. |
… | |
… | |
2530 | The combining table also contains entries for arabic presentation forms, |
2521 | The combining table also contains entries for arabic presentation forms, |
2531 | but these are not currently used. Bug me if you want these to be used (and |
2522 | but these are not currently used. Bug me if you want these to be used (and |
2532 | tell me how these are to be used...). |
2523 | tell me how these are to be used...). |
2533 | .IP "\-\-enable\-fallback[=CLASS] (default: Rxvt)" 4 |
2524 | .IP "\-\-enable\-fallback[=CLASS] (default: Rxvt)" 4 |
2534 | .IX Item "--enable-fallback[=CLASS] (default: Rxvt)" |
2525 | .IX Item "--enable-fallback[=CLASS] (default: Rxvt)" |
2535 | When reading resource settings, also read settings for class \s-1CLASS.\s0 To |
2526 | When reading resource settings, also read settings for class \s-1CLASS\s0. To |
2536 | disable resource fallback use \-\-disable\-fallback. |
2527 | disable resource fallback use \-\-disable\-fallback. |
2537 | .IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 |
2528 | .IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 |
2538 | .IX Item "--with-res-name=NAME (default: urxvt)" |
2529 | .IX Item "--with-res-name=NAME (default: urxvt)" |
2539 | Use the given name as default application name when |
2530 | Use the given name as default application name when |
2540 | reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt. |
2531 | reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt. |
… | |
… | |
2558 | \&\fIlastlogin\fR) at start of rxvt execution. This option requires |
2549 | \&\fIlastlogin\fR) at start of rxvt execution. This option requires |
2559 | \&\-\-enable\-utmp to also be specified. |
2550 | \&\-\-enable\-utmp to also be specified. |
2560 | .IP "\-\-enable\-pixbuf (default: on)" 4 |
2551 | .IP "\-\-enable\-pixbuf (default: on)" 4 |
2561 | .IX Item "--enable-pixbuf (default: on)" |
2552 | .IX Item "--enable-pixbuf (default: on)" |
2562 | Add support for GDK-PixBuf to be used for background images. |
2553 | Add support for GDK-PixBuf to be used for background images. |
2563 | It adds support for many file formats including \s-1JPG, PNG, |
2554 | It adds support for many file formats including \s-1JPG\s0, \s-1PNG\s0, |
2564 | TIFF, GIF, XPM, BMP, ICO\s0 and \s-1TGA.\s0 |
2555 | \&\s-1TIFF\s0, \s-1GIF\s0, \s-1XPM\s0, \s-1BMP\s0, \s-1ICO\s0 and \s-1TGA\s0. |
2565 | .IP "\-\-enable\-startup\-notification (default: on)" 4 |
2556 | .IP "\-\-enable\-startup\-notification (default: on)" 4 |
2566 | .IX Item "--enable-startup-notification (default: on)" |
2557 | .IX Item "--enable-startup-notification (default: on)" |
2567 | Add support for freedesktop startup notifications. This allows window managers |
2558 | Add support for freedesktop startup notifications. This allows window managers |
2568 | to display some kind of progress indicator during startup. |
2559 | to display some kind of progress indicator during startup. |
2569 | .IP "\-\-enable\-transparency (default: on)" 4 |
2560 | .IP "\-\-enable\-transparency (default: on)" 4 |
… | |
… | |
2643 | \& trailing space removal for selections |
2634 | \& trailing space removal for selections |
2644 | \& verbose X error handling |
2635 | \& verbose X error handling |
2645 | .Ve |
2636 | .Ve |
2646 | .IP "\-\-enable\-iso14755 (default: on)" 4 |
2637 | .IP "\-\-enable\-iso14755 (default: on)" 4 |
2647 | .IX Item "--enable-iso14755 (default: on)" |
2638 | .IX Item "--enable-iso14755 (default: on)" |
2648 | Enable extended \s-1ISO 14755\s0 support (see @@RXVT_NAME@@(1)). |
2639 | Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1)). |
2649 | Basic support (section 5.1) is enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR, while |
2640 | Basic support (section 5.1) is enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR, while |
2650 | support for 5.2, 5.3 and 5.4 is enabled with this switch. |
2641 | support for 5.2, 5.3 and 5.4 is enabled with this switch. |
2651 | .IP "\-\-enable\-keepscrolling (default: on)" 4 |
2642 | .IP "\-\-enable\-keepscrolling (default: on)" 4 |
2652 | .IX Item "--enable-keepscrolling (default: on)" |
2643 | .IX Item "--enable-keepscrolling (default: on)" |
2653 | Add support for continual scrolling of the display when you hold |
2644 | Add support for continual scrolling of the display when you hold |
… | |
… | |
2706 | Set the basename for the installed binaries, resulting |
2697 | Set the basename for the installed binaries, resulting |
2707 | in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with |
2698 | in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with |
2708 | \&\f(CW\*(C`rxvt\*(C'\fR. |
2699 | \&\f(CW\*(C`rxvt\*(C'\fR. |
2709 | .IP "\-\-with\-term=NAME (default: rxvt-unicode)" 4 |
2700 | .IP "\-\-with\-term=NAME (default: rxvt-unicode)" 4 |
2710 | .IX Item "--with-term=NAME (default: rxvt-unicode)" |
2701 | .IX Item "--with-term=NAME (default: rxvt-unicode)" |
2711 | Change the environmental variable for the terminal to \s-1NAME.\s0 |
2702 | Change the environmental variable for the terminal to \s-1NAME\s0. |
2712 | .IP "\-\-with\-terminfo=PATH" 4 |
2703 | .IP "\-\-with\-terminfo=PATH" 4 |
2713 | .IX Item "--with-terminfo=PATH" |
2704 | .IX Item "--with-terminfo=PATH" |
2714 | Change the environmental variable for the path to the terminfo tree to |
2705 | Change the environmental variable for the path to the terminfo tree to |
2715 | \&\s-1PATH.\s0 |
2706 | \&\s-1PATH\s0. |
2716 | .IP "\-\-with\-x" 4 |
2707 | .IP "\-\-with\-x" 4 |
2717 | .IX Item "--with-x" |
2708 | .IX Item "--with-x" |
2718 | Use the X Window System (pretty much default, eh?). |
2709 | Use the X Window System (pretty much default, eh?). |
2719 | .SH "AUTHORS" |
2710 | .SH "AUTHORS" |
2720 | .IX Header "AUTHORS" |
2711 | .IX Header "AUTHORS" |