… | |
… | |
105 | |
105 | |
106 | =item B<-j>|B<+j> |
106 | =item B<-j>|B<+j> |
107 | |
107 | |
108 | Turn on/off jump scrolling; resource B<jumpScroll>. |
108 | Turn on/off jump scrolling; resource B<jumpScroll>. |
109 | |
109 | |
110 | =item B<-ip>|B<+ip> |
110 | =item B<-ip>|B<+ip> | B<-tr>|B<+tr> |
111 | |
111 | |
112 | Turn on/off inheriting parent window's pixmap. Alternative form is |
112 | Turn on/off inheriting parent window's pixmap. Alternative form is |
113 | B<-tr>; resource B<inheritPixmap>. |
113 | B<-tr>; resource B<inheritPixmap>. |
114 | |
114 | |
115 | =item B<-fade> I<number> |
115 | =item B<-fade> I<number> |
116 | |
116 | |
117 | Fade the text by the given percentage when focus is lost. resource B<fading>. |
117 | Fade the text by the given percentage when focus is lost. Small values |
|
|
118 | fade a little only, 100 completely replaces all colours by the fade |
|
|
119 | colour; resource B<fading>. |
|
|
120 | |
|
|
121 | =item B<-fadecolor> I<colour> |
|
|
122 | |
|
|
123 | Fade to this colour when fading is used (see B<-fade>). The default colour |
|
|
124 | is black. resource B<fadeColor>. |
118 | |
125 | |
119 | =item B<-tint> I<colour> |
126 | =item B<-tint> I<colour> |
120 | |
127 | |
121 | Tint the transparent background pixmap with the given colour when |
128 | Tint the transparent background pixmap with the given colour when |
122 | transparency is enabled with B<-tr> or B<-ip>. See also the B<-sh> |
129 | transparency is enabled with B<-tr> or B<-ip>. This only works for |
123 | option that can be used to brighten or darken the image in addition to |
130 | non-tiled backgrounds, currently. See also the B<-sh> option that can be |
124 | tinting it. |
131 | used to brighten or darken the image in addition to tinting it; resource |
|
|
132 | I<tintColor>. Example: |
|
|
133 | |
|
|
134 | @@RXVT_NAME@@ -tr -tint blue -sh 40 |
125 | |
135 | |
126 | =item B<-sh> |
136 | =item B<-sh> |
127 | |
137 | |
128 | I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent |
138 | I<number> Darken (0 .. 100) or lighten (-1 .. -100) the transparent |
129 | background image in addition to tinting it (i.e. B<-tint> must be |
139 | background image in addition to tinting it (i.e. B<-tint> must be |
… | |
… | |
192 | =item B<-fbi> I<fontlist> |
202 | =item B<-fbi> I<fontlist> |
193 | |
203 | |
194 | Compile font-styles: The bold italic font list to use when bold characters are to |
204 | Compile font-styles: The bold italic font list to use when bold characters are to |
195 | be printed. See resource B<boldItalicFont> for details. |
205 | be printed. See resource B<boldItalicFont> for details. |
196 | |
206 | |
|
|
207 | =item B<-is>|B<+is> |
|
|
208 | |
|
|
209 | Compile font-styles: Bold/Italic font styles imply high intensity |
|
|
210 | foreground/background (default). See resource B<intensityStyles> for |
|
|
211 | details. |
|
|
212 | |
197 | =item B<-name> I<name> |
213 | =item B<-name> I<name> |
198 | |
214 | |
199 | Specify the application name under which resources are to be obtained, |
215 | Specify the application name under which resources are to be obtained, |
200 | rather than the default executable file name. Name should not contain |
216 | rather than the default executable file name. Name should not contain |
201 | `.' or `*' characters. Also sets the icon and title name. |
217 | `.' or `*' characters. Also sets the icon and title name. |
… | |
… | |
238 | |
254 | |
239 | Put scrollbar on right/left; resource B<scrollBar_right>. |
255 | Put scrollbar on right/left; resource B<scrollBar_right>. |
240 | |
256 | |
241 | =item B<-st>|B<+st> |
257 | =item B<-st>|B<+st> |
242 | |
258 | |
243 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
259 | Display rxvt (non XTerm/NeXT) scrollbar without/with a trough; |
244 | resource B<scrollBar_floating>. |
260 | resource B<scrollBar_floating>. |
245 | |
261 | |
246 | =item B<-ptab>|B<+ptab> |
262 | =item B<-ptab>|B<+ptab> |
247 | |
263 | |
248 | If enabled (default), "Horizontal Tab" characters are being stored as |
264 | If enabled (default), "Horizontal Tab" characters are being stored as |
… | |
… | |
303 | given on the command line. If this option is used, it must be the last |
319 | given on the command line. If this option is used, it must be the last |
304 | on the command-line. If there is no B<-e> option then the default is to |
320 | on the command-line. If there is no B<-e> option then the default is to |
305 | run the program specified by the B<SHELL> environment variable or, |
321 | run the program specified by the B<SHELL> environment variable or, |
306 | failing that, I<sh(1)>. |
322 | failing that, I<sh(1)>. |
307 | |
323 | |
|
|
324 | Please note that you must specify a program with arguments. If you want to |
|
|
325 | run shell commands, you have to specify the shell, like this: |
|
|
326 | |
|
|
327 | @@RXVT_NAME@@ -e sh -c "shell commands" |
|
|
328 | |
308 | =item B<-title> I<text> |
329 | =item B<-title> I<text> |
309 | |
330 | |
310 | Window title (B<-T> still respected); the default title is the basename |
331 | Window title (B<-T> still respected); the default title is the basename |
311 | of the program specified after the B<-e> option, if any, otherwise the |
332 | of the program specified after the B<-e> option, if any, otherwise the |
312 | application name; resource B<title>. |
333 | application name; resource B<title>. |
… | |
… | |
367 | |
388 | |
368 | =item B<-ssr>|B<+ssr> |
389 | =item B<-ssr>|B<+ssr> |
369 | |
390 | |
370 | Turn on/off secondary screen scroll (default enabled); resource |
391 | Turn on/off secondary screen scroll (default enabled); resource |
371 | B<secondaryScroll>. |
392 | B<secondaryScroll>. |
|
|
393 | |
|
|
394 | =item B<-hold>|B<+hold> |
|
|
395 | |
|
|
396 | Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ |
|
|
397 | will not immediately destroy its window when the program executed within |
|
|
398 | it exits. Instead, it will wait till it is being killed or closed by the |
|
|
399 | user; resource B<hold>. |
372 | |
400 | |
373 | =item B<-keysym.>I<sym> I<string> |
401 | =item B<-keysym.>I<sym> I<string> |
374 | |
402 | |
375 | Remap a key symbol. See resource B<keysym>. |
403 | Remap a key symbol. See resource B<keysym>. |
376 | |
404 | |
… | |
… | |
548 | artificial transparency. B<False>: do not inherit the parent windows' |
576 | artificial transparency. B<False>: do not inherit the parent windows' |
549 | pixmap. |
577 | pixmap. |
550 | |
578 | |
551 | =item B<fading:> I<number> |
579 | =item B<fading:> I<number> |
552 | |
580 | |
553 | Fade the text by the given percentage when focus is lost. |
581 | Fade the text by the given percentage when focus is lost; option B<-fade>. |
|
|
582 | |
|
|
583 | =item B<fadeColor:> I<colour> |
|
|
584 | |
|
|
585 | Fade to this colour, when fading is used (see B<fading:>). The default |
|
|
586 | colour is black; option B<-fadecolor>. |
554 | |
587 | |
555 | =item B<tintColor:> I<colour> |
588 | =item B<tintColor:> I<colour> |
556 | |
589 | |
557 | Tint the transparent background pixmap with the given colour. |
590 | Tint the transparent background pixmap with the given colour; option |
|
|
591 | B<-tint>. |
558 | |
592 | |
559 | =item B<shading:> I<number> |
593 | =item B<shading:> I<number> |
560 | |
594 | |
561 | Darken (0 .. 100) or lighten (-1 .. -100) the transparent background |
595 | Darken (0 .. 100) or lighten (-1 .. -100) the transparent background |
562 | image in addition to tinting it. |
596 | image in addition to tinting it. |
… | |
… | |
566 | Use the specified colour for the scrollbar [default #B2B2B2]. |
600 | Use the specified colour for the scrollbar [default #B2B2B2]. |
567 | |
601 | |
568 | =item B<troughColor:> I<colour> |
602 | =item B<troughColor:> I<colour> |
569 | |
603 | |
570 | Use the specified colour for the scrollbar's trough area [default |
604 | Use the specified colour for the scrollbar's trough area [default |
571 | #969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. |
605 | #969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar. |
572 | |
606 | |
573 | =item B<borderColor:> I<colour> |
607 | =item B<borderColor:> I<colour> |
574 | |
608 | |
575 | The colour of the border around the text area and between the scrollbar |
609 | The colour of the border around the text area and between the scrollbar |
576 | and the text. |
610 | and the text. |
… | |
… | |
659 | not possible, replacement fonts of the desired shape will be tried. |
693 | not possible, replacement fonts of the desired shape will be tried. |
660 | |
694 | |
661 | If set, but empty, then this specific style is disabled and the normal |
695 | If set, but empty, then this specific style is disabled and the normal |
662 | text font will being used for the given style. |
696 | text font will being used for the given style. |
663 | |
697 | |
|
|
698 | =item B<intensityStyles:> I<boolean> |
|
|
699 | |
|
|
700 | When font styles are not enabled, or this option is enabled (B<True>, |
|
|
701 | option B<-is>, the default), bold and italic font styles imply high |
|
|
702 | intensity foreground/backround colours. Disabling this option (B<False>, |
|
|
703 | option B<+is>) disables this behaviour, the high intensity colours are not |
|
|
704 | reachable. |
|
|
705 | |
664 | =item B<selectstyle:> I<mode> |
706 | =item B<selectstyle:> I<mode> |
665 | |
707 | |
666 | Set mouse selection style to B<old> which is 2.20, B<oldword> which is |
708 | Set mouse selection style to B<old> which is 2.20, B<oldword> which is |
667 | xterm style with 2.20 old word selection, or anything else which gives |
709 | xterm style with 2.20 old word selection, or anything else which gives |
668 | xterm style selection. |
710 | xterm style selection. |
669 | |
711 | |
670 | =item B<scrollstyle:> I<mode> |
712 | =item B<scrollstyle:> I<mode> |
671 | |
713 | |
672 | Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is |
714 | Set scrollbar style to B<rxvt>, B<plain>, B<next> or B<xterm>. B<plain> is |
673 | the author's favourite.. |
715 | the author's favourite. |
674 | |
716 | |
675 | =item B<title:> I<string> |
717 | =item B<title:> I<string> |
676 | |
718 | |
677 | Set window title string, the default title is the command-line |
719 | Set window title string, the default title is the command-line |
678 | specified after the B<-e> option, if any, otherwise the application |
720 | specified after the B<-e> option, if any, otherwise the application |
… | |
… | |
709 | =item B<print-pipe:> I<string> |
751 | =item B<print-pipe:> I<string> |
710 | |
752 | |
711 | Specify a command pipe for vt100 printer [default I<lpr(1)>]. Use |
753 | Specify a command pipe for vt100 printer [default I<lpr(1)>]. Use |
712 | B<Print> to initiate a screen dump to the printer and B<Ctrl-Print> or |
754 | B<Print> to initiate a screen dump to the printer and B<Ctrl-Print> or |
713 | B<Shift-Print> to include the scrollback as well. |
755 | B<Shift-Print> to include the scrollback as well. |
|
|
756 | |
|
|
757 | The string will be interpreted as if typed into the shell as-is. |
|
|
758 | |
|
|
759 | Example: |
|
|
760 | |
|
|
761 | URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX) |
|
|
762 | |
|
|
763 | This creates a new file in your home directory with the screen contents |
|
|
764 | everytime you hit C<Print>. |
714 | |
765 | |
715 | =item B<scrollBar:> I<boolean> |
766 | =item B<scrollBar:> I<boolean> |
716 | |
767 | |
717 | B<True>: enable the scrollbar [default]; option B<-sb>. B<False>: |
768 | B<True>: enable the scrollbar [default]; option B<-sb>. B<False>: |
718 | disable the scrollbar; option B<+sb>. |
769 | disable the scrollbar; option B<+sb>. |
… | |
… | |
815 | |
866 | |
816 | Mouse pointer background colour. |
867 | Mouse pointer background colour. |
817 | |
868 | |
818 | =item B<pointerBlankDelay:> I<number> |
869 | =item B<pointerBlankDelay:> I<number> |
819 | |
870 | |
820 | Specifies number of seconds before blanking the pointer [default 2]. |
871 | Specifies number of seconds before blanking the pointer [default 2]. Use a |
|
|
872 | large number (e.g. C<987654321>) to effectively disable the timeout. |
821 | |
873 | |
822 | =item B<backspacekey:> I<string> |
874 | =item B<backspacekey:> I<string> |
823 | |
875 | |
824 | The string to send when the backspace key is pressed. If set to B<DEC> |
876 | The string to send when the backspace key is pressed. If set to B<DEC> |
825 | or unset it will send B<Delete> (code 127) or, if shifted, B<Backspace> |
877 | or unset it will send B<Delete> (code 127) or, if shifted, B<Backspace> |
… | |
… | |
872 | =item B<insecure:> I<boolean> |
924 | =item B<insecure:> I<boolean> |
873 | |
925 | |
874 | Enables "insecure" mode. Rxvt-unicode offers some escape sequences that |
926 | Enables "insecure" mode. Rxvt-unicode offers some escape sequences that |
875 | echo arbitrary strings like the icon name or the locale. This could be |
927 | echo arbitrary strings like the icon name or the locale. This could be |
876 | abused if somebody gets 8-bit-clean access to your display, whether |
928 | abused if somebody gets 8-bit-clean access to your display, whether |
877 | throuh a mail client displaying mail bodies unfiltered or though |
929 | through a mail client displaying mail bodies unfiltered or through |
878 | write(1). Therefore, these sequences are disabled by default. (Note |
930 | write(1) or any other means. Therefore, these sequences are disabled by |
879 | that other terminals, including xterm, have these sequences |
931 | default. (Note that many other terminals, including xterm, have these |
880 | enabled by default). You can enable them by setting this boolean |
932 | sequences enabled by default, which doesn't make it safer, though). |
881 | resource or specifying B<-insecure> as an option. At the moment, this |
933 | |
882 | enabled display-answer, locale, findfont, icon label and window title |
934 | You can enable them by setting this boolean resource or specifying |
883 | requests as well as dynamic menubar dispatch. |
935 | B<-insecure> as an option. At the moment, this enables display-answer, |
|
|
936 | locale, findfont, icon label and window title requests as well as dynamic |
|
|
937 | menubar dispatch. |
884 | |
938 | |
885 | =item B<modifier:> I<modifier> |
939 | =item B<modifier:> I<modifier> |
886 | |
940 | |
887 | Set the key to be interpreted as the Meta key to: B<alt>, B<meta>, |
941 | Set the key to be interpreted as the Meta key to: B<alt>, B<meta>, |
888 | B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option |
942 | B<hyper>, B<super>, B<mod1>, B<mod2>, B<mod3>, B<mod4>, B<mod5>; option |
… | |
… | |
902 | |
956 | |
903 | Turn on/off secondary screen scroll (default enabled). If the this |
957 | Turn on/off secondary screen scroll (default enabled). If the this |
904 | option is enabled, scrolls on the secondary screen will change the |
958 | option is enabled, scrolls on the secondary screen will change the |
905 | scrollback buffer and switching to/from the secondary screen will |
959 | scrollback buffer and switching to/from the secondary screen will |
906 | instead scroll the screen up. |
960 | instead scroll the screen up. |
|
|
961 | |
|
|
962 | =item B<hold>: I<bool> |
|
|
963 | |
|
|
964 | Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ |
|
|
965 | will not immediately destroy its window when the program executed within |
|
|
966 | it exits. Instead, it will wait till it is being killed or closed by the |
|
|
967 | user. |
907 | |
968 | |
908 | =item B<keysym.>I<sym>: I<string> |
969 | =item B<keysym.>I<sym>: I<string> |
909 | |
970 | |
910 | Compile I<frills>: Associate I<string> with keysym I<sym>. The |
971 | Compile I<frills>: Associate I<string> with keysym I<sym>. The |
911 | intervening resource name B<keysym.> cannot be omitted. |
972 | intervening resource name B<keysym.> cannot be omitted. |
… | |
… | |
956 | is interpreted and executed as @@RXVT_NAME@@'s control sequence. For |
1017 | is interpreted and executed as @@RXVT_NAME@@'s control sequence. For |
957 | example the following means "change the current locale to C<zh_CN.GBK> |
1018 | example the following means "change the current locale to C<zh_CN.GBK> |
958 | when Control-Meta-c is being pressed": |
1019 | when Control-Meta-c is being pressed": |
959 | |
1020 | |
960 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 |
1021 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007 |
|
|
1022 | |
|
|
1023 | Due the the large number of modifier combinations, a defined key mapping |
|
|
1024 | will match if at I<at least> the specified identifiers are being set, and |
|
|
1025 | no other key mappings with those and more bits are being defined. That |
|
|
1026 | means that defining a key map for C<a> will automatically provide |
|
|
1027 | definitions for C<Meta-a>, C<Shift-a> and so on, unless some of those are defined |
|
|
1028 | mappings themselves. |
|
|
1029 | |
|
|
1030 | Unfortunately, this will override built-in key mappings. For example |
|
|
1031 | if you overwrite the C<Insert> key you will disable @@RXVT_NAME@@'s |
|
|
1032 | C<Shift-Insert> mapping. To re-enable that, you can poke "holes" into the |
|
|
1033 | user-defined keymap using the C<builtin:> replacement: |
|
|
1034 | |
|
|
1035 | URxvt.keysym.Insert: <my insert key sequence> |
|
|
1036 | URxvt.keysym.S-Insert: builtin: |
|
|
1037 | |
|
|
1038 | The first line defines a mapping for C<Insert> and I<any> combination |
|
|
1039 | of modifiers. The second line re-establishes the default mapping for |
|
|
1040 | C<Shift-Insert>. |
961 | |
1041 | |
962 | The following example will map Control-Meta-1 and Control-Meta-2 to |
1042 | The following example will map Control-Meta-1 and Control-Meta-2 to |
963 | the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited |
1043 | the fonts C<suxuseuro> and C<9x15bold>, so you can have some limited |
964 | font-switching at runtime: |
1044 | font-switching at runtime: |
965 | |
1045 | |
… | |
… | |
1013 | to select a word; Left triple-click to select the entire logical line |
1093 | to select a word; Left triple-click to select the entire logical line |
1014 | (which can span multiple screen lines), unless modified by resource |
1094 | (which can span multiple screen lines), unless modified by resource |
1015 | B<tripleclickwords>. |
1095 | B<tripleclickwords>. |
1016 | |
1096 | |
1017 | Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys) |
1097 | Starting a selection while pressing the B<Meta> key (or B<Meta+Ctrl> keys) |
1018 | (Compile: I<frills>) will create a rectangular selection instead of a normal |
1098 | (Compile: I<frills>) will create a rectangular selection instead of a |
1019 | one. |
1099 | normal one. In this mode, every selected row becomes its own line in the |
|
|
1100 | selection, and trailing whitespace is visually underlined and removed from |
|
|
1101 | the selection. |
1020 | |
1102 | |
1021 | =item B<Insertion>: |
1103 | =item B<Insertion>: |
1022 | |
1104 | |
1023 | Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in |
1105 | Pressing and releasing the Middle mouse button (or B<Shift-Insert>) in |
1024 | an B<@@RXVT_NAME@@> window causes the current text selection to be |
1106 | an B<@@RXVT_NAME@@> window causes the current text selection to be |
… | |
… | |
1032 | supported in rxvt-unicode. Bug me if you need this. |
1114 | supported in rxvt-unicode. Bug me if you need this. |
1033 | |
1115 | |
1034 | You can, however, switch fonts at runtime using escape sequences (and |
1116 | You can, however, switch fonts at runtime using escape sequences (and |
1035 | therefore using the menubar), e.g.: |
1117 | therefore using the menubar), e.g.: |
1036 | |
1118 | |
1037 | printf '\e]701;%s\007' "9x15bold,xft:Kochi Gothic" |
1119 | printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic" |
1038 | |
1120 | |
1039 | rxvt-unicode will automatically re-apply these fonts to the output so far. |
1121 | rxvt-unicode will automatically re-apply these fonts to the output so far. |
1040 | |
1122 | |
1041 | =head1 ISO 14755 SUPPORT |
1123 | =head1 ISO 14755 SUPPORT |
1042 | |
1124 | |
… | |
… | |
1218 | =item B<RXVT_SOCKET> |
1300 | =item B<RXVT_SOCKET> |
1219 | |
1301 | |
1220 | The unix domain socket path used by @@RXVT_NAME@@c(1) and |
1302 | The unix domain socket path used by @@RXVT_NAME@@c(1) and |
1221 | @@RXVT_NAME@@d(1). |
1303 | @@RXVT_NAME@@d(1). |
1222 | |
1304 | |
1223 | Default C<< $HOME/.rxvt-unicode-<nodename >>. |
1305 | Default F<<< $HOME/.rxvt-unicode-I<< <nodename >> >>>. |
1224 | |
1306 | |
1225 | =item B<HOME> |
1307 | =item B<HOME> |
1226 | |
1308 | |
1227 | Used to locate the default directory for the unix domain socket for |
1309 | Used to locate the default directory for the unix domain socket for |
1228 | daemon communications and to locate various resource files (such as |
1310 | daemon communications and to locate various resource files (such as |
… | |
… | |
1249 | |
1331 | |
1250 | =back |
1332 | =back |
1251 | |
1333 | |
1252 | =head1 SEE ALSO |
1334 | =head1 SEE ALSO |
1253 | |
1335 | |
1254 | @@RXVT_NAME@@(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) |
1336 | @@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) |
1255 | |
|
|
1256 | =head1 BUGS |
|
|
1257 | |
|
|
1258 | Check the BUGS file for an up-to-date list. |
|
|
1259 | |
|
|
1260 | Cursor change support is not yet implemented. |
|
|
1261 | |
|
|
1262 | Click-and-drag doesn't work with X11 mouse report overriding. |
|
|
1263 | |
1337 | |
1264 | =head1 CURRENT PROJECT COORDINATOR |
1338 | =head1 CURRENT PROJECT COORDINATOR |
1265 | |
1339 | |
1266 | =over 4 |
1340 | =over 4 |
1267 | |
1341 | |