… | |
… | |
127 | .\} |
127 | .\} |
128 | .rm #[ #] #H #V #F C |
128 | .rm #[ #] #H #V #F C |
129 | .\" ======================================================================== |
129 | .\" ======================================================================== |
130 | .\" |
130 | .\" |
131 | .IX Title "@@RXVT_NAME@@ 7" |
131 | .IX Title "@@RXVT_NAME@@ 7" |
132 | .TH @@RXVT_NAME@@ 7 "2007-06-25" "8.2" "RXVT-UNICODE" |
132 | .TH @@RXVT_NAME@@ 7 "2007-08-01" "8.3" "RXVT-UNICODE" |
133 | .SH "NAME" |
133 | .SH "NAME" |
134 | RXVT REFERENCE \- FAQ, command sequences and other background information |
134 | RXVT REFERENCE \- FAQ, command sequences and other background information |
135 | .SH "SYNOPSIS" |
135 | .SH "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
137 | .Vb 2 |
137 | .Vb 2 |
… | |
… | |
276 | \fIHow do I compile the manual pages on my own?\fR |
276 | \fIHow do I compile the manual pages on my own?\fR |
277 | .IX Subsection "How do I compile the manual pages on my own?" |
277 | .IX Subsection "How do I compile the manual pages on my own?" |
278 | .PP |
278 | .PP |
279 | You need to have a recent version of perl installed as \fI/usr/bin/perl\fR, |
279 | You need to have a recent version of perl installed as \fI/usr/bin/perl\fR, |
280 | one that comes with \fIpod2man\fR, \fIpod2text\fR and \fIpod2xhtml\fR (from |
280 | one that comes with \fIpod2man\fR, \fIpod2text\fR and \fIpod2xhtml\fR (from |
281 | \&\fIPod::XHTML\fR). Then go to the doc subdirectory and enter \f(CW\*(C`make alldoc\*(C'\fR. |
281 | \&\fIPod::Xhtml\fR). Then go to the doc subdirectory and enter \f(CW\*(C`make alldoc\*(C'\fR. |
282 | .PP |
282 | .PP |
283 | \fIIsn't rxvt-unicode supposed to be small? Don't all those features bloat?\fR |
283 | \fIIsn't rxvt-unicode supposed to be small? Don't all those features bloat?\fR |
284 | .IX Subsection "Isn't rxvt-unicode supposed to be small? Don't all those features bloat?" |
284 | .IX Subsection "Isn't rxvt-unicode supposed to be small? Don't all those features bloat?" |
285 | .PP |
285 | .PP |
286 | I often get asked about this, and I think, no, they didn't cause extra |
286 | I often get asked about this, and I think, no, they didn't cause extra |
… | |
… | |
1440 | This forking is done as the very first within \fImain()\fR, which is very early |
1440 | This forking is done as the very first within \fImain()\fR, which is very early |
1441 | and reduces possible bugs to initialisation code run before \fImain()\fR, or |
1441 | and reduces possible bugs to initialisation code run before \fImain()\fR, or |
1442 | things like the dynamic loader of your system, which should result in very |
1442 | things like the dynamic loader of your system, which should result in very |
1443 | little risk. |
1443 | little risk. |
1444 | .PP |
1444 | .PP |
1445 | \fIOn Solaris 9, many line-drawing characters are too wide.\fR |
|
|
1446 | .IX Subsection "On Solaris 9, many line-drawing characters are too wide." |
|
|
1447 | .PP |
|
|
1448 | Seems to be a known bug, read |
|
|
1449 | <http://nixdoc.net/files/forum/about34198.html>. Some people use the |
|
|
1450 | following ugly workaround to get non-double-wide-characters working: |
|
|
1451 | .PP |
|
|
1452 | .Vb 1 |
|
|
1453 | \& #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x) |
|
|
1454 | .Ve |
|
|
1455 | .PP |
|
|
1456 | \fII am on FreeBSD and rxvt-unicode does not seem to work at all.\fR |
1445 | \fII am on FreeBSD and rxvt-unicode does not seem to work at all.\fR |
1457 | .IX Subsection "I am on FreeBSD and rxvt-unicode does not seem to work at all." |
1446 | .IX Subsection "I am on FreeBSD and rxvt-unicode does not seem to work at all." |
1458 | .PP |
1447 | .PP |
1459 | Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined |
1448 | Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined |
1460 | in your compile environment, or an implementation that implements it, |
1449 | in your compile environment, or an implementation that implements it, |
… | |
… | |
1484 | .PP |
1473 | .PP |
1485 | The rxvt-unicode author insists that the right way to fix this is in the |
1474 | The rxvt-unicode author insists that the right way to fix this is in the |
1486 | system libraries once and for all, instead of forcing every app to carry |
1475 | system libraries once and for all, instead of forcing every app to carry |
1487 | complete replacements for them :) |
1476 | complete replacements for them :) |
1488 | .PP |
1477 | .PP |
1489 | \fII use Solaris 9 and it doesn't compile/work/etc.\fR |
|
|
1490 | .IX Subsection "I use Solaris 9 and it doesn't compile/work/etc." |
|
|
1491 | .PP |
|
|
1492 | Try the diff in \fIdoc/solaris9.patch\fR as a base. It fixes the worst |
|
|
1493 | problems with \f(CW\*(C`wcwidth\*(C'\fR and a compile problem. |
|
|
1494 | .PP |
|
|
1495 | \fIHow can I use rxvt-unicode under cygwin?\fR |
1478 | \fIHow can I use rxvt-unicode under cygwin?\fR |
1496 | .IX Subsection "How can I use rxvt-unicode under cygwin?" |
1479 | .IX Subsection "How can I use rxvt-unicode under cygwin?" |
1497 | .PP |
1480 | .PP |
1498 | rxvt-unicode should compile and run out of the box on cygwin, using |
1481 | rxvt-unicode should compile and run out of the box on cygwin, using |
1499 | the X11 libraries that come with cygwin. libW11 emulation is no |
1482 | the X11 libraries that come with cygwin. libW11 emulation is no |
… | |
… | |
1503 | old libW11 emulation. |
1486 | old libW11 emulation. |
1504 | .PP |
1487 | .PP |
1505 | At the time of this writing, cygwin didn't seem to support any multi-byte |
1488 | At the time of this writing, cygwin didn't seem to support any multi-byte |
1506 | encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited |
1489 | encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited |
1507 | to 8\-bit encodings. |
1490 | to 8\-bit encodings. |
|
|
1491 | .PP |
|
|
1492 | \fICharacter widths are not correct.\fR |
|
|
1493 | .IX Subsection "Character widths are not correct." |
|
|
1494 | .PP |
|
|
1495 | urxvt uses the system wcwidth function to know the information about |
|
|
1496 | the width of characters, so on systems with incorrect locale data you |
|
|
1497 | will likely get bad results. Two notorious examples are Solaris 9, |
|
|
1498 | where single-width characters like U+2514 are reported as double\-width, |
|
|
1499 | and Darwin 8, where combining chars are reported having width 1. |
|
|
1500 | .PP |
|
|
1501 | The solution is to upgrade your system or switch to a better one. A |
|
|
1502 | possibly working workaround is to use a wcwidth implementation like |
|
|
1503 | .PP |
|
|
1504 | http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c |
1508 | .SH "RXVT-UNICODE TECHNICAL REFERENCE" |
1505 | .SH "RXVT-UNICODE TECHNICAL REFERENCE" |
1509 | .IX Header "RXVT-UNICODE TECHNICAL REFERENCE" |
1506 | .IX Header "RXVT-UNICODE TECHNICAL REFERENCE" |
1510 | The rest of this document describes various technical aspects of |
1507 | The rest of this document describes various technical aspects of |
1511 | \&\fBrxvt-unicode\fR. First the description of supported command sequences, |
1508 | \&\fBrxvt-unicode\fR. First the description of supported command sequences, |
1512 | followed by pixmap support and last by a description of all features |
1509 | followed by pixmap support and last by a description of all features |
… | |
… | |
2551 | \&\fIlastlogin\fR) at start of rxvt execution. This option requires |
2548 | \&\fIlastlogin\fR) at start of rxvt execution. This option requires |
2552 | \&\-\-enable\-utmp to also be specified. |
2549 | \&\-\-enable\-utmp to also be specified. |
2553 | .IP "\-\-enable\-xpm\-background (default: on)" 4 |
2550 | .IP "\-\-enable\-xpm\-background (default: on)" 4 |
2554 | .IX Item "--enable-xpm-background (default: on)" |
2551 | .IX Item "--enable-xpm-background (default: on)" |
2555 | Add support for \s-1XPM\s0 background pixmaps. |
2552 | Add support for \s-1XPM\s0 background pixmaps. |
|
|
2553 | .IP "\-\-enable\-afterimage (default: on)" 4 |
|
|
2554 | .IX Item "--enable-afterimage (default: on)" |
|
|
2555 | Add support for libAfterImage to be used for transparency and background |
|
|
2556 | images. It adds support for many file formats including \s-1JPG\s0, \s-1PNG\s0, |
|
|
2557 | \&\s-1SVG\s0, \s-1TIFF\s0, \s-1GIF\s0, \s-1XPM\s0, \s-1BMP\s0, \s-1ICO\s0, \s-1XCF\s0, \s-1TGA\s0 and AfterStep image \s-1XML\s0 |
|
|
2558 | (<http://www.afterstep.org/visualdoc.php?show=asimagexml>). |
|
|
2559 | .Sp |
|
|
2560 | This option also adds such eye candy as blending an image over the root |
|
|
2561 | background, as well as dynamic scaling and bluring of background images. |
|
|
2562 | .Sp |
|
|
2563 | Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might |
|
|
2564 | increase by a few megabytes even if no extra features are used (mostly due |
|
|
2565 | to third-party libraries used by libAI). Memory footprint may somewhat be |
|
|
2566 | lowered if libAfterImage is configured without support for \s-1SVG\s0. |
2556 | .IP "\-\-enable\-transparency (default: on)" 4 |
2567 | .IP "\-\-enable\-transparency (default: on)" 4 |
2557 | .IX Item "--enable-transparency (default: on)" |
2568 | .IX Item "--enable-transparency (default: on)" |
2558 | Add support for inheriting parent backgrounds thus giving a fake |
2569 | Add support for inheriting parent backgrounds thus giving a fake |
2559 | transparency to the term. |
2570 | transparency to the term. |
2560 | .IP "\-\-enable\-fading (default: on)" 4 |
2571 | .IP "\-\-enable\-fading (default: on)" 4 |
2561 | .IX Item "--enable-fading (default: on)" |
2572 | .IX Item "--enable-fading (default: on)" |
2562 | Add support for fading the text when focus is lost (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR). |
2573 | Add support for fading the text when focus is lost. |
2563 | .IP "\-\-enable\-tinting (default: on)" 4 |
2574 | .IP "\-\-enable\-tinting (default: on)" 4 |
2564 | .IX Item "--enable-tinting (default: on)" |
2575 | .IX Item "--enable-tinting (default: on)" |
2565 | Add support for tinting of transparent backgrounds (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR). |
2576 | Add support for tinting of transparent backgrounds (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR). |
2566 | .IP "\-\-enable\-rxvt\-scroll (default: on)" 4 |
2577 | .IP "\-\-enable\-rxvt\-scroll (default: on)" 4 |
2567 | .IX Item "--enable-rxvt-scroll (default: on)" |
2578 | .IX Item "--enable-rxvt-scroll (default: on)" |
… | |
… | |
2646 | this switch. |
2657 | this switch. |
2647 | .IP "\-\-enable\-keepscrolling (default: on)" 4 |
2658 | .IP "\-\-enable\-keepscrolling (default: on)" 4 |
2648 | .IX Item "--enable-keepscrolling (default: on)" |
2659 | .IX Item "--enable-keepscrolling (default: on)" |
2649 | Add support for continual scrolling of the display when you hold |
2660 | Add support for continual scrolling of the display when you hold |
2650 | the mouse button down on a scrollbar arrow. |
2661 | the mouse button down on a scrollbar arrow. |
|
|
2662 | .IP "\-\-enable\-selectionscrolling (default: on)" 4 |
|
|
2663 | .IX Item "--enable-selectionscrolling (default: on)" |
|
|
2664 | Add support for scrolling when the selection moves to the top or |
|
|
2665 | bottom of the screen. |
2651 | .IP "\-\-enable\-mousewheel (default: on)" 4 |
2666 | .IP "\-\-enable\-mousewheel (default: on)" 4 |
2652 | .IX Item "--enable-mousewheel (default: on)" |
2667 | .IX Item "--enable-mousewheel (default: on)" |
2653 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2668 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2654 | .IP "\-\-enable\-slipwheeling (default: on)" 4 |
2669 | .IP "\-\-enable\-slipwheeling (default: on)" 4 |
2655 | .IX Item "--enable-slipwheeling (default: on)" |
2670 | .IX Item "--enable-slipwheeling (default: on)" |
2656 | Add support for continual scrolling (using the mouse wheel as an |
2671 | Add support for continual scrolling (using the mouse wheel as an |
2657 | accelerator) while the control key is held down. This option |
2672 | accelerator) while the control key is held down. This option |
2658 | requires \-\-enable\-mousewheel to also be specified. |
2673 | requires \-\-enable\-mousewheel to also be specified. |
2659 | .IP "\-\-disable\-new\-selection" 4 |
|
|
2660 | .IX Item "--disable-new-selection" |
|
|
2661 | Remove support for mouse selection style like that of xterm. |
|
|
2662 | .IP "\-\-enable\-dmalloc (default: off)" 4 |
|
|
2663 | .IX Item "--enable-dmalloc (default: off)" |
|
|
2664 | Use Gray Watson's malloc \- which is good for debugging See |
|
|
2665 | <http://www.letters.com/dmalloc/> for details If you use either this or the |
|
|
2666 | next option, you may need to edit src/Makefile after compiling to point |
|
|
2667 | \&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. |
|
|
2668 | .Sp |
|
|
2669 | You can only use either this option and the following (should |
|
|
2670 | you use either) . |
|
|
2671 | .IP "\-\-enable\-dlmalloc (default: off)" 4 |
|
|
2672 | .IX Item "--enable-dlmalloc (default: off)" |
|
|
2673 | Use Doug Lea's malloc \- which is good for a production version |
|
|
2674 | See <http://g.oswego.edu/dl/html/malloc.html> for details. |
|
|
2675 | .IP "\-\-enable\-smart\-resize (default: on)" 4 |
2674 | .IP "\-\-enable\-smart\-resize (default: off)" 4 |
2676 | .IX Item "--enable-smart-resize (default: on)" |
2675 | .IX Item "--enable-smart-resize (default: off)" |
2677 | Add smart growth/shrink behaviour when changing font size via hot |
2676 | Add smart growth/shrink behaviour when resizing. |
2678 | keys. This should keep the window corner which is closest to a corner of |
2677 | This should keep the window corner which is closest to a corner of |
2679 | the screen in a fixed position. |
2678 | the screen in a fixed position. |
2680 | .IP "\-\-enable\-pointer\-blank (default: on)" 4 |
2679 | .IP "\-\-enable\-pointer\-blank (default: on)" 4 |
2681 | .IX Item "--enable-pointer-blank (default: on)" |
2680 | .IX Item "--enable-pointer-blank (default: on)" |
2682 | Add support to have the pointer disappear when typing or inactive. |
2681 | Add support to have the pointer disappear when typing or inactive. |
2683 | .IP "\-\-enable\-perl (default: on)" 4 |
2682 | .IP "\-\-enable\-perl (default: on)" 4 |
… | |
… | |
2688 | default. The perl interpreter that is used can be specified via the |
2687 | default. The perl interpreter that is used can be specified via the |
2689 | \&\f(CW\*(C`PERL\*(C'\fR environment variable when running configure. Even when compiled |
2688 | \&\f(CW\*(C`PERL\*(C'\fR environment variable when running configure. Even when compiled |
2690 | in, perl will \fInot\fR be initialised when all extensions have been disabled |
2689 | in, perl will \fInot\fR be initialised when all extensions have been disabled |
2691 | \&\f(CW\*(C`\-pe "" \-\-perl\-ext\-common ""\*(C'\fR, so it should be safe to enable from a |
2690 | \&\f(CW\*(C`\-pe "" \-\-perl\-ext\-common ""\*(C'\fR, so it should be safe to enable from a |
2692 | resource standpoint. |
2691 | resource standpoint. |
|
|
2692 | .IP "\-\-with\-afterimage\-config=DIR" 4 |
|
|
2693 | .IX Item "--with-afterimage-config=DIR" |
|
|
2694 | Look for the libAfterImage config script in \s-1DIR\s0. |
2693 | .IP "\-\-with\-name=NAME (default: urxvt)" 4 |
2695 | .IP "\-\-with\-name=NAME (default: urxvt)" 4 |
2694 | .IX Item "--with-name=NAME (default: urxvt)" |
2696 | .IX Item "--with-name=NAME (default: urxvt)" |
2695 | Set the basename for the installed binaries, resulting |
2697 | Set the basename for the installed binaries, resulting |
2696 | in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with |
2698 | in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with |
2697 | \&\f(CW\*(C`rxvt\*(C'\fR. |
2699 | \&\f(CW\*(C`rxvt\*(C'\fR. |