… | |
… | |
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 | |
… | |
… | |
532 | close $pty; |
532 | close $pty; |
533 | |
533 | |
534 | # now communicate with rxvt |
534 | # now communicate with rxvt |
535 | my $slave = $pty->slave; |
535 | my $slave = $pty->slave; |
536 | 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"; |
537 | |
554 | |
538 | =item B<-pe> I<string> |
555 | =item B<-pe> I<string> |
539 | |
556 | |
540 | 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 |
541 | this terminal instance. See resource B<perl-ext> for details. |
558 | this terminal instance. See resource B<perl-ext> for details. |
… | |
… | |
569 | be used. Command-line arguments can be used to override resource |
586 | be used. Command-line arguments can be used to override resource |
570 | settings. The following resources are supported (you might want to |
587 | settings. The following resources are supported (you might want to |
571 | 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 |
572 | extensions not documented here): |
589 | extensions not documented here): |
573 | |
590 | |
574 | =over 4 |
591 | =over |
575 | |
592 | |
576 | =item B<depth:> I<bitdepth> |
593 | =item B<depth:> I<bitdepth> |
577 | |
594 | |
578 | 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; |
579 | option B<-depth>. |
596 | option B<-depth>. |
… | |
… | |
1157 | prefixed with C<string:>). |
1174 | prefixed with C<string:>). |
1158 | |
1175 | |
1159 | The following action prefixes are known - extensions can provide |
1176 | The following action prefixes are known - extensions can provide |
1160 | additional prefixes: |
1177 | additional prefixes: |
1161 | |
1178 | |
1162 | =over 4 |
1179 | =over |
1163 | |
1180 | |
1164 | =item string:STRING |
1181 | =item string:STRING |
1165 | |
1182 | |
1166 | 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), |
1167 | 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 |
… | |
… | |
1287 | =item B<perl-ext>: I<string> |
1304 | =item B<perl-ext>: I<string> |
1288 | |
1305 | |
1289 | 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 |
1290 | use in this terminal instance; option B<-pe>. |
1307 | use in this terminal instance; option B<-pe>. |
1291 | |
1308 | |
1292 | 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 |
1293 | them. This can be useful to selectively disable some extensions loaded |
1310 | case they had been specified earlier. This can be useful to selectively |
1294 | by default, or specified via the C<perl-ext-common> resource. For |
1311 | disable some extensions loaded by default, or specified via the |
1295 | example, C<default,-selection> will use all the default extensions except |
1312 | C<perl-ext-common> resource. For example, C<default,-selection> will use |
1296 | 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. |
1297 | |
1322 | |
1298 | The default set includes the C<selection>, C<option-popup>, |
1323 | The default set includes the C<selection>, C<option-popup>, |
1299 | C<selection-popup>, C<readline> and C<searchable-scrollback> |
1324 | C<selection-popup>, C<readline>, C<searchable-scrollback> and |
1300 | 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. |
1301 | |
1327 | |
1302 | Any extension such that a corresponding resource is given on the |
1328 | Any extension such that a corresponding resource is given on the |
1303 | command line is automatically appended to B<perl-ext>. |
1329 | command line is automatically appended to B<perl-ext>. |
1304 | |
1330 | |
1305 | Each extension is looked up in the library directories, loaded if |
1331 | Each extension is looked up in the library directories, loaded if |
… | |
… | |
1395 | =head1 THE SELECTION: SELECTING AND PASTING TEXT |
1421 | =head1 THE SELECTION: SELECTING AND PASTING TEXT |
1396 | |
1422 | |
1397 | The behaviour of text selection and insertion/pasting mechanism is similar |
1423 | The behaviour of text selection and insertion/pasting mechanism is similar |
1398 | to I<xterm>(1). |
1424 | to I<xterm>(1). |
1399 | |
1425 | |
1400 | =over 4 |
1426 | =over |
1401 | |
1427 | |
1402 | =item B<Selecting>: |
1428 | =item B<Selecting>: |
1403 | |
1429 | |
1404 | 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 |
1405 | 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 |
… | |
… | |
1452 | 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 |
1453 | first part is available if rxvt-unicode has been compiled with |
1479 | first part is available if rxvt-unicode has been compiled with |
1454 | 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 |
1455 | with C<--enable-iso14755>. |
1481 | with C<--enable-iso14755>. |
1456 | |
1482 | |
1457 | =over 4 |
1483 | =over |
1458 | |
1484 | |
1459 | =item * 5.1: Basic method |
1485 | =item * 5.1: Basic method |
1460 | |
1486 | |
1461 | This allows you to enter unicode characters using their hexcode. |
1487 | This allows you to enter unicode characters using their hexcode. |
1462 | |
1488 | |
… | |
… | |
1642 | |
1668 | |
1643 | =head1 ENVIRONMENT |
1669 | =head1 ENVIRONMENT |
1644 | |
1670 | |
1645 | B<@@RXVT_NAME@@> sets and/or uses the following environment variables: |
1671 | B<@@RXVT_NAME@@> sets and/or uses the following environment variables: |
1646 | |
1672 | |
1647 | =over 4 |
1673 | =over |
1648 | |
1674 | |
1649 | =item B<TERM> |
1675 | =item B<TERM> |
1650 | |
1676 | |
1651 | 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 |
1652 | resources or on the command line. |
1678 | resources or on the command line. |
… | |
… | |
1723 | |
1749 | |
1724 | =back |
1750 | =back |
1725 | |
1751 | |
1726 | =head1 FILES |
1752 | =head1 FILES |
1727 | |
1753 | |
1728 | =over 4 |
1754 | =over |
1729 | |
1755 | |
1730 | =item B</usr/lib/X11/rgb.txt> |
1756 | =item B</usr/lib/X11/rgb.txt> |
1731 | |
1757 | |
1732 | Colour names. |
1758 | Colour names. |
1733 | |
1759 | |
… | |
… | |
1738 | @@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), |
1739 | @@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) |
1740 | |
1766 | |
1741 | =head1 CURRENT PROJECT COORDINATOR |
1767 | =head1 CURRENT PROJECT COORDINATOR |
1742 | |
1768 | |
1743 | =over 4 |
1769 | =over |
1744 | |
1770 | |
1745 | =item Project Coordinator |
1771 | =item Project Coordinator |
1746 | |
1772 | |
1747 | Marc A. Lehmann <rxvt-unicode@schmorp.de>. |
1773 | Marc A. Lehmann <rxvt-unicode@schmorp.de>. |
1748 | |
1774 | |
… | |
… | |
1750 | |
1776 | |
1751 | =back |
1777 | =back |
1752 | |
1778 | |
1753 | =head1 AUTHORS |
1779 | =head1 AUTHORS |
1754 | |
1780 | |
1755 | =over 4 |
1781 | =over |
1756 | |
1782 | |
1757 | =item John Bovey |
1783 | =item John Bovey |
1758 | |
1784 | |
1759 | University of Kent, 1992, wrote the original Xvt. |
1785 | University of Kent, 1992, wrote the original Xvt. |
1760 | |
1786 | |