repo: rxvt-unicode-sixel action: commit revision: path_from: revision_from: b523e6a89ed563ab5a22ca49e4afd81e07619ac4: path_to: revision_to:
commit b523e6a89ed563ab5a22ca49e4afd81e07619ac4 Author: Marc LehmannDate: Fri May 14 13:47:43 2021 +0000 *** empty log message *** diff --git a/README.FAQ b/README.FAQ
--- a/README.FAQ
+++ b/README.FAQ
@@ -70,6 +70,28 @@ RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
re-run the command. Subsequent invocations of the script will re-use the
existing daemon.
+ Another option is to use systemd socket-based activation (see
+ systemd.socket(5)). Here is an example of a service unit file and of a
+ socket unit file for the default socket path:
+
+ urxvtd.service
+ [Unit]
+ Description=urxvt terminal daemon
+ Requires=urxvtd.socket
+
+ [Service]
+ ExecStart=/usr/bin/urxvtd -o
+
+ urxvtd.socket
+ [Unit]
+ Description=urxvt terminal daemon socket
+
+ [Socket]
+ ListenStream=%h/.urxvt/urxvtd-%H
+
+ [Install]
+ WantedBy=sockets.target
+
How do I distinguish whether I'm running rxvt-unicode or a regular
xterm? I need this to decide about setting colours etc.
The original rxvt and rxvt-unicode always export the variable
@@ -620,7 +642,7 @@ xterm? I need this to decide about setting colours etc.
certainly not *typical*, but what's typical...
URxvt.cutchars: "()*,<>[]{}|'
- URxvt.print-pipe: cat >/tmp/xxx
+ URxvt.print-pipe: cat >/some/path
These are just for testing stuff.
diff --git a/README.configure b/README.configure
--- a/README.configure
+++ b/README.configure
@@ -173,8 +173,10 @@ CONFIGURE OPTIONS
compile in built-in block graphics
skip builtin block graphics (-sbg)
separate highlight colour (-highlightColor, -highlightTextColor)
- extended mouse reporting modes (1005 and 1015).
+ focus reporting mode (1004).
+ extended mouse reporting modes (1005, 1006 and 1015).
visual selection via -visual and -depth.
+ systemd socket activation
It also enables some non-essential features otherwise disabled, such
as:
diff --git a/doc/rxvt.1.man.in b/doc/rxvt.1.man.in
--- a/doc/rxvt.1.man.in
+++ b/doc/rxvt.1.man.in
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
+.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -46,7 +46,7 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
@@ -56,12 +56,12 @@
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
-.if (\n(rF:(\n(.g==0)) \{
-. if \nF \{
+.if (\n(rF:(\n(.g==0)) \{\
+. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
-. if !\nF==2 \{
+. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 1"
-.TH @@RXVT_NAME@@ 1 "2016-01-23" "@@RXVT_VERSION@@" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 1 "2021-05-13" "@@RXVT_VERSION@@" "RXVT-UNICODE"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -430,7 +430,7 @@ work around odd font metrics; resource \fBletterSpace\fR.
.IX Item "-tn termname"
This option specifies the name of the terminal type to be set in the
\&\fB\s-1TERM\s0\fR environment variable. This terminal type must exist in the
-\&\fI\fItermcap\fI\|(5)\fR database and should have \fIli#\fR and \fIco#\fR entries;
+\&\fI\f(BItermcap\fI\|(5)\fR database and should have \fIli#\fR and \fIco#\fR entries;
resource \fBtermName\fR.
.IP "\fB\-e\fR \fIcommand [arguments]\fR" 4
.IX Item "-e command [arguments]"
@@ -440,7 +440,7 @@ the program being executed if neither \fI\-title\fR (\fI\-T\fR) nor \fI\-n\fR ar
given on the command line. If this option is used, it must be the last
on the command-line. If there is no \fB\-e\fR option then the default is to
run the program specified by the \fB\s-1SHELL\s0\fR environment variable or,
-failing that, \fI\fIsh\fI\|(1)\fR.
+failing that, \fI\f(BIsh\fI\|(1)\fR.
.Sp
Please note that you must specify a program with arguments. If you want to
run shell commands, you have to specify the shell, like this:
@@ -622,7 +622,7 @@ configured, while the class name \fBURxvt\fR allows resources unique to
configurations. If no resources are specified, suitable defaults will
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@@\fIperl\fR\|(3) manpage for additional settings by perl
+check the @@RXVT_NAME@@\fBperl\fR\|(3) manpage for additional settings by perl
extensions not documented here):
.IP "\fBdepth:\fR \fIbitdepth\fR" 4
.IX Item "depth: bitdepth"
@@ -851,7 +851,7 @@ option \fB\-ut\fR. \fBFalse\fR: write record into the system log file \fButmp\fR
[default]; option \fB+ut\fR.
.IP "\fBprint-pipe:\fR \fIstring\fR" 4
.IX Item "print-pipe: string"
-Specify a command pipe for vt100 printer [default \fI\fIlpr\fI\|(1)\fR]. Use
+Specify a command pipe for vt100 printer [default \fI\f(BIlpr\fI\|(1)\fR]. Use
\&\fBPrint\fR to initiate a screen dump to the printer and \fBCtrl-Print\fR or
\&\fBShift-Print\fR to include the scrollback as well.
.Sp
@@ -991,7 +991,7 @@ The characters used as delimiters for double-click word selection
(whitespace delimiting is added automatically if resource is given).
.Sp
When the perl selection extension is in use (the default if compiled
-in, see the @@RXVT_NAME@@\fIperl\fR\|(3) manpage), a suitable regex using these
+in, see the @@RXVT_NAME@@\fBperl\fR\|(3) manpage), a suitable regex using these
characters will be created (if the resource exists, otherwise, no regex
will be created). In this mode, characters outside \s-1ISO\-8859\-1\s0 can be used.
.Sp
@@ -1030,7 +1030,7 @@ Enables \*(L"insecure\*(R" 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
-\&\fIwrite\fR\|(1) or any other means. Therefore, these sequences are disabled by
+\&\fBwrite\fR\|(1) or any other means. Therefore, these sequences are disabled by
default. (Note that many other terminals, including xterm, have these
sequences enabled by default, which doesn't make it safer, though).
.Sp
@@ -1044,7 +1044,7 @@ Set the key to be interpreted as the Meta key to: \fBalt\fR, \fBmeta\fR,
\&\fB\-mod\fR.
.IP "\fBanswerbackString:\fR \fIstring\fR" 4
.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
in the entry on \fBkeysym\fR following.
.IP "\fBsecondaryScreen:\fR \fIboolean\fR" 4
@@ -1085,10 +1085,23 @@ The key combination that triggers the action, \fIsym\fR, has the following forma
\& (modifiers\-)key
.Ve
.Sp
-Where \fImodifiers\fR can be any combination of \fBISOLevel3\fR, \fBAppKeypad\fR,
-\&\fBControl\fR, \fBNumLock\fR, \fBShift\fR, \fBMeta\fR, \fBLock\fR, \fBMod1\fR, \fBMod2\fR,
-\&\fBMod3\fR, \fBMod4\fR, \fBMod5\fR, and the abbreviated \fBI\fR, \fBK\fR, \fBC\fR, \fBN\fR,
-\&\fBS\fR, \fBM\fR, \fBA\fR, \fBL\fR, \fB1\fR, \fB2\fR, \fB3\fR, \fB4\fR, \fB5\fR.
+Where \fImodifiers\fR can be any combination of the following full or
+abbreviated modifier names:
+.TS
+l l .
+ISOLevel3 I
+AppKeypad K
+Control C
+NumLock N
+Shift S
+Meta M or A
+Lock L
+Mod1 1
+Mod2 2
+Mod3 3
+Mod4 4
+Mod5 5
+.TE
.Sp
The \fBNumLock\fR, \fBMeta\fR and \fBISOLevel3\fR modifiers are usually aliased to
whatever modifier the NumLock key, Meta/Alt keys or \s-1ISO\s0 Level3 Shift/AltGr
@@ -1235,12 +1248,12 @@ this:
.IP "\s-1EXTENSION:STRING\s0" 4
.IX Item "EXTENSION:STRING"
An action of this form invokes the action \fB\s-1STRING\s0\fR, if any, provided
-by the @@RXVT_NAME@@\fIperl\fR\|(3) extension \fB\s-1EXTENSION\s0\fR. The extension will
+by the @@RXVT_NAME@@\fBperl\fR\|(3) extension \fB\s-1EXTENSION\s0\fR. The extension will
be loaded automatically if necessary.
.Sp
Not all extensions define actions, but popular extensions that do
include the \fIselection\fR and \fImatcher\fR extensions (documented in their
-own manpages, @@RXVT_NAME@@\-\fIselection\fR\|(1) and @@RXVT_NAME@@\-\fImatcher\fR\|(1),
+own manpages, @@RXVT_NAME@@\-\fBselection\fR\|(1) and @@RXVT_NAME@@\-\fBmatcher\fR\|(1),
respectively).
.Sp
From the silly examples department, this will rot13\-\*(L"encrypt\*(R"
@@ -1291,7 +1304,7 @@ all instances, while \fBperl-ext\fR is used for specific instances.
.IP "\fBperl-eval\fR: \fIstring\fR" 4
.IX Item "perl-eval: string"
Perl code to be evaluated when all extensions have been registered. See
-the @@RXVT_NAME@@\fIperl\fR\|(3) manpage.
+the @@RXVT_NAME@@\fBperl\fR\|(3) manpage.
.IP "\fBperl-lib\fR: \fIpath\fR" 4
.IX Item "perl-lib: path"
Colon-separated list of additional directories that hold extension
@@ -1299,14 +1312,14 @@ scripts. When looking for perl extensions, @@RXVT_NAME@@ will first look
in these directories, then in \f(CW$URXVT_PERL_LIB\fR, \fI\f(CI$HOME\fI/.urxvt/ext\fR and
lastly in \fI@@RXVT_LIBDIR@@/urxvt/perl/\fR.
.Sp
-See the @@RXVT_NAME@@\fIperl\fR\|(3) manpage.
+See the @@RXVT_NAME@@\fBperl\fR\|(3) manpage.
.IP "\fBselection.pattern\-\f(BIidx\fB\fR: \fIperl-regex\fR" 4
.IX Item "selection.pattern-idx: perl-regex"
-Additional selection patterns, see the @@RXVT_NAME@@\fIperl\fR\|(3) manpage for
+Additional selection patterns, see the @@RXVT_NAME@@\fBperl\fR\|(3) manpage for
details.
.IP "\fBselection-autotransform.\f(BIidx\fB\fR: \fIperl-transform\fR" 4
.IX Item "selection-autotransform.idx: perl-transform"
-Selection auto-transform patterns, see the @@RXVT_NAME@@\fIperl\fR\|(3) manpage
+Selection auto-transform patterns, see the @@RXVT_NAME@@\fBperl\fR\|(3) manpage
for details.
.IP "\fBsearchable-scrollback:\fR \fIkeysym\fR *DEPRECATED*" 4
.IX Item "searchable-scrollback: keysym *DEPRECATED*"
@@ -1329,113 +1342,10 @@ Compile \fIfrills\fR: Sets override-redirect for the terminal window, making
it almost invisible to window managers; option \fB\-override\-redirect\fR.
.IP "\fBiso14755:\fR \fIboolean\fR" 4
.IX Item "iso14755: boolean"
-Turn on/off \s-1ISO 14755 \s0(default enabled).
+Turn on/off \s-1ISO 14755\s0 (default enabled).
.IP "\fBiso14755_52:\fR \fIboolean\fR" 4
.IX Item "iso14755_52: boolean"
Turn on/off \s-1ISO 14755 5.2\s0 mode (default enabled).
-.SH "BACKGROUND IMAGE OPTIONS AND RESOURCES"
-.IX Header "BACKGROUND IMAGE OPTIONS AND RESOURCES"
-.IP "\fB\-pixmap\fR \fIfile[;oplist]\fR" 4
-.IX Item "-pixmap file[;oplist]"
-.PD 0
-.IP "\fBbackgroundPixmap:\fR \fIfile[;oplist]\fR" 4
-.IX Item "backgroundPixmap: file[;oplist]"
-.PD
-Compile \fIpixbuf\fR: Use the specified image file as the window's
-background and also optionally specify a colon separated list of
-operations to modify it. Note that you may need to quote the \f(CW\*(C`;\*(C'\fR
-character when using the command line option, as \f(CW\*(C`;\*(C'\fR is usually a
-metacharacter in shells. Supported operations are:
-.RS 4
-.IP "\fBWxH+X+Y\fR" 4
-.IX Item "WxH+X+Y"
-sets scale and position. \fB\*(L"W\*(R" / \*(L"H\*(R"\fR specify the horizontal/vertical
-scale (percent), and \fB\*(L"X\*(R" / \*(L"Y\*(R"\fR locate the image centre (percent). A
-scale of 0 disables scaling.
-.IP "\fBop=tile\fR" 4
-.IX Item "op=tile"
-enables tiling
-.IP "\fBop=keep\-aspect\fR" 4
-.IX Item "op=keep-aspect"
-maintain the image aspect ratio when scaling
-.IP "\fBop=root\-align\fR" 4
-.IX Item "op=root-align"
-use the position of the terminal window relative to the root window as
-the image offset, simulating a root window background
-.RE
-.RS 4
-.Sp
-The default scale and position setting is \f(CW\*(C`100x100+50+50\*(C'\fR.
-Alternatively, a predefined set of templates can be used to achieve
-the most common setups:
-.IP "\fBstyle=tiled\fR" 4
-.IX Item "style=tiled"
-the image is tiled with no scaling. Equivalent to 0x0+0+0:op=tile
-.IP "\fBstyle=aspect\-stretched\fR" 4
-.IX Item "style=aspect-stretched"
-the image is scaled to fill the whole window maintaining the aspect
-ratio and centered. Equivalent to 100x100+50+50:op=keep\-aspect
-.IP "\fBstyle=stretched\fR" 4
-.IX Item "style=stretched"
-the image is scaled to fill the whole window. Equivalent to 100x100
-.IP "\fBstyle=centered\fR" 4
-.IX Item "style=centered"
-the image is centered with no scaling. Equivalent to 0x0+50+50
-.IP "\fBstyle=root\-tiled\fR" 4
-.IX Item "style=root-tiled"
-the image is tiled with no scaling and using 'root' positioning.
-Equivalent to 0x0:op=tile:op=root\-align
-.RE
-.RS 4
-.Sp
-If multiple templates are specified the last one wins. Note that a
-template overrides all the scale, position and operations settings.
-.Sp
-If used in conjunction with pseudo-transparency, the specified pixmap
-will be blended over the transparent background using alpha-blending.
-.RE
-.IP "\fB\-tr\fR|\fB+tr\fR" 4
-.IX Item "-tr|+tr"
-.PD 0
-.IP "\fBtransparent:\fR \fIboolean\fR" 4
-.IX Item "transparent: boolean"
-.PD
-Turn on/off pseudo-transparency by using the root pixmap as background.
-.Sp
-\&\fB\-ip\fR (\fBinheritPixmap\fR) is still accepted as an obsolete alias but
-will be removed in future versions.
-.IP "\fB\-tint\fR \fIcolour\fR" 4
-.IX Item "-tint colour"
-.PD 0
-.IP "\fBtintColor:\fR \fIcolour\fR" 4
-.IX Item "tintColor: colour"
-.PD
-Tint the transparent background with the given colour. Note that a
-black tint yields a completely black image while a white tint yields
-the image unchanged.
-.IP "\fB\-sh\fR \fInumber\fR" 4
-.IX Item "-sh number"
-.PD 0
-.IP "\fBshading:\fR \fInumber\fR" 4
-.IX Item "shading: number"
-.PD
-Darken (0 .. 99) or lighten (101 .. 200) the transparent background.
-A value of 100 means no shading.
-.IP "\fB\-blr\fR \fIHxV\fR" 4
-.IX Item "-blr HxV"
-.PD 0
-.IP "\fBblurRadius:\fR \fIHxV\fR" 4
-.IX Item "blurRadius: HxV"
-.PD
-Apply gaussian blur with the specified radius to the transparent
-background. If a single number is specified, the vertical and
-horizontal radii are considered to be the same. Setting one of the
-radii to 1 and the other to a large number creates interesting effects
-on some backgrounds. The maximum radius value is 128. An horizontal or
-vertical radius of 0 disables blurring.
-.IP "\fBpath:\fR \fIpath\fR" 4
-.IX Item "path: path"
-Specify the colon-delimited search path for finding background image files.
.SH "THE SCROLLBAR"
.IX Header "THE SCROLLBAR"
Lines of text that scroll off the top of the \fB@@RXVT_NAME@@\fR window
@@ -1572,7 +1482,7 @@ both scenario A and B of \s-1ISO 14755,\s0 including part 5.2.
.SH "LOGIN STAMP"
.IX Header "LOGIN STAMP"
\&\fB@@RXVT_NAME@@\fR tries to write an entry into the \fIutmp\fR(5) file so that
-it can be seen via the \fI\fIwho\fI\|(1)\fR command, and can accept messages. To
+it can be seen via the \fI\f(BIwho\fI\|(1)\fR command, and can accept messages. To
allow this feature, \fB@@RXVT_NAME@@\fR may need to be installed setuid root
on some systems or setgid to root or to some other group on others.
.SH "COLOURS AND GRAPHICS"
@@ -1583,6 +1493,15 @@ high-intensity (potentially bold/blink) versions of the same, and 72 (or
240 in 256 colour mode) colours arranged in an 4x4x4 (or 6x6x6) colour \s-1RGB\s0
cube plus a 8 (24) colour greyscale ramp.
.PP
+\&\fB@@RXVT_NAME@@\fR supports direct 24\-bit fg/bg \s-1RGB\s0 colour escapes
+\&\f(CW\*(C` ESC [ 38 ; 2 ; R ; G ; Bm \*(C'\fR / \f(CW\*(C` ESC [ 48 ; 2; R ; G ; Bm \*(C'\fR. However the
+number of 24\-bit colours that can be used is limited: an internal 7x7x5 (256
+colour mode) or 6x6x4 (88 colour mode) colour cube is used to index into the
+24\-bit colour space. When indexing collisions happen, the nearest old colour in
+the cube will be adapted to the new 24\-bit \s-1RGB\s0 colour. That means one cannot
+use many similar 24\-bit colours. It's typically not a problem in common
+scenarios.
+.PP
Here is a list of the \s-1ANSI\s0 colours with their names.
.TS
l l l .
@@ -1762,8 +1681,8 @@ If set and accessible, gives the name of a X resource file to be loaded by
Colour names.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
-@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@\-\fIextensions\fR\|(1),
-@@RXVT_NAME@@\fIperl\fR\|(3), \fIxterm\fR\|(1), \fIsh\fR\|(1), \fIresize\fR\|(1), X(1), \fIpty\fR\|(4), \fItty\fR\|(4), \fIutmp\fR\|(5)
+@@RXVT_NAME@@(7), @@RXVT_NAME@@c(1), @@RXVT_NAME@@d(1), @@RXVT_NAME@@\-\fBextensions\fR\|(1),
+@@RXVT_NAME@@\fBperl\fR\|(3), \fBxterm\fR\|(1), \fBsh\fR\|(1), \fBresize\fR\|(1), X(1), \fBpty\fR\|(4), \fBtty\fR\|(4), \fButmp\fR\|(5)
.SH "CURRENT PROJECT COORDINATOR"
.IX Header "CURRENT PROJECT COORDINATOR"
.IP "Project Coordinator" 4
diff --git a/doc/rxvt.7.man.in b/doc/rxvt.7.man.in
--- a/doc/rxvt.7.man.in
+++ b/doc/rxvt.7.man.in
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
+.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -46,7 +46,7 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
@@ -56,12 +56,12 @@
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
-.if (\n(rF:(\n(.g==0)) \{
-. if \nF \{
+.if (\n(rF:(\n(.g==0)) \{\
+. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
-. if !\nF==2 \{
+. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 7"
-.TH @@RXVT_NAME@@ 7 "2016-01-23" "@@RXVT_VERSION@@" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 7 "2021-05-13" "@@RXVT_VERSION@@" "RXVT-UNICODE"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -169,7 +169,7 @@ The main manual page for @@RXVT_NAME@@ itself is available at
\fIMy question isn't answered here, can I ask a human?\fR
.IX Subsection "My question isn't answered here, can I ask a human?"
.PP
-Before sending me mail, you could go to \s-1IRC: \s0\f(CW\*(C`irc.freenode.net\*(C'\fR,
+Before sending me mail, you could go to \s-1IRC:\s0 \f(CW\*(C`irc.freenode.net\*(C'\fR,
channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be
interested in learning about new and exciting problems (but not FAQs :).
.PP
@@ -254,6 +254,32 @@ meaning it couldn't connect to the daemon, it will start the daemon and
re-run the command. Subsequent invocations of the script will re-use the
existing daemon.
.PP
+Another option is to use systemd socket-based activation (see
+\&\fBsystemd.socket\fR\|(5)). Here is an example of a service unit file and of a
+socket unit file for the default socket path:
+.IP "urxvtd.service" 4
+.IX Item "urxvtd.service"
+.Vb 3
+\& [Unit]
+\& Description=urxvt terminal daemon
+\& Requires=urxvtd.socket
+\&
+\& [Service]
+\& ExecStart=/usr/bin/urxvtd \-o
+.Ve
+.IP "urxvtd.socket" 4
+.IX Item "urxvtd.socket"
+.Vb 2
+\& [Unit]
+\& Description=urxvt terminal daemon socket
+\&
+\& [Socket]
+\& ListenStream=%h/.urxvt/urxvtd\-%H
+\&
+\& [Install]
+\& WantedBy=sockets.target
+.Ve
+.PP
\fIHow do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc.\fR
.IX Subsection "How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colours etc."
.PP
@@ -268,7 +294,7 @@ whether or not to use colour.
If you've compiled rxvt-unicode with \s-1DISPLAY_IS_IP\s0 and have enabled
insecure mode then it is possible to use the following shell script
snippets to correctly set the display. If your version of rxvt-unicode
-wasn't also compiled with \s-1ESCZ_ANSWER \s0(as assumed in these snippets) then
+wasn't also compiled with \s-1ESCZ_ANSWER\s0 (as assumed in these snippets) then
the \s-1COLORTERM\s0 variable can be used to distinguish rxvt-unicode from a
regular xterm.
.PP
@@ -736,7 +762,7 @@ rxvt-unicode from initialising perl, saving memory.
.PP
If you only want to disable specific features, you first have to
identify which perl extension is responsible. For this, read the section
-\&\fB\s-1PREPACKAGED EXTENSIONS\s0\fR in the @@URXVT_NAME@@\fIperl\fR\|(3) manpage. For
+\&\fB\s-1PREPACKAGED EXTENSIONS\s0\fR in the @@URXVT_NAME@@\fBperl\fR\|(3) manpage. For
example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify
this \fBperl-ext-common\fR resource:
.PP
@@ -916,7 +942,7 @@ not \fItypical\fR, but what's typical...
.PP
.Vb 2
\& URxvt.cutchars: "()*,<>[]{}|\*(Aq
-\& URxvt.print\-pipe: cat >/tmp/xxx
+\& URxvt.print\-pipe: cat >/some/path
.Ve
.PP
These are just for testing stuff.
@@ -1426,8 +1452,8 @@ immediately. This is much safer than most other terminals that keep
privileges while running (but is more relevant to urxvt, as it contains
things as perl interpreters, which might be \*(L"helpful\*(R" to attackers).
.PP
-This forking is done as the very first within \fImain()\fR, which is very early
-and reduces possible bugs to initialisation code run before \fImain()\fR, or
+This forking is done as the very first within \fBmain()\fR, which is very early
+and reduces possible bugs to initialisation code run before \fBmain()\fR, or
things like the dynamic loader of your system, which should result in very
little risk.
.PP
@@ -1497,163 +1523,169 @@ The rest of this document describes various technical aspects of
\&\fBrxvt-unicode\fR. First the description of supported command sequences,
followed by pixmap support and last by a description of all features
selectable at \f(CW\*(C`configure\*(C'\fR time.
+.PP
+When some functionality is marked as (insecure mode), then it requires
+insecure mode to be enabled to work fully, e.g. by using the \fBinsecure\fR
+resource or command line switch. As that name implies, a terminal running
+in insecure mode might not be secure against attackers that can output
+arbitrary sequences to the terminal.
.SS "Definitions"
.IX Subsection "Definitions"
-.ie n .IP "\fB\fB""c""\fB\fR" 4
+.ie n .IP "\fB\f(CB""c""\fB\fR" 4
.el .IP "\fB\f(CBc\fB\fR" 4
.IX Item "c"
The literal character c (potentially a multi-byte character).
-.ie n .IP "\fB\fB""C""\fB\fR" 4
+.ie n .IP "\fB\f(CB""C""\fB\fR" 4
.el .IP "\fB\f(CBC\fB\fR" 4
.IX Item "C"
A single (required) character.
-.ie n .IP "\fB\fB""Ps""\fB\fR" 4
+.ie n .IP "\fB\f(CB""Ps""\fB\fR" 4
.el .IP "\fB\f(CBPs\fB\fR" 4
.IX Item "Ps"
A single (usually optional) numeric parameter, composed of one or more
digits.
-.ie n .IP "\fB\fB""Pm""\fB\fR" 4
+.ie n .IP "\fB\f(CB""Pm""\fB\fR" 4
.el .IP "\fB\f(CBPm\fB\fR" 4
.IX Item "Pm"
A multiple numeric parameter composed of any number of single numeric
parameters, separated by \f(CW\*(C`;\*(C'\fR character(s).
-.ie n .IP "\fB\fB""Pt""\fB\fR" 4
+.ie n .IP "\fB\f(CB""Pt""\fB\fR" 4
.el .IP "\fB\f(CBPt\fB\fR" 4
.IX Item "Pt"
A text parameter composed of printable characters.
.SS "Values"
.IX Subsection "Values"
-.ie n .IP "\fB\fB""ENQ""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ENQ""\fB\fR" 4
.el .IP "\fB\f(CBENQ\fB\fR" 4
.IX Item "ENQ"
Enquiry (Ctrl-E) = Send Device Attributes (\s-1DA\s0)
request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR.
-.ie n .IP "\fB\fB""BEL""\fB\fR" 4
+.ie n .IP "\fB\f(CB""BEL""\fB\fR" 4
.el .IP "\fB\f(CBBEL\fB\fR" 4
.IX Item "BEL"
Bell (Ctrl-G)
-.ie n .IP "\fB\fB""BS""\fB\fR" 4
+.ie n .IP "\fB\f(CB""BS""\fB\fR" 4
.el .IP "\fB\f(CBBS\fB\fR" 4
.IX Item "BS"
Backspace (Ctrl-H)
-.ie n .IP "\fB\fB""TAB""\fB\fR" 4
+.ie n .IP "\fB\f(CB""TAB""\fB\fR" 4
.el .IP "\fB\f(CBTAB\fB\fR" 4
.IX Item "TAB"
Horizontal Tab (\s-1HT\s0) (Ctrl-I)
-.ie n .IP "\fB\fB""LF""\fB\fR" 4
+.ie n .IP "\fB\f(CB""LF""\fB\fR" 4
.el .IP "\fB\f(CBLF\fB\fR" 4
.IX Item "LF"
Line Feed or New Line (\s-1NL\s0) (Ctrl-J)
-.ie n .IP "\fB\fB""VT""\fB\fR" 4
+.ie n .IP "\fB\f(CB""VT""\fB\fR" 4
.el .IP "\fB\f(CBVT\fB\fR" 4
.IX Item "VT"
Vertical Tab (Ctrl-K) same as \fB\f(CB\*(C`LF\*(C'\fB\fR
-.ie n .IP "\fB\fB""FF""\fB\fR" 4
+.ie n .IP "\fB\f(CB""FF""\fB\fR" 4
.el .IP "\fB\f(CBFF\fB\fR" 4
.IX Item "FF"
Form Feed or New Page (\s-1NP\s0) (Ctrl-L) same as \fB\f(CB\*(C`LF\*(C'\fB\fR
-.ie n .IP "\fB\fB""CR""\fB\fR" 4
+.ie n .IP "\fB\f(CB""CR""\fB\fR" 4
.el .IP "\fB\f(CBCR\fB\fR" 4
.IX Item "CR"
Carriage Return (Ctrl-M)
-.ie n .IP "\fB\fB""SO""\fB\fR" 4
+.ie n .IP "\fB\f(CB""SO""\fB\fR" 4
.el .IP "\fB\f(CBSO\fB\fR" 4
.IX Item "SO"
Shift Out (Ctrl-N), invokes the G1 character set.
Switch to Alternate Character Set
-.ie n .IP "\fB\fB""SI""\fB\fR" 4
+.ie n .IP "\fB\f(CB""SI""\fB\fR" 4
.el .IP "\fB\f(CBSI\fB\fR" 4
.IX Item "SI"
Shift In (Ctrl-O), invokes the G0 character set (the default).
Switch to Standard Character Set
-.ie n .IP "\fB\fB""SP""\fB\fR" 4
+.ie n .IP "\fB\f(CB""SP""\fB\fR" 4
.el .IP "\fB\f(CBSP\fB\fR" 4
.IX Item "SP"
Space Character
.SS "Escape Sequences"
.IX Subsection "Escape Sequences"
-.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC # 8""\fB\fR" 4
.el .IP "\fB\f(CBESC # 8\fB\fR" 4
.IX Item "ESC # 8"
\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)
-.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC 7""\fB\fR" 4
.el .IP "\fB\f(CBESC 7\fB\fR" 4
.IX Item "ESC 7"
Save Cursor (\s-1SC\s0)
-.ie n .IP "\fB\fB""ESC 8""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC 8""\fB\fR" 4
.el .IP "\fB\f(CBESC 8\fB\fR" 4
.IX Item "ESC 8"
Restore Cursor
-.ie n .IP "\fB\fB""ESC =""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC =""\fB\fR" 4
.el .IP "\fB\f(CBESC =\fB\fR" 4
.IX Item "ESC ="
Application Keypad (\s-1SMKX\s0). See also next sequence.
-.ie n .IP "\fB\fB""ESC >""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC >""\fB\fR" 4
.el .IP "\fB\f(CBESC >\fB\fR" 4
.IX Item "ESC >"
Normal Keypad (\s-1RMKX\s0)
.Sp
\&\fBNote:\fR numbers or control functions are generated by the numeric
keypad in normal or application mode, respectively (see Key Codes).
-.ie n .IP "\fB\fB""ESC D""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC D""\fB\fR" 4
.el .IP "\fB\f(CBESC D\fB\fR" 4
.IX Item "ESC D"
Index (\s-1IND\s0)
-.ie n .IP "\fB\fB""ESC E""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC E""\fB\fR" 4
.el .IP "\fB\f(CBESC E\fB\fR" 4
.IX Item "ESC E"
Next Line (\s-1NEL\s0)
-.ie n .IP "\fB\fB""ESC H""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC H""\fB\fR" 4
.el .IP "\fB\f(CBESC H\fB\fR" 4
.IX Item "ESC H"
Tab Set (\s-1HTS\s0)
-.ie n .IP "\fB\fB""ESC M""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC M""\fB\fR" 4
.el .IP "\fB\f(CBESC M\fB\fR" 4
.IX Item "ESC M"
Reverse Index (\s-1RI\s0)
-.ie n .IP "\fB\fB""ESC N""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC N""\fB\fR" 4
.el .IP "\fB\f(CBESC N\fB\fR" 4
.IX Item "ESC N"
Single Shift Select of G2 Character Set (\s-1SS2\s0): affects next character
only \fIunimplemented\fR
-.ie n .IP "\fB\fB""ESC O""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC O""\fB\fR" 4
.el .IP "\fB\f(CBESC O\fB\fR" 4
.IX Item "ESC O"
Single Shift Select of G3 Character Set (\s-1SS3\s0): affects next character
only \fIunimplemented\fR
-.ie n .IP "\fB\fB""ESC Z""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC Z""\fB\fR" 4
.el .IP "\fB\f(CBESC Z\fB\fR" 4
.IX Item "ESC Z"
Obsolete form of returns: \fB\f(CB\*(C`ESC [ ? 1 ; 2 C\*(C'\fB\fR \fIrxvt-unicode compile-time option\fR
-.ie n .IP "\fB\fB""ESC c""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC c""\fB\fR" 4
.el .IP "\fB\f(CBESC c\fB\fR" 4
.IX Item "ESC c"
Full reset (\s-1RIS\s0)
-.ie n .IP "\fB\fB""ESC n""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC n""\fB\fR" 4
.el .IP "\fB\f(CBESC n\fB\fR" 4
.IX Item "ESC n"
Invoke the G2 Character Set (\s-1LS2\s0)
-.ie n .IP "\fB\fB""ESC o""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC o""\fB\fR" 4
.el .IP "\fB\f(CBESC o\fB\fR" 4
.IX Item "ESC o"
Invoke the G3 Character Set (\s-1LS3\s0)
-.ie n .IP "\fB\fB""ESC ( C""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC ( C""\fB\fR" 4
.el .IP "\fB\f(CBESC ( C\fB\fR" 4
.IX Item "ESC ( C"
Designate G0 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR.
-.ie n .IP "\fB\fB""ESC ) C""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC ) C""\fB\fR" 4
.el .IP "\fB\f(CBESC ) C\fB\fR" 4
.IX Item "ESC ) C"
Designate G1 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR.
-.ie n .IP "\fB\fB""ESC * C""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC * C""\fB\fR" 4
.el .IP "\fB\f(CBESC * C\fB\fR" 4
.IX Item "ESC * C"
Designate G2 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR.
-.ie n .IP "\fB\fB""ESC + C""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC + C""\fB\fR" 4
.el .IP "\fB\f(CBESC + C\fB\fR" 4
.IX Item "ESC + C"
Designate G3 Character Set (\s-1ISO 2022\s0), see below for values of \f(CW\*(C`C\*(C'\fR.
-.ie n .IP "\fB\fB""ESC $ C""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC $ C""\fB\fR" 4
.el .IP "\fB\f(CBESC $ C\fB\fR" 4
.IX Item "ESC $ C"
Designate Kanji Character Set
@@ -1672,52 +1704,52 @@ C = K German character set unimplemented
.PP
.IX Xref "CSI"
-.SS "\s-1CSI \s0(Command Sequence Introducer) Sequences"
+.SS "\s-1CSI\s0 (Command Sequence Introducer) Sequences"
.IX Subsection "CSI (Command Sequence Introducer) Sequences"
-.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps @""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4
.IX Item "ESC [ Ps @"
Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)
.IX Xref "ESCOBPsA"
-.ie n .IP "\fB\fB""ESC [ Ps A""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps A""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps A\fB\fR" 4
.IX Item "ESC [ Ps A"
Cursor Up \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUU\s0)
-.ie n .IP "\fB\fB""ESC [ Ps B""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps B""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps B\fB\fR" 4
.IX Item "ESC [ Ps B"
Cursor Down \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUD\s0)
.IX Xref "ESCOBPsC"
-.ie n .IP "\fB\fB""ESC [ Ps C""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps C""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps C\fB\fR" 4
.IX Item "ESC [ Ps C"
Cursor Forward \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUF\s0)
-.ie n .IP "\fB\fB""ESC [ Ps D""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps D""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps D\fB\fR" 4
.IX Item "ESC [ Ps D"
Cursor Backward \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUB\s0)
-.ie n .IP "\fB\fB""ESC [ Ps E""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps E""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps E\fB\fR" 4
.IX Item "ESC [ Ps E"
Cursor Down \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] and to first column
-.ie n .IP "\fB\fB""ESC [ Ps F""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps F""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps F\fB\fR" 4
.IX Item "ESC [ Ps F"
Cursor Up \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] and to first column
.IX Xref "ESCOBPsG"
-.ie n .IP "\fB\fB""ESC [ Ps G""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps G""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps G\fB\fR" 4
.IX Item "ESC [ Ps G"
Cursor to Column \fB\f(CB\*(C`Ps\*(C'\fB\fR (\s-1HPA\s0)
-.ie n .IP "\fB\fB""ESC [ Ps;Ps H""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps;Ps H""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps;Ps H\fB\fR" 4
.IX Item "ESC [ Ps;Ps H"
Cursor Position [row;column] [default: 1;1] (\s-1CUP\s0)
-.ie n .IP "\fB\fB""ESC [ Ps I""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps I""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps I\fB\fR" 4
.IX Item "ESC [ Ps I"
Move forward \fB\f(CB\*(C`Ps\*(C'\fB\fR tab stops [default: 1]
-.ie n .IP "\fB\fB""ESC [ Ps J""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps J""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps J\fB\fR" 4
.IX Item "ESC [ Ps J"
Erase in Display (\s-1ED\s0)
@@ -1727,7 +1759,7 @@ Ps = 0 Clear Right and Below (default)
Ps = 1 Clear Left and Above
Ps = 2 Clear All
.TE
-.ie n .IP "\fB\fB""ESC [ Ps K""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps K""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps K\fB\fR" 4
.IX Item "ESC [ Ps K"
Erase in Line (\s-1EL\s0)
@@ -1739,24 +1771,24 @@ Ps = 2 Clear All
Ps = 3 Like Ps = 0, but is ignored when wrapped
(@@RXVT_NAME@@ extension)
.TE
-.ie n .IP "\fB\fB""ESC [ Ps L""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps L""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps L\fB\fR" 4
.IX Item "ESC [ Ps L"
Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR Line(s) [default: 1] (\s-1IL\s0)
-.ie n .IP "\fB\fB""ESC [ Ps M""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps M""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps M\fB\fR" 4
.IX Item "ESC [ Ps M"
Delete \fB\f(CB\*(C`Ps\*(C'\fB\fR Line(s) [default: 1] (\s-1DL\s0)
-.ie n .IP "\fB\fB""ESC [ Ps P""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps P""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps P\fB\fR" 4
.IX Item "ESC [ Ps P"
Delete \fB\f(CB\*(C`Ps\*(C'\fB\fR Character(s) [default: 1] (\s-1DCH\s0)
-.ie n .IP "\fB\fB""ESC [ Ps;Ps;Ps;Ps;Ps T""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps;Ps;Ps;Ps;Ps T""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps;Ps;Ps;Ps;Ps T\fB\fR" 4
.IX Item "ESC [ Ps;Ps;Ps;Ps;Ps T"
Initiate . \fIunimplemented\fR Parameters are
[func;startx;starty;firstrow;lastrow].
-.ie n .IP "\fB\fB""ESC [ Ps W""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps W""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps W\fB\fR" 4
.IX Item "ESC [ Ps W"
Tabulator functions
@@ -1766,42 +1798,42 @@ Ps = 0 Tab Set (HTS)
Ps = 2 Tab Clear (TBC), Clear Current Column (default)
Ps = 5 Tab Clear (TBC), Clear All
.TE
-.ie n .IP "\fB\fB""ESC [ Ps X""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps X""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps X\fB\fR" 4
.IX Item "ESC [ Ps X"
Erase \fB\f(CB\*(C`Ps\*(C'\fB\fR Character(s) [default: 1] (\s-1ECH\s0)
-.ie n .IP "\fB\fB""ESC [ Ps Z""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps Z""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps Z\fB\fR" 4
.IX Item "ESC [ Ps Z"
Move backward \fB\f(CB\*(C`Ps\*(C'\fB\fR [default: 1] tab stops
-.ie n .IP "\fB\fB""ESC [ Ps \*(Aq""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps \*(Aq""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps \*(Aq\fB\fR" 4
.IX Item "ESC [ Ps "
See \fB\f(CB\*(C`ESC [ Ps G\*(C'\fB\fR
-.ie n .IP "\fB\fB""ESC [ Ps a""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps a""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps a\fB\fR" 4
.IX Item "ESC [ Ps a"
See \fB\f(CB\*(C`ESC [ Ps C\*(C'\fB\fR
-.ie n .IP "\fB\fB""ESC [ Ps c""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps c""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps c\fB\fR" 4
.IX Item "ESC [ Ps c"
Send Device Attributes (\s-1DA\s0)
\&\fB\f(CB\*(C`Ps = 0\*(C'\fB\fR (or omitted): request attributes from terminal
returns: \fB\f(CB\*(C`ESC [ ? 1 ; 2 c\*(C'\fB\fR (``I am a \s-1VT100\s0 with Advanced Video
Option'')
-.ie n .IP "\fB\fB""ESC [ Ps d""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps d""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps d\fB\fR" 4
.IX Item "ESC [ Ps d"
Cursor to Line \fB\f(CB\*(C`Ps\*(C'\fB\fR (\s-1VPA\s0)
-.ie n .IP "\fB\fB""ESC [ Ps e""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps e""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps e\fB\fR" 4
.IX Item "ESC [ Ps e"
See \fB\f(CB\*(C`ESC [ Ps A\*(C'\fB\fR
-.ie n .IP "\fB\fB""ESC [ Ps;Ps f""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps;Ps f""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps;Ps f\fB\fR" 4
.IX Item "ESC [ Ps;Ps f"
Horizontal and Vertical Position [row;column] (\s-1HVP\s0) [default: 1;1]
-.ie n .IP "\fB\fB""ESC [ Ps g""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps g""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps g\fB\fR" 4
.IX Item "ESC [ Ps g"
Tab Clear (\s-1TBC\s0)
@@ -1810,11 +1842,11 @@ l l .
Ps = 0 Clear Current Column (default)
Ps = 3 Clear All (TBC)
.TE
-.ie n .IP "\fB\fB""ESC [ Pm h""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Pm h""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Pm h\fB\fR" 4
.IX Item "ESC [ Pm h"
Set Mode (\s-1SM\s0). See \fB\f(CB\*(C`ESC [ Pm l\*(C'\fB\fR sequence for description of \f(CW\*(C`Pm\*(C'\fR.
-.ie n .IP "\fB\fB""ESC [ Ps i""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps i""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps i\fB\fR" 4
.IX Item "ESC [ Ps i"
Printing. See also the \f(CW\*(C`print\-pipe\*(C'\fR resource.
@@ -1824,12 +1856,12 @@ Ps = 0 print screen (MC0)
Ps = 4 disable transparent print mode (MC4)
Ps = 5 enable transparent print mode (MC5)
.TE
-.ie n .IP "\fB\fB""ESC [ Pm l""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Pm l""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Pm l\fB\fR" 4
.IX Item "ESC [ Pm l"
Reset Mode (\s-1RM\s0)
.RS 4
-.ie n .IP "\fB\fB""Ps = 4""\fB\fR" 4
+.ie n .IP "\fB\f(CB""Ps = 4""\fB\fR" 4
.el .IP "\fB\f(CBPs = 4\fB\fR" 4
.IX Item "Ps = 4"
.TS
@@ -1838,7 +1870,7 @@ h Insert Mode (SMIR)
l Replace Mode (RMIR)
.TE
.PD 0
-.ie n .IP "\fB\fB""Ps = 20""\fB\fR (partially implemented)" 4
+.ie n .IP "\fB\f(CB""Ps = 20""\fB\fR (partially implemented)" 4
.el .IP "\fB\f(CBPs = 20\fB\fR (partially implemented)" 4
.IX Item "Ps = 20 (partially implemented)"
.TS
@@ -1849,7 +1881,7 @@ l Normal Linefeed (LNM)
.RE
.RS 4
.RE
-.ie n .IP "\fB\fB""ESC [ Pm m""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Pm m""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Pm m\fB\fR" 4
.IX Item "ESC [ Pm m"
.PD
@@ -1873,6 +1905,8 @@ Pm = 35 / 45 fg/bg Magenta
Pm = 36 / 46 fg/bg Cyan
Pm = 37 / 47 fg/bg White
Pm = 38;5 / 48;5 set fg/bg to colour #m (ISO 8613-6)
+Pm = 38;2;R;G;B set fg to 24-bit colour #RGB (ISO 8613-3)
+Pm = 48;2;R;G;B set bg to 24-bit colour #RGB (ISO 8613-3)
Pm = 39 / 49 fg/bg Default
Pm = 90 / 100 fg/bg Bright Black
Pm = 91 / 101 fg/bg Bright Red
@@ -1884,7 +1918,7 @@ Pm = 96 / 106 fg/bg Bright Cyan
Pm = 97 / 107 fg/bg Bright White
Pm = 99 / 109 fg/bg Bright Default
.TE
-.ie n .IP "\fB\fB""ESC [ Ps n""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps n""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps n\fB\fR" 4
.IX Item "ESC [ Ps n"
Device Status Report (\s-1DSR\s0)
@@ -1892,10 +1926,10 @@ Device Status Report (\s-1DSR\s0)
l l .
Ps = 5 Status Report ESC [ 0 n (``OK'')
Ps = 6 Report Cursor Position (CPR) [row;column] as ESC [ r ; c R
-Ps = 7 Request Display Name
+Ps = 7 Request Display Name (insecure mode)
Ps = 8 Request Version Number (place in window title)
.TE
-.ie n .IP "\fB\fB""ESC [ Ps SP q""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps SP q""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps SP q\fB\fR" 4
.IX Item "ESC [ Ps SP q"
Set Cursor Style (\s-1DECSCUSR\s0)
@@ -1909,16 +1943,16 @@ Ps = 4 Steady Underline
Ps = 5 Blink Bar (XTerm)
Ps = 6 Steady Bar (XTerm)
.TE
-.ie n .IP "\fB\fB""ESC [ Ps;Ps r""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps;Ps r""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps;Ps r\fB\fR" 4
.IX Item "ESC [ Ps;Ps r"
Set Scrolling Region [top;bottom]
[default: full size of window] (\s-1CSR\s0)
-.ie n .IP "\fB\fB""ESC [ s""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ s""\fB\fR" 4
.el .IP "\fB\f(CBESC [ s\fB\fR" 4
.IX Item "ESC [ s"
Save Cursor (\s-1SC\s0)
-.ie n .IP "\fB\fB""ESC [ Ps;Pt t""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps;Pt t""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps;Pt t\fB\fR" 4
.IX Item "ESC [ Ps;Pt t"
Window Operations
@@ -1937,15 +1971,15 @@ Ps = 13 Report window position (responds with Ps = 3)
Ps = 14 Report window pixel size (responds with Ps = 4)
Ps = 18 Report window text size (responds with Ps = 7)
Ps = 19 Currently the same as Ps = 18, but responds with Ps = 9
-Ps = 20 Reports icon label (ESC ] L NAME \234)
-Ps = 21 Reports window title (ESC ] l NAME \234)
+Ps = 20 Reports icon label (ESC ] L NAME \234) (insecure mode)
+Ps = 21 Reports window title (ESC ] l NAME \234) (insecure mode)
Ps = 24.. Set window height to Ps rows
.TE
-.ie n .IP "\fB\fB""ESC [ u""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ u""\fB\fR" 4
.el .IP "\fB\f(CBESC [ u\fB\fR" 4
.IX Item "ESC [ u"
Restore Cursor
-.ie n .IP "\fB\fB""ESC [ Ps x""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ Ps x""\fB\fR" 4
.el .IP "\fB\f(CBESC [ Ps x\fB\fR" 4
.IX Item "ESC [ Ps x"
Request Terminal Parameters (\s-1DECREQTPARM\s0)
@@ -1954,28 +1988,28 @@ Request Terminal Parameters (\s-1DECREQTPARM\s0)
.IX Xref "PrivateModes"
.SS "\s-1DEC\s0 Private Modes"
.IX Subsection "DEC Private Modes"
-.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ ? Pm h""\fB\fR" 4
.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4
.IX Item "ESC [ ? Pm h"
\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)
-.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ ? Pm l""\fB\fR" 4
.el .IP "\fB\f(CBESC [ ? Pm l\fB\fR" 4
.IX Item "ESC [ ? Pm l"
\&\s-1DEC\s0 Private Mode Reset (\s-1DECRST\s0)
-.ie n .IP "\fB\fB""ESC [ ? Pm r""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ ? Pm r""\fB\fR" 4
.el .IP "\fB\f(CBESC [ ? Pm r\fB\fR" 4
.IX Item "ESC [ ? Pm r"
Restore previously saved \s-1DEC\s0 Private Mode Values.
-.ie n .IP "\fB\fB""ESC [ ? Pm s""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ ? Pm s""\fB\fR" 4
.el .IP "\fB\f(CBESC [ ? Pm s\fB\fR" 4
.IX Item "ESC [ ? Pm s"
Save \s-1DEC\s0 Private Mode Values.
-.ie n .IP "\fB\fB""ESC [ ? Pm t""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC [ ? Pm t""\fB\fR" 4
.el .IP "\fB\f(CBESC [ ? Pm t\fB\fR" 4
.IX Item "ESC [ ? Pm t"
Toggle \s-1DEC\s0 Private Mode Values (rxvt extension). \fIwhere\fR
.RS 4
-.ie n .IP "\fB\fB""Pm = 1""\fB\fR (\s-1DECCKM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 1""\fB\fR (\s-1DECCKM\s0)" 4
.el .IP "\fB\f(CBPm = 1\fB\fR (\s-1DECCKM\s0)" 4
.IX Item "Pm = 1 (DECCKM)"
.TS
@@ -1984,7 +2018,7 @@ h Application Cursor Keys
l Normal Cursor Keys
.TE
.PD 0
-.ie n .IP "\fB\fB""Pm = 2""\fB\fR (\s-1DECANM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 2""\fB\fR (\s-1DECANM\s0)" 4
.el .IP "\fB\f(CBPm = 2\fB\fR (\s-1DECANM\s0)" 4
.IX Item "Pm = 2 (DECANM)"
.TS
@@ -1992,7 +2026,7 @@ l l .
h Enter VT52 mode
l Enter VT52 mode
.TE
-.ie n .IP "\fB\fB""Pm = 3""\fB\fR (\s-1DECCOLM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 3""\fB\fR (\s-1DECCOLM\s0)" 4
.el .IP "\fB\f(CBPm = 3\fB\fR (\s-1DECCOLM\s0)" 4
.IX Item "Pm = 3 (DECCOLM)"
.TS
@@ -2000,7 +2034,7 @@ l l .
h 132 Column Mode
l 80 Column Mode
.TE
-.ie n .IP "\fB\fB""Pm = 4""\fB\fR (\s-1DECSCLM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 4""\fB\fR (\s-1DECSCLM\s0)" 4
.el .IP "\fB\f(CBPm = 4\fB\fR (\s-1DECSCLM\s0)" 4
.IX Item "Pm = 4 (DECSCLM)"
.TS
@@ -2008,7 +2042,7 @@ l l .
h Smooth (Slow) Scroll
l Jump (Fast) Scroll
.TE
-.ie n .IP "\fB\fB""Pm = 5""\fB\fR (\s-1DECSCNM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 5""\fB\fR (\s-1DECSCNM\s0)" 4
.el .IP "\fB\f(CBPm = 5\fB\fR (\s-1DECSCNM\s0)" 4
.IX Item "Pm = 5 (DECSCNM)"
.TS
@@ -2016,7 +2050,7 @@ l l .
h Reverse Video
l Normal Video
.TE
-.ie n .IP "\fB\fB""Pm = 6""\fB\fR (\s-1DECOM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 6""\fB\fR (\s-1DECOM\s0)" 4
.el .IP "\fB\f(CBPm = 6\fB\fR (\s-1DECOM\s0)" 4
.IX Item "Pm = 6 (DECOM)"
.TS
@@ -2024,7 +2058,7 @@ l l .
h Origin Mode
l Normal Cursor Mode
.TE
-.ie n .IP "\fB\fB""Pm = 7""\fB\fR (\s-1DECAWM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 7""\fB\fR (\s-1DECAWM\s0)" 4
.el .IP "\fB\f(CBPm = 7\fB\fR (\s-1DECAWM\s0)" 4
.IX Item "Pm = 7 (DECAWM)"
.TS
@@ -2032,7 +2066,7 @@ l l .
h Wraparound Mode
l No Wraparound Mode
.TE
-.ie n .IP "\fB\fB""Pm = 8""\fB\fR (\s-1DECARM\s0) \fIunimplemented\fR" 4
+.ie n .IP "\fB\f(CB""Pm = 8""\fB\fR (\s-1DECARM\s0) \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 8\fB\fR (\s-1DECARM\s0) \fIunimplemented\fR" 4
.IX Item "Pm = 8 (DECARM) unimplemented"
.TS
@@ -2040,7 +2074,7 @@ l l .
h Auto-repeat Keys
l No Auto-repeat Keys
.TE
-.ie n .IP "\fB\fB""Pm = 9""\fB\fR (X10 XTerm mouse protocol)" 4
+.ie n .IP "\fB\f(CB""Pm = 9""\fB\fR (X10 XTerm mouse protocol)" 4
.el .IP "\fB\f(CBPm = 9\fB\fR (X10 XTerm mouse protocol)" 4
.IX Item "Pm = 9 (X10 XTerm mouse protocol)"
.TS
@@ -2048,7 +2082,7 @@ l l .
h Send Mouse X & Y on button press.
l No mouse reporting.
.TE
-.ie n .IP "\fB\fB""Pm = 12""\fB\fR (\s-1AT&T 610,\s0 XTerm)" 4
+.ie n .IP "\fB\f(CB""Pm = 12""\fB\fR (\s-1AT&T 610,\s0 XTerm)" 4
.el .IP "\fB\f(CBPm = 12\fB\fR (\s-1AT&T 610,\s0 XTerm)" 4
.IX Item "Pm = 12 (AT&T 610, XTerm)"
.TS
@@ -2056,7 +2090,7 @@ l l .
h Blinking cursor (cvvis)
l Steady cursor (cnorm)
.TE
-.ie n .IP "\fB\fB""Pm = 25""\fB\fR (\s-1DECTCEM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 25""\fB\fR (\s-1DECTCEM\s0)" 4
.el .IP "\fB\f(CBPm = 25\fB\fR (\s-1DECTCEM\s0)" 4
.IX Item "Pm = 25 (DECTCEM)"
.TS
@@ -2064,7 +2098,7 @@ l l .
h Visible cursor {cnorm/cvvis}
l Invisible cursor {civis}
.TE
-.ie n .IP "\fB\fB""Pm = 30""\fB\fR (\fBrxvt\fR)" 4
+.ie n .IP "\fB\f(CB""Pm = 30""\fB\fR (\fBrxvt\fR)" 4
.el .IP "\fB\f(CBPm = 30\fB\fR (\fBrxvt\fR)" 4
.IX Item "Pm = 30 (rxvt)"
.TS
@@ -2072,7 +2106,7 @@ l l .
h scrollBar visible
l scrollBar invisible
.TE
-.ie n .IP "\fB\fB""Pm = 35""\fB\fR (\fBrxvt\fR)" 4
+.ie n .IP "\fB\f(CB""Pm = 35""\fB\fR (\fBrxvt\fR)" 4
.el .IP "\fB\f(CBPm = 35\fB\fR (\fBrxvt\fR)" 4
.IX Item "Pm = 35 (rxvt)"
.TS
@@ -2080,12 +2114,12 @@ l l .
h Allow XTerm Shift+key sequences
l Disallow XTerm Shift+key sequences
.TE
-.ie n .IP "\fB\fB""Pm = 38""\fB\fR \fIunimplemented\fR" 4
+.ie n .IP "\fB\f(CB""Pm = 38""\fB\fR \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 38\fB\fR \fIunimplemented\fR" 4
.IX Item "Pm = 38 unimplemented"
.PD
Enter Tektronix Mode (\s-1DECTEK\s0)
-.ie n .IP "\fB\fB""Pm = 40""\fB\fR" 4
+.ie n .IP "\fB\f(CB""Pm = 40""\fB\fR" 4
.el .IP "\fB\f(CBPm = 40\fB\fR" 4
.IX Item "Pm = 40"
.TS
@@ -2094,7 +2128,7 @@ h Allow 80/132 Mode
l Disallow 80/132 Mode
.TE
.PD 0
-.ie n .IP "\fB\fB""Pm = 44""\fB\fR \fIunimplemented\fR" 4
+.ie n .IP "\fB\f(CB""Pm = 44""\fB\fR \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 44\fB\fR \fIunimplemented\fR" 4
.IX Item "Pm = 44 unimplemented"
.TS
@@ -2102,7 +2136,7 @@ l l .
h Turn On Margin Bell
l Turn Off Margin Bell
.TE
-.ie n .IP "\fB\fB""Pm = 45""\fB\fR \fIunimplemented\fR" 4
+.ie n .IP "\fB\f(CB""Pm = 45""\fB\fR \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 45\fB\fR \fIunimplemented\fR" 4
.IX Item "Pm = 45 unimplemented"
.TS
@@ -2110,10 +2144,10 @@ l l .
h Reverse-wraparound Mode
l No Reverse-wraparound Mode
.TE
-.ie n .IP "\fB\fB""Pm = 46""\fB\fR \fIunimplemented\fR" 4
+.ie n .IP "\fB\f(CB""Pm = 46""\fB\fR \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 46\fB\fR \fIunimplemented\fR" 4
.IX Item "Pm = 46 unimplemented"
-.ie n .IP "\fB\fB""Pm = 47""\fB\fR" 4
+.ie n .IP "\fB\f(CB""Pm = 47""\fB\fR" 4
.el .IP "\fB\f(CBPm = 47\fB\fR" 4
.IX Item "Pm = 47"
.TS
@@ -2124,7 +2158,7 @@ l Use Normal Screen Buffer
.PD
.IX Xref "Priv66"
-.ie n .IP "\fB\fB""Pm = 66""\fB\fR (\s-1DECNKM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 66""\fB\fR (\s-1DECNKM\s0)" 4
.el .IP "\fB\f(CBPm = 66\fB\fR (\s-1DECNKM\s0)" 4
.IX Item "Pm = 66 (DECNKM)"
.TS
@@ -2133,7 +2167,7 @@ h Application Keypad (DECKPAM/DECPAM) == ESC =
l Normal Keypad (DECKPNM/DECPNM) == ESC >
.TE
.PD 0
-.ie n .IP "\fB\fB""Pm = 67""\fB\fR (\s-1DECBKM\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 67""\fB\fR (\s-1DECBKM\s0)" 4
.el .IP "\fB\f(CBPm = 67\fB\fR (\s-1DECBKM\s0)" 4
.IX Item "Pm = 67 (DECBKM)"
.TS
@@ -2141,7 +2175,7 @@ l l .
h Backspace key sends BS
l Backspace key sends DEL
.TE
-.ie n .IP "\fB\fB""Pm = 1000""\fB\fR (X11 XTerm mouse protocol)" 4
+.ie n .IP "\fB\f(CB""Pm = 1000""\fB\fR (X11 XTerm mouse protocol)" 4
.el .IP "\fB\f(CBPm = 1000\fB\fR (X11 XTerm mouse protocol)" 4
.IX Item "Pm = 1000 (X11 XTerm mouse protocol)"
.TS
@@ -2149,7 +2183,7 @@ l l .
h Send Mouse X & Y on button press and release.
l No mouse reporting.
.TE
-.ie n .IP "\fB\fB""Pm = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
+.ie n .IP "\fB\f(CB""Pm = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
.el .IP "\fB\f(CBPm = 1001\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
.IX Item "Pm = 1001 (X11 XTerm) unimplemented"
.TS
@@ -2157,7 +2191,7 @@ l l .
h Use Hilite Mouse Tracking.
l No mouse reporting.
.TE
-.ie n .IP "\fB\fB""Pm = 1002""\fB\fR (X11 XTerm cell motion mouse tracking)" 4
+.ie n .IP "\fB\f(CB""Pm = 1002""\fB\fR (X11 XTerm cell motion mouse tracking)" 4
.el .IP "\fB\f(CBPm = 1002\fB\fR (X11 XTerm cell motion mouse tracking)" 4
.IX Item "Pm = 1002 (X11 XTerm cell motion mouse tracking)"
.TS
@@ -2165,7 +2199,7 @@ l l .
h Send Mouse X & Y on button press and release, and motion with a button pressed.
l No mouse reporting.
.TE
-.ie n .IP "\fB\fB""Pm = 1003""\fB\fR (X11 XTerm all motion mouse tracking)" 4
+.ie n .IP "\fB\f(CB""Pm = 1003""\fB\fR (X11 XTerm all motion mouse tracking)" 4
.el .IP "\fB\f(CBPm = 1003\fB\fR (X11 XTerm all motion mouse tracking)" 4
.IX Item "Pm = 1003 (X11 XTerm all motion mouse tracking)"
.TS
@@ -2173,28 +2207,37 @@ l l .
h Send Mouse X & Y on button press and release, and motion.
l No mouse reporting.
.TE
-.ie n .IP "\fB\fB""Pm = 1004""\fB\fR (X11 XTerm focus in/focus out events) \fIunimplemented\fR" 4
-.el .IP "\fB\f(CBPm = 1004\fB\fR (X11 XTerm focus in/focus out events) \fIunimplemented\fR" 4
-.IX Item "Pm = 1004 (X11 XTerm focus in/focus out events) unimplemented"
+.ie n .IP "\fB\f(CB""Pm = 1004""\fB\fR (X11 XTerm focus in/focus out events)" 4
+.el .IP "\fB\f(CBPm = 1004\fB\fR (X11 XTerm focus in/focus out events)" 4
+.IX Item "Pm = 1004 (X11 XTerm focus in/focus out events)"
.TS
l l .
h Send Mouse focus in/focus out events.
-l Don'T send focus events.
+l Don't send focus events.
.TE
-.ie n .IP "\fB\fB""Pm = 1005""\fB\fR (X11 XTerm \s-1UTF\-8\s0 mouse mode) (Compile frills)" 4
+.ie n .IP "\fB\f(CB""Pm = 1005""\fB\fR (X11 XTerm \s-1UTF\-8\s0 mouse mode) (Compile frills)" 4
.el .IP "\fB\f(CBPm = 1005\fB\fR (X11 XTerm \s-1UTF\-8\s0 mouse mode) (Compile frills)" 4
.IX Item "Pm = 1005 (X11 XTerm UTF-8 mouse mode) (Compile frills)"
.PD
Try to avoid this mode, it doesn't work sensibly in non\-UTF\-8 locales. Use
mode \f(CW1015\fR instead.
.Sp
-Unlike XTerm, coordinates larger than 2015) will work fine.
+Unlike XTerm, coordinates larger than 2015 will work fine.
.TS
l l .
h Enable mouse coordinates in locale-specific encoding.
-l Enable mouse coordinates as binary octets.
+l Disable mouse coordinates in locale-specific encoding.
.TE
-.ie n .IP "\fB\fB""Pm = 1010""\fB\fR (\fBrxvt\fR)" 4
+.ie n .IP "\fB\f(CB""Pm = 1006""\fB\fR (X11 XTerm \s-1SGR\s0 mouse mode) (Compile frills)" 4
+.el .IP "\fB\f(CBPm = 1006\fB\fR (X11 XTerm \s-1SGR\s0 mouse mode) (Compile frills)" 4
+.IX Item "Pm = 1006 (X11 XTerm SGR mouse mode) (Compile frills)"
+.TS
+l l .
+h Enable xterm SGR mouse coordinate reporting.
+l Disable xterm SGR mouse coordinate reporting.
+.TE
+.PD 0
+.ie n .IP "\fB\f(CB""Pm = 1010""\fB\fR (\fBrxvt\fR)" 4
.el .IP "\fB\f(CBPm = 1010\fB\fR (\fBrxvt\fR)" 4
.IX Item "Pm = 1010 (rxvt)"
.TS
@@ -2202,8 +2245,7 @@ l l .
h Don't scroll to bottom on TTY output
l Scroll to bottom on TTY output
.TE
-.PD 0
-.ie n .IP "\fB\fB""Pm = 1011""\fB\fR (\fBrxvt\fR)" 4
+.ie n .IP "\fB\f(CB""Pm = 1011""\fB\fR (\fBrxvt\fR)" 4
.el .IP "\fB\f(CBPm = 1011\fB\fR (\fBrxvt\fR)" 4
.IX Item "Pm = 1011 (rxvt)"
.TS
@@ -2211,50 +2253,15 @@ l l .
h Scroll to bottom when a key is pressed
l Don't scroll to bottom when a key is pressed
.TE
-.ie n .IP "\fB\fB""Pm = 1015""\fB\fR (\fBrxvt-unicode\fR) (Compile frills)" 4
+.ie n .IP "\fB\f(CB""Pm = 1015""\fB\fR (\fBrxvt-unicode\fR) (Compile frills)" 4
.el .IP "\fB\f(CBPm = 1015\fB\fR (\fBrxvt-unicode\fR) (Compile frills)" 4
.IX Item "Pm = 1015 (rxvt-unicode) (Compile frills)"
.TS
l l .
h Enable urxvt mouse coordinate reporting.
-l Use old-style CSI M C C C encoding.
+l Disable urxvt mouse coordinate reporting.
.TE
-.PD
-Changes all mouse reporting codes to use decimal parameters instead of
-octets or characters.
-.Sp
-This mode should be enabled \fIbefore\fR actually enabling mouse reporting,
-for semi-obvious reasons.
-.Sp
-The sequences received for various modes are as follows:
-.Sp
-.Vb 3
-\& ESC [ M o o o !1005, !1015 (three octets)
-\& ESC [ M c c c 1005, !1015 (three characters)
-\& ESC [ Pm M 1015 (three or more numeric parameters)
-.Ve
-.Sp
-The first three parameters are \f(CW\*(C`code\*(C'\fR, \f(CW\*(C`x\*(C'\fR and \f(CW\*(C`y\*(C'\fR. Code is the numeric
-code as for the other modes (but encoded as a decimal number, including
-the additional offset of 32, so you have to subtract 32 first), \f(CW\*(C`x\*(C'\fR and
-\&\f(CW\*(C`y\*(C'\fR are the coordinates (1|1 is the upper left corner, just as with
-cursor positioning).
-.Sp
-Example: Shift\-Button\-1 press at top row, column 80.
-.Sp
-.Vb 1
-\& ESC [ 37 ; 80 ; 1 M
-.Ve
-.Sp
-One can use this feature by simply enabling it and then looking for
-parameters to the \f(CW\*(C`ESC [ M\*(C'\fR reply \- if there are any, this mode is
-active, otherwise one of the old reporting styles is used.
-.Sp
-Other (to be implemented) reply sequences will use a similar encoding.
-.Sp
-In the future, more parameters might get added (pixel coordinates for
-example \- anybody out there who needs this?).
-.ie n .IP "\fB\fB""Pm = 1021""\fB\fR (\fBrxvt\fR)" 4
+.ie n .IP "\fB\f(CB""Pm = 1021""\fB\fR (\fBrxvt\fR)" 4
.el .IP "\fB\f(CBPm = 1021\fB\fR (\fBrxvt\fR)" 4
.IX Item "Pm = 1021 (rxvt)"
.TS
@@ -2262,8 +2269,7 @@ l l .
h Bold/italic implies high intensity (see option -is)
l Font styles have no effect on intensity (Compile styles)
.TE
-.PD 0
-.ie n .IP "\fB\fB""Pm = 1047""\fB\fR (X11 XTerm alternate screen buffer)" 4
+.ie n .IP "\fB\f(CB""Pm = 1047""\fB\fR (X11 XTerm alternate screen buffer)" 4
.el .IP "\fB\f(CBPm = 1047\fB\fR (X11 XTerm alternate screen buffer)" 4
.IX Item "Pm = 1047 (X11 XTerm alternate screen buffer)"
.TS
@@ -2271,7 +2277,7 @@ l l .
h Use Alternate Screen Buffer
l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
.TE
-.ie n .IP "\fB\fB""Pm = 1048""\fB\fR (X11 XTerm alternate \s-1DECSC\s0)" 4
+.ie n .IP "\fB\f(CB""Pm = 1048""\fB\fR (X11 XTerm alternate \s-1DECSC\s0)" 4
.el .IP "\fB\f(CBPm = 1048\fB\fR (X11 XTerm alternate \s-1DECSC\s0)" 4
.IX Item "Pm = 1048 (X11 XTerm alternate DECSC)"
.TS
@@ -2279,7 +2285,7 @@ l l .
h Save cursor position
l Restore cursor position
.TE
-.ie n .IP "\fB\fB""Pm = 1049""\fB\fR (X11 XTerm 1047 + 1048)" 4
+.ie n .IP "\fB\f(CB""Pm = 1049""\fB\fR (X11 XTerm 1047 + 1048)" 4
.el .IP "\fB\f(CBPm = 1049\fB\fR (X11 XTerm 1047 + 1048)" 4
.IX Item "Pm = 1049 (X11 XTerm 1047 + 1048)"
.TS
@@ -2287,7 +2293,7 @@ l l .
h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
l Use Normal Screen Buffer
.TE
-.ie n .IP "\fB\fB""Pm = 2004""\fB\fR (X11 XTerm bracketed paste mode)" 4
+.ie n .IP "\fB\f(CB""Pm = 2004""\fB\fR (X11 XTerm bracketed paste mode)" 4
.el .IP "\fB\f(CBPm = 2004\fB\fR (X11 XTerm bracketed paste mode)" 4
.IX Item "Pm = 2004 (X11 XTerm bracketed paste mode)"
.TS
@@ -2304,18 +2310,21 @@ l Disable bracketed paste mode
.IX Xref "XTerm"
.SS "XTerm Operating System Commands"
.IX Subsection "XTerm Operating System Commands"
-.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4
+.ie n .IP "\fB\f(CB""ESC ] Ps;Pt ST""\fB\fR" 4
.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4
.IX Item "ESC ] Ps;Pt ST"
Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,
-0x5c), backwards compatible terminator \s-1BEL \s0(0x07) is also accepted. any
-\&\fBoctet\fR can be escaped by prefixing it with \s-1SYN \s0(0x16, ^V).
+0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any
+\&\fBoctet\fR can be escaped by prefixing it with \s-1SYN\s0 (0x16, ^V).
+.Sp
+Many of these settings can be queried by specifying \f(CW\*(C`?\*(C'\fR as parameter, but
+this requires insecure mode to be enabled for most of these.
.TS
l l .
Ps = 0 Change Icon Name and Window Title to Pt
Ps = 1 Change Icon Name to Pt
Ps = 2 Change Window Title to Pt
-Ps = 3 If Pt starts with a ?, query the (STRING) property of the window and return it. If Pt contains a =, set the named property to the given value, else delete the specified property.
+Ps = 3 If Pt starts with a ?, query the (STRING) property of the window and return it (insecure mode). If Pt contains a =, set the named property to the given value, else delete the specified property.
Ps = 4 Pt is a semi-colon separated sequence of one or more semi-colon separated number/name pairs, where number is an index to a colour and name is the name of a colour. Each pair causes the numbered colour to be changed to name. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white
Ps = 10 Change colour of text foreground to Pt
Ps = 11 Change colour of text background to Pt
@@ -2323,16 +2332,16 @@ Ps = 12 Change colour of text cursor foreground to Pt
Ps = 13 Change colour of mouse foreground to Pt
Ps = 17 Change background colour of highlight characters to Pt
Ps = 19 Change foreground colour of highlight characters to Pt
-Ps = 20 Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile pixbuf).
+Ps = 20 Change background image to Pt (see the urxvt-background) extension documentation)
Ps = 39 Change default foreground colour to Pt. [deprecated, use 10]
Ps = 46 Change Log File to Pt unimplemented
Ps = 49 Change default background colour to Pt. [deprecated, use 11]
Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n
Ps = 55 Log all scrollback buffer and all of screen to Pt [disabled]
-Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
+Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (insecure mode, Compile frills).
Ps = 702 Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST.
Ps = 704 Change colour of italic characters to Pt
-Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
+Ps = 705 Change background tint color to Pt (see the urxvt-background) extension documentation)
Ps = 706 Change colour of bold characters to Pt
Ps = 707 Change colour of underlined characters to Pt
Ps = 708 Change colour of the border to Pt
@@ -2344,34 +2353,20 @@ Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt =
Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
.TE
-.SH "BACKGROUND IMAGE"
-.IX Header "BACKGROUND IMAGE"
-For the \s-1BACKGROUND IMAGE\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR the value
-of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be one of the following commands:
-.ie n .IP "\fB\fB""?""\fB\fR" 4
-.el .IP "\fB\f(CB?\fB\fR" 4
-.IX Item "?"
-display scale and position in the title
-.ie n .IP "\fB\fB"";WxH+X+Y""\fB\fR" 4
-.el .IP "\fB\f(CB;WxH+X+Y\fB\fR" 4
-.IX Item ";WxH+X+Y"
-change scale and/or position
-.ie n .IP "\fB\fB""FILE;WxH+X+Y""\fB\fR" 4
-.el .IP "\fB\f(CBFILE;WxH+X+Y\fB\fR" 4
-.IX Item "FILE;WxH+X+Y"
-change background image
.PP
.IX Xref "Mouse"
.SH "Mouse Reporting"
.IX Header "Mouse Reporting"
-.ie n .IP "\fB\fB""ESC [ M ""\fB\fR" 4
+When mouse reporting is enabled and none of the extended mouse modes
+(1005, 1006, 1015) is active, urxvt sends the following sequence on a
+mouse event:
+.ie n .IP "\fB\f(CB""ESC [ M ""\fB\fR" 4
.el .IP "\fB\f(CBESC [ M \fB\fR" 4
.IX Item "ESC [ M "
-report mouse position
.PP
The lower 2 bits of \fB\f(CB\*(C`\*(C'\fB\fR indicate the button:
-.ie n .IP "Button = \fB\fB""( \- SPACE) & 3""\fB\fR" 4
+.ie n .IP "Button = \fB\f(CB""( \- SPACE) & 3""\fB\fR" 4
.el .IP "Button = \fB\f(CB( \- SPACE) & 3\fB\fR" 4
.IX Item "Button = ( - SPACE) & 3"
.TS
@@ -2384,7 +2379,7 @@ l l .
.PP
The upper bits of \fB\f(CB\*(C`\*(C'\fB\fR indicate the modifiers when the
button was pressed and are added together (X11 mouse report only):
-.ie n .IP "State = \fB\fB""( \- SPACE) & ~3""\fB\fR" 4
+.ie n .IP "State = \fB\f(CB""( \- SPACE) & ~3""\fB\fR" 4
.el .IP "State = \fB\f(CB( \- SPACE) & ~3\fB\fR" 4
.IX Item "State = ( - SPACE) & ~3"
.TS
@@ -2396,9 +2391,80 @@ l l .
32 Double Click (rxvt extension), disabled by default
64 Button1 is actually Button4, Button2 is actually Button5 etc.
.TE
-Col = \fB\f(CB\*(C` \- SPACE\*(C'\fB\fR
-.Sp
-Row = \fB\f(CB\*(C` \- SPACE\*(C'\fB\fR
+.PP
+\&\f(CW\*(C`x\*(C'\fR and \f(CW\*(C`y\*(C'\fR encode the coordinates (1|1 is the upper left corner,
+just as with cursor positioning):
+.ie n .IP "Col = \fB\f(CB"" \- SPACE""\fB\fR" 4
+.el .IP "Col = \fB\f(CB \- SPACE\fB\fR" 4
+.IX Item "Col = - SPACE"
+.PD 0
+.ie n .IP "Row = \fB\f(CB"" \- SPACE""\fB\fR" 4
+.el .IP "Row = \fB\f(CB \- SPACE\fB\fR" 4
+.IX Item "Row = - SPACE"
+.PD
+.PP
+The parameters include an offset of 32 to ensure that they are
+printable characters.
+.PP
+Example: Shift\-Button\-1 press at top row, column 80.
+.PP
+.Vb 1
+\& ESC [ M $ p !
+.Ve
+.PP
+The largest coordinate that can be represented in this encoding is
+223. The range can be extended by using one of the extended mouse
+modes, which should be enabled \fIbefore\fR enabling mouse reporting, for
+semi-obvious reasons.
+.SS "Mode 1005"
+.IX Subsection "Mode 1005"
+If mode 1005 is active, urxvt sends the sequence
+.ie n .IP "\fB\f(CB""ESC [ M ""\fB\fR" 4
+.el .IP "\fB\f(CBESC [ M \fB\fR" 4
+.IX Item "ESC [ M "
+.PP
+with the coordinates provided as characters in locale-encoding instead
+of 1 byte octets. This mode does not work sensibly in non\-UTF\-8
+locales and should therefore be avoided.
+.SS "Mode 1006"
+.IX Subsection "Mode 1006"
+If mode 1006 is active, urxvt sends the following sequences:
+.ie n .IP "\fB\f(CB""ESC [ < ;; M""\fB\fR" 4
+.el .IP "\fB\f(CBESC [ < ;; M\fB\fR" 4
+.IX Item "ESC [ < ;; M"
+button press and motion
+.ie n .IP "\fB\f(CB""ESC [ < ;; m""\fB\fR" 4
+.el .IP "\fB\f(CBESC [ < ;; m\fB\fR" 4
+.IX Item "ESC [ < ;; m"
+button release
+.PP
+where the parameters are provided as decimal numbers instead of
+octets and do not include an offset of 32.
+.PP
+The lower 2 bits of \f(CW\*(C`b\*(C'\fR encode the button number also on button
+release (instead of the value \f(CW3\fR). The final character of the
+sequence (M or m) specifies the event type (press/motion or release).
+.PP
+Example: Shift\-Button\-1 press at top row, column 80.
+.PP
+.Vb 1
+\& ESC [ < 4 ; 80 ; 1 M
+.Ve
+.SS "Mode 1015"
+.IX Subsection "Mode 1015"
+If mode 1015 is active, urxvt sends the sequence
+.ie n .IP "\fB\f(CB""ESC [ ;; M""\fB\fR" 4
+.el .IP "\fB\f(CBESC [ ;; M\fB\fR" 4
+.IX Item "ESC [ ;; M"
+.PP
+where the parameters are provided as decimal numbers instead of
+octets and only \f(CW\*(C`b\*(C'\fR includes an offset of 32.
+.PP
+Example: Shift\-Button\-1 press at top row, column 80.
+.PP
+.Vb 1
+\& ESC [ 36 ; 80 ; 1 M
+.Ve
.SH "Key Codes"
.IX Header "Key Codes"
@@ -2521,7 +2587,7 @@ kr korean encodings
.TE
.IP "\-\-enable\-xim (default: on)" 4
.IX Item "--enable-xim (default: on)"
-Add support for \s-1XIM \s0(X Input Method) protocol. This allows using
+Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using
alternative input methods (e.g. kinput2) and will also correctly
set up the input for people using dead keys or compose keys.
.IP "\-\-enable\-unicode3 (default: off)" 4
@@ -2650,8 +2716,10 @@ in combination with other switches) is:
\& compile in built\-in block graphics
\& skip builtin block graphics (\-sbg)
\& separate highlight colour (\-highlightColor, \-highlightTextColor)
-\& extended mouse reporting modes (1005 and 1015).
+\& focus reporting mode (1004).
+\& extended mouse reporting modes (1005, 1006 and 1015).
\& visual selection via \-visual and \-depth.
+\& systemd socket activation
.Ve
.Sp
It also enables some non-essential features otherwise disabled, such as:
@@ -2703,7 +2771,7 @@ Add support for blinking text.
Add support to have the pointer disappear when typing or inactive.
.IP "\-\-enable\-perl (default: on)" 4
.IX Item "--enable-perl (default: on)"
-Enable an embedded perl interpreter. See the \fB@@RXVT_NAME@@\f(BIperl\fB\|(3)\fR
+Enable an embedded perl interpreter. See the \fB@@RXVT_NAME@@\fBperl\fB\|(3)\fR
manpage for more info on this feature, or the files in \fIsrc/perl/\fR
for the extensions that are installed by default.
The perl interpreter that is used can be specified via the \f(CW\*(C`PERL\*(C'\fR
diff --git a/doc/rxvtc.1.man.in b/doc/rxvtc.1.man.in
--- a/doc/rxvtc.1.man.in
+++ b/doc/rxvtc.1.man.in
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
+.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -46,7 +46,7 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
@@ -56,12 +56,12 @@
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
-.if (\n(rF:(\n(.g==0)) \{
-. if \nF \{
+.if (\n(rF:(\n(.g==0)) \{\
+. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
-. if !\nF==2 \{
+. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 1"
-.TH @@RXVT_NAME@@ 1 "2016-01-23" "@@RXVT_VERSION@@" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 1 "2021-05-13" "@@RXVT_VERSION@@" "RXVT-UNICODE"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
diff --git a/doc/rxvtd.1.man.in b/doc/rxvtd.1.man.in
--- a/doc/rxvtd.1.man.in
+++ b/doc/rxvtd.1.man.in
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.30)
+.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
@@ -46,7 +46,7 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
-.\" If the F register is turned on, we'll generate index entries on stderr for
+.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
@@ -56,12 +56,12 @@
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
-.if (\n(rF:(\n(.g==0)) \{
-. if \nF \{
+.if (\n(rF:(\n(.g==0)) \{\
+. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
-. if !\nF==2 \{
+. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
@@ -133,7 +133,7 @@
.\" ========================================================================
.\"
.IX Title "@@RXVT_NAME@@ 1"
-.TH @@RXVT_NAME@@ 1 "2016-01-23" "@@RXVT_VERSION@@" "RXVT-UNICODE"
+.TH @@RXVT_NAME@@ 1 "2021-05-13" "@@RXVT_VERSION@@" "RXVT-UNICODE"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
@@ -186,7 +186,7 @@ This makes \fB@@RXVT_NAME@@d\fR fork after it has bound itself to its control
socket.
.IP "\fB\-m\fR, \fB\-\-mlock\fR" 4
.IX Item "-m, --mlock"
-This makes \fB@@RXVT_NAME@@d\fR call \fImlockall\fR\|(2) on itself. This locks
+This makes \fB@@RXVT_NAME@@d\fR call \fBmlockall\fR\|(2) on itself. This locks
\&\fB@@RXVT_NAME@@d\fR in \s-1RAM\s0 and prevents it from being swapped out to disk,
at the cost of consuming a lot more memory on most operating systems.
.Sp
@@ -229,6 +229,12 @@ Both \fB@@RXVT_NAME@@c\fR and \fB@@RXVT_NAME@@d\fR use the environment
variable \fI\s-1RXVT_SOCKET\s0\fR to create a listening socket and to contact
the @@RXVT_NAME@@d, respectively. If the variable is missing then
\&\fI\f(CI$HOME\fI/.urxvt/urxvtd\-\fI\fI\fR is used.
+.IP "\fB\s-1LISTEN_PID\s0\fR, \fB\s-1LISTEN_FDS\s0\fR, \fB\s-1LISTEN_FDNAMES\s0\fR" 4
+.IX Item "LISTEN_PID, LISTEN_FDS, LISTEN_FDNAMES"
+if these environment variables are set, @@RXVT_NAME@@d checks for a file
+descriptor passed by the service manager via systemd native interface. If
+one is provided, @@RXVT_NAME@@d uses it as its listening socket instead of
+creating one as specified above.
.IP "\fB\s-1DISPLAY\s0\fR" 4
.IX Item "DISPLAY"
Only used when the \f(CW\*(C`\-\-opendisplay\*(C'\fR option is specified. Must contain a
-----END OF PAGE-----