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.254 by root, Sat Jul 24 09:48:43 2021 UTC vs.
Revision 1.263 by sf-exg, Sat Jan 20 08:00:50 2024 UTC

128 128
129=item B<-ss>|B<+ss> 129=item B<-ss>|B<+ss>
130 130
131Turn on/off skip scrolling (allow multiple screens per refresh); resource B<skipScroll>. 131Turn on/off skip scrolling (allow multiple screens per refresh); resource B<skipScroll>.
132 132
133=item B<-fps> I<number>
134
135Compile I<frills>: Set the refresh interval (in frames per second or
136negative seconds); resource B<refreshRate>.
137
133=item B<-fade> I<number> 138=item B<-fade> I<number>
134 139
135Fade the text by the given percentage when focus is lost. Small values 140Fade the text by the given percentage when focus is lost. Small values
136fade a little only, 100 completely replaces all colours by the fade 141fade a little only, 100 completely replaces all colours by the fade
137colour; resource B<fading>. 142colour; resource B<fading>.
532 close $pty; 537 close $pty;
533 538
534 # now communicate with rxvt 539 # now communicate with rxvt
535 my $slave = $pty->slave; 540 my $slave = $pty->slave;
536 while (<$slave>) { print $slave "got <$_>\n" } 541 while (<$slave>) { print $slave "got <$_>\n" }
542
543Note that, despite what the name might imply, the file descriptor does not
544need to be a pty, it can be a bi-directional pipe as well (e.g. a unix
545domain or tcp socket). While tty operations cannot be done in this case,
546B<@@RXVT_NAME@@> can still be remote controlled with it:
547
548 use Socket;
549 use Fcntl;
550
551 socketpair my $URXVT, my $slave, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC;
552 fcntl $slave, Fcntl::F_SETFD, 0;
553 system "exec @@RXVT_NAME@@ -pty-fd " . (fileno $slave) . " &";
554 close $slave;
555
556 syswrite $URXVT, "Type a secret password: ";
557 my $secret = do { local $/ = "\r"; <$URXVT> };
558 print "Not so secret anymore: $secret\n";
537 559
538=item B<-pe> I<string> 560=item B<-pe> I<string>
539 561
540Comma-separated list of perl extension scripts to use (or not to use) in 562Comma-separated list of perl extension scripts to use (or not to use) in
541this terminal instance. See resource B<perl-ext> for details. 563this terminal instance. See resource B<perl-ext> for details.
680 702
681B<False>: specify that everything is to be displayed, even 703B<False>: specify that everything is to be displayed, even
682if the refresh is too fast for the human eye to read anything (or the 704if the refresh is too fast for the human eye to read anything (or the
683monitor to display anything); option B<+ss>. 705monitor to display anything); option B<+ss>.
684 706
707=item B<refreshRate:> I<number>
708
709Compile I<frills>: When positive, sets the maximum refreshes per second
710(the default is C<60>). When zero or negative, sets the minimum interval
711between refreshes, negated. That is, positive numbers limit the number
712of refreshes per second to that number, similar to a fps limiter in
713games. A negative number gets negated and directly sets the minimum
714interval between refreshes, that is, C<10> and C<-0.1> both specify
715the same refresh interval (likewise C<50> and C<0.02>). Finally, zero
716makes @@RXVT_NAME@@ refresh as fast as possible. Fractional values are
717supported; option B<-fps>.
718
685=item B<fading:> I<number> 719=item B<fading:> I<number>
686 720
687Fade the text by the given percentage when focus is lost; option B<-fade>. 721Fade the text by the given percentage when focus is lost; option B<-fade>.
688 722
689=item B<fadeColor:> I<colour> 723=item B<fadeColor:> I<colour>
869Align the B<top>, B<bottom> or B<centre> [default] of the scrollbar 903Align the B<top>, B<bottom> or B<centre> [default] of the scrollbar
870thumb with the pointer on middle button press/drag. 904thumb with the pointer on middle button press/drag.
871 905
872=item B<scrollTtyOutput:> I<boolean> 906=item B<scrollTtyOutput:> I<boolean>
873 907
874B<True>: scroll to bottom when tty receives output; option B<-si>. 908B<True>: scroll to bottom when tty receives output; option B<+si>.
875B<False>: do not scroll to bottom when tty receives output; option 909B<False>: do not scroll to bottom when tty receives output; option
876B<+si>. 910B<-si>.
877 911
878=item B<scrollWithBuffer:> I<boolean> 912=item B<scrollWithBuffer:> I<boolean>
879 913
880B<True>: scroll with scrollback buffer when tty receives new lines (i.e. 914B<True>: scroll with scrollback buffer when tty receives new lines (i.e.
881try to show the same lines) and B<scrollTtyOutput> is False; option 915try to show the same lines) and B<scrollTtyOutput> is False; option
1287=item B<perl-ext>: I<string> 1321=item B<perl-ext>: I<string>
1288 1322
1289Comma-separated list(s) of perl extension scripts (default: C<default>) to 1323Comma-separated list(s) of perl extension scripts (default: C<default>) to
1290use in this terminal instance; option B<-pe>. 1324use in this terminal instance; option B<-pe>.
1291 1325
1292Extension names can be prefixed with a C<-> sign to prohibit using 1326Extension names can be prefixed with a C<-> sign to remove them again, in
1293them. This can be useful to selectively disable some extensions loaded 1327case they had been specified earlier. This can be useful to selectively
1294by default, or specified via the C<perl-ext-common> resource. For 1328disable some extensions loaded by default, or specified via the
1295example, C<default,-selection> will use all the default extensions except 1329C<perl-ext-common> resource. For example, C<default,-selection> will use
1296C<selection>. 1330all the default extensions except C<selection>.
1331
1332To prohibit autoloading of extensions, you can prefix them with C</>,
1333which will make urxvt refuse to automatically load them (this can be
1334overridden, however, by specifying the extension name again without a
1335prefix, though). This does not prohibit extensions themselves loading
1336other extensions. For example, C<default,/background> will keep the
1337C<background> extension from being loaded when a background OSC sequence
1338is received.
1297 1339
1298The default set includes the C<selection>, C<option-popup>, 1340The default set includes the C<selection>, C<option-popup>,
1299C<selection-popup>, C<readline> and C<searchable-scrollback> 1341C<selection-popup>, C<readline>, C<searchable-scrollback> and
1300extensions, and extensions which are mentioned in B<keysym> resources. 1342C<confirm-paste> extensions, as well as any extensions which are mentioned
1343in B<keysym> resources.
1301 1344
1302Any extension such that a corresponding resource is given on the 1345Any extension such that a corresponding resource is given on the
1303command line is automatically appended to B<perl-ext>. 1346command line is automatically appended to B<perl-ext>.
1304 1347
1305Each extension is looked up in the library directories, loaded if 1348Each extension is looked up in the library directories, loaded if
1421 1464
1422Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be 1465Pressing B<Shift-Insert> causes the value of the PRIMARY selection to be
1423inserted too. 1466inserted too.
1424 1467
1425rxvt-unicode also provides the bindings B<Ctrl-Meta-c> and 1468rxvt-unicode also provides the bindings B<Ctrl-Meta-c> and
1426<Ctrl-Meta-v> to interact with the CLIPBOARD selection. The first 1469B<Ctrl-Meta-v> to interact with the CLIPBOARD selection. The first
1427binding causes the value of the internal selection to be copied to the 1470binding causes the value of the internal selection to be copied to the
1428CLIPBOARD selection, while the second binding causes the value of the 1471CLIPBOARD selection, while the second binding causes the value of the
1429CLIPBOARD selection to be inserted. 1472CLIPBOARD selection to be inserted.
1430 1473
1431=back 1474=back

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines