… | |
… | |
31 | The version number is displayed with the usage (-h). Also the escape |
31 | 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. |
32 | sequence C<ESC [ 8 n> sets the window title to the version number. |
33 | |
33 | |
34 | =item I am using Debian GNU/Linux and have a problem... |
34 | =item I am using Debian GNU/Linux and have a problem... |
35 | |
35 | |
36 | The Debian GNU/Linux package of rxvt-unicode contains large patches that |
36 | The Debian GNU/Linux package of rxvt-unicode in sarge contains large |
37 | considerably change the behaviour of rxvt-unicode. Before reporting a |
37 | patches that considerably change the behaviour of rxvt-unicode. Before |
38 | bug to the original rxvt-unicode author please download and install the |
38 | 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 |
39 | install the genuine version (L<http://software.schmorp.de#rxvt-unicode>) |
40 | reproduce the problem. If you cannot, chances are that the problems are |
40 | 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 |
41 | 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). |
42 | reported via the Debian Bug Tracking System (use C<reportbug> to report |
|
|
43 | the bug). |
43 | |
44 | |
44 | For other problems that also affect the Debian package, you can and |
45 | 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 |
46 | 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 |
47 | bug in the Debian version and it serves as a reminder for other users that |
47 | might encounter the same issue. |
48 | might encounter the same issue. |
… | |
… | |
71 | |
72 | |
72 | URxvt.termName: rxvt |
73 | URxvt.termName: rxvt |
73 | |
74 | |
74 | If you don't plan to use B<rxvt> (quite common...) you could also replace |
75 | 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. |
76 | the rxvt terminfo file with the rxvt-unicode one. |
|
|
77 | |
|
|
78 | =item C<tic> outputs some error when compiling the terminfo entry. |
|
|
79 | |
|
|
80 | Most likely it's the empty definition for C<enacs=>. Just replace it by |
|
|
81 | C<enacs=\E[0@> and try again. |
76 | |
82 | |
77 | =item C<bash>'s readline does not work correctly under @@RXVT_NAME@@. |
83 | =item C<bash>'s readline does not work correctly under @@RXVT_NAME@@. |
78 | |
84 | |
79 | =item I need a termcap file entry. |
85 | =item I need a termcap file entry. |
80 | |
86 | |
… | |
… | |
258 | might be forced to use a different font. |
264 | might be forced to use a different font. |
259 | |
265 | |
260 | All of this is not a problem when using X11 core fonts, as their bounding |
266 | All of this is not a problem when using X11 core fonts, as their bounding |
261 | box data is correct. |
267 | box data is correct. |
262 | |
268 | |
|
|
269 | =item On Solaris 9, many line-drawing characters are too wide. |
|
|
270 | |
|
|
271 | Seems to be a known bug, read |
|
|
272 | L<http://nixdoc.net/files/forum/about34198.html>. Some people use the |
|
|
273 | following ugly workaround to get non-double-wide-characters working: |
|
|
274 | |
|
|
275 | #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x) |
|
|
276 | |
263 | =item My Compose (Multi_key) key is no longer working. |
277 | =item My Compose (Multi_key) key is no longer working. |
264 | |
278 | |
265 | The most common causes for this are that either your locale is not set |
279 | 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 |
280 | correctly, or you specified a B<preeditStyle> that is not supported by |
267 | your input method. For example, if you specified B<OverTheSpot> and |
281 | your input method. For example, if you specified B<OverTheSpot> and |
… | |
… | |
310 | |
324 | |
311 | As you might have guessed, FreeBSD does neither define this symobl nor |
325 | 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 |
326 | 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. |
327 | B<wchar_t>. This is, of course, completely fine with respect to standards. |
314 | |
328 | |
|
|
329 | However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and |
|
|
330 | C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>. |
|
|
331 | |
315 | However, C<__STDC_ISO_10646__> is the only sane way to support |
332 | 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 |
333 | apps in an OS, as using a locale-dependent (and non-standardized) |
317 | non-standardized) representation of B<wchar_t> makes it impossible to |
334 | 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 |
335 | 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 |
336 | 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 |
337 | simply are no APIs to convert B<wchar_t> into anything except the current |
321 | except the current locale encoding. |
338 | locale encoding. |
322 | |
339 | |
323 | Some applications (such as the formidable B<mlterm>) work around this |
340 | Some applications (such as the formidable B<mlterm>) work around this |
324 | by carrying their own replacement functions for character set handling |
341 | by carrying their own replacement functions for character set handling |
325 | with them, and either implementing OS-dependent hacks or doing multiple |
342 | with them, and either implementing OS-dependent hacks or doing multiple |
326 | conversions (which is slow and unreliable in case the OS implements |
343 | conversions (which is slow and unreliable in case the OS implements |
327 | encodings slightly different than the terminal emulator). |
344 | encodings slightly different than the terminal emulator). |
328 | |
345 | |
329 | The rxvt-unicode author insists that the right way to fix this is in the |
346 | 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 |
347 | system libraries once and for all, instead of forcing every app to carry |
331 | complete replacements for them :) |
348 | complete replacements for them :) |
|
|
349 | |
|
|
350 | =item I use Solaris 9 and it doesn't compile/work/etc. |
|
|
351 | |
|
|
352 | Try the diff in F<doc/solaris9.patch> as a base. It fixes the worst |
|
|
353 | problems with C<wcwidth> and a compile problem. |
|
|
354 | |
|
|
355 | =item How can I use rxvt-unicode under cygwin? |
|
|
356 | |
|
|
357 | rxvt-unicode should compile and run out of the box on cygwin, using |
|
|
358 | the X11 libraries that come with cygwin. libW11 emulation is no |
|
|
359 | longer supported (and makes no sense, either, as it only supported a |
|
|
360 | single font). I recommend starting the X-server in C<-multiwindow> or |
|
|
361 | C<-rootless> mode instead, which will result in similar look&feel as the |
|
|
362 | old libW11 emulation. |
|
|
363 | |
|
|
364 | At the time of this writing, cygwin didn't seem to support any multi-byte |
|
|
365 | encodings (you might try C<LC_CTYPE=C-UTF-8>), so you are likely limited |
|
|
366 | to 8-bit encodings. |
332 | |
367 | |
333 | =item How does rxvt-unicode determine the encoding to use? |
368 | =item How does rxvt-unicode determine the encoding to use? |
334 | |
369 | |
335 | =item Is there an option to switch encodings? |
370 | =item Is there an option to switch encodings? |
336 | |
371 | |
… | |
… | |
452 | |
487 | |
453 | =item Can I speed up Xft rendering somehow? |
488 | =item Can I speed up Xft rendering somehow? |
454 | |
489 | |
455 | Yes, the most obvious way to speed it up is to avoid Xft entirely, as |
490 | 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 |
491 | 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 |
492 | antialiasing (by appending C<:antialias=false>), which saves lots of |
458 | memory and also speeds up rendering considerably. |
493 | memory and also speeds up rendering considerably. |
459 | |
494 | |
460 | =item Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? |
495 | =item Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? |
461 | |
496 | |
462 | Rxvt-unicode will use whatever you specify as a font. If it needs to |
497 | Rxvt-unicode will use whatever you specify as a font. If it needs to |
… | |
… | |
540 | URxvt.color7: #e1dddd |
575 | URxvt.color7: #e1dddd |
541 | URxvt.color15: #e1dddd |
576 | URxvt.color15: #e1dddd |
542 | |
577 | |
543 | =item How can I start @@RXVT_NAME@@d in a race-free way? |
578 | =item How can I start @@RXVT_NAME@@d in a race-free way? |
544 | |
579 | |
545 | Despite it's name, @@RXVT_NAME@@d is not a real daemon, but more like a |
580 | 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 |
581 | 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 | |
582 | |
554 | =item What's with the strange Backspace/Delete key behaviour? |
583 | =item What's with the strange Backspace/Delete key behaviour? |
555 | |
584 | |
556 | Assuming that the physical Backspace key corresponds to the |
585 | Assuming that the physical Backspace key corresponds to the |
557 | BackSpace keysym (not likely for Linux ... see the following |
586 | BackSpace keysym (not likely for Linux ... see the following |
… | |
… | |
1475 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
1504 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
1476 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
1505 | B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> |
1477 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> |
1506 | B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> |
1478 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> |
1507 | B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> |
1479 | B<< C<Ps = 20> >> Change default background to B<< C<Pt> >> |
1508 | B<< C<Ps = 20> >> Change default background to B<< C<Pt> >> |
1480 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >> I<rxvt compile-time option> |
1509 | B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. |
1481 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
1510 | B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> |
1482 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >> I<rxvt compile-time option> |
1511 | B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. |
1483 | 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> >> |
1512 | 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> >> |
1484 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
1513 | B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> |
1485 | 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) |
1514 | 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). |
1486 | B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> I<rxvt compile-time option> (rxvt-unicode extension) |
1515 | B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> (Compile menubar). |
1487 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
1516 | B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> |
1488 | B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> |
1517 | B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). |
1489 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
1518 | B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. |
1490 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
1519 | B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
1491 | B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
1520 | B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
1492 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50>. |
1521 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
|
|
1522 | B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
|
|
1523 | B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
1493 | |
1524 | |
1494 | =end table |
1525 | =end table |
1495 | |
1526 | |
1496 | =back |
1527 | =back |
1497 | |
1528 | |
… | |
… | |
2154 | =end table |
2185 | =end table |
2155 | |
2186 | |
2156 | =head1 CONFIGURE OPTIONS |
2187 | =head1 CONFIGURE OPTIONS |
2157 | |
2188 | |
2158 | General hint: if you get compile errors, then likely your configuration |
2189 | General hint: if you get compile errors, then likely your configuration |
2159 | hasn't been tested well. Either try with --enable-everything or use the |
2190 | hasn't been tested well. Either try with C<--enable-everything> or use |
2160 | ./reconf script as a base for experiments. ./reconf is used by myself, |
2191 | the F<./reconf> script as a base for experiments. F<./reconf> is used by |
2161 | so it should generally be a working config. Of course, you should always |
2192 | myself, so it should generally be a working config. Of course, you should |
2162 | report when a combination doesn't work, so it can be fixed. Marc Lehmann |
2193 | always report when a combination doesn't work, so it can be fixed. Marc |
2163 | <rxvt@schmorp.de>. |
2194 | Lehmann <rxvt@schmorp.de>. |
|
|
2195 | |
|
|
2196 | All |
2164 | |
2197 | |
2165 | =over 4 |
2198 | =over 4 |
2166 | |
2199 | |
2167 | =item --enable-everything |
2200 | =item --enable-everything |
2168 | |
2201 | |
2169 | Add support for all non-multichoice options listed in "./configure |
2202 | Add (or remove) support for all non-multichoice options listed in "./configure |
2170 | --help". Note that unlike other enable options this is order dependant. |
2203 | --help". |
|
|
2204 | |
2171 | You can specify this and then disable options which this enables by |
2205 | You can specify this and then disable options you do not like by |
2172 | I<following> this with the appropriate commands. |
2206 | I<following> this with the appropriate C<--disable-...> arguments, |
|
|
2207 | or you can start with a minimal configuration by specifying |
|
|
2208 | C<--disable-everything> and than adding just the C<--enable-...> arguments |
|
|
2209 | you want. |
2173 | |
2210 | |
2174 | =item --enable-xft |
2211 | =item --enable-xft (default: enabled) |
2175 | |
2212 | |
2176 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts are |
2213 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts are |
2177 | slower and require lots of memory, but as long as you don't use them, you |
2214 | slower and require lots of memory, but as long as you don't use them, you |
2178 | don't pay for them. |
2215 | don't pay for them. |
2179 | |
2216 | |
2180 | =item --enable-font-styles |
2217 | =item --enable-font-styles (default: on) |
2181 | |
2218 | |
2182 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
2219 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
2183 | styles. The fonts can be set manually or automatically. |
2220 | styles. The fonts can be set manually or automatically. |
2184 | |
2221 | |
2185 | =item --with-codesets=NAME,... |
2222 | =item --with-codesets=NAME,... (default: all) |
2186 | |
2223 | |
2187 | Compile in support for additional codeset (encoding) groups (eu, vn are |
2224 | Compile in support for additional codeset (encoding) groups (C<eu>, C<vn> |
2188 | always compiled in, which includes most 8-bit character sets). These |
2225 | are always compiled in, which includes most 8-bit character sets). These |
2189 | codeset tables are currently only used for driving X11 core fonts, they |
2226 | codeset tables are used for driving X11 core fonts, they are not required |
2190 | are not required for Xft fonts. Compiling them in will make your binary |
2227 | for Xft fonts, although having them compiled in lets rxvt-unicode choose |
2191 | bigger (together about 700kB), but it doesn't increase memory usage unless |
2228 | replacement fonts more intelligently. Compiling them in will make your |
|
|
2229 | binary bigger (all of together cost about 700kB), but it doesn't increase |
2192 | you use an X11 font requiring one of these encodings. |
2230 | memory usage unless you use a font requiring one of these encodings. |
2193 | |
2231 | |
2194 | =begin table |
2232 | =begin table |
2195 | |
2233 | |
2196 | all all available codeset groups |
2234 | all all available codeset groups |
2197 | zh common chinese encodings |
2235 | zh common chinese encodings |
… | |
… | |
2200 | jp_ext rarely used but big japanese encodings |
2238 | jp_ext rarely used but big japanese encodings |
2201 | kr korean encodings |
2239 | kr korean encodings |
2202 | |
2240 | |
2203 | =end table |
2241 | =end table |
2204 | |
2242 | |
2205 | =item --enable-xim |
2243 | =item --enable-xim (default: on) |
2206 | |
2244 | |
2207 | Add support for XIM (X Input Method) protocol. This allows using |
2245 | Add support for XIM (X Input Method) protocol. This allows using |
2208 | alternative input methods (e.g. kinput2) and will also correctly |
2246 | alternative input methods (e.g. kinput2) and will also correctly |
2209 | set up the input for people using dead keys or compose keys. |
2247 | set up the input for people using dead keys or compose keys. |
2210 | |
2248 | |
2211 | =item --enable-unicode3 |
2249 | =item --enable-unicode3 (default: off) |
2212 | |
2250 | |
2213 | Enable direct support for displaying unicode codepoints above |
2251 | Enable direct support for displaying unicode codepoints above |
2214 | 65535 (the basic multilingual page). This increases storage |
2252 | 65535 (the basic multilingual page). This increases storage |
2215 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
2253 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
2216 | support these extra characters, but Xft does. |
2254 | support these extra characters, but Xft does. |
… | |
… | |
2219 | even without this flag, but the number of such characters is |
2257 | even without this flag, but the number of such characters is |
2220 | limited to a view thousand (shared with combining characters, |
2258 | limited to a view thousand (shared with combining characters, |
2221 | see next switch), and right now rxvt-unicode cannot display them |
2259 | see next switch), and right now rxvt-unicode cannot display them |
2222 | (input/output and cut&paste still work, though). |
2260 | (input/output and cut&paste still work, though). |
2223 | |
2261 | |
2224 | =item --enable-combining |
2262 | =item --enable-combining (default: on) |
2225 | |
2263 | |
2226 | Enable automatic composition of combining characters into |
2264 | Enable automatic composition of combining characters into |
2227 | composite characters. This is required for proper viewing of text |
2265 | composite characters. This is required for proper viewing of text |
2228 | where accents are encoded as seperate unicode characters. This is |
2266 | where accents are encoded as seperate unicode characters. This is |
2229 | done by using precomposited characters when available or creating |
2267 | done by using precomposited characters when available or creating |
… | |
… | |
2239 | |
2277 | |
2240 | The combining table also contains entries for arabic presentation forms, |
2278 | The combining table also contains entries for arabic presentation forms, |
2241 | but these are not currently used. Bug me if you want these to be used (and |
2279 | but these are not currently used. Bug me if you want these to be used (and |
2242 | tell me how these are to be used...). |
2280 | tell me how these are to be used...). |
2243 | |
2281 | |
2244 | =item --enable-fallback(=CLASS) |
2282 | =item --enable-fallback(=CLASS) (default: Rxvt) |
2245 | |
2283 | |
2246 | When reading resource settings, also read settings for class CLASS |
2284 | When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. |
2247 | (default: Rxvt). To disable resource fallback use --disable-fallback. |
|
|
2248 | |
2285 | |
2249 | =item --with-res-name=NAME |
2286 | =item --with-res-name=NAME (default: urxvt) |
2250 | |
2287 | |
2251 | Use the given name (default: urxvt) as default application name when |
2288 | Use the given name as default application name when |
2252 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
2289 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
2253 | |
2290 | |
2254 | =item --with-res-class=CLASS |
2291 | =item --with-res-class=CLASS /default: URxvt) |
2255 | |
2292 | |
2256 | Use the given class (default: URxvt) as default application class |
2293 | Use the given class as default application class |
2257 | when reading resources. Specify --with-res-class=Rxvt to replace |
2294 | when reading resources. Specify --with-res-class=Rxvt to replace |
2258 | rxvt. |
2295 | rxvt. |
2259 | |
2296 | |
2260 | =item --enable-utmp |
2297 | =item --enable-utmp (default: on) |
2261 | |
2298 | |
2262 | Write user and tty to utmp file (used by programs like F<w>) at |
2299 | Write user and tty to utmp file (used by programs like F<w>) at |
2263 | start of rxvt execution and delete information when rxvt exits. |
2300 | start of rxvt execution and delete information when rxvt exits. |
2264 | |
2301 | |
2265 | =item --enable-wtmp |
2302 | =item --enable-wtmp (default: on) |
2266 | |
2303 | |
2267 | Write user and tty to wtmp file (used by programs like F<last>) at |
2304 | Write user and tty to wtmp file (used by programs like F<last>) at |
2268 | start of rxvt execution and write logout when rxvt exits. This |
2305 | start of rxvt execution and write logout when rxvt exits. This |
2269 | option requires --enable-utmp to also be specified. |
2306 | option requires --enable-utmp to also be specified. |
2270 | |
2307 | |
2271 | =item --enable-lastlog |
2308 | =item --enable-lastlog (default: on) |
2272 | |
2309 | |
2273 | Write user and tty to lastlog file (used by programs like |
2310 | Write user and tty to lastlog file (used by programs like |
2274 | F<lastlogin>) at start of rxvt execution. This option requires |
2311 | F<lastlogin>) at start of rxvt execution. This option requires |
2275 | --enable-utmp to also be specified. |
2312 | --enable-utmp to also be specified. |
2276 | |
2313 | |
2277 | =item --enable-xpm-background |
2314 | =item --enable-xpm-background (default: off) |
2278 | |
2315 | |
2279 | Add support for XPM background pixmaps. |
2316 | Add support for XPM background pixmaps. |
2280 | |
2317 | |
2281 | =item --enable-transparency |
2318 | =item --enable-transparency (default: off) |
2282 | |
2319 | |
2283 | Add support for inheriting parent backgrounds thus giving a fake |
2320 | Add support for inheriting parent backgrounds thus giving a fake |
2284 | transparency to the term. |
2321 | transparency to the term. |
2285 | |
2322 | |
2286 | =item --enable-fading |
2323 | =item --enable-fading (default: on) |
2287 | |
2324 | |
2288 | Add support for fading the text when focus is lost. |
2325 | Add support for fading the text when focus is lost (requires C<--enable-transparency>). |
2289 | |
2326 | |
2290 | =item --enable-tinting |
2327 | =item --enable-tinting (default: on) |
2291 | |
2328 | |
2292 | Add support for tinting of transparent backgrounds. |
2329 | Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). |
2293 | |
2330 | |
2294 | =item --enable-menubar |
2331 | =item --enable-menubar (default: off) |
2295 | |
2332 | |
2296 | Add support for our menu bar system (this interacts badly with |
2333 | Add support for our menu bar system (this interacts badly with |
2297 | dynamic locale switching currently). |
2334 | dynamic locale switching currently). |
2298 | |
2335 | |
2299 | =item --enable-rxvt-scroll |
2336 | =item --enable-rxvt-scroll (default: on) |
2300 | |
2337 | |
2301 | Add support for the original rxvt scrollbar. |
2338 | Add support for the original rxvt scrollbar. |
2302 | |
2339 | |
2303 | =item --enable-next-scroll |
2340 | =item --enable-next-scroll (default: on) |
2304 | |
2341 | |
2305 | Add support for a NeXT-like scrollbar. |
2342 | Add support for a NeXT-like scrollbar. |
2306 | |
2343 | |
2307 | =item --enable-xterm-scroll |
2344 | =item --enable-xterm-scroll (default: on) |
2308 | |
2345 | |
2309 | Add support for an Xterm-like scrollbar. |
2346 | Add support for an Xterm-like scrollbar. |
2310 | |
2347 | |
2311 | =item --enable-plain-scroll |
2348 | =item --enable-plain-scroll (default: on) |
2312 | |
2349 | |
2313 | Add support for a very unobtrusive, plain-looking scrollbar that |
2350 | Add support for a very unobtrusive, plain-looking scrollbar that |
2314 | is the favourite of the rxvt-unicode author, having used it for |
2351 | is the favourite of the rxvt-unicode author, having used it for |
2315 | many years. |
2352 | many years. |
2316 | |
2353 | |
2317 | =item --enable-half-shadow |
2354 | =item --enable-half-shadow (default: off) |
2318 | |
2355 | |
2319 | Make shadows on the scrollbar only half the normal width & height. |
2356 | Make shadows on the scrollbar only half the normal width & height. |
2320 | only applicable to rxvt scrollbars. |
2357 | only applicable to rxvt scrollbars. |
2321 | |
2358 | |
2322 | =item --enable-ttygid |
2359 | =item --enable-ttygid (default: off) |
2323 | |
2360 | |
2324 | Change tty device setting to group "tty" - only use this if |
2361 | Change tty device setting to group "tty" - only use this if |
2325 | your system uses this type of security. |
2362 | your system uses this type of security. |
2326 | |
2363 | |
2327 | =item --disable-backspace-key |
2364 | =item --disable-backspace-key |
2328 | |
2365 | |
2329 | Disable any handling of the backspace key by us - let the X server |
2366 | Removes any handling of the backspace key by us - let the X server do it. |
|
|
2367 | |
|
|
2368 | =item --disable-delete-key |
|
|
2369 | |
|
|
2370 | Removes any handling of the delete key by us - let the X server |
2330 | do it. |
2371 | do it. |
2331 | |
2372 | |
2332 | =item --disable-delete-key |
|
|
2333 | |
|
|
2334 | Disable any handling of the delete key by us - let the X server |
|
|
2335 | do it. |
|
|
2336 | |
|
|
2337 | =item --disable-resources |
2373 | =item --disable-resources |
2338 | |
2374 | |
2339 | Remove all resources checking. |
2375 | Removes any support for resource checking. |
2340 | |
2376 | |
2341 | =item --enable-xgetdefault |
2377 | =item --enable-xgetdefault |
2342 | |
2378 | |
2343 | Make resources checking via XGetDefault() instead of our small |
2379 | Make resources checking via XGetDefault() instead of our small |
2344 | version which only checks ~/.Xdefaults, or if that doesn't exist then |
2380 | version which only checks ~/.Xdefaults, or if that doesn't exist then |
… | |
… | |
2346 | |
2382 | |
2347 | Please note that nowadays, things like XIM will automatically pull in and |
2383 | Please note that nowadays, things like XIM will automatically pull in and |
2348 | use the full X resource manager, so the overhead of using it might be very |
2384 | use the full X resource manager, so the overhead of using it might be very |
2349 | small, if nonexistant. |
2385 | small, if nonexistant. |
2350 | |
2386 | |
2351 | =item --enable-strings |
2387 | =item --enable-strings (default: off) |
2352 | |
2388 | |
2353 | Add support for our possibly faster memset() function and other |
2389 | Add support for our possibly faster memset() function and other |
2354 | various routines, overriding your system's versions which may |
2390 | various routines, overriding your system's versions which may |
2355 | have been hand-crafted in assembly or may require extra libraries |
2391 | have been hand-crafted in assembly or may require extra libraries |
2356 | to link in. (this breaks ANSI-C rules and has problems on many |
2392 | to link in. (this breaks ANSI-C rules and has problems on many |
2357 | GNU/Linux systems). |
2393 | GNU/Linux systems). |
2358 | |
2394 | |
2359 | =item --disable-swapscreen |
2395 | =item --disable-swapscreen |
2360 | |
2396 | |
2361 | Remove support for swap screen. |
2397 | Remove support for secondary/swap screen. |
2362 | |
2398 | |
2363 | =item --enable-frills |
2399 | =item --enable-frills (default: on) |
2364 | |
2400 | |
2365 | Add support for many small features that are not essential but nice to |
2401 | Add support for many small features that are not essential but nice to |
2366 | have. Normally you want this, but for very small binaries you may want to |
2402 | have. Normally you want this, but for very small binaries you may want to |
2367 | disable this. |
2403 | disable this. |
2368 | |
2404 | |
2369 | A non-exhaustive list of features enabled by C<--enable-frills> (possibly |
2405 | A non-exhaustive list of features enabled by C<--enable-frills> (possibly |
2370 | in combination with other switches) is: |
2406 | in combination with other switches) is: |
2371 | |
2407 | |
2372 | MWM-hints |
2408 | MWM-hints |
|
|
2409 | EWMH-hints (pid, utf8 names) and protocols (ping) |
2373 | seperate underline colour |
2410 | seperate underline colour |
2374 | settable border widths and borderless switch |
2411 | settable border widths and borderless switch |
2375 | settable extra linespacing |
2412 | settable extra linespacing |
2376 | extra window properties (e.g. UTF-8 window names and PID) |
|
|
2377 | iso-14755-2 and -3, and visual feedback |
2413 | iso-14755-2 and -3, and visual feedback |
2378 | backindex and forwardindex escape sequence |
2414 | backindex and forwardindex escape sequence |
2379 | window op and locale change escape sequences |
2415 | window op and some xterm/OSC escape sequences |
2380 | tripleclickwords |
2416 | tripleclickwords |
2381 | settable insecure mode |
2417 | settable insecure mode |
2382 | keysym remapping support |
2418 | keysym remapping support |
|
|
2419 | cursor blinking and underline cursor |
|
|
2420 | -embed, -pty-fd and -hold options |
2383 | |
2421 | |
2384 | =item --enable-iso14755 |
2422 | =item --enable-iso14755 (default: on) |
2385 | |
2423 | |
2386 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2424 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2387 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
2425 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
2388 | C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with |
2426 | C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with |
2389 | this switch. |
2427 | this switch. |
2390 | |
2428 | |
2391 | =item --enable-keepscrolling |
2429 | =item --enable-keepscrolling (default: on) |
2392 | |
2430 | |
2393 | Add support for continual scrolling of the display when you hold |
2431 | Add support for continual scrolling of the display when you hold |
2394 | the mouse button down on a scrollbar arrow. |
2432 | the mouse button down on a scrollbar arrow. |
2395 | |
2433 | |
2396 | =item --enable-mousewheel |
2434 | =item --enable-mousewheel (default: on) |
2397 | |
2435 | |
2398 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2436 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2399 | |
2437 | |
2400 | =item --enable-slipwheeling |
2438 | =item --enable-slipwheeling (default: on) |
2401 | |
2439 | |
2402 | Add support for continual scrolling (using the mouse wheel as an |
2440 | Add support for continual scrolling (using the mouse wheel as an |
2403 | accelerator) while the control key is held down. This option |
2441 | accelerator) while the control key is held down. This option |
2404 | requires --enable-mousewheel to also be specified. |
2442 | requires --enable-mousewheel to also be specified. |
2405 | |
2443 | |
2406 | =item --disable-new-selection |
2444 | =item --disable-new-selection |
2407 | |
2445 | |
2408 | Remove support for mouse selection style like that of xterm. |
2446 | Remove support for mouse selection style like that of xterm. |
2409 | |
2447 | |
2410 | =item --enable-dmalloc |
2448 | =item --enable-dmalloc (default: off) |
2411 | |
2449 | |
2412 | Use Gray Watson's malloc - which is good for debugging See |
2450 | Use Gray Watson's malloc - which is good for debugging See |
2413 | http://www.letters.com/dmalloc/ for details If you use either this or the |
2451 | http://www.letters.com/dmalloc/ for details If you use either this or the |
2414 | next option, you may need to edit src/Makefile after compiling to point |
2452 | next option, you may need to edit src/Makefile after compiling to point |
2415 | DINCLUDE and DLIB to the right places. |
2453 | DINCLUDE and DLIB to the right places. |
2416 | |
2454 | |
2417 | You can only use either this option and the following (should |
2455 | You can only use either this option and the following (should |
2418 | you use either) . |
2456 | you use either) . |
2419 | |
2457 | |
2420 | =item --enable-dlmalloc |
2458 | =item --enable-dlmalloc (default: off) |
2421 | |
2459 | |
2422 | Use Doug Lea's malloc - which is good for a production version |
2460 | Use Doug Lea's malloc - which is good for a production version |
2423 | See L<http://g.oswego.edu/dl/html/malloc.html> for details. |
2461 | See L<http://g.oswego.edu/dl/html/malloc.html> for details. |
2424 | |
2462 | |
2425 | =item --enable-smart-resize |
2463 | =item --enable-smart-resize (default: on) |
2426 | |
2464 | |
2427 | Add smart growth/shrink behaviour when changing font size via from hot |
2465 | Add smart growth/shrink behaviour when changing font size via hot |
2428 | keys. This should keep in a fixed position the rxvt corner which is |
2466 | keys. This should keep the window corner which is closest to a corner of |
2429 | closest to a corner of the screen. |
2467 | the screen in a fixed position. |
2430 | |
2468 | |
2431 | =item --enable-cursor-blink |
|
|
2432 | |
|
|
2433 | Add support for a blinking cursor. |
|
|
2434 | |
|
|
2435 | =item --enable-pointer-blank |
2469 | =item --enable-pointer-blank (default: on) |
2436 | |
2470 | |
2437 | Add support to have the pointer disappear when typing or inactive. |
2471 | Add support to have the pointer disappear when typing or inactive. |
2438 | |
2472 | |
2439 | =item --with-name=NAME |
2473 | =item --with-name=NAME (default: urxvt) |
2440 | |
2474 | |
2441 | Set the basename for the installed binaries (default: C<urxvt>, resulting |
2475 | Set the basename for the installed binaries, resulting |
2442 | in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with |
2476 | in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with |
2443 | C<rxvt>. |
2477 | C<rxvt>. |
2444 | |
2478 | |
2445 | =item --with-term=NAME |
2479 | =item --with-term=NAME (default: rxvt-unicode) |
2446 | |
2480 | |
2447 | Change the environmental variable for the terminal to NAME (default |
2481 | Change the environmental variable for the terminal to NAME. |
2448 | C<rxvt-unicode>) |
|
|
2449 | |
2482 | |
2450 | =item --with-terminfo=PATH |
2483 | =item --with-terminfo=PATH |
2451 | |
2484 | |
2452 | Change the environmental variable for the path to the terminfo tree to |
2485 | Change the environmental variable for the path to the terminfo tree to |
2453 | PATH. |
2486 | PATH. |