… | |
… | |
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 | |
… | |
… | |
2182 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
2213 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
2183 | styles. The fonts can be set manually or automatically. |
2214 | styles. The fonts can be set manually or automatically. |
2184 | |
2215 | |
2185 | =item --with-codesets=NAME,... |
2216 | =item --with-codesets=NAME,... |
2186 | |
2217 | |
2187 | Compile in support for additional codeset (encoding) groups (eu, vn are |
2218 | Compile in support for additional codeset (encoding) groups (C<eu>, C<vn> |
2188 | always compiled in, which includes most 8-bit character sets). These |
2219 | 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 |
2220 | 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 |
2221 | 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 |
2222 | replacement fonts more intelligently. Compiling them in will make your |
|
|
2223 | binary bigger (all of together cost about 700kB), but it doesn't increase |
2192 | you use an X11 font requiring one of these encodings. |
2224 | memory usage unless you use a font requiring one of these encodings. |
2193 | |
2225 | |
2194 | =begin table |
2226 | =begin table |
2195 | |
2227 | |
2196 | all all available codeset groups |
2228 | all all available codeset groups |
2197 | zh common chinese encodings |
2229 | zh common chinese encodings |
… | |
… | |
2374 | seperate underline colour |
2406 | seperate underline colour |
2375 | settable border widths and borderless switch |
2407 | settable border widths and borderless switch |
2376 | settable extra linespacing |
2408 | settable extra linespacing |
2377 | iso-14755-2 and -3, and visual feedback |
2409 | iso-14755-2 and -3, and visual feedback |
2378 | backindex and forwardindex escape sequence |
2410 | backindex and forwardindex escape sequence |
2379 | window op and locale change escape sequences |
2411 | window op and some xterm/OSC escape sequences |
2380 | tripleclickwords |
2412 | tripleclickwords |
2381 | settable insecure mode |
2413 | settable insecure mode |
2382 | keysym remapping support |
2414 | keysym remapping support |
|
|
2415 | cursor blinking and underline cursor |
2383 | -embed and -pty-fd options |
2416 | -embed and -pty-fd options |
2384 | |
2417 | |
2385 | =item --enable-iso14755 |
2418 | =item --enable-iso14755 |
2386 | |
2419 | |
2387 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2420 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
… | |
… | |
2427 | |
2460 | |
2428 | Add smart growth/shrink behaviour when changing font size via from hot |
2461 | Add smart growth/shrink behaviour when changing font size via from hot |
2429 | keys. This should keep in a fixed position the rxvt corner which is |
2462 | keys. This should keep in a fixed position the rxvt corner which is |
2430 | closest to a corner of the screen. |
2463 | closest to a corner of the screen. |
2431 | |
2464 | |
2432 | =item --enable-cursor-blink |
|
|
2433 | |
|
|
2434 | Add support for a blinking cursor. |
|
|
2435 | |
|
|
2436 | =item --enable-pointer-blank |
2465 | =item --enable-pointer-blank |
2437 | |
2466 | |
2438 | Add support to have the pointer disappear when typing or inactive. |
2467 | Add support to have the pointer disappear when typing or inactive. |
2439 | |
2468 | |
2440 | =item --with-name=NAME |
2469 | =item --with-name=NAME |