ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.1.pod
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.252 by sf-exg, Sat Jul 3 15:32:32 2021 UTC vs.
Revision 1.259 by sf-exg, Sun Dec 19 20:48:21 2021 UTC

… …
84far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1 84far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1
85Orange'. 85Orange'.
86 86
87The following options are available: 87The 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
93Print out a message describing available options. 93Print out a message describing available options.
94 94
… …
408in-use. Instead of selecting a full line it will extend the selection to 408in-use. Instead of selecting a full line it will extend the selection to
409the end of the logical line only. resource B<tripleclickwords>. 409the end of the logical line only. resource B<tripleclickwords>.
410 410
411=item B<-dpb>|B<+dpb> 411=item B<-dpb>|B<+dpb>
412 412
413Compile frills: Disables (or enables) emitting bracketed paste mode 413Compile frills: Disable (or enable) emitting bracketed paste mode
414sequences (default enabled). Bracketed paste mode allows programs 414sequences (default enabled). Bracketed paste mode allows programs
415to detect when something is pasted. Since more and more programs 415to detect when something is pasted. Since more and more programs
416abuse this, these sequences can be disabled. The command sequences to 416abuse this, these sequences can be disabled. The command sequences to
417enable and query paste mode will still work, but the actual bracket 417enable and query paste mode will still work, but the actual bracket
418sequences will no longer be emitted. You can also toggle this from the 418sequences will no longer be emitted. You can also toggle this from the
… …
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
538Note that, despite what the name might imply, the file descriptor does not
539need to be a pty, it can be a bi-directional pipe as well (e.g. a unix
540domain or tcp socket). While tty operations cannot be done in this case,
541B<@@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 "Not so secret anymore: $secret\n";
537 554
538=item B<-pe> I<string> 555=item B<-pe> I<string>
539 556
540Comma-separated list of perl extension scripts to use (or not to use) in 557Comma-separated list of perl extension scripts to use (or not to use) in
541this terminal instance. See resource B<perl-ext> for details. 558this terminal instance. See resource B<perl-ext> for details.
… …
569be used. Command-line arguments can be used to override resource 586be used. Command-line arguments can be used to override resource
570settings. The following resources are supported (you might want to 587settings. The following resources are supported (you might want to
571check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl 588check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
572extensions not documented here): 589extensions 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
578Compile I<xft>: Attempt to find a visual with the given bit depth; 595Compile I<xft>: Attempt to find a visual with the given bit depth;
579option B<-depth>. 596option B<-depth>.
… …
1033button. Instead of selecting a full line it will extend the selection to 1050button. Instead of selecting a full line it will extend the selection to
1034the end of the logical line only; option B<-tcw>. 1051the end of the logical line only; option B<-tcw>.
1035 1052
1036=item B<disablePasteBrackets:> I<boolean> 1053=item B<disablePasteBrackets:> I<boolean>
1037 1054
1038Prevents emission of paste bracket sequences; option B<-dpb>. 1055Prevent emission of paste bracket sequences; option B<-dpb>.
1039 1056
1040=item B<insecure:> I<boolean> 1057=item B<insecure:> I<boolean>
1041 1058
1042Enables "insecure" mode. Rxvt-unicode offers some escape sequences that 1059Enable "insecure" mode. Rxvt-unicode offers some escape sequences that
1043echo arbitrary strings like the icon name or the locale. This could be 1060echo arbitrary strings like the icon name or the locale. This could be
1044abused if somebody gets 8-bit-clean access to your display, whether 1061abused if somebody gets 8-bit-clean access to your display, whether
1045through a mail client displaying mail bodies unfiltered or through 1062through a mail client displaying mail bodies unfiltered or through
1046write(1) or any other means. Therefore, these sequences are disabled by 1063write(1) or any other means. Therefore, these sequences are disabled by
1047default. (Note that many other terminals, including xterm, have these 1064default. (Note that many other terminals, including xterm, have these
… …
1157prefixed with C<string:>). 1174prefixed with C<string:>).
1158 1175
1159The following action prefixes are known - extensions can provide 1176The following action prefixes are known - extensions can provide
1160additional prefixes: 1177additional prefixes:
1161 1178
1162=over 4 1179=over
1163 1180
1164=item string:STRING 1181=item string:STRING
1165 1182
1166If the I<action> starts with C<string:> (or otherwise contains no colons), 1183If the I<action> starts with C<string:> (or otherwise contains no colons),
1167then the remaining C<STRING> will be passed to the program running in the 1184then 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
1289Comma-separated list(s) of perl extension scripts (default: C<default>) to 1306Comma-separated list(s) of perl extension scripts (default: C<default>) to
1290use in this terminal instance; option B<-pe>. 1307use in this terminal instance; option B<-pe>.
1291 1308
1292Extension names can be prefixed with a C<-> sign to prohibit using 1309Extension names can be prefixed with a C<-> sign to remove them again, in
1293them. This can be useful to selectively disable some extensions loaded 1310case they had been specified earlier. This can be useful to selectively
1294by default, or specified via the C<perl-ext-common> resource. For 1311disable some extensions loaded by default, or specified via the
1295example, C<default,-selection> will use all the default extensions except 1312C<perl-ext-common> resource. For example, C<default,-selection> will use
1296C<selection>. 1313all the default extensions except C<selection>.
1314
1315To prohibit autoloading of extensions, you can prefix them with C</>,
1316which will make urxvt refuse to automatically load them (this can be
1317overridden, however, by specifying the extension name again without a
1318prefix, though). This does not prohibit extensions themselves loading
1319other extensions. For example, C<default,/background> will keep the
1320C<background> extension from being loaded when a background OSC sequence
1321is received.
1297 1322
1298The default set includes the C<selection>, C<option-popup>, 1323The default set includes the C<selection>, C<option-popup>,
1299C<selection-popup>, C<readline> and C<searchable-scrollback> 1324C<selection-popup>, C<readline>, C<searchable-scrollback> and
1300extensions, and extensions which are mentioned in B<keysym> resources. 1325C<confirm-paste> extensions, as well as any extensions which are mentioned
1326in B<keysym> resources.
1301 1327
1302Any extension such that a corresponding resource is given on the 1328Any extension such that a corresponding resource is given on the
1303command line is automatically appended to B<perl-ext>. 1329command line is automatically appended to B<perl-ext>.
1304 1330
1305Each extension is looked up in the library directories, loaded if 1331Each 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
1397The behaviour of text selection and insertion/pasting mechanism is similar 1423The behaviour of text selection and insertion/pasting mechanism is similar
1398to I<xterm>(1). 1424to I<xterm>(1).
1399 1425
1400=over 4 1426=over
1401 1427
1402=item B<Selecting>: 1428=item B<Selecting>:
1403 1429
1404Left click at the beginning of the region, drag to the end of the region 1430Left click at the beginning of the region, drag to the end of the region
1405and release; Right click to extend the marked region; Left double-click 1431and release; Right click to extend the marked region; Left double-click
… …
1452and character codes using the keyboard. It consists of 4 parts. The 1478and character codes using the keyboard. It consists of 4 parts. The
1453first part is available if rxvt-unicode has been compiled with 1479first part is available if rxvt-unicode has been compiled with
1454C<--enable-frills>, the rest is available when rxvt-unicode was compiled 1480C<--enable-frills>, the rest is available when rxvt-unicode was compiled
1455with C<--enable-iso14755>. 1481with 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
1461This allows you to enter unicode characters using their hexcode. 1487This allows you to enter unicode characters using their hexcode.
1462 1488
… …
1642 1668
1643=head1 ENVIRONMENT 1669=head1 ENVIRONMENT
1644 1670
1645B<@@RXVT_NAME@@> sets and/or uses the following environment variables: 1671B<@@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
1651Normally set to C<rxvt-unicode>, unless overwritten at configure time, via 1677Normally set to C<rxvt-unicode>, unless overwritten at configure time, via
1652resources or on the command line. 1678resources 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
1732Colour names. 1758Colour 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
1747Marc A. Lehmann <rxvt-unicode@schmorp.de>. 1773Marc 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
1759University of Kent, 1992, wrote the original Xvt. 1785University of Kent, 1992, wrote the original Xvt.
1760 1786

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines