| … | |
… | |
| 24 | |
24 | |
| 25 | =head1 FREQUENTLY ASKED QUESTIONS |
25 | =head1 FREQUENTLY ASKED QUESTIONS |
| 26 | |
26 | |
| 27 | =over 4 |
27 | =over 4 |
| 28 | |
28 | |
|
|
29 | =item Isn't rxvt supposed to be small? Don't all those features bloat? |
|
|
30 | |
|
|
31 | I often get asked about this, and I think, no, they didn't cause extra |
|
|
32 | bloat. If you compare a minimal rxvt and a minimal urxvt, you can see |
|
|
33 | that the urxvt binary is larger (due to some encoding tables always being |
|
|
34 | compiled in), but it actually uses less memory (RSS) after startup. Even |
|
|
35 | with C<--disable-everything>, this comparison is a bit unfair, as many |
|
|
36 | features unique to urxvt (locale, encoding conversion, iso14755 etc.) are |
|
|
37 | already in use in this mode. |
|
|
38 | |
|
|
39 | text data bss drs rss filename |
|
|
40 | 98398 1664 24 15695 1824 rxvt --disable-everything |
|
|
41 | 188985 9048 66616 18222 1788 urxvt --disable-everything |
|
|
42 | |
|
|
43 | When you C<--enable-everything> (which _is_ unfair, as this involves xft |
|
|
44 | and full locale/XIM support which are quite bloaty inside libX11 and my |
|
|
45 | libc), the two diverge, but not unreasnobaly so. |
|
|
46 | |
|
|
47 | text data bss drs rss filename |
|
|
48 | 163431 2152 24 20123 2060 rxvt --enable-everything |
|
|
49 | 1035683 49680 66648 29096 3680 urxvt --enable-everything |
|
|
50 | |
|
|
51 | The very large size of the text section is explained by the east-asian |
|
|
52 | encoding tables, which, if unused, take up disk space but nothing else |
|
|
53 | and can be compiled out unless you rely on X11 core fonts that use those |
|
|
54 | encodings. The BSS size comes from the 64k emergency buffer that my c++ |
|
|
55 | compiler allocates (but of course doesn't use unless you are out of |
|
|
56 | memory). Also, using an xft font instead of a core font immediately adds a |
|
|
57 | few megabytes of RSS. Xft indeed is responsible for a lot of RSS even when |
|
|
58 | not used. |
|
|
59 | |
|
|
60 | Of course, due to every character using two or four bytes instead of one, |
|
|
61 | a large scrollback buffer will ultimately make rxvt-unicode use more |
|
|
62 | memory. |
|
|
63 | |
|
|
64 | Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this |
|
|
65 | still fares rather well. And compared to some monsters like gnome-terminal |
|
|
66 | (21152k + extra 4204k in separate processes) or konsole (22200k + extra |
|
|
67 | 43180k in daemons that stay around after exit, plus half aminute of |
|
|
68 | startup time, including the hundreds of warnings it spits out), it fares |
|
|
69 | extremely well *g*. |
|
|
70 | |
|
|
71 | =item Why C++, isn't that unportable/bloated/uncool? |
|
|
72 | |
|
|
73 | Is this a question? :) It comes up very often. The simple answer is: I had |
|
|
74 | to write it, and C++ allowed me to write and maintain it in a fraction |
|
|
75 | of the time and effort (which is a scarce resource for me). Put even |
|
|
76 | shorter: It simply wouldn't exist without C++. |
|
|
77 | |
|
|
78 | My personal stance on this is that C++ is less portable than C, but in |
|
|
79 | the case of rxvt-unicode this hardly matters, as its portability limits |
|
|
80 | are defined by things like X11, pseudo terminals, locale support and unix |
|
|
81 | domain sockets, which are all less portable than C++ itself. |
|
|
82 | |
|
|
83 | Regarding the bloat, see the above question: It's easy to write programs |
|
|
84 | in C that use gobs of memory, an certainly possible to write programs in |
|
|
85 | C++ that don't. C++ also often comes with large libraries, but this is |
|
|
86 | not necessarily the case with GCC. Here is what rxvt links against on my |
|
|
87 | system with a minimal config: |
|
|
88 | |
|
|
89 | libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) |
|
|
90 | libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000) |
|
|
91 | libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000) |
|
|
92 | /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) |
|
|
93 | |
|
|
94 | And here is rxvt-unicode: |
|
|
95 | |
|
|
96 | libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) |
|
|
97 | libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) |
|
|
98 | libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) |
|
|
99 | libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) |
|
|
100 | /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) |
|
|
101 | |
|
|
102 | No large bloated libraries (of course, none were linked in statically), |
|
|
103 | except maybe libX11 :) |
|
|
104 | |
|
|
105 | =item Does it support tabs, can I have a tabbed rxvt-unicode? |
|
|
106 | |
|
|
107 | rxvt-unicode does not directly support tabs. It will work fine with |
|
|
108 | tabbing functionality of many window managers or similar tabbing programs, |
|
|
109 | and its embedding-features allow it to be embedded into other programs, |
|
|
110 | as witnessed by F<doc/rxvt-tabbed> or the upcoming C<Gtk2::URxvt> perl |
|
|
111 | module, which features a tabbed urxvt (murxvt) terminal as an example |
|
|
112 | embedding application. |
|
|
113 | |
| 29 | =item How do I know which rxvt-unicode version I'm using? |
114 | =item How do I know which rxvt-unicode version I'm using? |
| 30 | |
115 | |
| 31 | The version number is displayed with the usage (-h). Also the escape |
116 | The version number is displayed with the usage (-h). Also the escape |
| 32 | sequence C<ESC [ 8 n> sets the window title to the version number. |
117 | sequence C<ESC [ 8 n> sets the window title to the version number. When |
|
|
118 | using the @@RXVT_NAME@@c client, the version displayed is that of the |
|
|
119 | daemon. |
| 33 | |
120 | |
| 34 | =item I am using Debian GNU/Linux and have a problem... |
121 | =item I am using Debian GNU/Linux and have a problem... |
| 35 | |
122 | |
| 36 | The Debian GNU/Linux package of rxvt-unicode contains large patches that |
123 | The Debian GNU/Linux package of rxvt-unicode in sarge contains large |
| 37 | considerably change the behaviour of rxvt-unicode. Before reporting a |
124 | patches that considerably change the behaviour of rxvt-unicode. Before |
| 38 | bug to the original rxvt-unicode author please download and install the |
125 | reporting a bug to the original rxvt-unicode author please download and |
| 39 | genuine version (L<http://software.schmorp.de#rxvt-unicode>) and try to |
126 | install the genuine version (L<http://software.schmorp.de#rxvt-unicode>) |
| 40 | reproduce the problem. If you cannot, chances are that the problems are |
127 | and try to reproduce the problem. If you cannot, chances are that the |
| 41 | specific to Debian GNU/Linux, in which case it should be reported via the |
128 | problems are specific to Debian GNU/Linux, in which case it should be |
| 42 | Debian Bug Tracking System (use C<reportbug> to report the bug). |
129 | reported via the Debian Bug Tracking System (use C<reportbug> to report |
|
|
130 | the bug). |
| 43 | |
131 | |
| 44 | For other problems that also affect the Debian package, you can and |
132 | For other problems that also affect the Debian package, you can and |
| 45 | probably should use the Debian BTS, too, because, after all, it's also a |
133 | probably should use the Debian BTS, too, because, after all, it's also a |
| 46 | bug in the Debian version and it serves as a reminder for other users that |
134 | bug in the Debian version and it serves as a reminder for other users that |
| 47 | might encounter the same issue. |
135 | might encounter the same issue. |
| … | |
… | |
| 72 | URxvt.termName: rxvt |
160 | URxvt.termName: rxvt |
| 73 | |
161 | |
| 74 | If you don't plan to use B<rxvt> (quite common...) you could also replace |
162 | If you don't plan to use B<rxvt> (quite common...) you could also replace |
| 75 | the rxvt terminfo file with the rxvt-unicode one. |
163 | the rxvt terminfo file with the rxvt-unicode one. |
| 76 | |
164 | |
|
|
165 | =item C<tic> outputs some error when compiling the terminfo entry. |
|
|
166 | |
|
|
167 | Most likely it's the empty definition for C<enacs=>. Just replace it by |
|
|
168 | C<enacs=\E[0@> and try again. |
|
|
169 | |
| 77 | =item C<bash>'s readline does not work correctly under @@RXVT_NAME@@. |
170 | =item C<bash>'s readline does not work correctly under @@RXVT_NAME@@. |
| 78 | |
171 | |
| 79 | =item I need a termcap file entry. |
172 | =item I need a termcap file entry. |
| 80 | |
173 | |
| 81 | One reason you might want this is that some distributions or operating |
174 | One reason you might want this is that some distributions or operating |
| 82 | systems still compile some programs using the long-obsoleted termcap |
175 | systems still compile some programs using the long-obsoleted termcap |
| 83 | (Fedora Core's bash is one example) and rely on a termcap entry for |
176 | library (Fedora Core's bash is one example) and rely on a termcap entry |
| 84 | C<rxvt-unicode>. |
177 | for C<rxvt-unicode>. |
| 85 | |
178 | |
| 86 | You could use rxvt's termcap entry with resonable results in many cases. |
179 | You could use rxvt's termcap entry with resonable results in many cases. |
| 87 | You can also create a termcap entry by using terminfo's infocmp program |
180 | You can also create a termcap entry by using terminfo's infocmp program |
| 88 | like this: |
181 | like this: |
| 89 | |
182 | |
| … | |
… | |
| 91 | |
184 | |
| 92 | Or you could use this termcap entry, generated by the command above: |
185 | Or you could use this termcap entry, generated by the command above: |
| 93 | |
186 | |
| 94 | rxvt-unicode|rxvt-unicode terminal (X Window System):\ |
187 | rxvt-unicode|rxvt-unicode terminal (X Window System):\ |
| 95 | :am:bw:eo:km:mi:ms:xn:xo:\ |
188 | :am:bw:eo:km:mi:ms:xn:xo:\ |
| 96 | :co#80:it#8:li#24:\ |
189 | :co#80:it#8:li#24:lm#0:\ |
| 97 | :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ |
190 | :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ |
| 98 | :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ |
191 | :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ |
| 99 | :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=^O:al=\E[L:\ |
192 | :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\ |
| 100 | :as=^N:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:cm=\E[%i%d;%dH:\ |
193 | :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\ |
| 101 | :cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:dl=\E[M:do=^J:\ |
194 | :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\ |
| 102 | :ec=\E[%dX:ei=\E[4l:ho=\E[H:i1=\E[?47l\E=\E[?1l:ic=\E[@:\ |
195 | :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\ |
|
|
196 | :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\ |
| 103 | :im=\E[4h:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ |
197 | :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ |
| 104 | :k0=\E[21~:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:\ |
198 | :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\ |
| 105 | :k5=\E[15~:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:\ |
199 | :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\ |
| 106 | :kD=\E[3~:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:\ |
200 | :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\ |
| 107 | :ke=\E[?1l\E>:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:\ |
201 | :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\ |
| 108 | :ku=\EOA:le=^H:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:\ |
202 | :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\ |
| 109 | :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\ |
203 | :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\ |
| 110 | :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\ |
204 | :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\ |
| 111 | :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ |
205 | :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ |
| 112 | :vs=\E[?25h: |
206 | :vs=\E[?25h: |
| 113 | |
207 | |
| 114 | =item Why does C<ls> no longer have coloured output? |
208 | =item Why does C<ls> no longer have coloured output? |
| 115 | |
209 | |
| 116 | The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to |
210 | The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to |
| … | |
… | |
| 257 | might be forced to use a different font. |
351 | might be forced to use a different font. |
| 258 | |
352 | |
| 259 | All of this is not a problem when using X11 core fonts, as their bounding |
353 | All of this is not a problem when using X11 core fonts, as their bounding |
| 260 | box data is correct. |
354 | box data is correct. |
| 261 | |
355 | |
|
|
356 | =item On Solaris 9, many line-drawing characters are too wide. |
|
|
357 | |
|
|
358 | Seems to be a known bug, read |
|
|
359 | L<http://nixdoc.net/files/forum/about34198.html>. Some people use the |
|
|
360 | following ugly workaround to get non-double-wide-characters working: |
|
|
361 | |
|
|
362 | #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x) |
|
|
363 | |
| 262 | =item My Compose (Multi_key) key is no longer working. |
364 | =item My Compose (Multi_key) key is no longer working. |
| 263 | |
365 | |
| 264 | The most common causes for this are that either your locale is not set |
366 | The most common causes for this are that either your locale is not set |
| 265 | correctly, or you specified a B<preeditStyle> that is not supported by |
367 | correctly, or you specified a B<preeditStyle> that is not supported by |
| 266 | your input method. For example, if you specified B<OverTheSpot> and |
368 | your input method. For example, if you specified B<OverTheSpot> and |
| … | |
… | |
| 309 | |
411 | |
| 310 | As you might have guessed, FreeBSD does neither define this symobl nor |
412 | As you might have guessed, FreeBSD does neither define this symobl nor |
| 311 | does it support it. Instead, it uses it's own internal representation of |
413 | does it support it. Instead, it uses it's own internal representation of |
| 312 | B<wchar_t>. This is, of course, completely fine with respect to standards. |
414 | B<wchar_t>. This is, of course, completely fine with respect to standards. |
| 313 | |
415 | |
|
|
416 | However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and |
|
|
417 | C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>. |
|
|
418 | |
| 314 | However, C<__STDC_ISO_10646__> is the only sane way to support |
419 | C<__STDC_ISO_10646__> is the only sane way to support multi-language |
| 315 | multi-language apps in an OS, as using a locale-dependent (and |
420 | apps in an OS, as using a locale-dependent (and non-standardized) |
| 316 | non-standardized) representation of B<wchar_t> makes it impossible to |
421 | representation of B<wchar_t> makes it impossible to convert between |
| 317 | convert between B<wchar_t> (as used by X11 and your applications) and any |
422 | B<wchar_t> (as used by X11 and your applications) and any other encoding |
| 318 | other encoding without implementing OS-specific-wrappers for each and |
423 | without implementing OS-specific-wrappers for each and every locale. There |
| 319 | every locale. There simply are no APIs to convert B<wchar_t> into anything |
424 | simply are no APIs to convert B<wchar_t> into anything except the current |
| 320 | except the current locale encoding. |
425 | locale encoding. |
| 321 | |
426 | |
| 322 | Some applications (such as the formidable B<mlterm>) work around this |
427 | Some applications (such as the formidable B<mlterm>) work around this |
| 323 | by carrying their own replacement functions for character set handling |
428 | by carrying their own replacement functions for character set handling |
| 324 | with them, and either implementing OS-dependent hacks or doing multiple |
429 | with them, and either implementing OS-dependent hacks or doing multiple |
| 325 | conversions (which is slow and unreliable in case the OS implements |
430 | conversions (which is slow and unreliable in case the OS implements |
| 326 | encodings slightly different than the terminal emulator). |
431 | encodings slightly different than the terminal emulator). |
| 327 | |
432 | |
| 328 | The rxvt-unicode author insists that the right way to fix this is in the |
433 | The rxvt-unicode author insists that the right way to fix this is in the |
| 329 | system libraries once and for all, instead of forcing every app to carry |
434 | system libraries once and for all, instead of forcing every app to carry |
| 330 | complete replacements for them :) |
435 | complete replacements for them :) |
|
|
436 | |
|
|
437 | =item I use Solaris 9 and it doesn't compile/work/etc. |
|
|
438 | |
|
|
439 | Try the diff in F<doc/solaris9.patch> as a base. It fixes the worst |
|
|
440 | problems with C<wcwidth> and a compile problem. |
|
|
441 | |
|
|
442 | =item How can I use rxvt-unicode under cygwin? |
|
|
443 | |
|
|
444 | rxvt-unicode should compile and run out of the box on cygwin, using |
|
|
445 | the X11 libraries that come with cygwin. libW11 emulation is no |
|
|
446 | longer supported (and makes no sense, either, as it only supported a |
|
|
447 | single font). I recommend starting the X-server in C<-multiwindow> or |
|
|
448 | C<-rootless> mode instead, which will result in similar look&feel as the |
|
|
449 | old libW11 emulation. |
|
|
450 | |
|
|
451 | At the time of this writing, cygwin didn't seem to support any multi-byte |
|
|
452 | encodings (you might try C<LC_CTYPE=C-UTF-8>), so you are likely limited |
|
|
453 | to 8-bit encodings. |
| 331 | |
454 | |
| 332 | =item How does rxvt-unicode determine the encoding to use? |
455 | =item How does rxvt-unicode determine the encoding to use? |
| 333 | |
456 | |
| 334 | =item Is there an option to switch encodings? |
457 | =item Is there an option to switch encodings? |
| 335 | |
458 | |
| … | |
… | |
| 451 | |
574 | |
| 452 | =item Can I speed up Xft rendering somehow? |
575 | =item Can I speed up Xft rendering somehow? |
| 453 | |
576 | |
| 454 | Yes, the most obvious way to speed it up is to avoid Xft entirely, as |
577 | Yes, the most obvious way to speed it up is to avoid Xft entirely, as |
| 455 | it is simply slow. If you still want Xft fonts you might try to disable |
578 | it is simply slow. If you still want Xft fonts you might try to disable |
| 456 | antialiasing (by appending C<:antialiasing=false>), which saves lots of |
579 | antialiasing (by appending C<:antialias=false>), which saves lots of |
| 457 | memory and also speeds up rendering considerably. |
580 | memory and also speeds up rendering considerably. |
| 458 | |
581 | |
| 459 | =item Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? |
582 | =item Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? |
| 460 | |
583 | |
| 461 | Rxvt-unicode will use whatever you specify as a font. If it needs to |
584 | Rxvt-unicode will use whatever you specify as a font. If it needs to |
| … | |
… | |
| 539 | URxvt.color7: #e1dddd |
662 | URxvt.color7: #e1dddd |
| 540 | URxvt.color15: #e1dddd |
663 | URxvt.color15: #e1dddd |
| 541 | |
664 | |
| 542 | =item How can I start @@RXVT_NAME@@d in a race-free way? |
665 | =item How can I start @@RXVT_NAME@@d in a race-free way? |
| 543 | |
666 | |
| 544 | Despite it's name, @@RXVT_NAME@@d is not a real daemon, but more like a |
667 | Try C<@@RXVT_NAME@@d -f -o>, which tells @@RXVT_NAME@@d to open the |
| 545 | server that answers @@RXVT_NAME@@c's requests, so it doesn't background |
668 | display, create the listening socket and then fork. |
| 546 | itself. |
|
|
| 547 | |
|
|
| 548 | To ensure @@RXVT_NAME@@d is listening on it's socket, you can use the |
|
|
| 549 | following method to wait for the startup message before continuing: |
|
|
| 550 | |
|
|
| 551 | { @@RXVT_NAME@@d & } | read |
|
|
| 552 | |
669 | |
| 553 | =item What's with the strange Backspace/Delete key behaviour? |
670 | =item What's with the strange Backspace/Delete key behaviour? |
| 554 | |
671 | |
| 555 | Assuming that the physical Backspace key corresponds to the |
672 | Assuming that the physical Backspace key corresponds to the |
| 556 | BackSpace keysym (not likely for Linux ... see the following |
673 | BackSpace keysym (not likely for Linux ... see the following |
| … | |
… | |
| 1474 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
1591 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
| 1475 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
1592 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
| 1476 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> |
1593 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> |
| 1477 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> |
1594 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> |
| 1478 | B<< C<Ps = 20> >> Change default background to B<< C<Pt> >> |
1595 | B<< C<Ps = 20> >> Change default background to B<< C<Pt> >> |
| 1479 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >> I<rxvt compile-time option> |
1596 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. |
| 1480 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
1597 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
| 1481 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >> I<rxvt compile-time option> |
1598 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. |
| 1482 | B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> |
1599 | B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> |
| 1483 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
1600 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
| 1484 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (@@RXVT_NAME@@ extension) |
1601 | B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills). |
| 1485 | B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> I<rxvt compile-time option> (rxvt-unicode extension) |
1602 | B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> (Compile menubar). |
| 1486 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
1603 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
| 1487 | B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> |
1604 | B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). |
| 1488 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
1605 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
| 1489 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
1606 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
| 1490 | B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
1607 | B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
| 1491 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
1608 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
|
|
1609 | B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
|
|
1610 | B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
| 1492 | |
1611 | |
| 1493 | =end table |
1612 | =end table |
| 1494 | |
1613 | |
| 1495 | =back |
1614 | =back |
| 1496 | |
1615 | |
| … | |
… | |
| 1548 | |
1667 | |
| 1549 | =item B<< [title:+I<string>] >> |
1668 | =item B<< [title:+I<string>] >> |
| 1550 | |
1669 | |
| 1551 | set the current menuBar's title to I<string>, which may contain the |
1670 | set the current menuBar's title to I<string>, which may contain the |
| 1552 | following format specifiers: |
1671 | following format specifiers: |
| 1553 | B<%%> : literal B<%> character |
1672 | |
| 1554 | B<%n> : rxvt name (as per the B<-name> command-line option) |
1673 | B<%n> rxvt name (as per the B<-name> command-line option) |
| 1555 | B<%v> : rxvt version |
1674 | B<%v> rxvt version |
|
|
1675 | B<%%> literal B<%> character |
| 1556 | |
1676 | |
| 1557 | =item B<[done]> |
1677 | =item B<[done]> |
| 1558 | |
1678 | |
| 1559 | set menuBar access as B<readonly>. |
1679 | set menuBar access as B<readonly>. |
| 1560 | End-of-file tag for B<< [read:+I<file>] >> operations. |
1680 | End-of-file tag for B<< [read:+I<file>] >> operations. |
| … | |
… | |
| 2152 | =end table |
2272 | =end table |
| 2153 | |
2273 | |
| 2154 | =head1 CONFIGURE OPTIONS |
2274 | =head1 CONFIGURE OPTIONS |
| 2155 | |
2275 | |
| 2156 | General hint: if you get compile errors, then likely your configuration |
2276 | General hint: if you get compile errors, then likely your configuration |
| 2157 | hasn't been tested well. Either try with --enable-everything or use the |
2277 | hasn't been tested well. Either try with C<--enable-everything> or use |
| 2158 | ./reconf script as a base for experiments. ./reconf is used by myself, |
2278 | the F<./reconf> script as a base for experiments. F<./reconf> is used by |
| 2159 | so it should generally be a working config. Of course, you should always |
2279 | myself, so it should generally be a working config. Of course, you should |
| 2160 | report when a combination doesn't work, so it can be fixed. Marc Lehmann |
2280 | always report when a combination doesn't work, so it can be fixed. Marc |
| 2161 | <rxvt@schmorp.de>. |
2281 | Lehmann <rxvt@schmorp.de>. |
|
|
2282 | |
|
|
2283 | All |
| 2162 | |
2284 | |
| 2163 | =over 4 |
2285 | =over 4 |
| 2164 | |
2286 | |
| 2165 | =item --enable-everything |
2287 | =item --enable-everything |
| 2166 | |
2288 | |
| 2167 | Add support for all non-multichoice options listed in "./configure |
2289 | Add (or remove) support for all non-multichoice options listed in "./configure |
| 2168 | --help". Note that unlike other enable options this is order dependant. |
2290 | --help". |
|
|
2291 | |
| 2169 | You can specify this and then disable options which this enables by |
2292 | You can specify this and then disable options you do not like by |
| 2170 | I<following> this with the appropriate commands. |
2293 | I<following> this with the appropriate C<--disable-...> arguments, |
|
|
2294 | or you can start with a minimal configuration by specifying |
|
|
2295 | C<--disable-everything> and than adding just the C<--enable-...> arguments |
|
|
2296 | you want. |
| 2171 | |
2297 | |
| 2172 | =item --enable-xft |
2298 | =item --enable-xft (default: enabled) |
| 2173 | |
2299 | |
| 2174 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts are |
2300 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts are |
| 2175 | slower and require lots of memory, but as long as you don't use them, you |
2301 | slower and require lots of memory, but as long as you don't use them, you |
| 2176 | don't pay for them. |
2302 | don't pay for them. |
| 2177 | |
2303 | |
| 2178 | =item --enable-font-styles |
2304 | =item --enable-font-styles (default: on) |
| 2179 | |
2305 | |
| 2180 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
2306 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
| 2181 | styles. The fonts can be set manually or automatically. |
2307 | styles. The fonts can be set manually or automatically. |
| 2182 | |
2308 | |
| 2183 | =item --with-codesets=NAME,... |
2309 | =item --with-codesets=NAME,... (default: all) |
| 2184 | |
2310 | |
| 2185 | Compile in support for additional codeset (encoding) groups (eu, vn are |
2311 | Compile in support for additional codeset (encoding) groups (C<eu>, C<vn> |
| 2186 | always compiled in, which includes most 8-bit character sets). These |
2312 | are always compiled in, which includes most 8-bit character sets). These |
| 2187 | codeset tables are currently only used for driving X11 core fonts, they |
2313 | codeset tables are used for driving X11 core fonts, they are not required |
| 2188 | are not required for Xft fonts. Compiling them in will make your binary |
2314 | for Xft fonts, although having them compiled in lets rxvt-unicode choose |
| 2189 | bigger (together about 700kB), but it doesn't increase memory usage unless |
2315 | replacement fonts more intelligently. Compiling them in will make your |
|
|
2316 | binary bigger (all of together cost about 700kB), but it doesn't increase |
| 2190 | you use an X11 font requiring one of these encodings. |
2317 | memory usage unless you use a font requiring one of these encodings. |
| 2191 | |
2318 | |
| 2192 | =begin table |
2319 | =begin table |
| 2193 | |
2320 | |
| 2194 | all all available codeset groups |
2321 | all all available codeset groups |
| 2195 | zh common chinese encodings |
2322 | zh common chinese encodings |
| … | |
… | |
| 2198 | jp_ext rarely used but big japanese encodings |
2325 | jp_ext rarely used but big japanese encodings |
| 2199 | kr korean encodings |
2326 | kr korean encodings |
| 2200 | |
2327 | |
| 2201 | =end table |
2328 | =end table |
| 2202 | |
2329 | |
| 2203 | =item --enable-xim |
2330 | =item --enable-xim (default: on) |
| 2204 | |
2331 | |
| 2205 | Add support for XIM (X Input Method) protocol. This allows using |
2332 | Add support for XIM (X Input Method) protocol. This allows using |
| 2206 | alternative input methods (e.g. kinput2) and will also correctly |
2333 | alternative input methods (e.g. kinput2) and will also correctly |
| 2207 | set up the input for people using dead keys or compose keys. |
2334 | set up the input for people using dead keys or compose keys. |
| 2208 | |
2335 | |
| 2209 | =item --enable-unicode3 |
2336 | =item --enable-unicode3 (default: off) |
| 2210 | |
2337 | |
| 2211 | Enable direct support for displaying unicode codepoints above |
2338 | Enable direct support for displaying unicode codepoints above |
| 2212 | 65535 (the basic multilingual page). This increases storage |
2339 | 65535 (the basic multilingual page). This increases storage |
| 2213 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
2340 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
| 2214 | support these extra characters, but Xft does. |
2341 | support these extra characters, but Xft does. |
| … | |
… | |
| 2217 | even without this flag, but the number of such characters is |
2344 | even without this flag, but the number of such characters is |
| 2218 | limited to a view thousand (shared with combining characters, |
2345 | limited to a view thousand (shared with combining characters, |
| 2219 | see next switch), and right now rxvt-unicode cannot display them |
2346 | see next switch), and right now rxvt-unicode cannot display them |
| 2220 | (input/output and cut&paste still work, though). |
2347 | (input/output and cut&paste still work, though). |
| 2221 | |
2348 | |
| 2222 | =item --enable-combining |
2349 | =item --enable-combining (default: on) |
| 2223 | |
2350 | |
| 2224 | Enable automatic composition of combining characters into |
2351 | Enable automatic composition of combining characters into |
| 2225 | composite characters. This is required for proper viewing of text |
2352 | composite characters. This is required for proper viewing of text |
| 2226 | where accents are encoded as seperate unicode characters. This is |
2353 | where accents are encoded as seperate unicode characters. This is |
| 2227 | done by using precomposited characters when available or creating |
2354 | done by using precomposited characters when available or creating |
| 2228 | new pseudo-characters when no precomposed form exists. |
2355 | new pseudo-characters when no precomposed form exists. |
| 2229 | |
2356 | |
| 2230 | Without --enable-unicode3, the number of additional precomposed |
2357 | Without --enable-unicode3, the number of additional precomposed characters |
| 2231 | characters is rather limited (2048, if this is full, rxvt will use the |
2358 | is rather limited (2048, if this is full, rxvt-unicode will use the |
| 2232 | private use area, extending the number of combinations to 8448). With |
2359 | private use area, extending the number of combinations to 8448). With |
| 2233 | --enable-unicode3, no practical limit exists. This will also enable |
2360 | --enable-unicode3, no practical limit exists. |
| 2234 | storage of characters >65535. |
2361 | |
|
|
2362 | This option will also enable storage (but not display) of characters |
|
|
2363 | beyond plane 0 (>65535) when --enable-unicode3 was not specified. |
| 2235 | |
2364 | |
| 2236 | The combining table also contains entries for arabic presentation forms, |
2365 | The combining table also contains entries for arabic presentation forms, |
| 2237 | but these are not currently used. Bug me if you want these to be used. |
2366 | but these are not currently used. Bug me if you want these to be used (and |
|
|
2367 | tell me how these are to be used...). |
| 2238 | |
2368 | |
| 2239 | =item --enable-fallback(=CLASS) |
2369 | =item --enable-fallback(=CLASS) (default: Rxvt) |
| 2240 | |
2370 | |
| 2241 | When reading resource settings, also read settings for class CLASS |
2371 | When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. |
| 2242 | (default: Rxvt). To disable resource fallback use --disable-fallback. |
|
|
| 2243 | |
2372 | |
| 2244 | =item --with-res-name=NAME |
2373 | =item --with-res-name=NAME (default: urxvt) |
| 2245 | |
2374 | |
| 2246 | Use the given name (default: urxvt) as default application name when |
2375 | Use the given name as default application name when |
| 2247 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
2376 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
| 2248 | |
2377 | |
| 2249 | =item --with-res-class=CLASS |
2378 | =item --with-res-class=CLASS /default: URxvt) |
| 2250 | |
2379 | |
| 2251 | Use the given class (default: URxvt) as default application class |
2380 | Use the given class as default application class |
| 2252 | when reading resources. Specify --with-res-class=Rxvt to replace |
2381 | when reading resources. Specify --with-res-class=Rxvt to replace |
| 2253 | rxvt. |
2382 | rxvt. |
| 2254 | |
2383 | |
| 2255 | =item --enable-utmp |
2384 | =item --enable-utmp (default: on) |
| 2256 | |
2385 | |
| 2257 | Write user and tty to utmp file (used by programs like F<w>) at |
2386 | Write user and tty to utmp file (used by programs like F<w>) at |
| 2258 | start of rxvt execution and delete information when rxvt exits. |
2387 | start of rxvt execution and delete information when rxvt exits. |
| 2259 | |
2388 | |
| 2260 | =item --enable-wtmp |
2389 | =item --enable-wtmp (default: on) |
| 2261 | |
2390 | |
| 2262 | Write user and tty to wtmp file (used by programs like F<last>) at |
2391 | Write user and tty to wtmp file (used by programs like F<last>) at |
| 2263 | start of rxvt execution and write logout when rxvt exits. This |
2392 | start of rxvt execution and write logout when rxvt exits. This |
| 2264 | option requires --enable-utmp to also be specified. |
2393 | option requires --enable-utmp to also be specified. |
| 2265 | |
2394 | |
| 2266 | =item --enable-lastlog |
2395 | =item --enable-lastlog (default: on) |
| 2267 | |
2396 | |
| 2268 | Write user and tty to lastlog file (used by programs like |
2397 | Write user and tty to lastlog file (used by programs like |
| 2269 | F<lastlogin>) at start of rxvt execution. This option requires |
2398 | F<lastlogin>) at start of rxvt execution. This option requires |
| 2270 | --enable-utmp to also be specified. |
2399 | --enable-utmp to also be specified. |
| 2271 | |
2400 | |
| 2272 | =item --enable-xpm-background |
2401 | =item --enable-xpm-background (default: off) |
| 2273 | |
2402 | |
| 2274 | Add support for XPM background pixmaps. |
2403 | Add support for XPM background pixmaps. |
| 2275 | |
2404 | |
| 2276 | =item --enable-transparency |
2405 | =item --enable-transparency (default: off) |
| 2277 | |
2406 | |
| 2278 | Add support for inheriting parent backgrounds thus giving a fake |
2407 | Add support for inheriting parent backgrounds thus giving a fake |
| 2279 | transparency to the term. |
2408 | transparency to the term. |
| 2280 | |
2409 | |
| 2281 | =item --enable-fading |
2410 | =item --enable-fading (default: on) |
| 2282 | |
2411 | |
| 2283 | Add support for fading the text when focus is lost. |
2412 | Add support for fading the text when focus is lost (requires C<--enable-transparency>). |
| 2284 | |
2413 | |
| 2285 | =item --enable-tinting |
2414 | =item --enable-tinting (default: on) |
| 2286 | |
2415 | |
| 2287 | Add support for tinting of transparent backgrounds. |
2416 | Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). |
| 2288 | |
2417 | |
| 2289 | =item --enable-menubar |
2418 | =item --enable-menubar (default: off) |
| 2290 | |
2419 | |
| 2291 | Add support for our menu bar system (this interacts badly with |
2420 | Add support for our menu bar system (this interacts badly with |
| 2292 | dynamic locale switching currently). |
2421 | dynamic locale switching currently). |
| 2293 | |
2422 | |
| 2294 | =item --enable-rxvt-scroll |
2423 | =item --enable-rxvt-scroll (default: on) |
| 2295 | |
2424 | |
| 2296 | Add support for the original rxvt scrollbar. |
2425 | Add support for the original rxvt scrollbar. |
| 2297 | |
2426 | |
| 2298 | =item --enable-next-scroll |
2427 | =item --enable-next-scroll (default: on) |
| 2299 | |
2428 | |
| 2300 | Add support for a NeXT-like scrollbar. |
2429 | Add support for a NeXT-like scrollbar. |
| 2301 | |
2430 | |
| 2302 | =item --enable-xterm-scroll |
2431 | =item --enable-xterm-scroll (default: on) |
| 2303 | |
2432 | |
| 2304 | Add support for an Xterm-like scrollbar. |
2433 | Add support for an Xterm-like scrollbar. |
| 2305 | |
2434 | |
| 2306 | =item --enable-plain-scroll |
2435 | =item --enable-plain-scroll (default: on) |
| 2307 | |
2436 | |
| 2308 | Add support for a very unobtrusive, plain-looking scrollbar that |
2437 | Add support for a very unobtrusive, plain-looking scrollbar that |
| 2309 | is the favourite of the rxvt-unicode author, having used it for |
2438 | is the favourite of the rxvt-unicode author, having used it for |
| 2310 | many years. |
2439 | many years. |
| 2311 | |
2440 | |
| 2312 | =item --enable-half-shadow |
2441 | =item --enable-half-shadow (default: off) |
| 2313 | |
2442 | |
| 2314 | Make shadows on the scrollbar only half the normal width & height. |
2443 | Make shadows on the scrollbar only half the normal width & height. |
| 2315 | only applicable to rxvt scrollbars. |
2444 | only applicable to rxvt scrollbars. |
| 2316 | |
2445 | |
| 2317 | =item --enable-ttygid |
2446 | =item --enable-ttygid (default: off) |
| 2318 | |
2447 | |
| 2319 | Change tty device setting to group "tty" - only use this if |
2448 | Change tty device setting to group "tty" - only use this if |
| 2320 | your system uses this type of security. |
2449 | your system uses this type of security. |
| 2321 | |
2450 | |
| 2322 | =item --disable-backspace-key |
2451 | =item --disable-backspace-key |
| 2323 | |
2452 | |
| 2324 | Disable any handling of the backspace key by us - let the X server |
2453 | Removes any handling of the backspace key by us - let the X server do it. |
|
|
2454 | |
|
|
2455 | =item --disable-delete-key |
|
|
2456 | |
|
|
2457 | Removes any handling of the delete key by us - let the X server |
| 2325 | do it. |
2458 | do it. |
| 2326 | |
2459 | |
| 2327 | =item --disable-delete-key |
|
|
| 2328 | |
|
|
| 2329 | Disable any handling of the delete key by us - let the X server |
|
|
| 2330 | do it. |
|
|
| 2331 | |
|
|
| 2332 | =item --disable-resources |
2460 | =item --disable-resources |
| 2333 | |
2461 | |
| 2334 | Remove all resources checking. |
2462 | Removes any support for resource checking. |
| 2335 | |
2463 | |
| 2336 | =item --enable-xgetdefault |
2464 | =item --enable-xgetdefault |
| 2337 | |
2465 | |
| 2338 | Make resources checking via XGetDefault() instead of our small |
2466 | Make resources checking via XGetDefault() instead of our small |
| 2339 | version which only checks ~/.Xdefaults, or if that doesn't exist then |
2467 | version which only checks ~/.Xdefaults, or if that doesn't exist then |
| … | |
… | |
| 2341 | |
2469 | |
| 2342 | Please note that nowadays, things like XIM will automatically pull in and |
2470 | Please note that nowadays, things like XIM will automatically pull in and |
| 2343 | use the full X resource manager, so the overhead of using it might be very |
2471 | use the full X resource manager, so the overhead of using it might be very |
| 2344 | small, if nonexistant. |
2472 | small, if nonexistant. |
| 2345 | |
2473 | |
| 2346 | =item --enable-strings |
2474 | =item --enable-strings (default: off) |
| 2347 | |
2475 | |
| 2348 | Add support for our possibly faster memset() function and other |
2476 | Add support for our possibly faster memset() function and other |
| 2349 | various routines, overriding your system's versions which may |
2477 | various routines, overriding your system's versions which may |
| 2350 | have been hand-crafted in assembly or may require extra libraries |
2478 | have been hand-crafted in assembly or may require extra libraries |
| 2351 | to link in. (this breaks ANSI-C rules and has problems on many |
2479 | to link in. (this breaks ANSI-C rules and has problems on many |
| 2352 | GNU/Linux systems). |
2480 | GNU/Linux systems). |
| 2353 | |
2481 | |
| 2354 | =item --disable-swapscreen |
2482 | =item --disable-swapscreen |
| 2355 | |
2483 | |
| 2356 | Remove support for swap screen. |
2484 | Remove support for secondary/swap screen. |
| 2357 | |
2485 | |
| 2358 | =item --enable-frills |
2486 | =item --enable-frills (default: on) |
| 2359 | |
2487 | |
| 2360 | Add support for many small features that are not essential but nice to |
2488 | Add support for many small features that are not essential but nice to |
| 2361 | have. Normally you want this, but for very small binaries you may want to |
2489 | have. Normally you want this, but for very small binaries you may want to |
| 2362 | disable this. |
2490 | disable this. |
| 2363 | |
2491 | |
| 2364 | A non-exhaustive list of features enabled by C<--enable-frills> (possibly |
2492 | A non-exhaustive list of features enabled by C<--enable-frills> (possibly |
| 2365 | in combination with other switches) is: |
2493 | in combination with other switches) is: |
| 2366 | |
2494 | |
| 2367 | MWM-hints |
2495 | MWM-hints |
|
|
2496 | EWMH-hints (pid, utf8 names) and protocols (ping) |
| 2368 | seperate underline colour |
2497 | seperate underline colour |
| 2369 | settable border widths and borderless switch |
2498 | settable border widths and borderless switch |
| 2370 | settable extra linespacing |
2499 | settable extra linespacing |
| 2371 | extra window properties (e.g. UTF-8 window names and PID) |
|
|
| 2372 | iso-14755-2 and -3, and visual feedback |
2500 | iso-14755-2 and -3, and visual feedback |
| 2373 | backindex and forwardindex escape sequence |
2501 | backindex and forwardindex escape sequence |
| 2374 | window op and locale change escape sequences |
2502 | window op and some xterm/OSC escape sequences |
| 2375 | tripleclickwords |
2503 | tripleclickwords |
| 2376 | settable insecure mode |
2504 | settable insecure mode |
| 2377 | keysym remapping support |
2505 | keysym remapping support |
|
|
2506 | cursor blinking and underline cursor |
|
|
2507 | -embed, -pty-fd and -hold options |
| 2378 | |
2508 | |
| 2379 | =item --enable-iso14755 |
2509 | =item --enable-iso14755 (default: on) |
| 2380 | |
2510 | |
| 2381 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2511 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
| 2382 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
2512 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
| 2383 | C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with |
2513 | C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with |
| 2384 | this switch. |
2514 | this switch. |
| 2385 | |
2515 | |
| 2386 | =item --enable-keepscrolling |
2516 | =item --enable-keepscrolling (default: on) |
| 2387 | |
2517 | |
| 2388 | Add support for continual scrolling of the display when you hold |
2518 | Add support for continual scrolling of the display when you hold |
| 2389 | the mouse button down on a scrollbar arrow. |
2519 | the mouse button down on a scrollbar arrow. |
| 2390 | |
2520 | |
| 2391 | =item --enable-mousewheel |
2521 | =item --enable-mousewheel (default: on) |
| 2392 | |
2522 | |
| 2393 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2523 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
| 2394 | |
2524 | |
| 2395 | =item --enable-slipwheeling |
2525 | =item --enable-slipwheeling (default: on) |
| 2396 | |
2526 | |
| 2397 | Add support for continual scrolling (using the mouse wheel as an |
2527 | Add support for continual scrolling (using the mouse wheel as an |
| 2398 | accelerator) while the control key is held down. This option |
2528 | accelerator) while the control key is held down. This option |
| 2399 | requires --enable-mousewheel to also be specified. |
2529 | requires --enable-mousewheel to also be specified. |
| 2400 | |
2530 | |
| 2401 | =item --disable-new-selection |
2531 | =item --disable-new-selection |
| 2402 | |
2532 | |
| 2403 | Remove support for mouse selection style like that of xterm. |
2533 | Remove support for mouse selection style like that of xterm. |
| 2404 | |
2534 | |
| 2405 | =item --enable-dmalloc |
2535 | =item --enable-dmalloc (default: off) |
| 2406 | |
2536 | |
| 2407 | Use Gray Watson's malloc - which is good for debugging See |
2537 | Use Gray Watson's malloc - which is good for debugging See |
| 2408 | http://www.letters.com/dmalloc/ for details If you use either this or the |
2538 | http://www.letters.com/dmalloc/ for details If you use either this or the |
| 2409 | next option, you may need to edit src/Makefile after compiling to point |
2539 | next option, you may need to edit src/Makefile after compiling to point |
| 2410 | DINCLUDE and DLIB to the right places. |
2540 | DINCLUDE and DLIB to the right places. |
| 2411 | |
2541 | |
| 2412 | You can only use either this option and the following (should |
2542 | You can only use either this option and the following (should |
| 2413 | you use either) . |
2543 | you use either) . |
| 2414 | |
2544 | |
| 2415 | =item --enable-dlmalloc |
2545 | =item --enable-dlmalloc (default: off) |
| 2416 | |
2546 | |
| 2417 | Use Doug Lea's malloc - which is good for a production version |
2547 | Use Doug Lea's malloc - which is good for a production version |
| 2418 | See L<http://g.oswego.edu/dl/html/malloc.html> for details. |
2548 | See L<http://g.oswego.edu/dl/html/malloc.html> for details. |
| 2419 | |
2549 | |
| 2420 | =item --enable-smart-resize |
2550 | =item --enable-smart-resize (default: on) |
| 2421 | |
2551 | |
| 2422 | Add smart growth/shrink behaviour when changing font size via from hot |
2552 | Add smart growth/shrink behaviour when changing font size via hot |
| 2423 | keys. This should keep in a fixed position the rxvt corner which is |
2553 | keys. This should keep the window corner which is closest to a corner of |
| 2424 | closest to a corner of the screen. |
2554 | the screen in a fixed position. |
| 2425 | |
2555 | |
| 2426 | =item --enable-cursor-blink |
|
|
| 2427 | |
|
|
| 2428 | Add support for a blinking cursor. |
|
|
| 2429 | |
|
|
| 2430 | =item --enable-pointer-blank |
2556 | =item --enable-pointer-blank (default: on) |
| 2431 | |
2557 | |
| 2432 | Add support to have the pointer disappear when typing or inactive. |
2558 | Add support to have the pointer disappear when typing or inactive. |
| 2433 | |
2559 | |
| 2434 | =item --with-name=NAME |
2560 | =item --with-name=NAME (default: urxvt) |
| 2435 | |
2561 | |
| 2436 | Set the basename for the installed binaries (default: C<urxvt>, resulting |
2562 | Set the basename for the installed binaries, resulting |
| 2437 | in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with |
2563 | in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with |
| 2438 | C<rxvt>. |
2564 | C<rxvt>. |
| 2439 | |
2565 | |
| 2440 | =item --with-term=NAME |
2566 | =item --with-term=NAME (default: rxvt-unicode) |
| 2441 | |
2567 | |
| 2442 | Change the environmental variable for the terminal to NAME (default |
2568 | Change the environmental variable for the terminal to NAME. |
| 2443 | C<rxvt-unicode>) |
|
|
| 2444 | |
2569 | |
| 2445 | =item --with-terminfo=PATH |
2570 | =item --with-terminfo=PATH |
| 2446 | |
2571 | |
| 2447 | Change the environmental variable for the path to the terminfo tree to |
2572 | Change the environmental variable for the path to the terminfo tree to |
| 2448 | PATH. |
2573 | PATH. |
