… | |
… | |
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.2</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. |
287 | </dd> |
288 | </dd> |
288 | <p></p> |
289 | <p></p> |
289 | <dt><strong><a name="item__2dis_7c_2bis"><strong>-is</strong>|<strong>+is</strong></a></strong><br /> |
290 | <dt><strong><a name="item__2dis_7c_2bis"><strong>-is</strong>|<strong>+is</strong></a></strong><br /> |
290 | </dt> |
291 | </dt> |
291 | <dd> |
292 | <dd> |
292 | Compile font-styles: Bold/Italic font styles imply high intensity |
293 | Compile <em>font-styles</em>: Bold/Italic font styles imply high intensity |
293 | foreground/background (default). See resource <strong>intensityStyles</strong> for |
294 | foreground/background (default). See resource <strong>intensityStyles</strong> for |
294 | details. |
295 | details. |
295 | </dd> |
296 | </dd> |
296 | <p></p> |
297 | <p></p> |
297 | <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 /> |
… | |
… | |
412 | </dt> |
413 | </dt> |
413 | <dd> |
414 | <dd> |
414 | 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. |
415 | 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 |
416 | 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>. |
417 | </dd> |
427 | </dd> |
418 | <p></p> |
428 | <p></p> |
419 | <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 /> |
420 | </dt> |
430 | </dt> |
421 | <dd> |
431 | <dd> |
… | |
… | |
590 | my $xid = $_[0]->window->get_xid; |
600 | my $xid = $_[0]->window->get_xid; |
591 | system "rxvt -embed $xid &"; |
601 | system "rxvt -embed $xid &"; |
592 | });</pre> |
602 | });</pre> |
593 | </dd> |
603 | </dd> |
594 | <p></p> |
604 | <p></p> |
595 | <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 /> |
596 | </dt> |
606 | </dt> |
597 | <dd> |
607 | <dd> |
598 | 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 |
599 | 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 |
600 | 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 |
… | |
… | |
602 | </dd> |
612 | </dd> |
603 | <dd> |
613 | <dd> |
604 | <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 |
605 | 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 |
606 | 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> |
607 | </dd> |
621 | </dd> |
608 | <dd> |
622 | <dd> |
609 | <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 |
610 | longer example is in <em>doc/pty-fd</em>):</p> |
624 | longer example is in <em>doc/pty-fd</em>):</p> |
611 | </dd> |
625 | </dd> |
… | |
… | |
629 | </dd> |
643 | </dd> |
630 | <p></p> |
644 | <p></p> |
631 | <dt><strong><a name="item__2dpe_string"><strong>-pe</strong> <em>string</em></a></strong><br /> |
645 | <dt><strong><a name="item__2dpe_string"><strong>-pe</strong> <em>string</em></a></strong><br /> |
632 | </dt> |
646 | </dt> |
633 | <dd> |
647 | <dd> |
634 | Colon-separated list of perl extension scripts to use in this terminal instance. See resource <strong>perl-ext</strong>. |
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. |
635 | </dd> |
650 | </dd> |
636 | <p></p></dl> |
651 | <p></p></dl> |
637 | <p> |
652 | <p> |
638 | </p> |
653 | </p> |
639 | <hr /> |
654 | <hr /> |
… | |
… | |
1106 | <dd> |
1121 | <dd> |
1107 | 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 |
1108 | 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>. |
1109 | </dd> |
1124 | </dd> |
1110 | <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> |
1111 | <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 /> |
1112 | </dt> |
1136 | </dt> |
1113 | <dd> |
1137 | <dd> |
1114 | 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 |
1115 | variable; option <strong>-tn</strong>. |
1139 | variable; option <strong>-tn</strong>. |
… | |
… | |
1424 | <pre> |
1448 | <pre> |
1425 | URxvt.keysym.M-C-3: command:\033[8;25;80t |
1449 | URxvt.keysym.M-C-3: command:\033[8;25;80t |
1426 | URxvt.keysym.M-C-4: command:\033[8;48;110t</pre> |
1450 | URxvt.keysym.M-C-4: command:\033[8;48;110t</pre> |
1427 | </dd> |
1451 | </dd> |
1428 | <p></p> |
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> |
1429 | <dt><strong><a name="item_perl_2dext_3a_string"><strong>perl-ext</strong>: <em>string</em></a></strong><br /> |
1455 | <dt><strong><a name="item_perl_2dext_3a_string"><strong>perl-ext</strong>: <em>string</em></a></strong><br /> |
1430 | </dt> |
1456 | </dt> |
1431 | <dd> |
1457 | <dd> |
1432 | Colon-separated list of perl extension scripts to use in this terminal |
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> |
1433 | instance. Each extension is looked up in the library directories, loaded |
1476 | <p>Each extension is looked up in the library directories, loaded if |
1434 | if necessary, and bound to the current terminal instance; option <strong>-pe</strong>. |
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> |
1435 | </dd> |
1484 | </dd> |
1436 | <p></p> |
1485 | <p></p> |
1437 | <dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong><br /> |
1486 | <dt><strong><a name="item_perl_2deval_3a_string"><strong>perl-eval</strong>: <em>string</em></a></strong><br /> |
1438 | </dt> |
1487 | </dt> |
1439 | <dd> |
1488 | <dd> |
1440 | Perl code to be evaluated when all extensions have been registered. See the |
1489 | Perl code to be evaluated when all extensions have been registered. See |
1441 | <code>rxvtperl(3)</code> manpage. |
1490 | the <code>rxvtperl(3)</code> manpage. Due to security reasons, this resource |
|
|
1491 | will be ignored when running setuid/setgid. |
1442 | </dd> |
1492 | </dd> |
1443 | <p></p> |
1493 | <p></p> |
1444 | <dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong><br /> |
1494 | <dt><strong><a name="item_perl_2dlib_3a_path"><strong>perl-lib</strong>: <em>path</em></a></strong><br /> |
1445 | </dt> |
1495 | </dt> |
1446 | <dd> |
1496 | <dd> |
1447 | Colon-separated list of additional directories that hold extension |
1497 | Colon-separated list of additional directories that hold extension |
1448 | scripts. When looking for extensions specified by the <code>perl</code> resource, |
1498 | scripts. When looking for extensions specified by the <code>perl</code> resource, |
1449 | rxvt will first look in these directories and then in |
1499 | rxvt will first look in these directories and then in |
1450 | <em>/opt/rxvt/lib/urxvt/perl/</em>. |
1500 | <em>/opt/rxvt/lib/urxvt/perl/</em>. Due to security reasons, this resource |
|
|
1501 | will be ignored when running setuid/setgid. |
1451 | </dd> |
1502 | </dd> |
1452 | <dd> |
1503 | <dd> |
1453 | <p>See the <code>rxvtperl(3)</code> manpage.</p> |
1504 | <p>See the <code>rxvtperl(3)</code> manpage.</p> |
|
|
1505 | </dd> |
|
|
1506 | <p></p> |
|
|
1507 | <dt><strong><a name="item_urllauncher_3a_string"><strong>urlLauncher</strong>: <em>string</em></a></strong><br /> |
|
|
1508 | </dt> |
|
|
1509 | <dd> |
|
|
1510 | Specifies the program to be started with a URL argument. Used by the |
|
|
1511 | <code>selection-popup</code> and <code>mark-urls</code> perl extensions. |
|
|
1512 | </dd> |
|
|
1513 | <p></p> |
|
|
1514 | <dt><strong><a name="item_transient_2dfor_3a_windowid"><strong>transient-for</strong>: <em>windowid</em></a></strong><br /> |
|
|
1515 | </dt> |
|
|
1516 | <dd> |
|
|
1517 | Sets the WM_TRANSIENT_FOR property to the given window iw. |
1454 | </dd> |
1518 | </dd> |
1455 | <p></p></dl> |
1519 | <p></p></dl> |
1456 | <p> |
1520 | <p> |
1457 | </p> |
1521 | </p> |
1458 | <hr /> |
1522 | <hr /> |