… | |
… | |
84 | far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1 |
84 | far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1 |
85 | Orange'. |
85 | Orange'. |
86 | |
86 | |
87 | The following options are available: |
87 | The following options are available: |
88 | |
88 | |
89 | =over 4 |
89 | =over |
90 | |
90 | |
91 | =item B<-help>, B<--help> |
91 | =item B<-help>, B<--help> |
92 | |
92 | |
93 | Print out a message describing available options. |
93 | Print out a message describing available options. |
94 | |
94 | |
… | |
… | |
406 | Change the meaning of triple-click selection with the left mouse |
406 | Change the meaning of triple-click selection with the left mouse |
407 | button. Only effective when the original (non-perl) selection code is |
407 | button. Only effective when the original (non-perl) selection code is |
408 | in-use. Instead of selecting a full line it will extend the selection to |
408 | in-use. Instead of selecting a full line it will extend the selection to |
409 | the end of the logical line only. resource B<tripleclickwords>. |
409 | the end of the logical line only. resource B<tripleclickwords>. |
410 | |
410 | |
|
|
411 | =item B<-dpb>|B<+dpb> |
|
|
412 | |
|
|
413 | Compile frills: Disable (or enable) emitting bracketed paste mode |
|
|
414 | sequences (default enabled). Bracketed paste mode allows programs |
|
|
415 | to detect when something is pasted. Since more and more programs |
|
|
416 | abuse this, these sequences can be disabled. The command sequences to |
|
|
417 | enable and query paste mode will still work, but the actual bracket |
|
|
418 | sequences will no longer be emitted. You can also toggle this from the |
|
|
419 | ctrl-middle-mouse-button menu; resource B<disablePasteBrackets>. |
|
|
420 | |
411 | =item B<-insecure> |
421 | =item B<-insecure> |
412 | |
422 | |
413 | Enable "insecure" mode, which currently enables most of the escape |
423 | Enable "insecure" mode, which currently enables most of the escape |
414 | sequences that echo strings. See the resource B<insecure> for more |
424 | sequences that echo strings. See the resource B<insecure> for more |
415 | info. |
425 | info. |
… | |
… | |
427 | |
437 | |
428 | =item B<-ssr>|B<+ssr> |
438 | =item B<-ssr>|B<+ssr> |
429 | |
439 | |
430 | Turn on/off secondary screen scroll (default enabled); resource |
440 | Turn on/off secondary screen scroll (default enabled); resource |
431 | B<secondaryScroll>. |
441 | B<secondaryScroll>. |
|
|
442 | |
|
|
443 | =item B<-rm> I<mode> |
|
|
444 | |
|
|
445 | Compile I<frills>: Sets long line rewrapping behaviour on window resizes |
|
|
446 | to one of B<auto> (the default), B<always> or B<never>. The latter two |
|
|
447 | modes do the obvious, B<auto> rewraps (acts like B<always>) if scrollback |
|
|
448 | is non-empty, and wings lines (acts like B<never>) otherwise; resource |
|
|
449 | B<rewrapMode>. |
432 | |
450 | |
433 | =item B<-hold>|B<+hold> |
451 | =item B<-hold>|B<+hold> |
434 | |
452 | |
435 | Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ |
453 | Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ |
436 | will not immediately destroy its window when the program executed within |
454 | will not immediately destroy its window when the program executed within |
… | |
… | |
514 | close $pty; |
532 | close $pty; |
515 | |
533 | |
516 | # now communicate with rxvt |
534 | # now communicate with rxvt |
517 | my $slave = $pty->slave; |
535 | my $slave = $pty->slave; |
518 | while (<$slave>) { print $slave "got <$_>\n" } |
536 | while (<$slave>) { print $slave "got <$_>\n" } |
|
|
537 | |
|
|
538 | Note that, despite what the name might imply, the file descriptor does not |
|
|
539 | need to be a pty, it can be a bi-directional pipe as well (e.g. a unix |
|
|
540 | domain or tcp socket). While tty operations cannot be done in this case, |
|
|
541 | B<@@RXVT_NAME@@> can still be remote controlled with it: |
|
|
542 | |
|
|
543 | use Socket; |
|
|
544 | use Fcntl; |
|
|
545 | |
|
|
546 | socketpair my $URXVT, my $slave, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC; |
|
|
547 | fcntl $slave, Fcntl::F_SETFD, 0; |
|
|
548 | system "exec @@RXVT_NAME|| -pty-fd " . (fileno $slave) . " &"; |
|
|
549 | close $slave; |
|
|
550 | |
|
|
551 | syswrite $URXVT, "Type a secret password: "; |
|
|
552 | my $secret = do { local $/ = "\r"; <$URXVT> }; |
|
|
553 | print "No so secret anymore: $secret\n"; |
519 | |
554 | |
520 | =item B<-pe> I<string> |
555 | =item B<-pe> I<string> |
521 | |
556 | |
522 | Comma-separated list of perl extension scripts to use (or not to use) in |
557 | Comma-separated list of perl extension scripts to use (or not to use) in |
523 | this terminal instance. See resource B<perl-ext> for details. |
558 | this terminal instance. See resource B<perl-ext> for details. |
… | |
… | |
551 | be used. Command-line arguments can be used to override resource |
586 | be used. Command-line arguments can be used to override resource |
552 | settings. The following resources are supported (you might want to |
587 | settings. The following resources are supported (you might want to |
553 | check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl |
588 | check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl |
554 | extensions not documented here): |
589 | extensions not documented here): |
555 | |
590 | |
556 | =over 4 |
591 | =over |
557 | |
592 | |
558 | =item B<depth:> I<bitdepth> |
593 | =item B<depth:> I<bitdepth> |
559 | |
594 | |
560 | Compile I<xft>: Attempt to find a visual with the given bit depth; |
595 | Compile I<xft>: Attempt to find a visual with the given bit depth; |
561 | option B<-depth>. |
596 | option B<-depth>. |
… | |
… | |
1013 | |
1048 | |
1014 | Change the meaning of triple-click selection with the left mouse |
1049 | Change the meaning of triple-click selection with the left mouse |
1015 | button. Instead of selecting a full line it will extend the selection to |
1050 | button. Instead of selecting a full line it will extend the selection to |
1016 | the end of the logical line only; option B<-tcw>. |
1051 | the end of the logical line only; option B<-tcw>. |
1017 | |
1052 | |
|
|
1053 | =item B<disablePasteBrackets:> I<boolean> |
|
|
1054 | |
|
|
1055 | Prevent emission of paste bracket sequences; option B<-dpb>. |
|
|
1056 | |
1018 | =item B<insecure:> I<boolean> |
1057 | =item B<insecure:> I<boolean> |
1019 | |
1058 | |
1020 | Enables "insecure" mode. Rxvt-unicode offers some escape sequences that |
1059 | Enable "insecure" mode. Rxvt-unicode offers some escape sequences that |
1021 | echo arbitrary strings like the icon name or the locale. This could be |
1060 | echo arbitrary strings like the icon name or the locale. This could be |
1022 | abused if somebody gets 8-bit-clean access to your display, whether |
1061 | abused if somebody gets 8-bit-clean access to your display, whether |
1023 | through a mail client displaying mail bodies unfiltered or through |
1062 | through a mail client displaying mail bodies unfiltered or through |
1024 | write(1) or any other means. Therefore, these sequences are disabled by |
1063 | write(1) or any other means. Therefore, these sequences are disabled by |
1025 | default. (Note that many other terminals, including xterm, have these |
1064 | default. (Note that many other terminals, including xterm, have these |
… | |
… | |
1042 | in the entry on B<keysym> following. |
1081 | in the entry on B<keysym> following. |
1043 | |
1082 | |
1044 | =item B<secondaryScreen:> I<boolean> |
1083 | =item B<secondaryScreen:> I<boolean> |
1045 | |
1084 | |
1046 | Turn on/off secondary screen (default enabled). |
1085 | Turn on/off secondary screen (default enabled). |
|
|
1086 | |
|
|
1087 | =item B<rewrapMode:> I<mode> |
|
|
1088 | |
|
|
1089 | Sets long line rewrap behaviour on window resize to one of B<auto> |
|
|
1090 | (default), B<always> or B<never>. |
1047 | |
1091 | |
1048 | =item B<secondaryScroll:> I<boolean> |
1092 | =item B<secondaryScroll:> I<boolean> |
1049 | |
1093 | |
1050 | Turn on/off secondary screen scroll (default enabled). If this |
1094 | Turn on/off secondary screen scroll (default enabled). If this |
1051 | option is enabled, scrolls on the secondary screen will change the |
1095 | option is enabled, scrolls on the secondary screen will change the |
… | |
… | |
1130 | prefixed with C<string:>). |
1174 | prefixed with C<string:>). |
1131 | |
1175 | |
1132 | The following action prefixes are known - extensions can provide |
1176 | The following action prefixes are known - extensions can provide |
1133 | additional prefixes: |
1177 | additional prefixes: |
1134 | |
1178 | |
1135 | =over 4 |
1179 | =over |
1136 | |
1180 | |
1137 | =item string:STRING |
1181 | =item string:STRING |
1138 | |
1182 | |
1139 | If the I<action> starts with C<string:> (or otherwise contains no colons), |
1183 | If the I<action> starts with C<string:> (or otherwise contains no colons), |
1140 | then the remaining C<STRING> will be passed to the program running in the |
1184 | then the remaining C<STRING> will be passed to the program running in the |
… | |
… | |
1260 | =item B<perl-ext>: I<string> |
1304 | =item B<perl-ext>: I<string> |
1261 | |
1305 | |
1262 | Comma-separated list(s) of perl extension scripts (default: C<default>) to |
1306 | Comma-separated list(s) of perl extension scripts (default: C<default>) to |
1263 | use in this terminal instance; option B<-pe>. |
1307 | use in this terminal instance; option B<-pe>. |
1264 | |
1308 | |
1265 | Extension names can be prefixed with a C<-> sign to prohibit using |
1309 | Extension names can be prefixed with a C<-> sign to remove them again, in |
1266 | them. This can be useful to selectively disable some extensions loaded |
1310 | case they had been specified earlier. This can be useful to selectively |
1267 | by default, or specified via the C<perl-ext-common> resource. For |
1311 | disable some extensions loaded by default, or specified via the |
1268 | example, C<default,-selection> will use all the default extensions except |
1312 | C<perl-ext-common> resource. For example, C<default,-selection> will use |
1269 | C<selection>. |
1313 | all the default extensions except C<selection>. |
|
|
1314 | |
|
|
1315 | To prohibit autoloading of extensions, you can prefix them with C</>, |
|
|
1316 | which will make urxvt refuse to automatically load them (this can be |
|
|
1317 | overriden, however, by specifying the extension name again without a |
|
|
1318 | prefix, though). This does not prohibit extensions themselves loading |
|
|
1319 | other extensions. For example, C<default,/background> will keep the |
|
|
1320 | C<background> extension from being loaded when a background OSC sequence |
|
|
1321 | is received. |
1270 | |
1322 | |
1271 | The default set includes the C<selection>, C<option-popup>, |
1323 | The default set includes the C<selection>, C<option-popup>, |
1272 | C<selection-popup>, C<readline> and C<searchable-scrollback> |
1324 | C<selection-popup>, C<readline>, C<searchable-scrollback> and |
1273 | extensions, and extensions which are mentioned in B<keysym> resources. |
1325 | C<confirm-paste> extensions, as well as any extensions which are mentioned |
|
|
1326 | in B<keysym> resources. |
1274 | |
1327 | |
1275 | Any extension such that a corresponding resource is given on the |
1328 | Any extension such that a corresponding resource is given on the |
1276 | command line is automatically appended to B<perl-ext>. |
1329 | command line is automatically appended to B<perl-ext>. |
1277 | |
1330 | |
1278 | Each extension is looked up in the library directories, loaded if |
1331 | Each extension is looked up in the library directories, loaded if |
… | |
… | |
1368 | =head1 THE SELECTION: SELECTING AND PASTING TEXT |
1421 | =head1 THE SELECTION: SELECTING AND PASTING TEXT |
1369 | |
1422 | |
1370 | The behaviour of text selection and insertion/pasting mechanism is similar |
1423 | The behaviour of text selection and insertion/pasting mechanism is similar |
1371 | to I<xterm>(1). |
1424 | to I<xterm>(1). |
1372 | |
1425 | |
1373 | =over 4 |
1426 | =over |
1374 | |
1427 | |
1375 | =item B<Selecting>: |
1428 | =item B<Selecting>: |
1376 | |
1429 | |
1377 | Left click at the beginning of the region, drag to the end of the region |
1430 | Left click at the beginning of the region, drag to the end of the region |
1378 | and release; Right click to extend the marked region; Left double-click |
1431 | and release; Right click to extend the marked region; Left double-click |
… | |
… | |
1425 | and character codes using the keyboard. It consists of 4 parts. The |
1478 | and character codes using the keyboard. It consists of 4 parts. The |
1426 | first part is available if rxvt-unicode has been compiled with |
1479 | first part is available if rxvt-unicode has been compiled with |
1427 | C<--enable-frills>, the rest is available when rxvt-unicode was compiled |
1480 | C<--enable-frills>, the rest is available when rxvt-unicode was compiled |
1428 | with C<--enable-iso14755>. |
1481 | with C<--enable-iso14755>. |
1429 | |
1482 | |
1430 | =over 4 |
1483 | =over |
1431 | |
1484 | |
1432 | =item * 5.1: Basic method |
1485 | =item * 5.1: Basic method |
1433 | |
1486 | |
1434 | This allows you to enter unicode characters using their hexcode. |
1487 | This allows you to enter unicode characters using their hexcode. |
1435 | |
1488 | |
… | |
… | |
1615 | |
1668 | |
1616 | =head1 ENVIRONMENT |
1669 | =head1 ENVIRONMENT |
1617 | |
1670 | |
1618 | B<@@RXVT_NAME@@> sets and/or uses the following environment variables: |
1671 | B<@@RXVT_NAME@@> sets and/or uses the following environment variables: |
1619 | |
1672 | |
1620 | =over 4 |
1673 | =over |
1621 | |
1674 | |
1622 | =item B<TERM> |
1675 | =item B<TERM> |
1623 | |
1676 | |
1624 | Normally set to C<rxvt-unicode>, unless overwritten at configure time, via |
1677 | Normally set to C<rxvt-unicode>, unless overwritten at configure time, via |
1625 | resources or on the command line. |
1678 | resources or on the command line. |
… | |
… | |
1696 | |
1749 | |
1697 | =back |
1750 | =back |
1698 | |
1751 | |
1699 | =head1 FILES |
1752 | =head1 FILES |
1700 | |
1753 | |
1701 | =over 4 |
1754 | =over |
1702 | |
1755 | |
1703 | =item B</usr/lib/X11/rgb.txt> |
1756 | =item B</usr/lib/X11/rgb.txt> |
1704 | |
1757 | |
1705 | Colour names. |
1758 | Colour names. |
1706 | |
1759 | |
… | |
… | |
1711 | @@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@-extensions(1), |
1764 | @@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@-extensions(1), |
1712 | @@RXVT_NAME@@perl(3), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) |
1765 | @@RXVT_NAME@@perl(3), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5) |
1713 | |
1766 | |
1714 | =head1 CURRENT PROJECT COORDINATOR |
1767 | =head1 CURRENT PROJECT COORDINATOR |
1715 | |
1768 | |
1716 | =over 4 |
1769 | =over |
1717 | |
1770 | |
1718 | =item Project Coordinator |
1771 | =item Project Coordinator |
1719 | |
1772 | |
1720 | Marc A. Lehmann <rxvt-unicode@schmorp.de>. |
1773 | Marc A. Lehmann <rxvt-unicode@schmorp.de>. |
1721 | |
1774 | |
… | |
… | |
1723 | |
1776 | |
1724 | =back |
1777 | =back |
1725 | |
1778 | |
1726 | =head1 AUTHORS |
1779 | =head1 AUTHORS |
1727 | |
1780 | |
1728 | =over 4 |
1781 | =over |
1729 | |
1782 | |
1730 | =item John Bovey |
1783 | =item John Bovey |
1731 | |
1784 | |
1732 | University of Kent, 1992, wrote the original Xvt. |
1785 | University of Kent, 1992, wrote the original Xvt. |
1733 | |
1786 | |