… | |
… | |
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. |
… | |
… | |
71 | |
159 | |
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. |
|
|
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. |
76 | |
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 | |
… | |
… | |
258 | might be forced to use a different font. |
351 | might be forced to use a different font. |
259 | |
352 | |
260 | 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 |
261 | box data is correct. |
354 | box data is correct. |
262 | |
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 | |
263 | =item My Compose (Multi_key) key is no longer working. |
364 | =item My Compose (Multi_key) key is no longer working. |
264 | |
365 | |
265 | 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 |
266 | 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 |
267 | your input method. For example, if you specified B<OverTheSpot> and |
368 | your input method. For example, if you specified B<OverTheSpot> and |
… | |
… | |
310 | |
411 | |
311 | 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 |
312 | 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 |
313 | 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. |
314 | |
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 | |
315 | 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 |
316 | 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) |
317 | non-standardized) representation of B<wchar_t> makes it impossible to |
421 | representation of B<wchar_t> makes it impossible to convert between |
318 | 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 |
319 | other encoding without implementing OS-specific-wrappers for each and |
423 | without implementing OS-specific-wrappers for each and every locale. There |
320 | 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 |
321 | except the current locale encoding. |
425 | locale encoding. |
322 | |
426 | |
323 | Some applications (such as the formidable B<mlterm>) work around this |
427 | Some applications (such as the formidable B<mlterm>) work around this |
324 | by carrying their own replacement functions for character set handling |
428 | by carrying their own replacement functions for character set handling |
325 | with them, and either implementing OS-dependent hacks or doing multiple |
429 | with them, and either implementing OS-dependent hacks or doing multiple |
326 | conversions (which is slow and unreliable in case the OS implements |
430 | conversions (which is slow and unreliable in case the OS implements |
327 | encodings slightly different than the terminal emulator). |
431 | encodings slightly different than the terminal emulator). |
328 | |
432 | |
329 | 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 |
330 | 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 |
331 | 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. |
332 | |
454 | |
333 | =item How does rxvt-unicode determine the encoding to use? |
455 | =item How does rxvt-unicode determine the encoding to use? |
334 | |
456 | |
335 | =item Is there an option to switch encodings? |
457 | =item Is there an option to switch encodings? |
336 | |
458 | |
… | |
… | |
452 | |
574 | |
453 | =item Can I speed up Xft rendering somehow? |
575 | =item Can I speed up Xft rendering somehow? |
454 | |
576 | |
455 | 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 |
456 | 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 |
457 | antialiasing (by appending C<:antialiasing=false>), which saves lots of |
579 | antialiasing (by appending C<:antialias=false>), which saves lots of |
458 | memory and also speeds up rendering considerably. |
580 | memory and also speeds up rendering considerably. |
459 | |
581 | |
460 | =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? |
461 | |
583 | |
462 | 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 |
… | |
… | |
540 | URxvt.color7: #e1dddd |
662 | URxvt.color7: #e1dddd |
541 | URxvt.color15: #e1dddd |
663 | URxvt.color15: #e1dddd |
542 | |
664 | |
543 | =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? |
544 | |
666 | |
545 | 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 |
546 | server that answers @@RXVT_NAME@@c's requests, so it doesn't background |
668 | display, create the listening socket and then fork. |
547 | itself. |
|
|
548 | |
|
|
549 | To ensure @@RXVT_NAME@@d is listening on it's socket, you can use the |
|
|
550 | following method to wait for the startup message before continuing: |
|
|
551 | |
|
|
552 | { @@RXVT_NAME@@d & } | read |
|
|
553 | |
669 | |
554 | =item What's with the strange Backspace/Delete key behaviour? |
670 | =item What's with the strange Backspace/Delete key behaviour? |
555 | |
671 | |
556 | Assuming that the physical Backspace key corresponds to the |
672 | Assuming that the physical Backspace key corresponds to the |
557 | BackSpace keysym (not likely for Linux ... see the following |
673 | BackSpace keysym (not likely for Linux ... see the following |
… | |
… | |
2156 | =end table |
2272 | =end table |
2157 | |
2273 | |
2158 | =head1 CONFIGURE OPTIONS |
2274 | =head1 CONFIGURE OPTIONS |
2159 | |
2275 | |
2160 | General hint: if you get compile errors, then likely your configuration |
2276 | General hint: if you get compile errors, then likely your configuration |
2161 | 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 |
2162 | ./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 |
2163 | 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 |
2164 | 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 |
2165 | <rxvt@schmorp.de>. |
2281 | Lehmann <rxvt@schmorp.de>. |
|
|
2282 | |
|
|
2283 | All |
2166 | |
2284 | |
2167 | =over 4 |
2285 | =over 4 |
2168 | |
2286 | |
2169 | =item --enable-everything |
2287 | =item --enable-everything |
2170 | |
2288 | |
2171 | Add support for all non-multichoice options listed in "./configure |
2289 | Add (or remove) support for all non-multichoice options listed in "./configure |
2172 | --help". Note that unlike other enable options this is order dependant. |
2290 | --help". |
|
|
2291 | |
2173 | 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 |
2174 | 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. |
2175 | |
2297 | |
2176 | =item --enable-xft |
2298 | =item --enable-xft (default: enabled) |
2177 | |
2299 | |
2178 | 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 |
2179 | 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 |
2180 | don't pay for them. |
2302 | don't pay for them. |
2181 | |
2303 | |
2182 | =item --enable-font-styles |
2304 | =item --enable-font-styles (default: on) |
2183 | |
2305 | |
2184 | 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 |
2185 | styles. The fonts can be set manually or automatically. |
2307 | styles. The fonts can be set manually or automatically. |
2186 | |
2308 | |
2187 | =item --with-codesets=NAME,... |
2309 | =item --with-codesets=NAME,... (default: all) |
2188 | |
2310 | |
2189 | Compile in support for additional codeset (encoding) groups (eu, vn are |
2311 | Compile in support for additional codeset (encoding) groups (C<eu>, C<vn> |
2190 | always compiled in, which includes most 8-bit character sets). These |
2312 | are always compiled in, which includes most 8-bit character sets). These |
2191 | 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 |
2192 | 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 |
2193 | 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 |
2194 | you use an X11 font requiring one of these encodings. |
2317 | memory usage unless you use a font requiring one of these encodings. |
2195 | |
2318 | |
2196 | =begin table |
2319 | =begin table |
2197 | |
2320 | |
2198 | all all available codeset groups |
2321 | all all available codeset groups |
2199 | zh common chinese encodings |
2322 | zh common chinese encodings |
… | |
… | |
2202 | jp_ext rarely used but big japanese encodings |
2325 | jp_ext rarely used but big japanese encodings |
2203 | kr korean encodings |
2326 | kr korean encodings |
2204 | |
2327 | |
2205 | =end table |
2328 | =end table |
2206 | |
2329 | |
2207 | =item --enable-xim |
2330 | =item --enable-xim (default: on) |
2208 | |
2331 | |
2209 | Add support for XIM (X Input Method) protocol. This allows using |
2332 | Add support for XIM (X Input Method) protocol. This allows using |
2210 | alternative input methods (e.g. kinput2) and will also correctly |
2333 | alternative input methods (e.g. kinput2) and will also correctly |
2211 | 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. |
2212 | |
2335 | |
2213 | =item --enable-unicode3 |
2336 | =item --enable-unicode3 (default: off) |
2214 | |
2337 | |
2215 | Enable direct support for displaying unicode codepoints above |
2338 | Enable direct support for displaying unicode codepoints above |
2216 | 65535 (the basic multilingual page). This increases storage |
2339 | 65535 (the basic multilingual page). This increases storage |
2217 | 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 |
2218 | support these extra characters, but Xft does. |
2341 | support these extra characters, but Xft does. |
… | |
… | |
2221 | even without this flag, but the number of such characters is |
2344 | even without this flag, but the number of such characters is |
2222 | limited to a view thousand (shared with combining characters, |
2345 | limited to a view thousand (shared with combining characters, |
2223 | see next switch), and right now rxvt-unicode cannot display them |
2346 | see next switch), and right now rxvt-unicode cannot display them |
2224 | (input/output and cut&paste still work, though). |
2347 | (input/output and cut&paste still work, though). |
2225 | |
2348 | |
2226 | =item --enable-combining |
2349 | =item --enable-combining (default: on) |
2227 | |
2350 | |
2228 | Enable automatic composition of combining characters into |
2351 | Enable automatic composition of combining characters into |
2229 | composite characters. This is required for proper viewing of text |
2352 | composite characters. This is required for proper viewing of text |
2230 | where accents are encoded as seperate unicode characters. This is |
2353 | where accents are encoded as seperate unicode characters. This is |
2231 | done by using precomposited characters when available or creating |
2354 | done by using precomposited characters when available or creating |
… | |
… | |
2241 | |
2364 | |
2242 | The combining table also contains entries for arabic presentation forms, |
2365 | The combining table also contains entries for arabic presentation forms, |
2243 | but these are not currently used. Bug me if you want these to be used (and |
2366 | but these are not currently used. Bug me if you want these to be used (and |
2244 | tell me how these are to be used...). |
2367 | tell me how these are to be used...). |
2245 | |
2368 | |
2246 | =item --enable-fallback(=CLASS) |
2369 | =item --enable-fallback(=CLASS) (default: Rxvt) |
2247 | |
2370 | |
2248 | 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. |
2249 | (default: Rxvt). To disable resource fallback use --disable-fallback. |
|
|
2250 | |
2372 | |
2251 | =item --with-res-name=NAME |
2373 | =item --with-res-name=NAME (default: urxvt) |
2252 | |
2374 | |
2253 | Use the given name (default: urxvt) as default application name when |
2375 | Use the given name as default application name when |
2254 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
2376 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
2255 | |
2377 | |
2256 | =item --with-res-class=CLASS |
2378 | =item --with-res-class=CLASS /default: URxvt) |
2257 | |
2379 | |
2258 | Use the given class (default: URxvt) as default application class |
2380 | Use the given class as default application class |
2259 | when reading resources. Specify --with-res-class=Rxvt to replace |
2381 | when reading resources. Specify --with-res-class=Rxvt to replace |
2260 | rxvt. |
2382 | rxvt. |
2261 | |
2383 | |
2262 | =item --enable-utmp |
2384 | =item --enable-utmp (default: on) |
2263 | |
2385 | |
2264 | 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 |
2265 | start of rxvt execution and delete information when rxvt exits. |
2387 | start of rxvt execution and delete information when rxvt exits. |
2266 | |
2388 | |
2267 | =item --enable-wtmp |
2389 | =item --enable-wtmp (default: on) |
2268 | |
2390 | |
2269 | 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 |
2270 | start of rxvt execution and write logout when rxvt exits. This |
2392 | start of rxvt execution and write logout when rxvt exits. This |
2271 | option requires --enable-utmp to also be specified. |
2393 | option requires --enable-utmp to also be specified. |
2272 | |
2394 | |
2273 | =item --enable-lastlog |
2395 | =item --enable-lastlog (default: on) |
2274 | |
2396 | |
2275 | Write user and tty to lastlog file (used by programs like |
2397 | Write user and tty to lastlog file (used by programs like |
2276 | F<lastlogin>) at start of rxvt execution. This option requires |
2398 | F<lastlogin>) at start of rxvt execution. This option requires |
2277 | --enable-utmp to also be specified. |
2399 | --enable-utmp to also be specified. |
2278 | |
2400 | |
2279 | =item --enable-xpm-background |
2401 | =item --enable-xpm-background (default: off) |
2280 | |
2402 | |
2281 | Add support for XPM background pixmaps. |
2403 | Add support for XPM background pixmaps. |
2282 | |
2404 | |
2283 | =item --enable-transparency |
2405 | =item --enable-transparency (default: off) |
2284 | |
2406 | |
2285 | Add support for inheriting parent backgrounds thus giving a fake |
2407 | Add support for inheriting parent backgrounds thus giving a fake |
2286 | transparency to the term. |
2408 | transparency to the term. |
2287 | |
2409 | |
2288 | =item --enable-fading |
2410 | =item --enable-fading (default: on) |
2289 | |
2411 | |
2290 | 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>). |
2291 | |
2413 | |
2292 | =item --enable-tinting |
2414 | =item --enable-tinting (default: on) |
2293 | |
2415 | |
2294 | Add support for tinting of transparent backgrounds. |
2416 | Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). |
2295 | |
2417 | |
2296 | =item --enable-menubar |
2418 | =item --enable-menubar (default: off) |
2297 | |
2419 | |
2298 | Add support for our menu bar system (this interacts badly with |
2420 | Add support for our menu bar system (this interacts badly with |
2299 | dynamic locale switching currently). |
2421 | dynamic locale switching currently). |
2300 | |
2422 | |
2301 | =item --enable-rxvt-scroll |
2423 | =item --enable-rxvt-scroll (default: on) |
2302 | |
2424 | |
2303 | Add support for the original rxvt scrollbar. |
2425 | Add support for the original rxvt scrollbar. |
2304 | |
2426 | |
2305 | =item --enable-next-scroll |
2427 | =item --enable-next-scroll (default: on) |
2306 | |
2428 | |
2307 | Add support for a NeXT-like scrollbar. |
2429 | Add support for a NeXT-like scrollbar. |
2308 | |
2430 | |
2309 | =item --enable-xterm-scroll |
2431 | =item --enable-xterm-scroll (default: on) |
2310 | |
2432 | |
2311 | Add support for an Xterm-like scrollbar. |
2433 | Add support for an Xterm-like scrollbar. |
2312 | |
2434 | |
2313 | =item --enable-plain-scroll |
2435 | =item --enable-plain-scroll (default: on) |
2314 | |
2436 | |
2315 | Add support for a very unobtrusive, plain-looking scrollbar that |
2437 | Add support for a very unobtrusive, plain-looking scrollbar that |
2316 | 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 |
2317 | many years. |
2439 | many years. |
2318 | |
2440 | |
2319 | =item --enable-half-shadow |
2441 | =item --enable-half-shadow (default: off) |
2320 | |
2442 | |
2321 | Make shadows on the scrollbar only half the normal width & height. |
2443 | Make shadows on the scrollbar only half the normal width & height. |
2322 | only applicable to rxvt scrollbars. |
2444 | only applicable to rxvt scrollbars. |
2323 | |
2445 | |
2324 | =item --enable-ttygid |
2446 | =item --enable-ttygid (default: off) |
2325 | |
2447 | |
2326 | Change tty device setting to group "tty" - only use this if |
2448 | Change tty device setting to group "tty" - only use this if |
2327 | your system uses this type of security. |
2449 | your system uses this type of security. |
2328 | |
2450 | |
2329 | =item --disable-backspace-key |
2451 | =item --disable-backspace-key |
2330 | |
2452 | |
2331 | 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 |
2332 | do it. |
2458 | do it. |
2333 | |
2459 | |
2334 | =item --disable-delete-key |
|
|
2335 | |
|
|
2336 | Disable any handling of the delete key by us - let the X server |
|
|
2337 | do it. |
|
|
2338 | |
|
|
2339 | =item --disable-resources |
2460 | =item --disable-resources |
2340 | |
2461 | |
2341 | Remove all resources checking. |
2462 | Removes any support for resource checking. |
2342 | |
2463 | |
2343 | =item --enable-xgetdefault |
2464 | =item --enable-xgetdefault |
2344 | |
2465 | |
2345 | Make resources checking via XGetDefault() instead of our small |
2466 | Make resources checking via XGetDefault() instead of our small |
2346 | 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 |
… | |
… | |
2348 | |
2469 | |
2349 | 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 |
2350 | 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 |
2351 | small, if nonexistant. |
2472 | small, if nonexistant. |
2352 | |
2473 | |
2353 | =item --enable-strings |
2474 | =item --enable-strings (default: off) |
2354 | |
2475 | |
2355 | Add support for our possibly faster memset() function and other |
2476 | Add support for our possibly faster memset() function and other |
2356 | various routines, overriding your system's versions which may |
2477 | various routines, overriding your system's versions which may |
2357 | have been hand-crafted in assembly or may require extra libraries |
2478 | have been hand-crafted in assembly or may require extra libraries |
2358 | 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 |
2359 | GNU/Linux systems). |
2480 | GNU/Linux systems). |
2360 | |
2481 | |
2361 | =item --disable-swapscreen |
2482 | =item --disable-swapscreen |
2362 | |
2483 | |
2363 | Remove support for swap screen. |
2484 | Remove support for secondary/swap screen. |
2364 | |
2485 | |
2365 | =item --enable-frills |
2486 | =item --enable-frills (default: on) |
2366 | |
2487 | |
2367 | 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 |
2368 | 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 |
2369 | disable this. |
2490 | disable this. |
2370 | |
2491 | |
… | |
… | |
2380 | backindex and forwardindex escape sequence |
2501 | backindex and forwardindex escape sequence |
2381 | window op and some xterm/OSC escape sequences |
2502 | window op and some xterm/OSC escape sequences |
2382 | tripleclickwords |
2503 | tripleclickwords |
2383 | settable insecure mode |
2504 | settable insecure mode |
2384 | keysym remapping support |
2505 | keysym remapping support |
|
|
2506 | cursor blinking and underline cursor |
2385 | -embed and -pty-fd options |
2507 | -embed, -pty-fd and -hold options |
2386 | |
2508 | |
2387 | =item --enable-iso14755 |
2509 | =item --enable-iso14755 (default: on) |
2388 | |
2510 | |
2389 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2511 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2390 | 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 |
2391 | 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 |
2392 | this switch. |
2514 | this switch. |
2393 | |
2515 | |
2394 | =item --enable-keepscrolling |
2516 | =item --enable-keepscrolling (default: on) |
2395 | |
2517 | |
2396 | Add support for continual scrolling of the display when you hold |
2518 | Add support for continual scrolling of the display when you hold |
2397 | the mouse button down on a scrollbar arrow. |
2519 | the mouse button down on a scrollbar arrow. |
2398 | |
2520 | |
2399 | =item --enable-mousewheel |
2521 | =item --enable-mousewheel (default: on) |
2400 | |
2522 | |
2401 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2523 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2402 | |
2524 | |
2403 | =item --enable-slipwheeling |
2525 | =item --enable-slipwheeling (default: on) |
2404 | |
2526 | |
2405 | Add support for continual scrolling (using the mouse wheel as an |
2527 | Add support for continual scrolling (using the mouse wheel as an |
2406 | accelerator) while the control key is held down. This option |
2528 | accelerator) while the control key is held down. This option |
2407 | requires --enable-mousewheel to also be specified. |
2529 | requires --enable-mousewheel to also be specified. |
2408 | |
2530 | |
2409 | =item --disable-new-selection |
2531 | =item --disable-new-selection |
2410 | |
2532 | |
2411 | Remove support for mouse selection style like that of xterm. |
2533 | Remove support for mouse selection style like that of xterm. |
2412 | |
2534 | |
2413 | =item --enable-dmalloc |
2535 | =item --enable-dmalloc (default: off) |
2414 | |
2536 | |
2415 | Use Gray Watson's malloc - which is good for debugging See |
2537 | Use Gray Watson's malloc - which is good for debugging See |
2416 | 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 |
2417 | 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 |
2418 | DINCLUDE and DLIB to the right places. |
2540 | DINCLUDE and DLIB to the right places. |
2419 | |
2541 | |
2420 | You can only use either this option and the following (should |
2542 | You can only use either this option and the following (should |
2421 | you use either) . |
2543 | you use either) . |
2422 | |
2544 | |
2423 | =item --enable-dlmalloc |
2545 | =item --enable-dlmalloc (default: off) |
2424 | |
2546 | |
2425 | 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 |
2426 | 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. |
2427 | |
2549 | |
2428 | =item --enable-smart-resize |
2550 | =item --enable-smart-resize (default: on) |
2429 | |
2551 | |
2430 | Add smart growth/shrink behaviour when changing font size via from hot |
2552 | Add smart growth/shrink behaviour when changing font size via hot |
2431 | 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 |
2432 | closest to a corner of the screen. |
2554 | the screen in a fixed position. |
2433 | |
2555 | |
2434 | =item --enable-cursor-blink |
|
|
2435 | |
|
|
2436 | Add support for a blinking cursor. |
|
|
2437 | |
|
|
2438 | =item --enable-pointer-blank |
2556 | =item --enable-pointer-blank (default: on) |
2439 | |
2557 | |
2440 | Add support to have the pointer disappear when typing or inactive. |
2558 | Add support to have the pointer disappear when typing or inactive. |
2441 | |
2559 | |
2442 | =item --with-name=NAME |
2560 | =item --with-name=NAME (default: urxvt) |
2443 | |
2561 | |
2444 | Set the basename for the installed binaries (default: C<urxvt>, resulting |
2562 | Set the basename for the installed binaries, resulting |
2445 | 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 |
2446 | C<rxvt>. |
2564 | C<rxvt>. |
2447 | |
2565 | |
2448 | =item --with-term=NAME |
2566 | =item --with-term=NAME (default: rxvt-unicode) |
2449 | |
2567 | |
2450 | Change the environmental variable for the terminal to NAME (default |
2568 | Change the environmental variable for the terminal to NAME. |
2451 | C<rxvt-unicode>) |
|
|
2452 | |
2569 | |
2453 | =item --with-terminfo=PATH |
2570 | =item --with-terminfo=PATH |
2454 | |
2571 | |
2455 | 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 |
2456 | PATH. |
2573 | PATH. |