… | |
… | |
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.6</strong>, is a colour vt102 terminal |
51 | <p><strong>rxvt-unicode</strong>, version <strong>6.1</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> |
… | |
… | |
421 | given on the command line. If this option is used, it must be the last |
434 | given on the command line. If this option is used, it must be the last |
422 | on the command-line. If there is no <strong>-e</strong> option then the default is to |
435 | on the command-line. If there is no <strong>-e</strong> option then the default is to |
423 | run the program specified by the <strong>SHELL</strong> environment variable or, |
436 | run the program specified by the <strong>SHELL</strong> environment variable or, |
424 | failing that, <em>sh(1)</em>. |
437 | failing that, <em>sh(1)</em>. |
425 | </dd> |
438 | </dd> |
|
|
439 | <dd> |
|
|
440 | <p>Please note that you must specify a program with arguments. If you want to |
|
|
441 | run shell commands, you have to specify the shell, like this:</p> |
|
|
442 | </dd> |
|
|
443 | <dd> |
|
|
444 | <pre> |
|
|
445 | rxvt -e sh -c "shell commands"</pre> |
|
|
446 | </dd> |
426 | <p></p> |
447 | <p></p> |
427 | <dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br /> |
448 | <dt><strong><a name="item__2dtitle_text"><strong>-title</strong> <em>text</em></a></strong><br /> |
428 | </dt> |
449 | </dt> |
429 | <dd> |
450 | <dd> |
430 | Window title (<strong>-T</strong> still respected); the default title is the basename |
451 | Window title (<strong>-T</strong> still respected); the default title is the basename |
… | |
… | |
509 | <dt><strong><a name="item__2dssr_7c_2bssr"><strong>-ssr</strong>|<strong>+ssr</strong></a></strong><br /> |
530 | <dt><strong><a name="item__2dssr_7c_2bssr"><strong>-ssr</strong>|<strong>+ssr</strong></a></strong><br /> |
510 | </dt> |
531 | </dt> |
511 | <dd> |
532 | <dd> |
512 | Turn on/off secondary screen scroll (default enabled); resource |
533 | Turn on/off secondary screen scroll (default enabled); resource |
513 | <strong>secondaryScroll</strong>. |
534 | <strong>secondaryScroll</strong>. |
|
|
535 | </dd> |
|
|
536 | <p></p> |
|
|
537 | <dt><strong><a name="item__2dhold_7c_2bhold"><strong>-hold</strong>|<strong>+hold</strong></a></strong><br /> |
|
|
538 | </dt> |
|
|
539 | <dd> |
|
|
540 | Turn on/off hold window after exit support. If enabled, rxvt |
|
|
541 | will not immediately destroy its window when the program executed within |
|
|
542 | it exits. Instead, it will wait till it is being killed or closed by the |
|
|
543 | user; resource <strong>hold</strong>. |
514 | </dd> |
544 | </dd> |
515 | <p></p> |
545 | <p></p> |
516 | <dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong><br /> |
546 | <dt><strong><a name="item__2dkeysym_2esym_string"><strong>-keysym.</strong><em>sym</em> <em>string</em></a></strong><br /> |
517 | </dt> |
547 | </dt> |
518 | <dd> |
548 | <dd> |
… | |
… | |
736 | </dd> |
766 | </dd> |
737 | <p></p> |
767 | <p></p> |
738 | <dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> |
768 | <dt><strong><a name="item_fading_3a_number"><strong>fading:</strong> <em>number</em></a></strong><br /> |
739 | </dt> |
769 | </dt> |
740 | <dd> |
770 | <dd> |
741 | Fade the text by the given percentage when focus is lost. |
771 | Fade the text by the given percentage when focus is lost; option <strong>-fade</strong>. |
|
|
772 | </dd> |
|
|
773 | <p></p> |
|
|
774 | <dt><strong><a name="item_fadecolor_3a_colour"><strong>fadeColor:</strong> <em>colour</em></a></strong><br /> |
|
|
775 | </dt> |
|
|
776 | <dd> |
|
|
777 | Fade to this colour, when fading is used (see <strong>fading:</strong>). The default |
|
|
778 | colour is black; option <strong>-fadecolor</strong>. |
742 | </dd> |
779 | </dd> |
743 | <p></p> |
780 | <p></p> |
744 | <dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br /> |
781 | <dt><strong><a name="item_tintcolor_3a_colour"><strong>tintColor:</strong> <em>colour</em></a></strong><br /> |
745 | </dt> |
782 | </dt> |
746 | <dd> |
783 | <dd> |
747 | Tint the transparent background pixmap with the given colour. |
784 | Tint the transparent background pixmap with the given colour; option |
|
|
785 | <strong>-tint</strong>. |
748 | </dd> |
786 | </dd> |
749 | <p></p> |
787 | <p></p> |
750 | <dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br /> |
788 | <dt><strong><a name="item_shading_3a_number"><strong>shading:</strong> <em>number</em></a></strong><br /> |
751 | </dt> |
789 | </dt> |
752 | <dd> |
790 | <dd> |
… | |
… | |
1186 | </dt> |
1224 | </dt> |
1187 | <dd> |
1225 | <dd> |
1188 | Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that |
1226 | Enables ``insecure'' mode. Rxvt-unicode offers some escape sequences that |
1189 | echo arbitrary strings like the icon name or the locale. This could be |
1227 | echo arbitrary strings like the icon name or the locale. This could be |
1190 | abused if somebody gets 8-bit-clean access to your display, whether |
1228 | abused if somebody gets 8-bit-clean access to your display, whether |
1191 | throuh a mail client displaying mail bodies unfiltered or though |
1229 | through a mail client displaying mail bodies unfiltered or through |
1192 | write(1). Therefore, these sequences are disabled by default. (Note |
1230 | <code>write(1)</code> or any other means. Therefore, these sequences are disabled by |
1193 | that other terminals, including xterm, have these sequences |
1231 | default. (Note that many other terminals, including xterm, have these |
1194 | enabled by default). You can enable them by setting this boolean |
1232 | sequences enabled by default, which doesn't make it safer, though). |
1195 | resource or specifying <strong>-insecure</strong> as an option. At the moment, this |
1233 | </dd> |
1196 | enabled display-answer, locale, findfont, icon label and window title |
1234 | <dd> |
1197 | requests as well as dynamic menubar dispatch. |
1235 | <p>You can enable them by setting this boolean resource or specifying |
|
|
1236 | <strong>-insecure</strong> as an option. At the moment, this enables display-answer, |
|
|
1237 | locale, findfont, icon label and window title requests as well as dynamic |
|
|
1238 | menubar dispatch.</p> |
1198 | </dd> |
1239 | </dd> |
1199 | <p></p> |
1240 | <p></p> |
1200 | <dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> |
1241 | <dt><strong><a name="item_modifier_3a_modifier"><strong>modifier:</strong> <em>modifier</em></a></strong><br /> |
1201 | </dt> |
1242 | </dt> |
1202 | <dd> |
1243 | <dd> |
… | |
… | |
1224 | <dd> |
1265 | <dd> |
1225 | Turn on/off secondary screen scroll (default enabled). If the this |
1266 | Turn on/off secondary screen scroll (default enabled). If the this |
1226 | option is enabled, scrolls on the secondary screen will change the |
1267 | option is enabled, scrolls on the secondary screen will change the |
1227 | scrollback buffer and switching to/from the secondary screen will |
1268 | scrollback buffer and switching to/from the secondary screen will |
1228 | instead scroll the screen up. |
1269 | instead scroll the screen up. |
|
|
1270 | </dd> |
|
|
1271 | <p></p> |
|
|
1272 | <dt><strong><a name="item_hold_3a_bool"><strong>hold</strong>: <em>bool</em></a></strong><br /> |
|
|
1273 | </dt> |
|
|
1274 | <dd> |
|
|
1275 | Turn on/off hold window after exit support. If enabled, rxvt |
|
|
1276 | will not immediately destroy its window when the program executed within |
|
|
1277 | it exits. Instead, it will wait till it is being killed or closed by the |
|
|
1278 | user. |
1229 | </dd> |
1279 | </dd> |
1230 | <p></p> |
1280 | <p></p> |
1231 | <dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong><br /> |
1281 | <dt><strong><a name="item_keysym_2esym_3a_string"><strong>keysym.</strong><em>sym</em>: <em>string</em></a></strong><br /> |
1232 | </dt> |
1282 | </dt> |
1233 | <dd> |
1283 | <dd> |
… | |
… | |
1383 | (which can span multiple screen lines), unless modified by resource |
1433 | (which can span multiple screen lines), unless modified by resource |
1384 | <strong>tripleclickwords</strong>. |
1434 | <strong>tripleclickwords</strong>. |
1385 | </dd> |
1435 | </dd> |
1386 | <dd> |
1436 | <dd> |
1387 | <p>Starting a selection while pressing the <strong>Meta</strong> key (or <strong>Meta+Ctrl</strong> keys) |
1437 | <p>Starting a selection while pressing the <strong>Meta</strong> key (or <strong>Meta+Ctrl</strong> keys) |
1388 | (Compile: <em>frills</em>) will create a rectangular selection instead of a normal |
1438 | (Compile: <em>frills</em>) will create a rectangular selection instead of a |
1389 | one.</p> |
1439 | normal one. In this mode, every selected row becomes its own line in the |
|
|
1440 | selection, and trailing whitespace is visually underlined and removed from |
|
|
1441 | the selection.</p> |
1390 | </dd> |
1442 | </dd> |
1391 | <p></p> |
1443 | <p></p> |
1392 | <dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br /> |
1444 | <dt><strong><a name="item_insertion_3a"><strong>Insertion</strong>:</a></strong><br /> |
1393 | </dt> |
1445 | </dt> |
1394 | <dd> |
1446 | <dd> |
… | |
… | |
1404 | <p>Changing fonts (or font sizes, respectively) via the keypad is not yet |
1456 | <p>Changing fonts (or font sizes, respectively) via the keypad is not yet |
1405 | supported in rxvt-unicode. Bug me if you need this.</p> |
1457 | supported in rxvt-unicode. Bug me if you need this.</p> |
1406 | <p>You can, however, switch fonts at runtime using escape sequences (and |
1458 | <p>You can, however, switch fonts at runtime using escape sequences (and |
1407 | therefore using the menubar), e.g.:</p> |
1459 | therefore using the menubar), e.g.:</p> |
1408 | <pre> |
1460 | <pre> |
1409 | printf '\e]701;%s\007' "9x15bold,xft:Kochi Gothic"</pre> |
1461 | printf '\e]710;%s\007' "9x15bold,xft:Kochi Gothic"</pre> |
1410 | <p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> |
1462 | <p>rxvt-unicode will automatically re-apply these fonts to the output so far.</p> |
1411 | <p> |
1463 | <p> |
1412 | </p> |
1464 | </p> |
1413 | <hr /> |
1465 | <hr /> |
1414 | <h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> |
1466 | <h1><a name="iso_14755_support">ISO 14755 SUPPORT</a></h1> |
… | |
… | |
1638 | <h1><a name="see_also">SEE ALSO</a></h1> |
1690 | <h1><a name="see_also">SEE ALSO</a></h1> |
1639 | <p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> |
1691 | <p>rxvt(7), rxvtc(1), rxvtd(1), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), <code>utmp(5)</code></p> |
1640 | <p> |
1692 | <p> |
1641 | </p> |
1693 | </p> |
1642 | <hr /> |
1694 | <hr /> |
1643 | <h1><a name="bugs">BUGS</a></h1> |
|
|
1644 | <p>Check the BUGS file for an up-to-date list.</p> |
|
|
1645 | <p>Cursor change support is not yet implemented.</p> |
|
|
1646 | <p>Click-and-drag doesn't work with X11 mouse report overriding.</p> |
|
|
1647 | <p> |
|
|
1648 | </p> |
|
|
1649 | <hr /> |
|
|
1650 | <h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> |
1695 | <h1><a name="current_project_coordinator">CURRENT PROJECT COORDINATOR</a></h1> |
1651 | <dl> |
1696 | <dl> |
1652 | <dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong><br /> |
1697 | <dt><strong><a name="item_project_coordinator">Project Coordinator</a></strong><br /> |
1653 | </dt> |
1698 | </dt> |
1654 | <dd> |
1699 | <dd> |