… | |
… | |
110 | Turn on/off inheriting parent window's pixmap. Alternative form is |
110 | Turn on/off inheriting parent window's pixmap. Alternative form is |
111 | B<-tr>; resource B<inheritPixmap>. |
111 | B<-tr>; resource B<inheritPixmap>. |
112 | |
112 | |
113 | =item B<-fade> I<number> |
113 | =item B<-fade> I<number> |
114 | |
114 | |
115 | Fade the text by the given percentage when focus is lost. |
115 | Fade the text by the given percentage when focus is lost. resource B<fading>. |
116 | |
116 | |
117 | =item B<-tint> I<colour> |
117 | =item B<-tint> I<colour> |
118 | |
118 | |
119 | Tint the transparent background pixmap with the given colour when |
119 | Tint the transparent background pixmap with the given colour when |
120 | transparency is enabled with B<-tr> or B<-ip>. See also the B<-sh> |
120 | transparency is enabled with B<-tr> or B<-ip>. See also the B<-sh> |
… | |
… | |
123 | |
123 | |
124 | =item B<-sh> |
124 | =item B<-sh> |
125 | |
125 | |
126 | I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent |
126 | I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent |
127 | background image in addition to tinting it (i.e. B<-tint> must be |
127 | background image in addition to tinting it (i.e. B<-tint> must be |
128 | specified, too). |
128 | specified, too, e.g. C<-tint white>). |
129 | |
129 | |
130 | =item B<-bg> I<colour> |
130 | =item B<-bg> I<colour> |
131 | |
131 | |
132 | Window background colour; resource B<background>. |
132 | Window background colour; resource B<background>. |
133 | |
133 | |
… | |
… | |
136 | Window foreground colour; resource B<foreground>. |
136 | Window foreground colour; resource B<foreground>. |
137 | |
137 | |
138 | =item B<-pixmap> I<file[;geom]> |
138 | =item B<-pixmap> I<file[;geom]> |
139 | |
139 | |
140 | Compile I<XPM>: Specify XPM file for the background and also optionally |
140 | Compile I<XPM>: Specify XPM file for the background and also optionally |
141 | specify its scaling with a geometry string. Note you may need to add |
141 | specify its scaling with a geometry string. Note you may need to |
142 | quotes to avoid special shell interpretation of the `;' in the |
142 | add quotes to avoid special shell interpretation of the C<;> in the |
143 | command-line; resource B<backgroundPixmap>. |
143 | command-line; resource B<backgroundPixmap>. |
144 | |
144 | |
145 | =item B<-cr> I<colour> |
145 | =item B<-cr> I<colour> |
146 | |
146 | |
147 | The cursor colour; resource B<cursorColor>. |
147 | The cursor colour; resource B<cursorColor>. |
… | |
… | |
162 | =item B<-fn> I<fontlist> |
162 | =item B<-fn> I<fontlist> |
163 | |
163 | |
164 | Select the fonts to be used. This is a comma separated list of font names |
164 | Select the fonts to be used. This is a comma separated list of font names |
165 | that are used in turn when trying to display Unicode characters. The |
165 | that are used in turn when trying to display Unicode characters. The |
166 | first font defines the cell size for characters; other fonts might be |
166 | first font defines the cell size for characters; other fonts might be |
167 | smaller, but not (in general) larger. A reasonable default font list is |
167 | smaller, but not (in general) larger. A (hopefully) reasonable default |
168 | always appended to it. See resource B<font> for details. |
168 | font list is always appended to it. See resource B<font> for more details. |
|
|
169 | |
|
|
170 | In short, to specify an X11 core font, just specify it's name or prefix it |
|
|
171 | with C<x:>. To specify an XFT-font, you need to prefix it with C<xft:>, |
|
|
172 | e.g.: |
|
|
173 | |
|
|
174 | @@RXVT_NAME@@ -fn "xft:Bitstream Vera Sans Mono:pixelsize=15" |
|
|
175 | @@RXVT_NAME@@ -fn "9x15bold,xft:Bitstream Vera Sans Mono" |
169 | |
176 | |
170 | See also the question "How does rxvt-unicode choose fonts?" in the FAQ |
177 | See also the question "How does rxvt-unicode choose fonts?" in the FAQ |
171 | section of @@RXVT_NAME@@(7). |
178 | section of @@RXVT_NAME@@(7). |
172 | |
179 | |
173 | =item B<-fb> I<fontlist> |
180 | =item B<-fb> I<fontlist> |
… | |
… | |
232 | =item B<-st>|B<+st> |
239 | =item B<-st>|B<+st> |
233 | |
240 | |
234 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
241 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
235 | resource B<scrollBar_floating>. |
242 | resource B<scrollBar_floating>. |
236 | |
243 | |
|
|
244 | =item B<-ptab>|B<+ptab> |
|
|
245 | |
|
|
246 | If enabled (default), "Horizontal Tab" characters are being stored as |
|
|
247 | actual wide characters in the screen buffer, which makes it possible to |
|
|
248 | select and paste them. Since a horizontal tab is a cursor movement and |
|
|
249 | not an actual glyph, this can sometimes be visually annoying as the cursor |
|
|
250 | on a tab character is displayed as a wide cursor; resource B<pastableTabs>. |
|
|
251 | |
237 | =item B<-bc>|B<+bc> |
252 | =item B<-bc>|B<+bc> |
238 | |
253 | |
239 | Blink the cursor; resource B<cursorBlink>. |
254 | Blink the cursor; resource B<cursorBlink>. |
240 | |
255 | |
241 | =item B<-iconic> |
256 | =item B<-iconic> |
… | |
… | |
265 | if honoured by the WM, the rxvt-unicode window will not have window |
280 | if honoured by the WM, the rxvt-unicode window will not have window |
266 | decorations; resource B<borderLess>. |
281 | decorations; resource B<borderLess>. |
267 | |
282 | |
268 | =item B<-lsp> I<number> |
283 | =item B<-lsp> I<number> |
269 | |
284 | |
270 | Compile I<linespace>: Lines (pixel height) to insert between each row |
285 | Compile I<frills>: Lines (pixel height) to insert between each row of |
271 | of the display; resource B<linespace>. |
286 | the display. Useful to work around font rendering problems; resource |
|
|
287 | B<linespace>. |
272 | |
288 | |
273 | =item B<-tn> I<termname> |
289 | =item B<-tn> I<termname> |
274 | |
290 | |
275 | This option specifies the name of the terminal type to be set in the |
291 | This option specifies the name of the terminal type to be set in the |
276 | B<TERM> environment variable. This terminal type must exist in the |
292 | B<TERM> environment variable. This terminal type must exist in the |
… | |
… | |
412 | |
428 | |
413 | =item B<colorIT:> I<colour> |
429 | =item B<colorIT:> I<colour> |
414 | |
430 | |
415 | Use the specified colour to display bold or italic characters when the |
431 | Use the specified colour to display bold or italic characters when the |
416 | foreground colour is the default. If font styles are not available |
432 | foreground colour is the default. If font styles are not available |
417 | (Compile styles) and this option is unset, reverse video is used instead. |
433 | (Compile I<styles>) and this option is unset, reverse video is used instead. |
418 | |
434 | |
419 | =item B<colorUL:> I<colour> |
435 | =item B<colorUL:> I<colour> |
420 | |
436 | |
421 | Use the specified colour to display underlined characters when the |
437 | Use the specified colour to display underlined characters when the |
422 | foreground colour is the default. |
438 | foreground colour is the default. |
423 | |
439 | |
424 | =item B<colorRV:> I<colour> |
440 | =item B<colorRV:> I<colour> |
425 | |
441 | |
426 | Use the specified colour as the background for reverse video |
442 | Use the specified colour as the background for reverse video |
427 | characters. |
443 | characters. |
|
|
444 | |
|
|
445 | =item B<underlineColor:> I<colour> |
|
|
446 | |
|
|
447 | If set, use the specified colour as the colour for the underline |
|
|
448 | itself. If unset, use the foreground colour. |
428 | |
449 | |
429 | =item B<cursorColor:> I<colour> |
450 | =item B<cursorColor:> I<colour> |
430 | |
451 | |
431 | Use the specified colour for the cursor. The default is to use the |
452 | Use the specified colour for the cursor. The default is to use the |
432 | foreground colour; option B<-cr>. |
453 | foreground colour; option B<-cr>. |
… | |
… | |
465 | |
486 | |
466 | =item B<shading:> I<number> |
487 | =item B<shading:> I<number> |
467 | |
488 | |
468 | Darken (0 .. 100) or lighten (-1 .. -100) the transparent background |
489 | Darken (0 .. 100) or lighten (-1 .. -100) the transparent background |
469 | image in addition to tinting it. |
490 | image in addition to tinting it. |
470 | |
|
|
471 | =item B<fading:> I<number> |
|
|
472 | |
|
|
473 | Scale the tint colour by the given percentage. |
|
|
474 | |
491 | |
475 | =item B<scrollColor:> I<colour> |
492 | =item B<scrollColor:> I<colour> |
476 | |
493 | |
477 | Use the specified colour for the scrollbar [default #B2B2B2]. |
494 | Use the specified colour for the scrollbar [default #B2B2B2]. |
478 | |
495 | |
… | |
… | |
517 | The first font defines the cell size for characters; other fonts might |
534 | The first font defines the cell size for characters; other fonts might |
518 | be smaller, but not larger. A reasonable default font list is always |
535 | be smaller, but not larger. A reasonable default font list is always |
519 | appended to it. option B<-fn>. |
536 | appended to it. option B<-fn>. |
520 | |
537 | |
521 | Each font can either be a standard X11 core font (XLFD) name, with |
538 | Each font can either be a standard X11 core font (XLFD) name, with |
522 | optional prefix C<x:> or a Xft font (Compile xft), prefixed with C<xft:>. |
539 | optional prefix C<x:> or a Xft font (Compile I<xft>), prefixed with C<xft:>. |
523 | |
540 | |
524 | In addition, each font can be prefixed with additional hints and |
541 | In addition, each font can be prefixed with additional hints and |
525 | specifications enclosed in square brackets (C<[]>). The only available |
542 | specifications enclosed in square brackets (C<[]>). The only available |
526 | hint currently is C<codeset=codeset-name>, and this is only used for Xft |
543 | hint currently is C<codeset=codeset-name>, and this is only used for Xft |
527 | fonts. |
544 | fonts. |
… | |
… | |
537 | specifies five fonts to be used. The first one is C<9x15bold> (actually |
554 | specifies five fonts to be used. The first one is C<9x15bold> (actually |
538 | the iso8859-1 version of the second font), which is the base font (because |
555 | the iso8859-1 version of the second font), which is the base font (because |
539 | it is named first) and thus defines the character cell grid to be 9 pixels |
556 | it is named first) and thus defines the character cell grid to be 9 pixels |
540 | wide and 15 pixels high. |
557 | wide and 15 pixels high. |
541 | |
558 | |
542 | the second font is just used to add additional unicode characters not in |
559 | The second font is just used to add additional unicode characters not in |
543 | the base font, likewise the third, which is unfortunately non-bold, but |
560 | the base font, likewise the third, which is unfortunately non-bold, but |
544 | the bold version of the font does contain less characters, so this is a |
561 | the bold version of the font does contain less characters, so this is a |
545 | useful supplement. |
562 | useful supplement. |
546 | |
563 | |
547 | The third font is an Xft font with aliasing turned off, and the characters |
564 | The third font is an Xft font with aliasing turned off, and the characters |
… | |
… | |
699 | |
716 | |
700 | =item B<mouseWheelScrollPage:> I<boolean> |
717 | =item B<mouseWheelScrollPage:> I<boolean> |
701 | |
718 | |
702 | B<True>: the mouse wheel scrolls a page full. B<False>: the mouse wheel |
719 | B<True>: the mouse wheel scrolls a page full. B<False>: the mouse wheel |
703 | scrolls five lines [default]. |
720 | scrolls five lines [default]. |
|
|
721 | |
|
|
722 | =item B<pastableTabs:> I<boolean> |
|
|
723 | |
|
|
724 | B<True>: store tabs as wide characters. B<False>: interpret tabs as cursor |
|
|
725 | movement only; option C<-ptab>. |
704 | |
726 | |
705 | =item B<cursorBlink:> I<boolean> |
727 | =item B<cursorBlink:> I<boolean> |
706 | |
728 | |
707 | B<True>: blink the cursor. B<False>: do not blink the cursor [default]; |
729 | B<True>: blink the cursor. B<False>: do not blink the cursor [default]; |
708 | option B<-bc>. |
730 | option B<-bc>. |
… | |
… | |
796 | scrollback buffer and switching to/from the secondary screen will |
818 | scrollback buffer and switching to/from the secondary screen will |
797 | instead scroll the screen up. |
819 | instead scroll the screen up. |
798 | |
820 | |
799 | =item B<keysym.>I<sym>: I<string> |
821 | =item B<keysym.>I<sym>: I<string> |
800 | |
822 | |
801 | Associate I<string> with keysym I<sym> (B<0xFF00 - 0xFFFF>). It may |
823 | Compile I<frills>: Associate I<string> with keysym I<sym>. The |
802 | contain escape values (\a: bell, \b: backspace, \e, \E: escape, \n: |
824 | intervening resource name B<keysym.> cannot be omitted. |
803 | newline, \r: return, \t: |
825 | |
|
|
826 | The format of I<sym> is "I<(modifiers-)key>", where I<modifiers> can be |
|
|
827 | any combination of B<ISOLevel3>, B<AppKeypad>, B<Control>, B<NumLock>, |
|
|
828 | B<Shift>, B<Meta>, B<Lock>, B<Mod1>, B<Mod2>, B<Mod3>, B<Mod4>, B<Mod5>, |
|
|
829 | and the abbreviated B<I>, B<K>, B<C>, B<N>, B<S>, B<M>, B<A>, B<L>, B<1>, |
|
|
830 | B<2>, B<3>, B<4>, B<5>. |
|
|
831 | |
|
|
832 | The B<NumLock>, B<Meta> and B<ISOLevel3> modifiers are usually aliased to |
|
|
833 | whatever modifier the NumLock key, Meta/Alt keys or ISO Level3 Shift/AltGr |
|
|
834 | keys are being mapped. B<AppKeypad> is a artificial modifier mapped to the |
|
|
835 | current application keymap mode state. |
|
|
836 | |
|
|
837 | The spellings of I<key> can be obtained by using B<xev>(1) command or |
|
|
838 | searching keysym macros from B</usr/X11R6/include/X11/keysymdef.h> and |
|
|
839 | omitting the prefix B<XK_>. Alternatively you can specify I<key> by its hex |
|
|
840 | keysym value (B<0x0000 - 0xFFFF>). Note that the lookup of I<sym>s is not |
|
|
841 | performed in an exact manner; however, the closest match is assured. |
|
|
842 | |
|
|
843 | I<string> may contain escape values (C<\a>: bell, C<\b>: backspace, |
|
|
844 | C<\e>, C<\E>: escape, C<\n>: newline, C<\r>: carriage return, C<\t>: tab, |
804 | tab, \000: octal number) or control characters (^?: delete, ^@: null, |
845 | C<\000>: octal number) or verbatim control characters (C<^?>: delete, |
805 | ^A ...) and may enclosed with double quotes so that it can start or end |
846 | C<^@>: null, C<^A> ...) and may be enclosed with double quotes so that it |
806 | with whitespace. The intervening resource name B<keysym.> cannot be |
847 | can start or end with whitespace. |
807 | omitted. This resource is only available when compiled with |
848 | |
808 | KEYSYM_RESOURCE. |
849 | You can define a range of keysyms in one shot by providing a I<string> |
|
|
850 | with pattern B<list/PREFIX/MIDDLE/SUFFIX>, where the delimeter `/' |
|
|
851 | should be a character not used by the strings. |
|
|
852 | |
|
|
853 | Its usage can be demonstrated by an example: |
|
|
854 | |
|
|
855 | URxvt.keysym.M-C-0x61: list|\e<M-C-|abc|> |
|
|
856 | |
|
|
857 | The above line is equivalent to the following three lines: |
|
|
858 | |
|
|
859 | URxvt.keysym.Meta-Control-0x61: \e<M-C-a> |
|
|
860 | URxvt.keysym.Meta-Control-0x62: \e<M-C-b> |
|
|
861 | URxvt.keysym.Meta-Control-0x63: \e<M-C-c> |
|
|
862 | |
|
|
863 | If I<string> takes the form of C<proto:STRING>, the specified B<STRING> is |
|
|
864 | interpreted and executed as @@RXVT_NAME@@'s control sequence. For example, |
|
|
865 | C<proto:\033]701;zh_CN.GBK\007> means: change the current locale to |
|
|
866 | C<zh_CN.GBK>. |
809 | |
867 | |
810 | =back |
868 | =back |
811 | |
869 | |
812 | =head1 THE SCROLLBAR |
870 | =head1 THE SCROLLBAR |
813 | |
871 | |
… | |
… | |
847 | region and release; Right click to extend the marked region; Left |
905 | region and release; Right click to extend the marked region; Left |
848 | double-click to select a word; Left triple-click to select the entire |
906 | double-click to select a word; Left triple-click to select the entire |
849 | line. |
907 | line. |
850 | |
908 | |
851 | Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys) |
909 | Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys) |
852 | (Compile: frills) will create a rectangular selection instead of a normal |
910 | (Compile: I<frills>) will create a rectangular selection instead of a normal |
853 | one. |
911 | one. |
854 | |
912 | |
855 | =item B<Insertion>: |
913 | =item B<Insertion>: |
856 | |
914 | |
857 | Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in |
915 | Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in |