"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/rxvt.1.man.in" between
rxvt-unicode-9.26.tar.bz2 and rxvt-unicode-9.29.tar.bz2

About: rxvt-unicode is a clone of the terminal emulator rxvt.

rxvt.1.man.in  (rxvt-unicode-9.26.tar.bz2):rxvt.1.man.in  (rxvt-unicode-9.29.tar.bz2)
.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35) .\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\" .\"
.\" Standard preamble: .\" Standard preamble:
.\" ======================================================================== .\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP) .de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v .if t .sp .5v
.if n .sp .if n .sp
.. ..
.de Vb \" Begin verbatim text .de Vb \" Begin verbatim text
.ft CW .ft CW
.nf .nf
skipping to change at line 136 skipping to change at line 136
. ds D- D\h'-1'\(hy . ds D- D\h'-1'\(hy
. ds th \o'bp' . ds th \o'bp'
. ds Th \o'LP' . ds Th \o'LP'
. ds ae ae . ds ae ae
. ds Ae AE . ds Ae AE
.\} .\}
.rm #[ #] #H #V #F C .rm #[ #] #H #V #F C
.\" ======================================================================== .\" ========================================================================
.\" .\"
.IX Title "@@RXVT_NAME@@ 1" .IX Title "@@RXVT_NAME@@ 1"
.TH @@RXVT_NAME@@ 1 "2021-05-14" "@@RXVT_VERSION@@" "RXVT-UNICODE" .TH @@RXVT_NAME@@ 1 "2021-11-22" "@@RXVT_VERSION@@" "RXVT-UNICODE"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents. .\" way too many mistakes in technical documents.
.if n .ad l .if n .ad l
.nh .nh
.SH "NAME" .SH "NAME"
rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system) rxvt\-unicode (ouR XVT, unicode) \- (a VT102 emulator for the X window system)
.SH "SYNOPSIS" .SH "SYNOPSIS"
.IX Header "SYNOPSIS" .IX Header "SYNOPSIS"
\&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]] \&\fB@@RXVT_NAME@@\fR [options] [\-e command [ args ]]
.SH "DESCRIPTION" .SH "DESCRIPTION"
skipping to change at line 490 skipping to change at line 490
.IP "\fB\-imfont\fR \fIfontset\fR" 4 .IP "\fB\-imfont\fR \fIfontset\fR" 4
.IX Item "-imfont fontset" .IX Item "-imfont fontset"
Set the font set to use for the X Input Method, see resource \fBimFont\fR Set the font set to use for the X Input Method, see resource \fBimFont\fR
for more info. for more info.
.IP "\fB\-tcw\fR" 4 .IP "\fB\-tcw\fR" 4
.IX Item "-tcw" .IX Item "-tcw"
Change the meaning of triple-click selection with the left mouse Change the meaning of triple-click selection with the left mouse
button. Only effective when the original (non-perl) selection code is 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 in-use. Instead of selecting a full line it will extend the selection to
the end of the logical line only. resource \fBtripleclickwords\fR. the end of the logical line only. resource \fBtripleclickwords\fR.
.IP "\fB\-dpb\fR|\fB+dpb\fR" 4
.IX Item "-dpb|+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 \fBdisablePasteBrackets\fR.
.IP "\fB\-insecure\fR" 4 .IP "\fB\-insecure\fR" 4
.IX Item "-insecure" .IX Item "-insecure"
Enable \*(L"insecure\*(R" mode, which currently enables most of the escape Enable \*(L"insecure\*(R" mode, which currently enables most of the escape
sequences that echo strings. See the resource \fBinsecure\fR for more sequences that echo strings. See the resource \fBinsecure\fR for more
info. info.
.IP "\fB\-mod\fR \fImodifier\fR" 4 .IP "\fB\-mod\fR \fImodifier\fR" 4
.IX Item "-mod modifier" .IX Item "-mod modifier"
Override detection of Meta modifier with specified key: \fBalt\fR, Override detection of Meta modifier with specified key: \fBalt\fR,
\&\fBmeta\fR, \fBhyper\fR, \fBsuper\fR, \fBmod1\fR, \fBmod2\fR, \fBmod3\fR, \fBm od4\fR, \&\fBmeta\fR, \fBhyper\fR, \fBsuper\fR, \fBmod1\fR, \fBmod2\fR, \fBmod3\fR, \fBm od4\fR,
\&\fBmod5\fR; resource \fImodifier\fR. \&\fBmod5\fR; resource \fImodifier\fR.
.IP "\fB\-ssc\fR|\fB+ssc\fR" 4 .IP "\fB\-ssc\fR|\fB+ssc\fR" 4
.IX Item "-ssc|+ssc" .IX Item "-ssc|+ssc"
Turn on/off secondary screen (default enabled); resource Turn on/off secondary screen (default enabled); resource
\&\fBsecondaryScreen\fR. \&\fBsecondaryScreen\fR.
.IP "\fB\-ssr\fR|\fB+ssr\fR" 4 .IP "\fB\-ssr\fR|\fB+ssr\fR" 4
.IX Item "-ssr|+ssr" .IX Item "-ssr|+ssr"
Turn on/off secondary screen scroll (default enabled); resource Turn on/off secondary screen scroll (default enabled); resource
\&\fBsecondaryScroll\fR. \&\fBsecondaryScroll\fR.
.IP "\fB\-rm\fR \fImode\fR" 4
.IX Item "-rm mode"
Compile \fIfrills\fR: Sets long line rewrapping behaviour on window resizes
to one of \fBauto\fR (the default), \fBalways\fR or \fBnever\fR. The latter two
modes do the obvious, \fBauto\fR rewraps (acts like \fBalways\fR) if scrollback
is non-empty, and wings lines (acts like \fBnever\fR) otherwise; resource
\&\fBrewrapMode\fR.
.IP "\fB\-hold\fR|\fB+hold\fR" 4 .IP "\fB\-hold\fR|\fB+hold\fR" 4
.IX Item "-hold|+hold" .IX Item "-hold|+hold"
Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
will not immediately destroy its window when the program executed within will not immediately destroy its window when the program executed within
it exits. Instead, it will wait till it is being killed or closed by the it exits. Instead, it will wait till it is being killed or closed by the
user; resource \fBhold\fR. user; resource \fBhold\fR.
.IP "\fB\-cd\fR \fIpath\fR" 4 .IP "\fB\-cd\fR \fIpath\fR" 4
.IX Item "-cd path" .IX Item "-cd path"
Sets the working directory for the shell (or the command specified via Sets the working directory for the shell (or the command specified via
\&\fB\-e\fR). The \fIpath\fR must be an absolute path and it must exist for \&\fB\-e\fR). The \fIpath\fR must be an absolute path and it must exist for
skipping to change at line 593 skipping to change at line 609
\& \&
\& my $pty = new IO::Pty; \& my $pty = new IO::Pty;
\& fcntl $pty, F_SETFD, 0; # clear close\-on\-exec \& fcntl $pty, F_SETFD, 0; # clear close\-on\-exec
\& system "@@RXVT_NAME@@ \-pty\-fd " . (fileno $pty) . "&"; \& system "@@RXVT_NAME@@ \-pty\-fd " . (fileno $pty) . "&";
\& close $pty; \& close $pty;
\& \&
\& # now communicate with rxvt \& # now communicate with rxvt
\& my $slave = $pty\->slave; \& my $slave = $pty\->slave;
\& while (<$slave>) { print $slave "got <$_>\en" } \& while (<$slave>) { print $slave "got <$_>\en" }
.Ve .Ve
.Sp
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,
\&\fB@@RXVT_NAME@@\fR can still be remote controlled with it:
.Sp
.Vb 2
\& use Socket;
\& use Fcntl;
\&
\& socketpair my $URXVT, my $slave, Socket::AF_UNIX, Socket::SOCK_STREAM, Sock
et::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 $/ = "\er"; <$URXVT> };
\& print "Not so secret anymore: $secret\en";
.Ve
.IP "\fB\-pe\fR \fIstring\fR" 4 .IP "\fB\-pe\fR \fIstring\fR" 4
.IX Item "-pe string" .IX Item "-pe string"
Comma-separated list of perl extension scripts to use (or not to use) in Comma-separated list of perl extension scripts to use (or not to use) in
this terminal instance. See resource \fBperl-ext\fR for details. this terminal instance. See resource \fBperl-ext\fR for details.
.SH "RESOURCES" .SH "RESOURCES"
.IX Header "RESOURCES" .IX Header "RESOURCES"
Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long Note: `@@RXVT_NAME@@ \-\-help' gives a list of all resources (long
options) compiled into your version. All resources are also available as options) compiled into your version. All resources are also available as
long-options. long-options.
.PP .PP
skipping to change at line 1027 skipping to change at line 1062
\&\f(CW\*(C`OffTheSpot\*(C'\fR. It must be a standard X font set (\s-1XLFD\s0 pa tterns separated \&\f(CW\*(C`OffTheSpot\*(C'\fR. It must be a standard X font set (\s-1XLFD\s0 pa tterns separated
by commas), i.e. it's not in the same format as the other font lists used by commas), i.e. it's not in the same format as the other font lists used
in @@RXVT_NAME@@. The default will be set-up to chose *any* suitable found in @@RXVT_NAME@@. The default will be set-up to chose *any* suitable found
found, preferably one or two pixels differing in size to the base font. found, preferably one or two pixels differing in size to the base font.
option \fB\-imfont\fR. option \fB\-imfont\fR.
.IP "\fBtripleclickwords:\fR \fIboolean\fR" 4 .IP "\fBtripleclickwords:\fR \fIboolean\fR" 4
.IX Item "tripleclickwords: boolean" .IX Item "tripleclickwords: boolean"
Change the meaning of triple-click selection with the left mouse Change the meaning of triple-click selection with the left mouse
button. Instead of selecting a full line it will extend the selection to button. Instead of selecting a full line it will extend the selection to
the end of the logical line only; option \fB\-tcw\fR. the end of the logical line only; option \fB\-tcw\fR.
.IP "\fBdisablePasteBrackets:\fR \fIboolean\fR" 4
.IX Item "disablePasteBrackets: boolean"
Prevent emission of paste bracket sequences; option \fB\-dpb\fR.
.IP "\fBinsecure:\fR \fIboolean\fR" 4 .IP "\fBinsecure:\fR \fIboolean\fR" 4
.IX Item "insecure: boolean" .IX Item "insecure: boolean"
Enables \*(L"insecure\*(R" mode. Rxvt-unicode offers some escape sequences that Enable \*(L"insecure\*(R" mode. Rxvt-unicode offers some escape sequences that
echo arbitrary strings like the icon name or the locale. This could be 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 abused if somebody gets 8\-bit\-clean access to your display, whether
through a mail client displaying mail bodies unfiltered or through through a mail client displaying mail bodies unfiltered or through
\&\fBwrite\fR\|(1) or any other means. Therefore, these sequences are disabled b y \&\fBwrite\fR\|(1) or any other means. Therefore, these sequences are disabled b y
default. (Note that many other terminals, including xterm, have these default. (Note that many other terminals, including xterm, have these
sequences enabled by default, which doesn't make it safer, though). sequences enabled by default, which doesn't make it safer, though).
.Sp .Sp
You can enable them by setting this boolean resource or specifying You can enable them by setting this boolean resource or specifying
\&\fB\-insecure\fR as an option. At the moment, this enables display-answer, \&\fB\-insecure\fR as an option. At the moment, this enables display-answer,
locale, findfont, icon label and window title requests. locale, findfont, icon label and window title requests.
skipping to change at line 1053 skipping to change at line 1091
\&\fBhyper\fR, \fBsuper\fR, \fBmod1\fR, \fBmod2\fR, \fBmod3\fR, \fBmod4\fR, \fBm od5\fR; option \&\fBhyper\fR, \fBsuper\fR, \fBmod1\fR, \fBmod2\fR, \fBmod3\fR, \fBmod4\fR, \fBm od5\fR; option
\&\fB\-mod\fR. \&\fB\-mod\fR.
.IP "\fBanswerbackString:\fR \fIstring\fR" 4 .IP "\fBanswerbackString:\fR \fIstring\fR" 4
.IX Item "answerbackString: string" .IX Item "answerbackString: string"
Specify the reply rxvt-unicode sends to the shell when an \s-1ENQ\s0 (control-E) Specify the reply rxvt-unicode sends to the shell when an \s-1ENQ\s0 (control-E)
character is passed through. It may contain escape values as described character is passed through. It may contain escape values as described
in the entry on \fBkeysym\fR following. in the entry on \fBkeysym\fR following.
.IP "\fBsecondaryScreen:\fR \fIboolean\fR" 4 .IP "\fBsecondaryScreen:\fR \fIboolean\fR" 4
.IX Item "secondaryScreen: boolean" .IX Item "secondaryScreen: boolean"
Turn on/off secondary screen (default enabled). Turn on/off secondary screen (default enabled).
.IP "\fBrewrapMode:\fR \fImode\fR" 4
.IX Item "rewrapMode: mode"
Sets long line rewrap behaviour on window resize to one of \fBauto\fR
(default), \fBalways\fR or \fBnever\fR.
.IP "\fBsecondaryScroll:\fR \fIboolean\fR" 4 .IP "\fBsecondaryScroll:\fR \fIboolean\fR" 4
.IX Item "secondaryScroll: boolean" .IX Item "secondaryScroll: boolean"
Turn on/off secondary screen scroll (default enabled). If this Turn on/off secondary screen scroll (default enabled). If this
option is enabled, scrolls on the secondary screen will change the option is enabled, scrolls on the secondary screen will change the
scrollback buffer and, when secondaryScreen is off, switching scrollback buffer and, when secondaryScreen is off, switching
to/from the secondary screen will instead scroll the screen up. to/from the secondary screen will instead scroll the screen up.
.IP "\fBhold\fR: \fIboolean\fR" 4 .IP "\fBhold\fR: \fIboolean\fR" 4
.IX Item "hold: boolean" .IX Item "hold: boolean"
Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@ Turn on/off hold window after exit support. If enabled, @@RXVT_NAME@@
will not immediately destroy its window when the program executed within will not immediately destroy its window when the program executed within
skipping to change at line 1282 skipping to change at line 1324
.RE .RE
.IP "\fBperl-ext-common\fR: \fIstring\fR" 4 .IP "\fBperl-ext-common\fR: \fIstring\fR" 4
.IX Item "perl-ext-common: string" .IX Item "perl-ext-common: string"
.PD 0 .PD 0
.IP "\fBperl-ext\fR: \fIstring\fR" 4 .IP "\fBperl-ext\fR: \fIstring\fR" 4
.IX Item "perl-ext: string" .IX Item "perl-ext: string"
.PD .PD
Comma-separated list(s) of perl extension scripts (default: \f(CW\*(C`default\*( C'\fR) to Comma-separated list(s) of perl extension scripts (default: \f(CW\*(C`default\*( C'\fR) to
use in this terminal instance; option \fB\-pe\fR. use in this terminal instance; option \fB\-pe\fR.
.Sp .Sp
Extension names can be prefixed with a \f(CW\*(C`\-\*(C'\fR sign to prohibit usi Extension names can be prefixed with a \f(CW\*(C`\-\*(C'\fR sign to remove them
ng 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 \f(CW\*(C`perl\-ext\-common\*(C'\fR resource. F disable some extensions loaded by default, or specified via the
or \&\f(CW\*(C`perl\-ext\-common\*(C'\fR resource. For example, \f(CW\*(C`default,\
example, \f(CW\*(C`default,\-selection\*(C'\fR will use all the default extensio -selection\*(C'\fR will use
ns except all the default extensions except \f(CW\*(C`selection\*(C'\fR.
\&\f(CW\*(C`selection\*(C'\fR. .Sp
To prohibit autoloading of extensions, you can prefix them with \f(CW\*(C`/\*(C'
\fR,
which will make urxvt refuse to automatically load them (this can be
overriden, however, by specifying the extension name again without a
prefix, though). This does not prohibit extensions themselves loading
other extensions. For example, \f(CW\*(C`default,/background\*(C'\fR will keep t
he
\&\f(CW\*(C`background\*(C'\fR extension from being loaded when a background \s-
1OSC\s0 sequence
is received.
.Sp .Sp
The default set includes the \f(CW\*(C`selection\*(C'\fR, \f(CW\*(C`option\-popu p\*(C'\fR, The default set includes the \f(CW\*(C`selection\*(C'\fR, \f(CW\*(C`option\-popu p\*(C'\fR,
\&\f(CW\*(C`selection\-popup\*(C'\fR, \f(CW\*(C`readline\*(C'\fR and \f(CW\*(C`s \&\f(CW\*(C`selection\-popup\*(C'\fR, \f(CW\*(C`readline\*(C'\fR, \f(CW\*(C`sear
earchable\-scrollback\*(C'\fR chable\-scrollback\*(C'\fR and
extensions, and extensions which are mentioned in \fBkeysym\fR resources. \&\f(CW\*(C`confirm\-paste\*(C'\fR extensions, as well as any extensions which a
re mentioned
in \fBkeysym\fR resources.
.Sp .Sp
Any extension such that a corresponding resource is given on the Any extension such that a corresponding resource is given on the
command line is automatically appended to \fBperl-ext\fR. command line is automatically appended to \fBperl-ext\fR.
.Sp .Sp
Each extension is looked up in the library directories, loaded if Each extension is looked up in the library directories, loaded if
necessary, and bound to the current terminal instance. When the library necessary, and bound to the current terminal instance. When the library
search path contains multiple extension files of the same name, then the search path contains multiple extension files of the same name, then the
first one found will be used. first one found will be used.
.Sp .Sp
If both of these resources are the empty string, then the perl interpreter If both of these resources are the empty string, then the perl interpreter
 End of changes. 10 change blocks. 
14 lines changed or deleted 69 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)