[ViewVC] Diff of: cvs/rxvt-unicode/doc/rxvt.1.pod

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.250 by root, Sat Oct 10 20:06:45 2020 UTC vs.
Revision 1.262 by root, Mon Feb 13 17:29:02 2023 UTC

 far greater than those listed. For example: `@@RXVT_NAME@@ --loginShell --color1
 Orange'.
 The following options are available:
-=over 4
+=over
 =item B<-help>, B<--help>
 Print out a message describing available options.
 Turn on/off jump scrolling (allow multiple lines per refresh); resource B<jumpScroll>.
 =item B<-ss>|B<+ss>
 Turn on/off skip scrolling (allow multiple screens per refresh); resource B<skipScroll>.
+=item B<-fps> I<number>
+Compile I<frills>: Set the refresh interval (in frames per second or
+negative seconds); resource B<refreshRate>.
 =item B<-fade> I<number>
 Fade the text by the given percentage when focus is lost. Small values
 fade a little only, 100 completely replaces all colours by the fade
 Change the meaning of triple-click selection with the left mouse
 button. Only effective when the original (non-perl) selection code is
 in-use. Instead of selecting a full line it will extend the selection to
 the end of the logical line only. resource B<tripleclickwords>.
+=item B<-dpb>|B<+dpb>
+Compile frills: Disable (or enable) emitting bracketed paste mode
+sequences (default enabled). Bracketed paste mode allows programs
+to detect when something is pasted. Since more and more programs
+abuse this, these sequences can be disabled. The command sequences to
+enable and query paste mode will still work, but the actual bracket
+sequences will no longer be emitted. You can also toggle this from the
+ctrl-middle-mouse-button menu; resource B<disablePasteBrackets>.
 =item B<-insecure>
 Enable "insecure" mode, which currently enables most of the escape
 sequences that echo strings. See the resource B<insecure> for more
 info.
 =item B<-ssr>|B<+ssr>
 Turn on/off secondary screen scroll (default enabled); resource
 B<secondaryScroll>.
+=item B<-rm> I<mode>
+Compile I<frills>: Sets long line rewrapping behaviour on window resizes
+to one of B<auto> (the default), B<always> or B<never>. The latter two
+modes do the obvious, B<auto> rewraps (acts like B<always>) if scrollback
+is non-empty, and wings lines (acts like B<never>) otherwise; resource
+B<rewrapMode>.
 =item B<-hold>|B<+hold>
 Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
 will not immediately destroy its window when the program executed within
    close $pty;
    # now communicate with rxvt
    my $slave = $pty->slave;
    while (<$slave>) { print $slave "got <$_>\n" }
+Note that, despite what the name might imply, the file descriptor does not
+need to be a pty, it can be a bi-directional pipe as well (e.g. a unix
+domain or tcp socket). While tty operations cannot be done in this case,
+B<@@RXVT_NAME@@> can still be remote controlled with it:
+   use Socket;
+   use Fcntl;
+   socketpair my $URXVT, my $slave, Socket::AF_UNIX, Socket::SOCK_STREAM, Socket::PF_UNSPEC;
+   fcntl $slave, Fcntl::F_SETFD, 0;
+   system "exec @@RXVT_NAME@@ -pty-fd " . (fileno $slave) . " &";
+   close $slave;
+   syswrite $URXVT, "Type a secret password: ";
+   my $secret = do { local $/ = "\r"; <$URXVT> };
+   print "Not so secret anymore: $secret\n";
 =item B<-pe> I<string>
 Comma-separated list of perl extension scripts to use (or not to use) in
 this terminal instance. See resource B<perl-ext> for details.
 be used. Command-line arguments can be used to override resource
 settings. The following resources are supported (you might want to
 check the @@RXVT_NAME@@perl(3) manpage for additional settings by perl
 extensions not documented here):
-=over 4
+=over
 =item B<depth:> I<bitdepth>
 Compile I<xft>: Attempt to find a visual with the given bit depth;
 option B<-depth>.
 B<False>: specify that everything is to be displayed, even
 if the refresh is too fast for the human eye to read anything (or the
 monitor to display anything); option B<+ss>.
+=item B<refreshRate:> I<number>
+Compile I<frills>: When positive, sets the maximum refreshes per second
+(the default is C<60>). When zero or negative, sets the minimum interval
+between refreshes, negated. That is, positive numbers limit the number
+of refreshes per second to that number, similar to a fps limiter in
+games. A negative number gets negated and directly sets the minimum
+interval between refreshes, that is, C<10> and C<-0.1> both specify
+the same refresh interval (likewise C<50> and C<0.02>). Finally, zero
+makes @@RXVT_NAME@@ refresh as fast as possible. Fractional values are
+supported; option B<-fps>.
 =item B<fading:> I<number>
 Fade the text by the given percentage when focus is lost; option B<-fade>.
 =item B<fadeColor:> I<colour>
 Align the B<top>, B<bottom> or B<centre> [default] of the scrollbar
 thumb with the pointer on middle button press/drag.
 =item B<scrollTtyOutput:> I<boolean>
-B<True>: scroll to bottom when tty receives output; option B<-si>.
+B<True>: scroll to bottom when tty receives output; option B<+si>.
 B<False>: do not scroll to bottom when tty receives output; option
-B<+si>.
+B<-si>.
 =item B<scrollWithBuffer:> I<boolean>
 B<True>: scroll with scrollback buffer when tty receives new lines (i.e.
 try to show the same lines) and B<scrollTtyOutput> is False; option
 Change the meaning of triple-click selection with the left mouse
 button. Instead of selecting a full line it will extend the selection to
 the end of the logical line only; option B<-tcw>.
+=item B<disablePasteBrackets:> I<boolean>
+Prevent emission of paste bracket sequences; option B<-dpb>.
 =item B<insecure:> I<boolean>
-Enables "insecure" mode. Rxvt-unicode offers some escape sequences that
+Enable "insecure" mode. Rxvt-unicode offers some escape sequences that
 echo arbitrary strings like the icon name or the locale. This could be
 abused if somebody gets 8-bit-clean access to your display, whether
 through a mail client displaying mail bodies unfiltered or through
 write(1) or any other means. Therefore, these sequences are disabled by
 default. (Note that many other terminals, including xterm, have these
 in the entry on B<keysym> following.
 =item B<secondaryScreen:> I<boolean>
 Turn on/off secondary screen (default enabled).
+=item B<rewrapMode:> I<mode>
+Sets long line rewrap behaviour on window resize to one of B<auto>
+(default), B<always> or B<never>.
 =item B<secondaryScroll:> I<boolean>
 Turn on/off secondary screen scroll (default enabled). If this
 option is enabled, scrolls on the secondary screen will change the
 prefixed with C<string:>).
 The following action prefixes are known - extensions can provide
 additional prefixes:
-=over 4
+=over
 =item string:STRING
 If the I<action> starts with C<string:> (or otherwise contains no colons),
 then the remaining C<STRING> will be passed to the program running in the
 =item B<perl-ext>: I<string>
 Comma-separated list(s) of perl extension scripts (default: C<default>) to
 use in this terminal instance; option B<-pe>.
-Extension names can be prefixed with a C<-> sign to prohibit using
+Extension names can be prefixed with a C<-> sign to remove them again, in
-them. This can be useful to selectively disable some extensions loaded
+case they had been specified earlier. This can be useful to selectively
-by default, or specified via the C<perl-ext-common> resource. For
+disable some extensions loaded by default, or specified via the
-example, C<default,-selection> will use all the default extensions except
+C<perl-ext-common> resource. For example, C<default,-selection> will use
-C<selection>.
+all the default extensions except C<selection>.
+To prohibit autoloading of extensions, you can prefix them with C</>,
+which will make urxvt refuse to automatically load them (this can be
+overridden, however, by specifying the extension name again without a
+prefix, though). This does not prohibit extensions themselves loading
+other extensions. For example, C<default,/background> will keep the
+C<background> extension from being loaded when a background OSC sequence
+is received.
 The default set includes the C<selection>, C<option-popup>,
-C<selection-popup>, C<readline> and C<searchable-scrollback>
+C<selection-popup>, C<readline>, C<searchable-scrollback> and
-extensions, and extensions which are mentioned in B<keysym> resources.
+C<confirm-paste> extensions, as well as any extensions which are mentioned
+in B<keysym> resources.
 Any extension such that a corresponding resource is given on the
 command line is automatically appended to B<perl-ext>.
 Each extension is looked up in the library directories, loaded if
 =head1 THE SELECTION: SELECTING AND PASTING TEXT
 The behaviour of text selection and insertion/pasting mechanism is similar
 to I<xterm>(1).
-=over 4
+=over
 =item B<Selecting>:
 Left click at the beginning of the region, drag to the end of the region
 and release; Right click to extend the marked region; Left double-click
 and character codes using the keyboard. It consists of 4 parts. The
 first part is available if rxvt-unicode has been compiled with
 C<--enable-frills>, the rest is available when rxvt-unicode was compiled
 with C<--enable-iso14755>.
-=over 4
+=over
 =item * 5.1: Basic method
 This allows you to enter unicode characters using their hexcode.
 =head1 ENVIRONMENT
 B<@@RXVT_NAME@@> sets and/or uses the following environment variables:
-=over 4
+=over
 =item B<TERM>
 Normally set to C<rxvt-unicode>, unless overwritten at configure time, via
 resources or on the command line.
 =back
 =head1 FILES
-=over 4
+=over
 =item B</usr/lib/X11/rgb.txt>
 Colour names.
 @@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@-extensions(1),
 @@RXVT_NAME@@perl(3), xterm(1), sh(1), resize(1), X(1), pty(4), tty(4), utmp(5)
 =head1 CURRENT PROJECT COORDINATOR
-=over 4
+=over
 =item Project Coordinator
 Marc A. Lehmann <rxvt-unicode@schmorp.de>.
 =back
 =head1 AUTHORS
-=over 4
+=over
 =item John Bovey
 University of Kent, 1992, wrote the original Xvt.

Diff Legend

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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents): Revision 1.250 by root, Sat Oct 10 20:06:45 2020 UTC vs. Revision 1.262 by root, Mon Feb 13 17:29:02 2023 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.250 by root, Sat Oct 10 20:06:45 2020 UTC vs.
Revision 1.262 by root, Mon Feb 13 17:29:02 2023 UTC