… | |
… | |
122 | .\} |
122 | .\} |
123 | .rm #[ #] #H #V #F C |
123 | .rm #[ #] #H #V #F C |
124 | .\" ======================================================================== |
124 | .\" ======================================================================== |
125 | .\" |
125 | .\" |
126 | .IX Title "@@RXVT_NAME@@ 7" |
126 | .IX Title "@@RXVT_NAME@@ 7" |
127 | .TH @@RXVT_NAME@@ 7 "2010-12-13" "@@RXVT_VERSION@@" "RXVT-UNICODE" |
127 | .TH @@RXVT_NAME@@ 7 "2011-05-01" "@@RXVT_VERSION@@" "RXVT-UNICODE" |
128 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
128 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
129 | .\" way too many mistakes in technical documents. |
129 | .\" way too many mistakes in technical documents. |
130 | .if n .ad l |
130 | .if n .ad l |
131 | .nh |
131 | .nh |
132 | .SH "NAME" |
132 | .SH "NAME" |
… | |
… | |
781 | .PP |
781 | .PP |
782 | \fIMouse cut/paste suddenly no longer works.\fR |
782 | \fIMouse cut/paste suddenly no longer works.\fR |
783 | .IX Subsection "Mouse cut/paste suddenly no longer works." |
783 | .IX Subsection "Mouse cut/paste suddenly no longer works." |
784 | .PP |
784 | .PP |
785 | Make sure that mouse reporting is actually turned off since killing |
785 | Make sure that mouse reporting is actually turned off since killing |
786 | some editors prematurely may leave the mouse in mouse report mode. I've |
786 | some editors prematurely may leave it active. I've |
787 | heard that tcsh may use mouse reporting unless it otherwise specified. A |
787 | heard that tcsh may use mouse reporting unless it is otherwise specified. A |
788 | quick check is to see if cut/paste works when the Alt or Shift keys are |
788 | quick check is to see if cut/paste works when the Alt or Shift keys are |
789 | depressed. |
789 | pressed. |
790 | .PP |
790 | .PP |
791 | \fIWhat's with the strange Backspace/Delete key behaviour?\fR |
791 | \fIWhat's with the strange Backspace/Delete key behaviour?\fR |
792 | .IX Subsection "What's with the strange Backspace/Delete key behaviour?" |
792 | .IX Subsection "What's with the strange Backspace/Delete key behaviour?" |
793 | .PP |
793 | .PP |
794 | Assuming that the physical Backspace key corresponds to the |
794 | Assuming that the physical Backspace key corresponds to the |
… | |
… | |
837 | you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can |
837 | you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can |
838 | use the `keysym' resource to alter the keystrings associated with keysyms. |
838 | use the `keysym' resource to alter the keystrings associated with keysyms. |
839 | .PP |
839 | .PP |
840 | Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR |
840 | Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR |
841 | .PP |
841 | .PP |
842 | .Vb 10 |
842 | .Vb 8 |
|
|
843 | \& URxvt.keysym.Prior: \e033[5~ |
|
|
844 | \& URxvt.keysym.Next: \e033[6~ |
843 | \& URxvt.keysym.Home: \e033[1~ |
845 | \& URxvt.keysym.Home: \e033[7~ |
844 | \& URxvt.keysym.End: \e033[4~ |
846 | \& URxvt.keysym.End: \e033[8~ |
845 | \& URxvt.keysym.C\-apostrophe: \e033<C\-\*(Aq> |
|
|
846 | \& URxvt.keysym.C\-slash: \e033<C\-/> |
|
|
847 | \& URxvt.keysym.C\-semicolon: \e033<C\-;> |
|
|
848 | \& URxvt.keysym.C\-grave: \e033<C\-\`> |
|
|
849 | \& URxvt.keysym.C\-comma: \e033<C\-,> |
|
|
850 | \& URxvt.keysym.C\-period: \e033<C\-.> |
|
|
851 | \& URxvt.keysym.C\-0x60: \e033<C\-\`> |
|
|
852 | \& URxvt.keysym.C\-Tab: \e033<C\-Tab> |
|
|
853 | \& URxvt.keysym.C\-Return: \e033<C\-Return> |
|
|
854 | \& URxvt.keysym.S\-Return: \e033<S\-Return> |
|
|
855 | \& URxvt.keysym.S\-space: \e033<S\-Space> |
|
|
856 | \& URxvt.keysym.M\-Up: \e033<M\-Up> |
847 | \& URxvt.keysym.Up: \e033[A |
857 | \& URxvt.keysym.M\-Down: \e033<M\-Down> |
848 | \& URxvt.keysym.Down: \e033[B |
|
|
849 | \& URxvt.keysym.Right: \e033[C |
858 | \& URxvt.keysym.M\-Left: \e033<M\-Left> |
850 | \& URxvt.keysym.Left: \e033[D |
859 | \& URxvt.keysym.M\-Right: \e033<M\-Right> |
|
|
860 | \& URxvt.keysym.M\-C\-0: list \e033<M\-C\- 0123456789 > |
|
|
861 | \& URxvt.keysym.M\-C\-a: list \e033<M\-C\- abcdefghijklmnopqrstuvwxyz > |
|
|
862 | \& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007 |
|
|
863 | .Ve |
851 | .Ve |
864 | .PP |
852 | .PP |
865 | See some more examples in the documentation for the \fBkeysym\fR resource. |
853 | See some more examples in the documentation for the \fBkeysym\fR resource. |
866 | .PP |
854 | .PP |
867 | \fII'm using keyboard model \s-1XXX\s0 that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map\fR |
855 | \fII'm using keyboard model \s-1XXX\s0 that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map\fR |
… | |
… | |
2192 | The sequences received for various modes are as follows: |
2180 | The sequences received for various modes are as follows: |
2193 | .Sp |
2181 | .Sp |
2194 | .Vb 3 |
2182 | .Vb 3 |
2195 | \& ESC [ M o o o !1005, !1015 (three octets) |
2183 | \& ESC [ M o o o !1005, !1015 (three octets) |
2196 | \& ESC [ M c c c 1005, !1015 (three characters) |
2184 | \& ESC [ M c c c 1005, !1015 (three characters) |
2197 | \& ESC [ Pm M 1015 (three or more numeric paramaters) |
2185 | \& ESC [ Pm M 1015 (three or more numeric parameters) |
2198 | .Ve |
2186 | .Ve |
2199 | .Sp |
2187 | .Sp |
2200 | The three parameters are \f(CW\*(C`code\*(C'\fR, \f(CW\*(C`x\*(C'\fR and \f(CW\*(C`y\*(C'\fR. Code is the numeric code |
2188 | The first three parameters are \f(CW\*(C`code\*(C'\fR, \f(CW\*(C`x\*(C'\fR and \f(CW\*(C`y\*(C'\fR. Code is the numeric |
2201 | as for the other modes (but encoded as a decimal number), \f(CW\*(C`x\*(C'\fR and \f(CW\*(C`y\*(C'\fR |
2189 | code as for the other modes (but encoded as a decimal number, including |
|
|
2190 | the additional offset of 32, so you have to subtract 32 first), \f(CW\*(C`x\*(C'\fR and |
2202 | are the coordinates (1|1 is the upper left corner, just as with cursor |
2191 | \&\f(CW\*(C`y\*(C'\fR are the coordinates (1|1 is the upper left corner, just as with |
2203 | positioning). |
2192 | cursor positioning). |
2204 | .Sp |
2193 | .Sp |
2205 | Example: Shift\-Button\-1 press at top row, column 80. |
2194 | Example: Shift\-Button\-1 press at top row, column 80. |
2206 | .Sp |
2195 | .Sp |
2207 | .Vb 1 |
2196 | .Vb 1 |
2208 | \& ESC [ 5 ; 80 ; 1 M |
2197 | \& ESC [ 37 ; 80 ; 1 M |
2209 | .Ve |
2198 | .Ve |
2210 | .Sp |
2199 | .Sp |
2211 | One can use this feature by simply enabling it and then looking for |
2200 | One can use this feature by simply enabling it and then looking for |
2212 | parameters to the \f(CW\*(C`ESC [ M\*(C'\fR reply \- if there are any, this mode is |
2201 | parameters to the \f(CW\*(C`ESC [ M\*(C'\fR reply \- if there are any, this mode is |
2213 | active, otherwise one of the old reporting styles is used. |
2202 | active, otherwise one of the old reporting styles is used. |
… | |
… | |
2349 | 3 button released (X11 mouse report) |
2338 | 3 button released (X11 mouse report) |
2350 | .TE |
2339 | .TE |
2351 | .PP |
2340 | .PP |
2352 | The upper bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the modifiers when the |
2341 | The upper bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the modifiers when the |
2353 | button was pressed and are added together (X11 mouse report only): |
2342 | button was pressed and are added together (X11 mouse report only): |
2354 | .ie n .IP "State = \fB\fB""(<b> \- SPACE) & 60""\fB\fR" 4 |
2343 | .ie n .IP "State = \fB\fB""(<b> \- SPACE) & ~3""\fB\fR" 4 |
2355 | .el .IP "State = \fB\f(CB(<b> \- SPACE) & 60\fB\fR" 4 |
2344 | .el .IP "State = \fB\f(CB(<b> \- SPACE) & ~3\fB\fR" 4 |
2356 | .IX Item "State = (<b> - SPACE) & 60" |
2345 | .IX Item "State = (<b> - SPACE) & ~3" |
2357 | .TS |
2346 | .TS |
2358 | l l . |
2347 | l l . |
2359 | 4 Shift |
2348 | 4 Shift |
2360 | 8 Meta |
2349 | 8 Meta |
2361 | 16 Control |
2350 | 16 Control |
|
|
2351 | 32 Motion Notify |
2362 | 32 Double Click (rxvt extension) |
2352 | 32 Double Click (rxvt extension), disabled by default |
|
|
2353 | 64 Button1 is actually Button4, Button2 is actually Button5 etc. |
2363 | .TE |
2354 | .TE |
2364 | Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR |
2355 | Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR |
2365 | .Sp |
2356 | .Sp |
2366 | Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR |
2357 | Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR |
2367 | .SH "Key Codes" |
2358 | .SH "Key Codes" |
… | |
… | |
2455 | You can specify this and then disable options you do not like by |
2446 | You can specify this and then disable options you do not like by |
2456 | \&\fIfollowing\fR this with the appropriate \f(CW\*(C`\-\-disable\-...\*(C'\fR arguments, |
2447 | \&\fIfollowing\fR this with the appropriate \f(CW\*(C`\-\-disable\-...\*(C'\fR arguments, |
2457 | or you can start with a minimal configuration by specifying |
2448 | or you can start with a minimal configuration by specifying |
2458 | \&\f(CW\*(C`\-\-disable\-everything\*(C'\fR and than adding just the \f(CW\*(C`\-\-enable\-...\*(C'\fR arguments |
2449 | \&\f(CW\*(C`\-\-disable\-everything\*(C'\fR and than adding just the \f(CW\*(C`\-\-enable\-...\*(C'\fR arguments |
2459 | you want. |
2450 | you want. |
2460 | .IP "\-\-enable\-xft (default: enabled)" 4 |
2451 | .IP "\-\-enable\-xft (default: on)" 4 |
2461 | .IX Item "--enable-xft (default: enabled)" |
2452 | .IX Item "--enable-xft (default: on)" |
2462 | Add support for Xft (anti-aliased, among others) fonts. Xft fonts are |
2453 | Add support for Xft (anti-aliased, among others) fonts. Xft fonts are |
2463 | slower and require lots of memory, but as long as you don't use them, you |
2454 | slower and require lots of memory, but as long as you don't use them, you |
2464 | don't pay for them. |
2455 | don't pay for them. |
2465 | .IP "\-\-enable\-font\-styles (default: on)" 4 |
2456 | .IP "\-\-enable\-font\-styles (default: on)" 4 |
2466 | .IX Item "--enable-font-styles (default: on)" |
2457 | .IX Item "--enable-font-styles (default: on)" |
2467 | Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font |
2458 | Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font |
2468 | styles. The fonts can be set manually or automatically. |
2459 | styles. The fonts can be set manually or automatically. |
2469 | .IP "\-\-with\-codesets=NAME,... (default: all)" 4 |
2460 | .IP "\-\-with\-codesets=CS,... (default: all)" 4 |
2470 | .IX Item "--with-codesets=NAME,... (default: all)" |
2461 | .IX Item "--with-codesets=CS,... (default: all)" |
2471 | Compile in support for additional codeset (encoding) groups (\f(CW\*(C`eu\*(C'\fR, \f(CW\*(C`vn\*(C'\fR |
2462 | Compile in support for additional codeset (encoding) groups (\f(CW\*(C`eu\*(C'\fR, \f(CW\*(C`vn\*(C'\fR |
2472 | are always compiled in, which includes most 8\-bit character sets). These |
2463 | are always compiled in, which includes most 8\-bit character sets). These |
2473 | codeset tables are used for driving X11 core fonts, they are not required |
2464 | codeset tables are used for driving X11 core fonts, they are not required |
2474 | for Xft fonts, although having them compiled in lets rxvt-unicode choose |
2465 | for Xft fonts, although having them compiled in lets rxvt-unicode choose |
2475 | replacement fonts more intelligently. Compiling them in will make your |
2466 | replacement fonts more intelligently. Compiling them in will make your |
… | |
… | |
2506 | .IP "\-\-enable\-combining (default: on)" 4 |
2497 | .IP "\-\-enable\-combining (default: on)" 4 |
2507 | .IX Item "--enable-combining (default: on)" |
2498 | .IX Item "--enable-combining (default: on)" |
2508 | Enable automatic composition of combining characters into |
2499 | Enable automatic composition of combining characters into |
2509 | composite characters. This is required for proper viewing of text |
2500 | composite characters. This is required for proper viewing of text |
2510 | where accents are encoded as separate unicode characters. This is |
2501 | where accents are encoded as separate unicode characters. This is |
2511 | done by using precomposited characters when available or creating |
2502 | done by using precomposed characters when available or creating |
2512 | new pseudo-characters when no precomposed form exists. |
2503 | new pseudo-characters when no precomposed form exists. |
2513 | .Sp |
2504 | .Sp |
2514 | Without \-\-enable\-unicode3, the number of additional precomposed |
2505 | Without \-\-enable\-unicode3, the number of additional precomposed |
2515 | characters is somewhat limited (the 6400 private use characters will be |
2506 | characters is somewhat limited (the 6400 private use characters will be |
2516 | (ab\-)used). With \-\-enable\-unicode3, no practical limit exists. |
2507 | (ab\-)used). With \-\-enable\-unicode3, no practical limit exists. |
… | |
… | |
2519 | beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified. |
2510 | beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified. |
2520 | .Sp |
2511 | .Sp |
2521 | The combining table also contains entries for arabic presentation forms, |
2512 | The combining table also contains entries for arabic presentation forms, |
2522 | but these are not currently used. Bug me if you want these to be used (and |
2513 | but these are not currently used. Bug me if you want these to be used (and |
2523 | tell me how these are to be used...). |
2514 | tell me how these are to be used...). |
2524 | .IP "\-\-enable\-fallback(=CLASS) (default: Rxvt)" 4 |
2515 | .IP "\-\-enable\-fallback[=CLASS] (default: Rxvt)" 4 |
2525 | .IX Item "--enable-fallback(=CLASS) (default: Rxvt)" |
2516 | .IX Item "--enable-fallback[=CLASS] (default: Rxvt)" |
2526 | When reading resource settings, also read settings for class \s-1CLASS\s0. To |
2517 | When reading resource settings, also read settings for class \s-1CLASS\s0. To |
2527 | disable resource fallback use \-\-disable\-fallback. |
2518 | disable resource fallback use \-\-disable\-fallback. |
2528 | .IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 |
2519 | .IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 |
2529 | .IX Item "--with-res-name=NAME (default: urxvt)" |
2520 | .IX Item "--with-res-name=NAME (default: urxvt)" |
2530 | Use the given name as default application name when |
2521 | Use the given name as default application name when |
… | |
… | |
2557 | .Sp |
2548 | .Sp |
2558 | Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might |
2549 | Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might |
2559 | increase by a few megabytes even if no extra features are used (mostly due |
2550 | increase by a few megabytes even if no extra features are used (mostly due |
2560 | to third-party libraries used by libAI). Memory footprint may somewhat be |
2551 | to third-party libraries used by libAI). Memory footprint may somewhat be |
2561 | lowered if libAfterImage is configured without support for \s-1SVG\s0. |
2552 | lowered if libAfterImage is configured without support for \s-1SVG\s0. |
2562 | .IP "\-\-enable\-pixbuf (default: off)" 4 |
2553 | .IP "\-\-enable\-pixbuf (default: on)" 4 |
2563 | .IX Item "--enable-pixbuf (default: off)" |
2554 | .IX Item "--enable-pixbuf (default: on)" |
2564 | Add support for GDK-PixBuf to be used for background images. |
2555 | Add support for GDK-PixBuf to be used for background images. |
2565 | It adds support for many file formats including \s-1JPG\s0, \s-1PNG\s0, |
2556 | It adds support for many file formats including \s-1JPG\s0, \s-1PNG\s0, |
2566 | \&\s-1TIFF\s0, \s-1GIF\s0, \s-1XPM\s0, \s-1BMP\s0, \s-1ICO\s0 and \s-1TGA\s0. |
2557 | \&\s-1TIFF\s0, \s-1GIF\s0, \s-1XPM\s0, \s-1BMP\s0, \s-1ICO\s0 and \s-1TGA\s0. |
2567 | .IP "\-\-enable\-transparency (default: on)" 4 |
2558 | .IP "\-\-enable\-transparency (default: on)" 4 |
2568 | .IX Item "--enable-transparency (default: on)" |
2559 | .IX Item "--enable-transparency (default: on)" |