… | |
… | |
46 | <p><strong>rxvt</strong> [options] [-e command [ args ]]</p> |
46 | <p><strong>rxvt</strong> [options] [-e command [ args ]]</p> |
47 | <p> |
47 | <p> |
48 | </p> |
48 | </p> |
49 | <hr /> |
49 | <hr /> |
50 | <h1><a name="description">DESCRIPTION</a></h1> |
50 | <h1><a name="description">DESCRIPTION</a></h1> |
51 | <p><strong>rxvt-unicode</strong>, version <strong>6.1</strong>, is a colour vt102 terminal |
51 | <p><strong>rxvt-unicode</strong>, version <strong>6.3</strong>, is a colour vt102 terminal |
52 | 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 |
53 | require features such as Tektronix 4014 emulation and toolkit-style |
53 | require features such as Tektronix 4014 emulation and toolkit-style |
54 | 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 -- |
55 | a significant advantage on a machine serving many X sessions.</p> |
55 | a significant advantage on a machine serving many X sessions.</p> |
56 | <p> |
56 | <p> |
… | |
… | |
266 | </dd> |
266 | </dd> |
267 | <p></p> |
267 | <p></p> |
268 | <dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br /> |
268 | <dt><strong><a name="item__2dfb_fontlist"><strong>-fb</strong> <em>fontlist</em></a></strong><br /> |
269 | </dt> |
269 | </dt> |
270 | <dd> |
270 | <dd> |
271 | Compile font-styles: The bold font list to use when bold characters are to |
271 | Compile <em>font-styles</em>: The bold font list to use when <strong>bold</strong> characters |
272 | be printed. See resource <strong>boldFont</strong> for details. |
272 | are to be printed. See resource <strong>boldFont</strong> for details. |
273 | </dd> |
273 | </dd> |
274 | <p></p> |
274 | <p></p> |
275 | <dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong><br /> |
275 | <dt><strong><a name="item__2dfi_fontlist"><strong>-fi</strong> <em>fontlist</em></a></strong><br /> |
276 | </dt> |
276 | </dt> |
277 | <dd> |
277 | <dd> |
278 | Compile font-styles: The italic font list to use when bold characters are to |
278 | Compile <em>font-styles</em>: The italic font list to use when <em>italic</em> |
279 | be printed. See resource <strong>italicFont</strong> for details. |
279 | characters are to be printed. See resource <strong>italicFont</strong> for details. |
280 | </dd> |
280 | </dd> |
281 | <p></p> |
281 | <p></p> |
282 | <dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong><br /> |
282 | <dt><strong><a name="item__2dfbi_fontlist"><strong>-fbi</strong> <em>fontlist</em></a></strong><br /> |
283 | </dt> |
283 | </dt> |
284 | <dd> |
284 | <dd> |
285 | Compile font-styles: The bold italic font list to use when bold characters are to |
285 | Compile <em>font-styles</em>: The bold italic font list to use when <strong><em>bold |
286 | be printed. See resource <strong>boldItalicFont</strong> for details. |
286 | italic</em> </strong>> characters are to be printed. See resource <strong>boldItalicFont</strong> |
|
|
287 | for details. |
|
|
288 | </dd> |
|
|
289 | <p></p> |
|
|
290 | <dt><strong><a name="item__2dis_7c_2bis"><strong>-is</strong>|<strong>+is</strong></a></strong><br /> |
|
|
291 | </dt> |
|
|
292 | <dd> |
|
|
293 | Compile <em>font-styles</em>: Bold/Italic font styles imply high intensity |
|
|
294 | foreground/background (default). See resource <strong>intensityStyles</strong> for |
|
|
295 | details. |
287 | </dd> |
296 | </dd> |
288 | <p></p> |
297 | <p></p> |
289 | <dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong><br /> |
298 | <dt><strong><a name="item__2dname_name"><strong>-name</strong> <em>name</em></a></strong><br /> |
290 | </dt> |
299 | </dt> |
291 | <dd> |
300 | <dd> |
… | |
… | |
404 | </dt> |
413 | </dt> |
405 | <dd> |
414 | <dd> |
406 | Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e. |
415 | Compile <em>frills</em>: Set MWM hints to request a borderless window, i.e. |
407 | if honoured by the WM, the rxvt-unicode window will not have window |
416 | if honoured by the WM, the rxvt-unicode window will not have window |
408 | decorations; resource <strong>borderLess</strong>. |
417 | decorations; resource <strong>borderLess</strong>. |
|
|
418 | </dd> |
|
|
419 | <p></p> |
|
|
420 | <dt><strong><a name="item__2dsbg"><strong>-sbg</strong></a></strong><br /> |
|
|
421 | </dt> |
|
|
422 | <dd> |
|
|
423 | Compile <em>frills</em>: Disable the usage of the built-in block graphics/line |
|
|
424 | drawing characters and just rely on what the specified fonts provide. Use |
|
|
425 | this if you have a good font and want to use its block graphic glyphs; |
|
|
426 | resource <strong>skipBuiltinGlyphs</strong>. |
409 | </dd> |
427 | </dd> |
410 | <p></p> |
428 | <p></p> |
411 | <dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong><br /> |
429 | <dt><strong><a name="item__2dlsp_number"><strong>-lsp</strong> <em>number</em></a></strong><br /> |
412 | </dt> |
430 | </dt> |
413 | <dd> |
431 | <dd> |
… | |
… | |
582 | my $xid = $_[0]->window->get_xid; |
600 | my $xid = $_[0]->window->get_xid; |
583 | system "rxvt -embed $xid &"; |
601 | system "rxvt -embed $xid &"; |
584 | });</pre> |
602 | });</pre> |
585 | </dd> |
603 | </dd> |
586 | <p></p> |
604 | <p></p> |
587 | <dt><strong><a name="item__2dpty_2dfd_fileno"><strong>-pty-fd</strong> <em>fileno</em></a></strong><br /> |
605 | <dt><strong><a name="item__2dpty_2dfd_file_descriptor"><strong>-pty-fd</strong> <em>file descriptor</em></a></strong><br /> |
588 | </dt> |
606 | </dt> |
589 | <dd> |
607 | <dd> |
590 | Tells rxvt NOT to execute any commands or create a new pty/tty |
608 | Tells rxvt NOT to execute any commands or create a new pty/tty |
591 | pair but instead use the given filehandle as the tty master. This is |
609 | pair but instead use the given filehandle as the tty master. This is |
592 | useful if you want to drive rxvt as a generic terminal emulator |
610 | useful if you want to drive rxvt as a generic terminal emulator |
… | |
… | |
594 | </dd> |
612 | </dd> |
595 | <dd> |
613 | <dd> |
596 | <p>If this switch is given, rxvt will not create any utmp/wtmp |
614 | <p>If this switch is given, rxvt will not create any utmp/wtmp |
597 | entries and will not tinker with pty/tty permissions - you have to do that |
615 | entries and will not tinker with pty/tty permissions - you have to do that |
598 | yourself if you want that.</p> |
616 | yourself if you want that.</p> |
|
|
617 | </dd> |
|
|
618 | <dd> |
|
|
619 | <p>As an extremely special case, specifying <code>-1</code> will completely suppress |
|
|
620 | pty/tty operations.</p> |
599 | </dd> |
621 | </dd> |
600 | <dd> |
622 | <dd> |
601 | <p>Here is a example in perl that illustrates how this option can be used (a |
623 | <p>Here is a example in perl that illustrates how this option can be used (a |
602 | longer example is in <em>doc/pty-fd</em>):</p> |
624 | longer example is in <em>doc/pty-fd</em>):</p> |
603 | </dd> |
625 | </dd> |
… | |
… | |
616 | <dd> |
638 | <dd> |
617 | <pre> |
639 | <pre> |
618 | # now communicate with rxvt |
640 | # now communicate with rxvt |
619 | my $slave = $pty->slave; |
641 | my $slave = $pty->slave; |
620 | while (<$slave>) { print $slave "got <$_>\n" }</pre> |
642 | while (<$slave>) { print $slave "got <$_>\n" }</pre> |
|
|
643 | </dd> |
|
|
644 | <p></p> |
|
|
645 | <dt><strong><a name="item__2dpe_string"><strong>-pe</strong> <em>string</em></a></strong><br /> |
|
|
646 | </dt> |
|
|
647 | <dd> |
|
|
648 | Comma-separated list of perl extension scripts to use (or not to use) in |
|
|
649 | this terminal instance. See resource <strong>perl-ext</strong> for details. |
621 | </dd> |
650 | </dd> |
622 | <p></p></dl> |
651 | <p></p></dl> |
623 | <p> |
652 | <p> |
624 | </p> |
653 | </p> |
625 | <hr /> |
654 | <hr /> |
… | |
… | |
847 | <dd> |
876 | <dd> |
848 | Select the fonts to be used. This is a comma separated list of font |
877 | Select the fonts to be used. This is a comma separated list of font |
849 | names that are used in turn when trying to display Unicode characters. |
878 | names that are used in turn when trying to display Unicode characters. |
850 | The first font defines the cell size for characters; other fonts might |
879 | The first font defines the cell size for characters; other fonts might |
851 | be smaller, but not larger. A reasonable default font list is always |
880 | be smaller, but not larger. A reasonable default font list is always |
852 | appended to it. option <strong>-fn</strong>. |
881 | appended to it; option <strong>-fn</strong>. |
853 | </dd> |
882 | </dd> |
854 | <dd> |
883 | <dd> |
855 | <p>Each font can either be a standard X11 core font (XLFD) name, with |
884 | <p>Each font can either be a standard X11 core font (XLFD) name, with |
856 | optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p> |
885 | optional prefix <code>x:</code> or a Xft font (Compile <em>xft</em>), prefixed with <code>xft:</code>.</p> |
857 | </dd> |
886 | </dd> |
… | |
… | |
918 | <dd> |
947 | <dd> |
919 | <p>If set, but empty, then this specific style is disabled and the normal |
948 | <p>If set, but empty, then this specific style is disabled and the normal |
920 | text font will being used for the given style.</p> |
949 | text font will being used for the given style.</p> |
921 | </dd> |
950 | </dd> |
922 | <p></p> |
951 | <p></p> |
|
|
952 | <dt><strong><a name="item_intensitystyles_3a_boolean"><strong>intensityStyles:</strong> <em>boolean</em></a></strong><br /> |
|
|
953 | </dt> |
|
|
954 | <dd> |
|
|
955 | When font styles are not enabled, or this option is enabled (<strong>True</strong>, |
|
|
956 | option <strong>-is</strong>, the default), bold and italic font styles imply high |
|
|
957 | intensity foreground/backround colours. Disabling this option (<strong>False</strong>, |
|
|
958 | option <strong>+is</strong>) disables this behaviour, the high intensity colours are not |
|
|
959 | reachable. |
|
|
960 | </dd> |
|
|
961 | <p></p> |
923 | <dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong><br /> |
962 | <dt><strong><a name="item_selectstyle_3a_mode"><strong>selectstyle:</strong> <em>mode</em></a></strong><br /> |
924 | </dt> |
963 | </dt> |
925 | <dd> |
964 | <dd> |
926 | Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is |
965 | Set mouse selection style to <strong>old</strong> which is 2.20, <strong>oldword</strong> which is |
927 | xterm style with 2.20 old word selection, or anything else which gives |
966 | xterm style with 2.20 old word selection, or anything else which gives |
… | |
… | |
1082 | <dd> |
1121 | <dd> |
1083 | Set MWM hints to request a borderless window, i.e. if honoured by the |
1122 | Set MWM hints to request a borderless window, i.e. if honoured by the |
1084 | WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>. |
1123 | WM, the rxvt-unicode window will not have window decorations; option <strong>-bl</strong>. |
1085 | </dd> |
1124 | </dd> |
1086 | <p></p> |
1125 | <p></p> |
|
|
1126 | <dt><strong><a name="item_skipbuiltinglyphs_3a_boolean"><strong>skipBuiltinGlyphs:</strong> <em>boolean</em></a></strong><br /> |
|
|
1127 | </dt> |
|
|
1128 | <dd> |
|
|
1129 | Compile <em>frills</em>: Disable the usage of the built-in block graphics/line |
|
|
1130 | drawing characters and just rely on what the specified fonts provide. Use |
|
|
1131 | this if you have a good font and want to use its block graphic glyphs; |
|
|
1132 | option <strong>-sbg</strong>. |
|
|
1133 | </dd> |
|
|
1134 | <p></p> |
1087 | <dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong><br /> |
1135 | <dt><strong><a name="item_termname_3a_termname"><strong>termName:</strong> <em>termname</em></a></strong><br /> |
1088 | </dt> |
1136 | </dt> |
1089 | <dd> |
1137 | <dd> |
1090 | Specifies the terminal type name to be set in the <strong>TERM</strong> environment |
1138 | Specifies the terminal type name to be set in the <strong>TERM</strong> environment |
1091 | variable; option <strong>-tn</strong>. |
1139 | variable; option <strong>-tn</strong>. |
… | |
… | |
1196 | </dt> |
1244 | </dt> |
1197 | <dd> |
1245 | <dd> |
1198 | The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g. |
1246 | The locale to use for opening the IM. You can use an <code>LC_CTYPE</code> of e.g. |
1199 | <code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the |
1247 | <code>de_DE.UTF-8</code> for normal text processing but <code>ja_JP.EUC-JP</code> for the |
1200 | input extension to be able to input japanese characters while staying in |
1248 | input extension to be able to input japanese characters while staying in |
1201 | another locale. option <strong>-imlocale</strong>. |
1249 | another locale; option <strong>-imlocale</strong>. |
1202 | </dd> |
1250 | </dd> |
1203 | <p></p> |
1251 | <p></p> |
1204 | <dt><strong><a name="item_imfont_3a_fontset"><strong>imFont:</strong> <em>fontset</em></a></strong><br /> |
1252 | <dt><strong><a name="item_imfont_3a_fontset"><strong>imFont:</strong> <em>fontset</em></a></strong><br /> |
1205 | </dt> |
1253 | </dt> |
1206 | <dd> |
1254 | <dd> |
… | |
… | |
1215 | <dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br /> |
1263 | <dt><strong><a name="item_tripleclickwords_3a_boolean"><strong>tripleclickwords:</strong> <em>boolean</em></a></strong><br /> |
1216 | </dt> |
1264 | </dt> |
1217 | <dd> |
1265 | <dd> |
1218 | Change the meaning of triple-click selection with the left mouse |
1266 | Change the meaning of triple-click selection with the left mouse |
1219 | button. Instead of selecting a full line it will extend the selection to |
1267 | button. Instead of selecting a full line it will extend the selection to |
1220 | the end of the logical line only. option <strong>-tcw</strong>. |
1268 | the end of the logical line only; option <strong>-tcw</strong>. |
1221 | </dd> |
1269 | </dd> |
1222 | <p></p> |
1270 | <p></p> |
1223 | <dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong><br /> |
1271 | <dt><strong><a name="item_insecure_3a_boolean"><strong>insecure:</strong> <em>boolean</em></a></strong><br /> |
1224 | </dt> |
1272 | </dt> |
1225 | <dd> |
1273 | <dd> |
… | |
… | |
1347 | <dd> |
1395 | <dd> |
1348 | <pre> |
1396 | <pre> |
1349 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> |
1397 | URxvt.keysym.M-C-c: command:\033]701;zh_CN.GBK\007</pre> |
1350 | </dd> |
1398 | </dd> |
1351 | <dd> |
1399 | <dd> |
|
|
1400 | <p>If <em>string</em> takes the form <code>perl:STRING</code>, then the specified <strong>STRING</strong> |
|
|
1401 | is passed to the <code>on_keyboard_command</code> perl handler. See the <code>rxvtperl(3)</code> |
|
|
1402 | manpage. For example, the <em>selection</em> extension (activated via |
|
|
1403 | <code>rxvt -pe selection</code>) listens for <code>selection:rot13</code> events:</p> |
|
|
1404 | </dd> |
|
|
1405 | <dd> |
|
|
1406 | <pre> |
|
|
1407 | URxvt.keysym.M-C-c: perl:selection:rot13</pre> |
|
|
1408 | </dd> |
|
|
1409 | <dd> |
1352 | <p>Due the the large number of modifier combinations, a defined key mapping |
1410 | <p>Due the the large number of modifier combinations, a defined key mapping |
1353 | will match if at <em>at least</em> the specified identifiers are being set, and |
1411 | will match if at <em>at least</em> the specified identifiers are being set, and |
1354 | no other key mappings with those and more bits are being defined. That |
1412 | no other key mappings with those and more bits are being defined. That |
1355 | means that defining a key map for <code>a</code> will automatically provide |
1413 | means that defining a key map for <code>a</code> will automatically provide |
1356 | definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined |
1414 | definitions for <code>Meta-a</code>, <code>Shift-a</code> and so on, unless some of those are defined |
… | |
… | |
1388 | </dd> |
1446 | </dd> |
1389 | <dd> |
1447 | <dd> |
1390 | <pre> |
1448 | <pre> |
1391 | URxvt.keysym.M-C-3: command:\033[8;25;80t |
1449 | URxvt.keysym.M-C-3: command:\033[8;25;80t |
1392 | URxvt.keysym.M-C-4: command:\033[8;48;110t</pre> |
1450 | URxvt.keysym.M-C-4: command:\033[8;48;110t</pre> |
|
|
1451 | </dd> |
|
|
1452 | <p></p> |
|
|
1453 | <dt><strong><a name="item_perl_2dext_2dcommon_3a_string"><strong>perl-ext-common</strong>: <em>string</em></a></strong><br /> |
|
|
1454 | </dt> |
|
|
1455 | <dt><strong><a name="item_perl_2dext_3a_string"><strong>perl-ext</strong>: <em>string</em></a></strong><br /> |
|
|
1456 | </dt> |
|
|
1457 | <dd> |
|
|
1458 | Comma-separated <code>list(s)</code> of perl extension scripts (default: <code>default</code>) to |
|
|
1459 | use in this terminal instance; option <strong>-pe</strong>. |
|
|
1460 | </dd> |
|
|
1461 | <dd> |
|
|
1462 | <p>Extension names can be prefixed with a <code>-</code> sign to prohibit using |
|
|
1463 | them. This can be useful to selectively disable some extensions loaded |
|
|
1464 | by default, or specified via the <code>perl-ext-common</code> resource. For |
|
|
1465 | example, <code>default,-selection</code> will use all the default extension except |
|
|
1466 | <code>selection</code>.</p> |
|
|
1467 | </dd> |
|
|
1468 | <dd> |
|
|
1469 | <p>Extension names can also be followed by an argument in angle brackets |
|
|
1470 | (e.g. <code>searchable-scrollback<M-s></code>, which binds the hotkey for |
|
|
1471 | searchable scorllback to Alt/Meta-s). Mentioning the same extension |
|
|
1472 | multiple times with different arguments will pass multiple arguments to |
|
|
1473 | the extension.</p> |
|
|
1474 | </dd> |
|
|
1475 | <dd> |
|
|
1476 | <p>Each extension is looked up in the library directories, loaded if |
|
|
1477 | necessary, and bound to the current terminal instance.</p> |
|
|
1478 | </dd> |
|
|
1479 | <dd> |
|
|
1480 | <p>If both of these resources are the empty string, then the perl |
|
|
1481 | interpreter will not be initialized. The idea behind two options is that |
|
|
1482 | <strong>perl-ext-common</strong> will be used for extensions that should be available to |
|
|
1483 | all instances, while <strong>perl-ext</strong> is used for specific instances.</p> |
|
|
1484 | </dd> |
|
|
1485 | <p></p> |
|
|
1486 | <dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong><br /> |
|
|
1487 | </dt> |
|
|
1488 | <dd> |
|
|
1489 | Perl code to be evaluated when all extensions have been registered. See |
|
|
1490 | the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource |
|
|
1491 | will be ignored when running setuid/setgid. |
|
|
1492 | </dd> |
|
|
1493 | <p></p> |
|
|
1494 | <dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong><br /> |
|
|
1495 | </dt> |
|
|
1496 | <dd> |
|
|
1497 | Colon-separated list of additional directories that hold extension |
|
|
1498 | scripts. When looking for extensions specified by the <code>perl</code> resource, |
|
|
1499 | rxvt will first look in these directories and then in |
|
|
1500 | <em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource |
|
|
1501 | will be ignored when running setuid/setgid. |
|
|
1502 | </dd> |
|
|
1503 | <dd> |
|
|
1504 | <p>See the <code>rxvtperl(3)</code> manpage.</p> |
|
|
1505 | </dd> |
|
|
1506 | <p></p> |
|
|
1507 | <dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong><br /> |
|
|
1508 | </dt> |
|
|
1509 | <dd> |
|
|
1510 | Sets the WM_TRANSIENT_FOR property to the given window iw. |
1393 | </dd> |
1511 | </dd> |
1394 | <p></p></dl> |
1512 | <p></p></dl> |
1395 | <p> |
1513 | <p> |
1396 | </p> |
1514 | </p> |
1397 | <hr /> |
1515 | <hr /> |