ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.man.in
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.107 by root, Mon Dec 13 16:47:27 2010 UTC vs.
Revision 1.108 by sf-exg, Mon May 2 08:25:24 2011 UTC

… …
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
785Make sure that mouse reporting is actually turned off since killing 785Make sure that mouse reporting is actually turned off since killing
786some editors prematurely may leave the mouse in mouse report mode. I've 786some editors prematurely may leave it active. I've
787heard that tcsh may use mouse reporting unless it otherwise specified. A 787heard that tcsh may use mouse reporting unless it is otherwise specified. A
788quick check is to see if cut/paste works when the Alt or Shift keys are 788quick check is to see if cut/paste works when the Alt or Shift keys are
789depressed. 789pressed.
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
794Assuming that the physical Backspace key corresponds to the 794Assuming that the physical Backspace key corresponds to the
… …
837you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can 837you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can
838use the `keysym' resource to alter the keystrings associated with keysyms. 838use the `keysym' resource to alter the keystrings associated with keysyms.
839.PP 839.PP
840Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR 840Here'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
865See some more examples in the documentation for the \fBkeysym\fR resource. 853See 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
… …
2192The sequences received for various modes are as follows: 2180The 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
2200The 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 2188The 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
2201as for the other modes (but encoded as a decimal number), \f(CW\*(C`x\*(C'\fR and \f(CW\*(C`y\*(C'\fR 2189code as for the other modes (but encoded as a decimal number, including
2190the additional offset of 32, so you have to subtract 32 first), \f(CW\*(C`x\*(C'\fR and
2202are 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
2203positioning). 2192cursor positioning).
2204.Sp 2193.Sp
2205Example: Shift\-Button\-1 press at top row, column 80. 2194Example: 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
2211One can use this feature by simply enabling it and then looking for 2200One can use this feature by simply enabling it and then looking for
2212parameters to the \f(CW\*(C`ESC [ M\*(C'\fR reply \- if there are any, this mode is 2201parameters to the \f(CW\*(C`ESC [ M\*(C'\fR reply \- if there are any, this mode is
2213active, otherwise one of the old reporting styles is used. 2202active, otherwise one of the old reporting styles is used.
… …
23493 button released (X11 mouse report) 23383 button released (X11 mouse report)
2350.TE 2339.TE
2351.PP 2340.PP
2352The upper bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the modifiers when the 2341The upper bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the modifiers when the
2353button was pressed and are added together (X11 mouse report only): 2342button 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
2358l l . 2347l l .
23594 Shift 23484 Shift
23608 Meta 23498 Meta
236116 Control 235016 Control
235132 Motion Notify
236232 Double Click (rxvt extension) 235232 Double Click (rxvt extension), disabled by default
235364 Button1 is actually Button4, Button2 is actually Button5 etc.
2363.TE 2354.TE
2364Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR 2355Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR
2365.Sp 2356.Sp
2366Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR 2357Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR
2367.SH "Key Codes" 2358.SH "Key Codes"
… …
2455You can specify this and then disable options you do not like by 2446You 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,
2457or you can start with a minimal configuration by specifying 2448or 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
2459you want. 2450you 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)"
2462Add support for Xft (anti-aliased, among others) fonts. Xft fonts are 2453Add support for Xft (anti-aliased, among others) fonts. Xft fonts are
2463slower and require lots of memory, but as long as you don't use them, you 2454slower and require lots of memory, but as long as you don't use them, you
2464don't pay for them. 2455don'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)"
2467Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font 2458Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font
2468styles. The fonts can be set manually or automatically. 2459styles. 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)"
2471Compile in support for additional codeset (encoding) groups (\f(CW\*(C`eu\*(C'\fR, \f(CW\*(C`vn\*(C'\fR 2462Compile in support for additional codeset (encoding) groups (\f(CW\*(C`eu\*(C'\fR, \f(CW\*(C`vn\*(C'\fR
2472are always compiled in, which includes most 8\-bit character sets). These 2463are always compiled in, which includes most 8\-bit character sets). These
2473codeset tables are used for driving X11 core fonts, they are not required 2464codeset tables are used for driving X11 core fonts, they are not required
2474for Xft fonts, although having them compiled in lets rxvt-unicode choose 2465for Xft fonts, although having them compiled in lets rxvt-unicode choose
2475replacement fonts more intelligently. Compiling them in will make your 2466replacement 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)"
2508Enable automatic composition of combining characters into 2499Enable automatic composition of combining characters into
2509composite characters. This is required for proper viewing of text 2500composite characters. This is required for proper viewing of text
2510where accents are encoded as separate unicode characters. This is 2501where accents are encoded as separate unicode characters. This is
2511done by using precomposited characters when available or creating 2502done by using precomposed characters when available or creating
2512new pseudo-characters when no precomposed form exists. 2503new pseudo-characters when no precomposed form exists.
2513.Sp 2504.Sp
2514Without \-\-enable\-unicode3, the number of additional precomposed 2505Without \-\-enable\-unicode3, the number of additional precomposed
2515characters is somewhat limited (the 6400 private use characters will be 2506characters 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.
… …
2519beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified. 2510beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified.
2520.Sp 2511.Sp
2521The combining table also contains entries for arabic presentation forms, 2512The combining table also contains entries for arabic presentation forms,
2522but these are not currently used. Bug me if you want these to be used (and 2513but these are not currently used. Bug me if you want these to be used (and
2523tell me how these are to be used...). 2514tell 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)"
2526When reading resource settings, also read settings for class \s-1CLASS\s0. To 2517When reading resource settings, also read settings for class \s-1CLASS\s0. To
2527disable resource fallback use \-\-disable\-fallback. 2518disable 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)"
2530Use the given name as default application name when 2521Use the given name as default application name when
… …
2557.Sp 2548.Sp
2558Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might 2549Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might
2559increase by a few megabytes even if no extra features are used (mostly due 2550increase by a few megabytes even if no extra features are used (mostly due
2560to third-party libraries used by libAI). Memory footprint may somewhat be 2551to third-party libraries used by libAI). Memory footprint may somewhat be
2561lowered if libAfterImage is configured without support for \s-1SVG\s0. 2552lowered 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)"
2564Add support for GDK-PixBuf to be used for background images. 2555Add support for GDK-PixBuf to be used for background images.
2565It adds support for many file formats including \s-1JPG\s0, \s-1PNG\s0, 2556It 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)"

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines