… | |
… | |
27 | <li><a href="#login_stamp">LOGIN STAMP</a></li> |
27 | <li><a href="#login_stamp">LOGIN STAMP</a></li> |
28 | <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li> |
28 | <li><a href="#colors_and_graphics">COLORS AND GRAPHICS</a></li> |
29 | <li><a href="#environment">ENVIRONMENT</a></li> |
29 | <li><a href="#environment">ENVIRONMENT</a></li> |
30 | <li><a href="#files">FILES</a></li> |
30 | <li><a href="#files">FILES</a></li> |
31 | <li><a href="#see_also">SEE ALSO</a></li> |
31 | <li><a href="#see_also">SEE ALSO</a></li> |
32 | <li><a href="#bugs">BUGS</a></li> |
|
|
33 | <li><a href="#current_project_coordinator">CURRENT PROJECT COORDINATOR</a></li> |
32 | <li><a href="#current_project_coordinator">CURRENT PROJECT COORDINATOR</a></li> |
34 | <li><a href="#authors">AUTHORS</a></li> |
33 | <li><a href="#authors">AUTHORS</a></li> |
35 | </ul> |
34 | </ul> |
36 | <!-- INDEX END --> |
35 | <!-- INDEX END --> |
37 | |
36 | |
… | |
… | |
47 | <p><strong>rxvt</strong> [options] [-e command [ args ]]</p> |
46 | <p><strong>rxvt</strong> [options] [-e command [ args ]]</p> |
48 | <p> |
47 | <p> |
49 | </p> |
48 | </p> |
50 | <hr /> |
49 | <hr /> |
51 | <h1><a name="description">DESCRIPTION</a></h1> |
50 | <h1><a name="description">DESCRIPTION</a></h1> |
52 | <p><strong>rxvt-unicode</strong>, version <strong>5.3</strong>, is a colour vt102 terminal |
51 | <p><strong>rxvt-unicode</strong>, version <strong>5.9</strong>, is a colour vt102 terminal |
53 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
52 | emulator intended as an <em>xterm</em>(1) replacement for users who do not |
54 | require features such as Tektronix 4014 emulation and toolkit-style |
53 | require features such as Tektronix 4014 emulation and toolkit-style |
55 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
54 | configurability. As a result, <strong>rxvt-unicode</strong> uses much less swap space -- |
56 | a significant advantage on a machine serving many X sessions.</p> |
55 | a significant advantage on a machine serving many X sessions.</p> |
57 | <p> |
56 | <p> |
… | |
… | |
150 | </dt> |
149 | </dt> |
151 | <dd> |
150 | <dd> |
152 | Turn on/off jump scrolling; resource <strong>jumpScroll</strong>. |
151 | Turn on/off jump scrolling; resource <strong>jumpScroll</strong>. |
153 | </dd> |
152 | </dd> |
154 | <p></p> |
153 | <p></p> |
155 | <dt><strong><a name="item__2dip_7c_2bip"><strong>-ip</strong>|<strong>+ip</strong></a></strong><br /> |
154 | <dt><strong><a name="item__2dip_7c_2bip__7c__2dtr_7c_2btr"><strong>-ip</strong>|<strong>+ip</strong> | <strong>-tr</strong>|<strong>+tr</strong></a></strong><br /> |
156 | </dt> |
155 | </dt> |
157 | <dd> |
156 | <dd> |
158 | Turn on/off inheriting parent window's pixmap. Alternative form is |
157 | Turn on/off inheriting parent window's pixmap. Alternative form is |
159 | <strong>-tr</strong>; resource <strong>inheritPixmap</strong>. |
158 | <strong>-tr</strong>; resource <strong>inheritPixmap</strong>. |
160 | </dd> |
159 | </dd> |
161 | <p></p> |
160 | <p></p> |
162 | <dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br /> |
161 | <dt><strong><a name="item__2dfade_number"><strong>-fade</strong> <em>number</em></a></strong><br /> |
163 | </dt> |
162 | </dt> |
164 | <dd> |
163 | <dd> |
165 | Fade the text by the given percentage when focus is lost. resource <strong>fading</strong>. |
164 | Fade the text by the given percentage when focus is lost. Small values |
|
|
165 | fade a little only, 100 completely replaces all colours by the fade |
|
|
166 | colour; resource <strong>fading</strong>. |
|
|
167 | </dd> |
|
|
168 | <p></p> |
|
|
169 | <dt><strong><a name="item__2dfadecolor_colour"><strong>-fadecolor</strong> <em>colour</em></a></strong><br /> |
|
|
170 | </dt> |
|
|
171 | <dd> |
|
|
172 | Fade to this colour when fading is used (see <strong>-fade</strong>). The default colour |
|
|
173 | is black. resource <strong>fadeColor</strong>. |
166 | </dd> |
174 | </dd> |
167 | <p></p> |
175 | <p></p> |
168 | <dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br /> |
176 | <dt><strong><a name="item__2dtint_colour"><strong>-tint</strong> <em>colour</em></a></strong><br /> |
169 | </dt> |
177 | </dt> |
170 | <dd> |
178 | <dd> |
171 | Tint the transparent background pixmap with the given colour when |
179 | Tint the transparent background pixmap with the given colour when |
172 | transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. See also the <strong>-sh</strong> |
180 | transparency is enabled with <strong>-tr</strong> or <strong>-ip</strong>. This only works for |
173 | option that can be used to brighten or darken the image in addition to |
181 | non-tiled backgrounds, currently. See also the <strong>-sh</strong> option that can be |
174 | tinting it. |
182 | used to brighten or darken the image in addition to tinting it; resource |
|
|
183 | <em>tintColor</em>. Example: |
|
|
184 | </dd> |
|
|
185 | <dd> |
|
|
186 | <pre> |
|
|
187 | rxvt -tr -tint blue -sh 40</pre> |
175 | </dd> |
188 | </dd> |
176 | <p></p> |
189 | <p></p> |
177 | <dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br /> |
190 | <dt><strong><a name="item__2dsh"><strong>-sh</strong></a></strong><br /> |
178 | </dt> |
191 | </dt> |
179 | <dd> |
192 | <dd> |
… | |
… | |
336 | </dd> |
349 | </dd> |
337 | <p></p> |
350 | <p></p> |
338 | <dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br /> |
351 | <dt><strong><a name="item__2dst_7c_2bst"><strong>-st</strong>|<strong>+st</strong></a></strong><br /> |
339 | </dt> |
352 | </dt> |
340 | <dd> |
353 | <dd> |
341 | Display normal (non XTerm/NeXT) scrollbar without/with a trough; |
354 | Display rxvt (non XTerm/NeXT) scrollbar without/with a trough; |
342 | resource <strong>scrollBar_floating</strong>. |
355 | resource <strong>scrollBar_floating</strong>. |
343 | </dd> |
356 | </dd> |
344 | <p></p> |
357 | <p></p> |
345 | <dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong><br /> |
358 | <dt><strong><a name="item__2dptab_7c_2bptab"><strong>-ptab</strong>|<strong>+ptab</strong></a></strong><br /> |
346 | </dt> |
359 | </dt> |
… | |
… | |
736 | </dd> |
749 | </dd> |
737 | <p></p> |
750 | <p></p> |
738 | <dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> |
751 | <dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> |
739 | </dt> |
752 | </dt> |
740 | <dd> |
753 | <dd> |
741 | Fade the text by the given percentage when focus is lost. |
754 | Fade the text by the given percentage when focus is lost; option <strong>-fade</strong>. |
|
|
755 | </dd> |
|
|
756 | <p></p> |
|
|
757 | <dt><strong><a name="item_fadecolor_3a_colour"><strong>fadeColor:</strong> <em>colour</em></a></strong><br /> |
|
|
758 | </dt> |
|
|
759 | <dd> |
|
|
760 | Fade to this colour, when fading is used (see <strong>fading:</strong>). The default |
|
|
761 | colour is black; option <strong>-fadecolor</strong>. |
742 | </dd> |
762 | </dd> |
743 | <p></p> |
763 | <p></p> |
744 | <dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br /> |
764 | <dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br /> |
745 | </dt> |
765 | </dt> |
746 | <dd> |
766 | <dd> |
747 | Tint the transparent background pixmap with the given colour. |
767 | Tint the transparent background pixmap with the given colour; option |
|
|
768 | <strong>-tint</strong>. |
748 | </dd> |
769 | </dd> |
749 | <p></p> |
770 | <p></p> |
750 | <dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br /> |
771 | <dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br /> |
751 | </dt> |
772 | </dt> |
752 | <dd> |
773 | <dd> |
… | |
… | |
762 | <p></p> |
783 | <p></p> |
763 | <dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong><br /> |
784 | <dt><strong><a name="item_troughcolor_3a_colour"><strong>troughColor:</strong> <em>colour</em></a></strong><br /> |
764 | </dt> |
785 | </dt> |
765 | <dd> |
786 | <dd> |
766 | Use the specified colour for the scrollbar's trough area [default |
787 | Use the specified colour for the scrollbar's trough area [default |
767 | #969696]. Only relevant for normal (non XTerm/NeXT) scrollbar. |
788 | #969696]. Only relevant for rxvt (non XTerm/NeXT) scrollbar. |
768 | </dd> |
789 | </dd> |
769 | <p></p> |
790 | <p></p> |
770 | <dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br /> |
791 | <dt><strong><a name="item_bordercolor_3a_colour"><strong>borderColor:</strong> <em>colour</em></a></strong><br /> |
771 | </dt> |
792 | </dt> |
772 | <dd> |
793 | <dd> |
… | |
… | |
892 | <p></p> |
913 | <p></p> |
893 | <dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong><br /> |
914 | <dt><strong><a name="item_scrollstyle_3a_mode"><strong>scrollstyle:</strong> <em>mode</em></a></strong><br /> |
894 | </dt> |
915 | </dt> |
895 | <dd> |
916 | <dd> |
896 | Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is |
917 | Set scrollbar style to <strong>rxvt</strong>, <strong>plain</strong>, <strong>next</strong> or <strong>xterm</strong>. <strong>plain</strong> is |
897 | the author's favourite.. |
918 | the author's favourite. |
898 | </dd> |
919 | </dd> |
899 | <p></p> |
920 | <p></p> |
900 | <dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br /> |
921 | <dt><strong><a name="item_title_3a_string"><strong>title:</strong> <em>string</em></a></strong><br /> |
901 | </dt> |
922 | </dt> |
902 | <dd> |
923 | <dd> |
… | |
… | |
947 | </dt> |
968 | </dt> |
948 | <dd> |
969 | <dd> |
949 | Specify a command pipe for vt100 printer [default <em>lpr(1)</em>]. Use |
970 | Specify a command pipe for vt100 printer [default <em>lpr(1)</em>]. Use |
950 | <strong>Print</strong> to initiate a screen dump to the printer and <strong>Ctrl-Print</strong> or |
971 | <strong>Print</strong> to initiate a screen dump to the printer and <strong>Ctrl-Print</strong> or |
951 | <strong>Shift-Print</strong> to include the scrollback as well. |
972 | <strong>Shift-Print</strong> to include the scrollback as well. |
|
|
973 | </dd> |
|
|
974 | <dd> |
|
|
975 | <p>The string will be interpreted as if typed into the shell as-is.</p> |
|
|
976 | </dd> |
|
|
977 | <dd> |
|
|
978 | <p>Example:</p> |
|
|
979 | </dd> |
|
|
980 | <dd> |
|
|
981 | <pre> |
|
|
982 | URxvt*print-pipe: cat > $(TMPDIR=$HOME mktemp urxvt.XXXXXX)</pre> |
|
|
983 | </dd> |
|
|
984 | <dd> |
|
|
985 | <p>This creates a new file in your home directory with the screen contents |
|
|
986 | everytime you hit <code>Print</code>.</p> |
952 | </dd> |
987 | </dd> |
953 | <p></p> |
988 | <p></p> |
954 | <dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br /> |
989 | <dt><strong><a name="item_scrollbar_3a_boolean"><strong>scrollBar:</strong> <em>boolean</em></a></strong><br /> |
955 | </dt> |
990 | </dt> |
956 | <dd> |
991 | <dd> |
… | |
… | |
1172 | </dt> |
1207 | </dt> |
1173 | <dd> |
1208 | <dd> |
1174 | Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that |
1209 | Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that |
1175 | echo arbitrary strings like the icon name or the locale. This could be |
1210 | echo arbitrary strings like the icon name or the locale. This could be |
1176 | abused if somebody gets 8-bit-clean access to your display, whether |
1211 | abused if somebody gets 8-bit-clean access to your display, whether |
1177 | throuh a mail client displaying mail bodies unfiltered or though |
1212 | through a mail client displaying mail bodies unfiltered or through |
1178 | write(1). Therefore, these sequences are disabled by default. (Note |
1213 | <code>write(1)</code> or any other means. Therefore, these sequences are disabled by |
1179 | that other terminals, including xterm, have these sequences |
1214 | default. (Note that many other terminals, including xterm, have these |
1180 | enabled by default). You can enable them by setting this boolean |
1215 | sequences enabled by default, which doesn't make it safer, though). |
1181 | resource or specifying <strong>-insecure</strong> as an option. At the moment, this |
1216 | </dd> |
1182 | enabled display-answer, locale, findfont, icon label and window title |
1217 | <dd> |
1183 | requests as well as dynamic menubar dispatch. |
1218 | <p>You can enable them by setting this boolean resource or specifying |
|
|
1219 | <strong>-insecure</strong> as an option. At the moment, this enables display-answer, |
|
|
1220 | locale, findfont, icon label and window title requests as well as dynamic |
|
|
1221 | menubar dispatch.</p> |
1184 | </dd> |
1222 | </dd> |
1185 | <p></p> |
1223 | <p></p> |
1186 | <dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> |
1224 | <dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> |
1187 | </dt> |
1225 | </dt> |
1188 | <dd> |
1226 | <dd> |
… | |
… | |
1281 | when Control-Meta-c is being pressed'':</p> |
1319 | when Control-Meta-c is being pressed'':</p> |
1282 | </dd> |
1320 | </dd> |
1283 | <dd> |
1321 | <dd> |
1284 | <pre> |
1322 | <pre> |
1285 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> |
1323 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> |
|
|
1324 | </dd> |
|
|
1325 | <dd> |
|
|
1326 | <p>Due the the large number of modifier combinations, a defined key mapping |
|
|
1327 | will match if at <em>at least</em> the specified identifiers are being set, and |
|
|
1328 | no other key mappings with those and more bits are being defined. That |
|
|
1329 | means that defining a key map for <code>a</code> will automatically provide |
|
|
1330 | definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined |
|
|
1331 | mappings themselves.</p> |
|
|
1332 | </dd> |
|
|
1333 | <dd> |
|
|
1334 | <p>Unfortunately, this will override built-in key mappings. For example |
|
|
1335 | if you overwrite the <code>Insert</code> key you will disable rxvt's |
|
|
1336 | <code>Shift-Insert</code> mapping. To re-enable that, you can poke ``holes'' into the |
|
|
1337 | user-defined keymap using the <code>builtin:</code> replacement:</p> |
|
|
1338 | </dd> |
|
|
1339 | <dd> |
|
|
1340 | <pre> |
|
|
1341 | URxvt.keysym.Insert: <my insert key sequence> |
|
|
1342 | URxvt.keysym.S-Insert: builtin:</pre> |
|
|
1343 | </dd> |
|
|
1344 | <dd> |
|
|
1345 | <p>The first line defines a mapping for <code>Insert</code> and <em>any</em> combination |
|
|
1346 | of modifiers. The second line re-establishes the default mapping for |
|
|
1347 | <code>Shift-Insert</code>.</p> |
1286 | </dd> |
1348 | </dd> |
1287 | <dd> |
1349 | <dd> |
1288 | <p>The following example will map Control-Meta-1 and Control-Meta-2 to |
1350 | <p>The following example will map Control-Meta-1 and Control-Meta-2 to |
1289 | the fonts <code>suxuseuro</code> and <code>9x15bold</code>, so you can have some limited |
1351 | the fonts <code>suxuseuro</code> and <code>9x15bold</code>, so you can have some limited |
1290 | font-switching at runtime:</p> |
1352 | font-switching at runtime:</p> |
… | |
… | |
1366 | <p>Changing fonts (or font sizes, respectively) via the keypad is not yet |
1428 | <p>Changing fonts (or font sizes, respectively) via the keypad is not yet |
1367 | supported in rxvt-unicode. Bug me if you need this.</p> |
1429 | supported in rxvt-unicode. Bug me if you need this.</p> |
1368 | <p>You can, however, switch fonts at runtime using escape sequences (and |
1430 | <p>You can, however, switch fonts at runtime using escape sequences (and |
1369 | therefore using the menubar), e.g.:</p> |
1431 | therefore using the menubar), e.g.:</p> |
1370 | <pre> |
1432 | <pre> |
1371 | printf '\e]701;%s\007' "9x15bold,xft:Kochi Gothic"</pre> |
1433 | printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"</pre> |
1372 | <p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> |
1434 | <p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> |
1373 | <p> |
1435 | <p> |
1374 | </p> |
1436 | </p> |
1375 | <hr /> |
1437 | <hr /> |
1376 | <h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> |
1438 | <h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> |
… | |
… | |
1557 | <dd> |
1619 | <dd> |
1558 | The unix domain socket path used by <code>rxvtc(1)</code> and |
1620 | The unix domain socket path used by <code>rxvtc(1)</code> and |
1559 | rxvtd(1). |
1621 | rxvtd(1). |
1560 | </dd> |
1622 | </dd> |
1561 | <dd> |
1623 | <dd> |
1562 | <p>Default <code>$HOME/.rxvt-unicode-<nodename</code>.</p> |
1624 | <p>Default <em>$HOME/.rxvt-unicode-<em><nodename </em></em> >>>.</p> |
1563 | </dd> |
1625 | </dd> |
1564 | <p></p> |
1626 | <p></p> |
1565 | <dt><strong><a name="item_home"><strong>HOME</strong></a></strong><br /> |
1627 | <dt><strong><a name="item_home"><strong>HOME</strong></a></strong><br /> |
1566 | </dt> |
1628 | </dt> |
1567 | <dd> |
1629 | <dd> |
… | |
… | |
1596 | <p></p></dl> |
1658 | <p></p></dl> |
1597 | <p> |
1659 | <p> |
1598 | </p> |
1660 | </p> |
1599 | <hr /> |
1661 | <hr /> |
1600 | <h1><a name="see_also">SEE ALSO</a></h1> |
1662 | <h1><a name="see_also">SEE ALSO</a></h1> |
1601 | <p>rxvt(7), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> |
1663 | <p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> |
1602 | <p> |
|
|
1603 | </p> |
|
|
1604 | <hr /> |
|
|
1605 | <h1><a name="bugs">BUGS</a></h1> |
|
|
1606 | <p>Check the BUGS file for an up-to-date list.</p> |
|
|
1607 | <p>Cursor change support is not yet implemented.</p> |
|
|
1608 | <p>Click-and-drag doesn't work with X11 mouse report overriding.</p> |
|
|
1609 | <p> |
1664 | <p> |
1610 | </p> |
1665 | </p> |
1611 | <hr /> |
1666 | <hr /> |
1612 | <h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> |
1667 | <h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> |
1613 | <dl> |
1668 | <dl> |