… | |
… | |
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 | |
… | |
… | |
1475 | B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> |
1510 | 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> >> |
1511 | 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> >> |
1512 | 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> >> |
1513 | 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> >> |
1514 | 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> |
1515 | 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> |
1516 | 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> |
1517 | 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> >> |
1518 | 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> >> |
1519 | 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) |
1520 | 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) |
1521 | 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> >> |
1522 | 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> >> |
1523 | 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>. |
1524 | 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>. |
1525 | 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>. |
1526 | 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>. |
1527 | B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). |
|
|
1528 | B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
|
|
1529 | B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). |
1493 | |
1530 | |
1494 | =end table |
1531 | =end table |
1495 | |
1532 | |
1496 | =back |
1533 | =back |
1497 | |
1534 | |
… | |
… | |
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,... |
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 |
… | |
… | |
2368 | |
2406 | |
2369 | A non-exhaustive list of features enabled by C<--enable-frills> (possibly |
2407 | A non-exhaustive list of features enabled by C<--enable-frills> (possibly |
2370 | in combination with other switches) is: |
2408 | in combination with other switches) is: |
2371 | |
2409 | |
2372 | MWM-hints |
2410 | MWM-hints |
|
|
2411 | EWMH-hints (pid, utf8 names) and protocols (ping) |
2373 | seperate underline colour |
2412 | seperate underline colour |
2374 | settable border widths and borderless switch |
2413 | settable border widths and borderless switch |
2375 | settable extra linespacing |
2414 | settable extra linespacing |
2376 | extra window properties (e.g. UTF-8 window names and PID) |
|
|
2377 | iso-14755-2 and -3, and visual feedback |
2415 | iso-14755-2 and -3, and visual feedback |
2378 | backindex and forwardindex escape sequence |
2416 | backindex and forwardindex escape sequence |
2379 | window op and locale change escape sequences |
2417 | window op and some xterm/OSC escape sequences |
2380 | tripleclickwords |
2418 | tripleclickwords |
2381 | settable insecure mode |
2419 | settable insecure mode |
2382 | keysym remapping support |
2420 | keysym remapping support |
|
|
2421 | cursor blinking and underline cursor |
|
|
2422 | -embed and -pty-fd options |
2383 | |
2423 | |
2384 | =item --enable-iso14755 |
2424 | =item --enable-iso14755 |
2385 | |
2425 | |
2386 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2426 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2387 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
2427 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
… | |
… | |
2426 | |
2466 | |
2427 | Add smart growth/shrink behaviour when changing font size via from hot |
2467 | Add smart growth/shrink behaviour when changing font size via from hot |
2428 | keys. This should keep in a fixed position the rxvt corner which is |
2468 | keys. This should keep in a fixed position the rxvt corner which is |
2429 | closest to a corner of the screen. |
2469 | closest to a corner of the screen. |
2430 | |
2470 | |
2431 | =item --enable-cursor-blink |
|
|
2432 | |
|
|
2433 | Add support for a blinking cursor. |
|
|
2434 | |
|
|
2435 | =item --enable-pointer-blank |
2471 | =item --enable-pointer-blank |
2436 | |
2472 | |
2437 | Add support to have the pointer disappear when typing or inactive. |
2473 | Add support to have the pointer disappear when typing or inactive. |
2438 | |
2474 | |
2439 | =item --with-name=NAME |
2475 | =item --with-name=NAME |