rxvt.7.man.in (rxvt-unicode-9.26.tar.bz2) | : | rxvt.7.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@@ 7" | .IX Title "@@RXVT_NAME@@ 7" | |||
.TH @@RXVT_NAME@@ 7 "2021-05-14" "@@RXVT_VERSION@@" "RXVT-UNICODE" | .TH @@RXVT_NAME@@ 7 "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 REFERENCE \- FAQ, command sequences and other background information | RXVT REFERENCE \- FAQ, command sequences and other background information | |||
.SH "SYNOPSIS" | .SH "SYNOPSIS" | |||
.IX Header "SYNOPSIS" | .IX Header "SYNOPSIS" | |||
.Vb 2 | .Vb 2 | |||
\& # set a new font set | \& # set a new font set | |||
skipping to change at line 172 | skipping to change at line 172 | |||
.PP | .PP | |||
The main manual page for @@RXVT_NAME@@ itself is available at | The main manual page for @@RXVT_NAME@@ itself is available at | |||
<http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.1.pod>. | <http://pod.tst.eu/http://cvs.schmorp.de/rxvt\-unicode/doc/rxvt.1.pod>. | |||
.SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" | .SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" | |||
.IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" | .IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" | |||
.SS "Meta, Features & Commandline Issues" | .SS "Meta, Features & Commandline Issues" | |||
.IX Subsection "Meta, Features & Commandline Issues" | .IX Subsection "Meta, Features & Commandline Issues" | |||
\fIMy question isn't answered here, can I ask a human?\fR | \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?" | .IX Subsection "My question isn't answered here, can I ask a human?" | |||
.PP | .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.libera.chat\*( C'\fR, | |||
channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be | 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 :). | interested in learning about new and exciting problems (but not FAQs :). | |||
.PP | .PP | |||
\fII use Gentoo, and I have a problem...\fR | \fII use Gentoo, and I have a problem...\fR | |||
.IX Subsection "I use Gentoo, and I have a problem..." | .IX Subsection "I use Gentoo, and I have a problem..." | |||
.PP | .PP | |||
There are two big problems with Gentoo Linux: first, most if not all | There are two big problems with Gentoo Linux: first, most if not all | |||
Gentoo systems are completely broken (missing or mismatched header | Gentoo systems are completely broken (missing or mismatched header | |||
files, broken compiler etc. are just the tip of the iceberg); | files, broken compiler etc. are just the tip of the iceberg); | |||
secondly, it should be called Gentoo GNU/Linux. | secondly, it should be called Gentoo GNU/Linux. | |||
skipping to change at line 424 | skipping to change at line 424 | |||
.IX Subsection "I can't get transparency working, what am I doing wrong?" | .IX Subsection "I can't get transparency working, what am I doing wrong?" | |||
.PP | .PP | |||
First of all, transparency isn't officially supported in rxvt-unicode, so | First of all, transparency isn't officially supported in rxvt-unicode, so | |||
you are mostly on your own. Do not bug the author about it (but you may | you are mostly on your own. Do not bug the author about it (but you may | |||
bug everybody else). Also, if you can't get it working consider it a rite | bug everybody else). Also, if you can't get it working consider it a rite | |||
of passage: ... and you failed. | of passage: ... and you failed. | |||
.PP | .PP | |||
Here are four ways to get transparency. \fBDo\fR read the manpage and option | Here are four ways to get transparency. \fBDo\fR read the manpage and option | |||
descriptions for the programs mentioned and rxvt-unicode. Really, do it! | descriptions for the programs mentioned and rxvt-unicode. Really, do it! | |||
.PP | .PP | |||
1. Use transparent mode: | 1. Use pseudo-transparency: | |||
.PP | .PP | |||
.Vb 2 | .Vb 2 | |||
\& Esetroot wallpaper.jpg | \& Esetroot wallpaper.jpg | |||
\& @@URXVT_NAME@@ \-tr \-tint red \-sh 40 | \& @@URXVT_NAME@@ \-tr \-tint red \-sh 40 | |||
.Ve | .Ve | |||
.PP | .PP | |||
That works. If you think it doesn't, you lack transparency and tinting | That works. If you think it doesn't, you lack transparency and tinting | |||
support, or you are unable to read. | support, or you are unable to read. | |||
This method requires that the background-setting program sets the | This method requires that the background-setting program sets the | |||
_XROOTPMAP_ID or \s-1ESETROOT_PMAP_ID\s0 property. Compatible programs | _XROOTPMAP_ID or \s-1ESETROOT_PMAP_ID\s0 property. Compatible programs | |||
skipping to change at line 456 | skipping to change at line 456 | |||
That works. If you think it doesn't, you lack GDK-PixBuf support, or you | That works. If you think it doesn't, you lack GDK-PixBuf support, or you | |||
are unable to read. | are unable to read. | |||
.PP | .PP | |||
3. Use an \s-1ARGB\s0 visual: | 3. Use an \s-1ARGB\s0 visual: | |||
.PP | .PP | |||
.Vb 1 | .Vb 1 | |||
\& @@URXVT_NAME@@ \-depth 32 \-fg grey90 \-bg rgba:0000/0000/4444/cccc | \& @@URXVT_NAME@@ \-depth 32 \-fg grey90 \-bg rgba:0000/0000/4444/cccc | |||
.Ve | .Ve | |||
.PP | .PP | |||
This requires \s-1XFT\s0 support, and the support of your X\-server. If that | This requires \s-1XFT\s0 support, and the support of your X\-server. If that | |||
doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't | doesn't work for you, find a working composite manager or window manager, | |||
there yet, no matter what they claim. Rxvt-Unicode contains the necessary | both are required to support \s-1ARGB\s0 visuals for client windows. | |||
bugfixes and workarounds for Xft and Xlib to make it work, but that | ||||
doesn't mean that your \s-1WM\s0 has the required kludges in place. | ||||
.PP | .PP | |||
4. Use xcompmgr and let it do the job: | 4. Use xcompmgr and let it do the job: | |||
.PP | .PP | |||
.Vb 2 | .Vb 2 | |||
\& xprop \-frame \-f _NET_WM_WINDOW_OPACITY 32c \e | \& xprop \-frame \-f _NET_WM_WINDOW_OPACITY 32c \e | |||
\& \-set _NET_WM_WINDOW_OPACITY 0xc0000000 | \& \-set _NET_WM_WINDOW_OPACITY 0xc0000000 | |||
.Ve | .Ve | |||
.PP | .PP | |||
Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR | Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR | |||
by other values to change the degree of opacity. If it doesn't work and | by other values to change the degree of opacity. If it doesn't work and | |||
skipping to change at line 1999 | skipping to change at line 1997 | |||
.SS "\s-1DEC\s0 Private Modes" | .SS "\s-1DEC\s0 Private Modes" | |||
.IX Subsection "DEC Private Modes" | .IX Subsection "DEC Private Modes" | |||
.ie n .IP "\fB\f(CB""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 | .el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4 | |||
.IX Item "ESC [ ? Pm h" | .IX Item "ESC [ ? Pm h" | |||
\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0) | \&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0) | |||
.ie n .IP "\fB\f(CB""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 | .el .IP "\fB\f(CBESC [ ? Pm l\fB\fR" 4 | |||
.IX Item "ESC [ ? Pm l" | .IX Item "ESC [ ? Pm l" | |||
\&\s-1DEC\s0 Private Mode Reset (\s-1DECRST\s0) | \&\s-1DEC\s0 Private Mode Reset (\s-1DECRST\s0) | |||
.ie n .IP "\fB\f(CB""ESC [ ? Pm $ p""\fB\fR" 4 | ||||
.el .IP "\fB\f(CBESC [ ? Pm $ p\fB\fR" 4 | ||||
.IX Item "ESC [ ? Pm $ p" | ||||
\&\s-1DEC\s0 Private Mode Request (\s-1DECRQM\s0) | ||||
.ie n .IP "\fB\f(CB""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 | .el .IP "\fB\f(CBESC [ ? Pm r\fB\fR" 4 | |||
.IX Item "ESC [ ? Pm r" | .IX Item "ESC [ ? Pm r" | |||
Restore previously saved \s-1DEC\s0 Private Mode Values. | Restore previously saved \s-1DEC\s0 Private Mode Values. | |||
.ie n .IP "\fB\f(CB""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 | .el .IP "\fB\f(CBESC [ ? Pm s\fB\fR" 4 | |||
.IX Item "ESC [ ? Pm s" | .IX Item "ESC [ ? Pm s" | |||
Save \s-1DEC\s0 Private Mode Values. | Save \s-1DEC\s0 Private Mode Values. | |||
.ie n .IP "\fB\f(CB""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 | .el .IP "\fB\f(CBESC [ ? Pm t\fB\fR" 4 | |||
.IX Item "ESC [ ? Pm t" | .IX Item "ESC [ ? Pm t" | |||
Toggle \s-1DEC\s0 Private Mode Values (rxvt extension). \fIwhere\fR | Toggle \s-1DEC\s0 Private Mode Values (rxvt extension). | |||
.RS 4 | .PP | |||
where | ||||
.ie n .IP "\fB\f(CB""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 | .el .IP "\fB\f(CBPm = 1\fB\fR (\s-1DECCKM\s0)" 4 | |||
.IX Item "Pm = 1 (DECCKM)" | .IX Item "Pm = 1 (DECCKM)" | |||
.TS | .TS | |||
l l . | l l . | |||
h Application Cursor Keys | h Application Cursor Keys | |||
l Normal Cursor Keys | l Normal Cursor Keys | |||
.TE | .TE | |||
.PD 0 | .PD 0 | |||
.ie n .IP "\fB\f(CB""Pm = 2""\fB\fR (\s-1DECANM\s0)" 4 | .ie n .IP "\fB\f(CB""Pm = 2""\fB\fR (\s-1DECANM\s0)" 4 | |||
skipping to change at line 2304 | skipping to change at line 2307 | |||
l Use Normal Screen Buffer | l Use Normal Screen Buffer | |||
.TE | .TE | |||
.ie n .IP "\fB\f(CB""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 | .el .IP "\fB\f(CBPm = 2004\fB\fR (X11 XTerm bracketed paste mode)" 4 | |||
.IX Item "Pm = 2004 (X11 XTerm bracketed paste mode)" | .IX Item "Pm = 2004 (X11 XTerm bracketed paste mode)" | |||
.TS | .TS | |||
l l . | l l . | |||
h Enable bracketed paste mode - prepend / append to the pasted text the con trol sequences ESC [ 200 ~ / ESC [ 201 ~ | h Enable bracketed paste mode - prepend / append to the pasted text the con trol sequences ESC [ 200 ~ / ESC [ 201 ~ | |||
l Disable bracketed paste mode | l Disable bracketed paste mode | |||
.TE | .TE | |||
.RE | ||||
.RS 4 | ||||
.RE | ||||
.PD | .PD | |||
.PP | .PP | |||
.IX Xref "XTerm" | .IX Xref "XTerm" | |||
.SS "XTerm Operating System Commands" | .SS "XTerm Operating System Commands" | |||
.IX Subsection "XTerm Operating System Commands" | .IX Subsection "XTerm Operating System Commands" | |||
.ie n .IP "\fB\f(CB""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 | .el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4 | |||
.IX Item "ESC ] Ps;Pt ST" | .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, | Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC \s0 \e (0x1b, | |||
skipping to change at line 2335 | skipping to change at line 2335 | |||
Ps = 1 Change Icon Name to Pt | Ps = 1 Change Icon Name to Pt | |||
Ps = 2 Change Window Title to Pt | Ps = 2 Change Window Title to Pt | |||
Ps = 3 If Pt starts with a ?, query the (STRING) property of the window and retu rn it (insecure mode). If Pt contains a =, set the named property to the given v alue, else delete the specified property. | Ps = 3 If Pt starts with a ?, query the (STRING) property of the window and retu rn it (insecure mode). If Pt contains a =, set the named property to the given v alue, 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-in tensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7 =white | 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-in tensity 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 = 10 Change colour of text foreground to Pt | |||
Ps = 11 Change colour of text background to Pt | Ps = 11 Change colour of text background to Pt | |||
Ps = 12 Change colour of text cursor foreground to Pt | Ps = 12 Change colour of text cursor foreground to Pt | |||
Ps = 13 Change colour of mouse foreground to Pt | Ps = 13 Change colour of mouse foreground to Pt | |||
Ps = 17 Change background colour of highlight characters to Pt | Ps = 17 Change background colour of highlight characters to Pt | |||
Ps = 19 Change foreground colour of highlight characters to Pt | Ps = 19 Change foreground colour of highlight characters to Pt | |||
Ps = 20 Change background image to Pt (see the urxvt-background) extensio n documentation) | 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 = 39 Change default foreground colour to Pt. [deprecated, use 10] | |||
Ps = 46 Change Log File to Pt unimplemented | Ps = 46 Change Log File to Pt unimplemented | |||
Ps = 49 Change default background colour to Pt. [deprecated, use 11] | 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 em pty change to font0 n change to font n | 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 em pty change to font0 n change to font n | |||
Ps = 55 Log all scrollback buffer and all of screen to Pt [disabled] | 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 l ocale (insecure mode, Compile frills). | Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current l ocale (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 = 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 = 704 Change colour of italic characters to Pt | |||
Ps = 705 Change background tint color to Pt (see the urxvt-background) ext ension documentation) | Ps = 705 Change background tint color to Pt (see the urxvt-background exte nsion documentation) | |||
Ps = 706 Change colour of bold characters to Pt | Ps = 706 Change colour of bold characters to Pt | |||
Ps = 707 Change colour of underlined characters to Pt | Ps = 707 Change colour of underlined characters to Pt | |||
Ps = 708 Change colour of the border to Pt | Ps = 708 Change colour of the border to Pt | |||
Ps = 710 Set normal fontset to Pt. Same as Ps = 50. | Ps = 710 Set normal fontset to Pt. Same as Ps = 50. | |||
Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles). | Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles). | |||
Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles). | Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles). | |||
Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles ). | Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles ). | |||
Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). | Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). | |||
Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). | 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 | Ps = 776 (urxvt 9.29) Returns info about the character cell size, replies | |||
the form extension:parameters (Compile perl). | with ESC ] 776 ; cell-width ; cell-height ; font-ascent ST | |||
Ps = 777 Call the perl extension with the given string, which should be of | ||||
the form extension;parameters (Compile perl). | ||||
.TE | .TE | |||
.PP | .PP | |||
.IX Xref "Mouse" | .IX Xref "Mouse" | |||
.SH "Mouse Reporting" | .SH "Mouse Reporting" | |||
.IX Header "Mouse Reporting" | .IX Header "Mouse Reporting" | |||
When mouse reporting is enabled and none of the extended mouse modes | When mouse reporting is enabled and none of the extended mouse modes | |||
(1005, 1006, 1015) is active, urxvt sends the following sequence on a | (1005, 1006, 1015) is active, urxvt sends the following sequence on a | |||
mouse event: | mouse event: | |||
.ie n .IP "\fB\f(CB""ESC [ M <b> <x> <y>""\fB\fR" 4 | .ie n .IP "\fB\f(CB""ESC [ M <b> <x> <y>""\fB\fR" 4 | |||
skipping to change at line 2595 | skipping to change at line 2596 | |||
jp_ext rarely used but big japanese encodings | jp_ext rarely used but big japanese encodings | |||
kr korean encodings | kr korean encodings | |||
.TE | .TE | |||
.IP "\-\-enable\-xim (default: on)" 4 | .IP "\-\-enable\-xim (default: on)" 4 | |||
.IX Item "--enable-xim (default: on)" | .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 | alternative input methods (e.g. kinput2) and will also correctly | |||
set up the input for people using dead keys or compose keys. | set up the input for people using dead keys or compose keys. | |||
.IP "\-\-enable\-unicode3 (default: off)" 4 | .IP "\-\-enable\-unicode3 (default: off)" 4 | |||
.IX Item "--enable-unicode3 (default: off)" | .IX Item "--enable-unicode3 (default: off)" | |||
Recommended to stay off unless you really need non-BMP characters. | Recommended to stay off unless you really need a lot of non-BMP | |||
characters. | ||||
.Sp | .Sp | |||
Enable direct support for displaying unicode codepoints above | Enable support for direct storage of unicode characters above 65535 | |||
65535 (the basic multilingual page). This increases storage | (the basic multilingual page). This increases storage requirements per | |||
requirements per character from 2 to 4 bytes. X11 fonts do not yet | character from 2 to 4 bytes. X11 fonts do not yet support these extra | |||
support these extra characters, but Xft does. | characters, but Xft does. | |||
.Sp | .Sp | |||
Please note that rxvt-unicode can store unicode code points >65535 | Please note that rxvt-unicode can store and display unicode characters | |||
even without this flag, but the number of such characters is | above 65535 even without this flag, but the number of such characters is | |||
limited to a few thousand (shared with combining characters, | limited to a few thousand (shared with combining characters, see next | |||
see next switch), and right now rxvt-unicode cannot display them | switch). | |||
(input/output and cut&paste still work, though). | ||||
.IP "\-\-enable\-combining (default: on)" 4 | .IP "\-\-enable\-combining (default: on)" 4 | |||
.IX Item "--enable-combining (default: on)" | .IX Item "--enable-combining (default: on)" | |||
Enable automatic composition of combining characters into | Enable automatic composition of combining characters into | |||
composite characters. This is required for proper viewing of text | composite characters. This is required for proper viewing of text | |||
where accents are encoded as separate unicode characters. This is | where accents are encoded as separate unicode characters. This is | |||
done by using precomposed characters when available or creating | done by using precomposed characters when available or creating | |||
new pseudo-characters when no precomposed form exists. | new pseudo-characters when no precomposed form exists. | |||
.Sp | .Sp | |||
Without \-\-enable\-unicode3, the number of additional precomposed | Without \-\-enable\-unicode3, the number of additional precomposed | |||
characters is somewhat limited (the 6400 private use characters will be | characters is somewhat limited (the 6400 private use characters will be | |||
skipping to change at line 2638 | skipping to change at line 2639 | |||
disable resource fallback use \-\-disable\-fallback. | disable resource fallback use \-\-disable\-fallback. | |||
.IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 | .IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 | |||
.IX Item "--with-res-name=NAME (default: urxvt)" | .IX Item "--with-res-name=NAME (default: urxvt)" | |||
Use the given name as default application name when | Use the given name as default application name when | |||
reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt. | reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt. | |||
.IP "\-\-with\-res\-class=CLASS (default: URxvt)" 4 | .IP "\-\-with\-res\-class=CLASS (default: URxvt)" 4 | |||
.IX Item "--with-res-class=CLASS (default: URxvt)" | .IX Item "--with-res-class=CLASS (default: URxvt)" | |||
Use the given class as default application class | Use the given class as default application class | |||
when reading resources. Specify \-\-with\-res\-class=Rxvt to replace | when reading resources. Specify \-\-with\-res\-class=Rxvt to replace | |||
rxvt. | rxvt. | |||
.IP "\-\-enable\-utmp (default: on)" 4 | ||||
.IX Item "--enable-utmp (default: on)" | ||||
Write user and tty to utmp file (used by programs like \fIw\fR) at | ||||
start of rxvt execution and delete information when rxvt exits. | ||||
.IP "\-\-enable\-wtmp (default: on)" 4 | ||||
.IX Item "--enable-wtmp (default: on)" | ||||
Write user and tty to wtmp file (used by programs like \fIlast\fR) at | ||||
start of rxvt execution and write logout when rxvt exits. This | ||||
option requires \-\-enable\-utmp to also be specified. | ||||
.IP "\-\-enable\-lastlog (default: on)" 4 | ||||
.IX Item "--enable-lastlog (default: on)" | ||||
Write user and tty to lastlog file (used by programs like | ||||
\&\fIlastlogin\fR) at start of rxvt execution. This option requires | ||||
\&\-\-enable\-utmp to also be specified. | ||||
.IP "\-\-enable\-pixbuf (default: on)" 4 | .IP "\-\-enable\-pixbuf (default: on)" 4 | |||
.IX Item "--enable-pixbuf (default: on)" | .IX Item "--enable-pixbuf (default: on)" | |||
Add support for GDK-PixBuf to be used for background images. | Add support for GDK-PixBuf to be used for background images. | |||
It adds support for many file formats including \s-1JPG, PNG, | It adds support for many file formats including \s-1JPG, PNG, | |||
TIFF, GIF, XPM, BMP, ICO\s0 and \s-1TGA.\s0 | TIFF, GIF, XPM, BMP, ICO\s0 and \s-1TGA.\s0 | |||
.IP "\-\-enable\-startup\-notification (default: on)" 4 | .IP "\-\-enable\-startup\-notification (default: on)" 4 | |||
.IX Item "--enable-startup-notification (default: on)" | .IX Item "--enable-startup-notification (default: on)" | |||
Add support for freedesktop startup notifications. This allows window managers | Add support for freedesktop startup notifications. This allows window managers | |||
to display some kind of progress indicator during startup. | to display some kind of progress indicator during startup. | |||
.IP "\-\-enable\-transparency (default: on)" 4 | .IP "\-\-enable\-transparency (default: on)" 4 | |||
skipping to change at line 2723 | skipping to change at line 2710 | |||
\& XEmbed support (\-embed) | \& XEmbed support (\-embed) | |||
\& user\-pty (\-pty\-fd) | \& user\-pty (\-pty\-fd) | |||
\& hold on exit (\-hold) | \& hold on exit (\-hold) | |||
\& compile in built\-in block graphics | \& compile in built\-in block graphics | |||
\& skip builtin block graphics (\-sbg) | \& skip builtin block graphics (\-sbg) | |||
\& separate highlight colour (\-highlightColor, \-highlightTextColor) | \& separate highlight colour (\-highlightColor, \-highlightTextColor) | |||
\& focus reporting mode (1004). | \& focus reporting mode (1004). | |||
\& extended mouse reporting modes (1005, 1006 and 1015). | \& extended mouse reporting modes (1005, 1006 and 1015). | |||
\& visual selection via \-visual and \-depth. | \& visual selection via \-visual and \-depth. | |||
\& systemd socket activation | \& systemd socket activation | |||
\& selectable rewrapmode | ||||
\& bracketed paste mode | ||||
.Ve | .Ve | |||
.Sp | .Sp | |||
It also enables some non-essential features otherwise disabled, such as: | It also enables some non-essential features otherwise disabled, such as: | |||
.Sp | .Sp | |||
.Vb 11 | .Vb 11 | |||
\& some round\-trip time optimisations | \& some round\-trip time optimisations | |||
\& nearest colour allocation on pseudocolor screens | \& nearest colour allocation on pseudocolor screens | |||
\& UTF8_STRING support for selection | \& UTF8_STRING support for selection | |||
\& sgr modes 90..97 and 100..107 | \& sgr modes 90..97 and 100..107 | |||
\& backindex and forwardindex escape sequences | \& backindex and forwardindex escape sequences | |||
skipping to change at line 2805 | skipping to change at line 2794 | |||
.Sp | .Sp | |||
It also results in higher memory usage and can slow down @@RXVT_NAME@@ | It also results in higher memory usage and can slow down @@RXVT_NAME@@ | |||
dramatically when more than six fonts are in use by a terminal instance. | dramatically when more than six fonts are in use by a terminal instance. | |||
.IP "\-\-with\-name=NAME (default: urxvt)" 4 | .IP "\-\-with\-name=NAME (default: urxvt)" 4 | |||
.IX Item "--with-name=NAME (default: urxvt)" | .IX Item "--with-name=NAME (default: urxvt)" | |||
Set the basename for the installed binaries, resulting | Set the basename for the installed binaries, resulting | |||
in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\- \-with\-name=rxvt\*(C'\fR to replace with | in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\- \-with\-name=rxvt\*(C'\fR to replace with | |||
\&\f(CW\*(C`rxvt\*(C'\fR. | \&\f(CW\*(C`rxvt\*(C'\fR. | |||
.IP "\-\-with\-term=NAME (default: rxvt-unicode)" 4 | .IP "\-\-with\-term=NAME (default: rxvt-unicode)" 4 | |||
.IX Item "--with-term=NAME (default: rxvt-unicode)" | .IX Item "--with-term=NAME (default: rxvt-unicode)" | |||
Change the environmental variable for the terminal to \s-1NAME.\s0 | Sets the default \f(CW\*(C`TERM\*(C'\fR value that @@RXVT_NAME@@ sets. The defau | |||
lt is | ||||
either \f(CW\*(C`rxvt\-unicode\*(C'\fR or \f(CW\*(C`rxvt\-unicode\-256color\*(C' | ||||
\fR, as appropriate. | ||||
.IP "\-\-with\-terminfo=PATH" 4 | .IP "\-\-with\-terminfo=PATH" 4 | |||
.IX Item "--with-terminfo=PATH" | .IX Item "--with-terminfo=PATH" | |||
Change the environmental variable for the path to the terminfo tree to | If set, @@RXVT_NAME@@ will set the environment variable \f(CW\*(C`TERMINFO\*(C'\ | |||
\&\s-1PATH.\s0 | fR to | |||
the given \s-1PATH,\s0 which can be useful as a last resort if installing the | ||||
terminfo entries system-wide is not possible. | ||||
.IP "\-\-with\-x" 4 | .IP "\-\-with\-x" 4 | |||
.IX Item "--with-x" | .IX Item "--with-x" | |||
Use the X Window System (pretty much default, eh?). | Use the X Window System (pretty much default, eh?). | |||
.SH "AUTHORS" | .SH "AUTHORS" | |||
.IX Header "AUTHORS" | .IX Header "AUTHORS" | |||
Marc Lehmann <rxvt@schmorp.de> converted this document to pod and | Marc Lehmann <rxvt@schmorp.de> converted this document to pod and | |||
reworked it from the original Rxvt documentation, which was done by Geoff | reworked it from the original Rxvt documentation, which was done by Geoff | |||
Wing <gcw@pobox.com>, who in turn used the XTerm documentation and other | Wing <gcw@pobox.com>, who in turn used the XTerm documentation and other | |||
sources. | sources. | |||
End of changes. 18 change blocks. | ||||
44 lines changed or deleted | 39 lines changed or added |