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

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.249 by root, Sat Oct 10 20:03:39 2020 UTC vs.
Revision 1.259 by sf-exg, Sun Dec 19 20:48:21 2021 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.
 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>.
 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
 =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
 scrollback buffer and, when secondaryScreen is off, switching
 	B<ISOLevel3>	B<I>
 	B<AppKeypad>	B<K>
 	B<Control>	B<C>
 	B<NumLock>	B<N>
 	B<Shift>	B<S>
-	B<Meta>	B<M>, B<A>
+	B<Meta>	B<M> I<or> B<A>
 	B<Lock>	B<L>
 	B<Mod1>	B<1>
 	B<Mod2>	B<2>
 	B<Mod3>	B<3>
 	B<Mod4>	B<4>
 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.249 by root, Sat Oct 10 20:03:39 2020 UTC vs. Revision 1.259 by sf-exg, Sun Dec 19 20:48:21 2021 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.1.pod (file contents):
Revision 1.249 by root, Sat Oct 10 20:03:39 2020 UTC vs.
Revision 1.259 by sf-exg, Sun Dec 19 20:48:21 2021 UTC