"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/rxvt.7.pod" between
rxvt-unicode-9.26.tar.bz2 and rxvt-unicode-9.29.tar.bz2

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

rxvt.7.pod  (rxvt-unicode-9.26.tar.bz2):rxvt.7.pod  (rxvt-unicode-9.29.tar.bz2)
skipping to change at line 33 skipping to change at line 33
The main manual page for @@RXVT_NAME@@ itself is available at The main manual page for @@RXVT_NAME@@ itself is available at
L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod>. L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod>.
=head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS =head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
=head2 Meta, Features & Commandline Issues =head2 Meta, Features & Commandline Issues
=head3 My question isn't answered here, can I ask a human? =head3 My question isn't answered here, can I ask a human?
Before sending me mail, you could go to IRC: C<irc.freenode.net>, Before sending me mail, you could go to IRC: C<irc.libera.chat>,
channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be channel C<#rxvt-unicode> 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 :).
=head3 I use Gentoo, and I have a problem... =head3 I use Gentoo, and I have a problem...
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 112 skipping to change at line 112
This tries to create a new terminal, and if fails with exit status 2, This tries to create a new terminal, and if fails with exit status 2,
meaning it couldn't connect to the daemon, it will start the daemon and 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 re-run the command. Subsequent invocations of the script will re-use the
existing daemon. existing daemon.
Another option is to use systemd socket-based activation (see 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 systemd.socket(5)). Here is an example of a service unit file and of a
socket unit file for the default socket path: socket unit file for the default socket path:
=over 4 =over
=item urxvtd.service =item urxvtd.service
[Unit] [Unit]
Description=urxvt terminal daemon Description=urxvt terminal daemon
Requires=urxvtd.socket Requires=urxvtd.socket
[Service] [Service]
ExecStart=/usr/bin/urxvtd -o ExecStart=/usr/bin/urxvtd -o
skipping to change at line 263 skipping to change at line 263
=head3 I can't get transparency working, what am I doing wrong? =head3 I can't get transparency working, what am I doing wrong?
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.
Here are four ways to get transparency. B<Do> read the manpage and option Here are four ways to get transparency. B<Do> 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!
1. Use transparent mode: 1. Use pseudo-transparency:
Esetroot wallpaper.jpg Esetroot wallpaper.jpg
@@URXVT_NAME@@ -tr -tint red -sh 40 @@URXVT_NAME@@ -tr -tint red -sh 40
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 ESETROOT_PMAP_ID property. Compatible programs _XROOTPMAP_ID or ESETROOT_PMAP_ID property. Compatible programs
are Esetroot, hsetroot and feh. are Esetroot, hsetroot and feh.
skipping to change at line 289 skipping to change at line 289
@@URXVT_NAME@@ -pixmap "background.jpg;:root" @@URXVT_NAME@@ -pixmap "background.jpg;:root"
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.
3. Use an ARGB visual: 3. Use an ARGB visual:
@@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
This requires XFT support, and the support of your X-server. If that This requires XFT support, and the support of your X-server. If that
doesn't work for you, blame Xorg and Keith Packard. ARGB 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 ARGB visuals for client windows.
bugfixes and workarounds for Xft and Xlib to make it work, but that
doesn't mean that your WM has the required kludges in place.
4. Use xcompmgr and let it do the job: 4. Use xcompmgr and let it do the job:
xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \ xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \
-set _NET_WM_WINDOW_OPACITY 0xc0000000 -set _NET_WM_WINDOW_OPACITY 0xc0000000
Then click on a window you want to make transparent. Replace C<0xc0000000> Then click on a window you want to make transparent. Replace C<0xc0000000>
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
your server crashes, you got to keep the pieces. your server crashes, you got to keep the pieces.
skipping to change at line 1082 skipping to change at line 1080
You can also use xterm's C<luit> program, which usually works fine, except You can also use xterm's C<luit> program, which usually works fine, except
for some locales where character width differs between program- and for some locales where character width differs between program- and
rxvt-unicode-locales. rxvt-unicode-locales.
=head3 I have problems getting my input method working. =head3 I have problems getting my input method working.
Try a search engine, as this is slightly different for every input method server . Try a search engine, as this is slightly different for every input method server .
Here is a checklist: Here is a checklist:
=over 4 =over
=item - Make sure your locale I<and> the imLocale are supported on your OS. =item - Make sure your locale I<and> the imLocale are supported on your OS.
Try C<locale -a> or check the documentation for your OS. Try C<locale -a> or check the documentation for your OS.
=item - Make sure your locale or imLocale matches a locale supported by your XIM . =item - Make sure your locale or imLocale matches a locale supported by your XIM .
For example, B<kinput2> does not support UTF-8 locales, you should use For example, B<kinput2> does not support UTF-8 locales, you should use
C<ja_JP.EUC-JP> or equivalent. C<ja_JP.EUC-JP> or equivalent.
skipping to change at line 1240 skipping to change at line 1238
selectable at C<configure> time. selectable at C<configure> time.
When some functionality is marked as (insecure mode), then it requires When some functionality is marked as (insecure mode), then it requires
insecure mode to be enabled to work fully, e.g. by using the B<insecure> insecure mode to be enabled to work fully, e.g. by using the B<insecure>
resource or command line switch. As that name implies, a terminal running resource or command line switch. As that name implies, a terminal running
in insecure mode might not be secure against attackers that can output in insecure mode might not be secure against attackers that can output
arbitrary sequences to the terminal. arbitrary sequences to the terminal.
=head2 Definitions =head2 Definitions
=over 4 =over
=item B<< C<c> >> =item B<< C<c> >>
The literal character c (potentially a multi-byte character). The literal character c (potentially a multi-byte character).
=item B<< C<C> >> =item B<< C<C> >>
A single (required) character. A single (required) character.
=item B<< C<Ps> >> =item B<< C<Ps> >>
skipping to change at line 1268 skipping to change at line 1266
parameters, separated by C<;> character(s). parameters, separated by C<;> character(s).
=item B<< C<Pt> >> =item B<< C<Pt> >>
A text parameter composed of printable characters. A text parameter composed of printable characters.
=back =back
=head2 Values =head2 Values
=over 4 =over
=item B<< C<ENQ> >> =item B<< C<ENQ> >>
Enquiry (Ctrl-E) = Send Device Attributes (DA) Enquiry (Ctrl-E) = Send Device Attributes (DA)
request attributes from terminal. See B<< C<ESC [ Ps c> >>. request attributes from terminal. See B<< C<ESC [ Ps c> >>.
=item B<< C<BEL> >> =item B<< C<BEL> >>
Bell (Ctrl-G) Bell (Ctrl-G)
skipping to change at line 1321 skipping to change at line 1319
Switch to Standard Character Set Switch to Standard Character Set
=item B<< C<SP> >> =item B<< C<SP> >>
Space Character Space Character
=back =back
=head2 Escape Sequences =head2 Escape Sequences
=over 4 =over
=item B<< C<ESC # 8> >> =item B<< C<ESC # 8> >>
DEC Screen Alignment Test (DECALN) DEC Screen Alignment Test (DECALN)
=item B<< C<ESC 7> >> =item B<< C<ESC 7> >>
Save Cursor (SC) Save Cursor (SC)
=item B<< C<ESC 8> >> =item B<< C<ESC 8> >>
skipping to change at line 1428 skipping to change at line 1426
C = C<K> German character set I<unimplemented> C = C<K> German character set I<unimplemented>
=end table =end table
=back =back
X<CSI> X<CSI>
=head2 CSI (Command Sequence Introducer) Sequences =head2 CSI (Command Sequence Introducer) Sequences
=over 4 =over
=item B<< C<ESC [ Ps @> >> =item B<< C<ESC [ Ps @> >>
Insert B<< C<Ps> >> (Blank) Character(s) [default: 1] (ICH)X<ESCOBPsA> Insert B<< C<Ps> >> (Blank) Character(s) [default: 1] (ICH)X<ESCOBPsA>
=item B<< C<ESC [ Ps A> >> =item B<< C<ESC [ Ps A> >>
Cursor Up B<< C<Ps> >> Times [default: 1] (CUU) Cursor Up B<< C<Ps> >> Times [default: 1] (CUU)
=item B<< C<ESC [ Ps B> >> =item B<< C<ESC [ Ps B> >>
skipping to change at line 1591 skipping to change at line 1589
B<< C<Ps = 0> >> print screen (MC0) B<< C<Ps = 0> >> print screen (MC0)
B<< C<Ps = 4> >> disable transparent print mode (MC4) B<< C<Ps = 4> >> disable transparent print mode (MC4)
B<< C<Ps = 5> >> enable transparent print mode (MC5) B<< C<Ps = 5> >> enable transparent print mode (MC5)
=end table =end table
=item B<< C<ESC [ Pm l> >> =item B<< C<ESC [ Pm l> >>
Reset Mode (RM) Reset Mode (RM)
=over 4 =over
=item B<< C<Ps = 4> >> =item B<< C<Ps = 4> >>
=begin table =begin table
B<< C<h> >> Insert Mode (SMIR) B<< C<h> >> Insert Mode (SMIR)
B<< C<l> >> Replace Mode (RMIR) B<< C<l> >> Replace Mode (RMIR)
=end table =end table
skipping to change at line 1728 skipping to change at line 1726
=item B<< C<ESC [ Ps x> >> =item B<< C<ESC [ Ps x> >>
Request Terminal Parameters (DECREQTPARM) Request Terminal Parameters (DECREQTPARM)
=back =back
X<PrivateModes> X<PrivateModes>
=head2 DEC Private Modes =head2 DEC Private Modes
=over 4 =over
=item B<< C<ESC [ ? Pm h> >> =item B<< C<ESC [ ? Pm h> >>
DEC Private Mode Set (DECSET) DEC Private Mode Set (DECSET)
=item B<< C<ESC [ ? Pm l> >> =item B<< C<ESC [ ? Pm l> >>
DEC Private Mode Reset (DECRST) DEC Private Mode Reset (DECRST)
=item B<< C<ESC [ ? Pm $ p> >>
DEC Private Mode Request (DECRQM)
=item B<< C<ESC [ ? Pm r> >> =item B<< C<ESC [ ? Pm r> >>
Restore previously saved DEC Private Mode Values. Restore previously saved DEC Private Mode Values.
=item B<< C<ESC [ ? Pm s> >> =item B<< C<ESC [ ? Pm s> >>
Save DEC Private Mode Values. Save DEC Private Mode Values.
=item B<< C<ESC [ ? Pm t> >> =item B<< C<ESC [ ? Pm t> >>
Toggle DEC Private Mode Values (rxvt extension). I<where> Toggle DEC Private Mode Values (rxvt extension).
=back
=over 4 where
=over
=item B<< C<Pm = 1> >> (DECCKM) =item B<< C<Pm = 1> >> (DECCKM)
=begin table =begin table
B<< C<h> >> Application Cursor Keys B<< C<h> >> Application Cursor Keys
B<< C<l> >> Normal Cursor Keys B<< C<l> >> Normal Cursor Keys
=end table =end table
skipping to change at line 2073 skipping to change at line 2079
=begin table =begin table
B<< C<h> >> Enable bracketed paste mode - prepend / append to the pas ted text the control sequences C<ESC [ 200 ~> / C<ESC [ 201 ~> B<< C<h> >> Enable bracketed paste mode - prepend / append to the pas ted text the control sequences C<ESC [ 200 ~> / C<ESC [ 201 ~>
B<< C<l> >> Disable bracketed paste mode B<< C<l> >> Disable bracketed paste mode
=end table =end table
=back =back
=back
X<XTerm> X<XTerm>
=head2 XTerm Operating System Commands =head2 XTerm Operating System Commands
=over 4 =over
=item B<< C<ESC ] Ps;Pt ST> >> =item B<< C<ESC ] Ps;Pt ST> >>
Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b, Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b,
0x5c), backwards compatible terminator BEL (0x07) is also accepted. any 0x5c), backwards compatible terminator BEL (0x07) is also accepted. any
B<octet> can be escaped by prefixing it with SYN (0x16, ^V). B<octet> can be escaped by prefixing it with SYN (0x16, ^V).
Many of these settings can be queried by specifying C<?> as parameter, but Many of these settings can be queried by specifying C<?> as parameter, but
this requires insecure mode to be enabled for most of these. this requires insecure mode to be enabled for most of these.
skipping to change at line 2103 skipping to change at line 2107
B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >> B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >>
B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >> B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >>
B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it (insecure mode). If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delet e the specified property. B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it (insecure mode). If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delet e the specified property.
B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence o f one or more semi-colon separated B<number>/B<name> pairs, where B<number> is a n index to a colour and B<name> is the name of a colour. Each pair causes the B< number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intens ity (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 B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence o f one or more semi-colon separated B<number>/B<name> pairs, where B<number> is a n index to a colour and B<name> is the name of a colour. Each pair causes the B< number>ed colour to be changed to B<name>. Numbers 0-7 corresponds to low-intens ity (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
B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >>
B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >>
B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C< Pt> >> B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C< Pt> >>
B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >>
B<< C<Ps = 17> >> Change background colour of highlight characters to B<< C<Pt> >> B<< C<Ps = 17> >> Change background colour of highlight characters to B<< C<Pt> >>
B<< C<Ps = 19> >> Change foreground colour of highlight characters to B<< C<Pt> >> B<< C<Ps = 19> >> Change foreground colour of highlight characters to B<< C<Pt> >>
B<< C<Ps = 20> >> Change background image to B<< C<Pt> >> (see the L<urxvt-background>) extension documentation) B<< C<Ps = 20> >> Change background image to B<< C<Pt> >> (see the L<urxvt-background> extension documentation)
B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10] B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10]
B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11] B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11]
B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following s pecial values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 i s used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following s pecial values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 i s used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >>
B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B< < C<Pt> >> [disabled] B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B< < C<Pt> >> [disabled]
B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (insecure mode, Compile fril ls). B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (insecure mode, Compile fril ls).
B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, r eturning C<rxvt-unicode>, the resource name, the major and minor version numbers , e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>. B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, r eturning C<rxvt-unicode>, the resource name, the major and minor version numbers , e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>.
B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> > > B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> > >
B<< C<Ps = 705> >> Change background tint color to B<< C<Pt> >> (see the L<urxvt-background>) extension documentation) B<< C<Ps = 705> >> Change background tint color to B<< C<Pt> >> (see the L<urxvt-background> extension documentation)
B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<P t> >> B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<P t> >>
B<< C<Ps = 708> >> Change colour of the border to B<< C<Pt> >> B<< C<Ps = 708> >> Change colour of the border to B<< C<Pt> >>
B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>.
B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C< Ps = 50> (Compile styles). B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C< Ps = 50> (Compile styles).
B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, o r clear scrollback buffer if C<Pt = 0> (Compile frills). B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, o r clear scrollback buffer if C<Pt = 0> (Compile frills).
B<< C<Ps = 777> >> Call the perl extension with the given string, wh B<< C<Ps = 776> >> (urxvt 9.29) Returns info about the character cel
ich should be of the form C<extension:parameters> (Compile perl). l size, replies with C<ESC ] 776 ; cell-width ; cell-height ; font-ascent ST>
B<< C<Ps = 777> >> Call the perl extension with the given string, wh
ich should be of the form C<extension;parameters> (Compile perl).
=end table =end table
=back =back
X<Mouse> X<Mouse>
=head1 Mouse Reporting =head1 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:
=over 4 =over
=item B<< C<< ESC [ M <b> <x> <y> >> >> =item B<< C<< ESC [ M <b> <x> <y> >> >>
=back =back
The lower 2 bits of B<< C<< <b> >> >> indicate the button: The lower 2 bits of B<< C<< <b> >> >> indicate the button:
=over 4 =over
=item Button = B<< C<< (<b> - SPACE) & 3 >> >> =item Button = B<< C<< (<b> - SPACE) & 3 >> >>
=begin table =begin table
0 Button1 pressed 0 Button1 pressed
1 Button2 pressed 1 Button2 pressed
2 Button3 pressed 2 Button3 pressed
3 button released (X11 mouse report) 3 button released (X11 mouse report)
=end table =end table
=back =back
The upper bits of B<< C<< <b> >> >> indicate the modifiers when the The upper bits of B<< C<< <b> >> >> indicate the modifiers when the
button was pressed and are added together (X11 mouse report only): button was pressed and are added together (X11 mouse report only):
=over 4 =over
=item State = B<< C<< (<b> - SPACE) & ~3 >> >> =item State = B<< C<< (<b> - SPACE) & ~3 >> >>
=begin table =begin table
4 Shift 4 Shift
8 Meta 8 Meta
16 Control 16 Control
32 Motion Notify 32 Motion Notify
32 Double Click I<(rxvt extension)>, disabled by default 32 Double Click I<(rxvt extension)>, disabled by default
64 Button1 is actually Button4, Button2 is actually Button5 etc. 64 Button1 is actually Button4, Button2 is actually Button5 etc.
=end table =end table
=back =back
C<x> and C<y> encode the coordinates (1|1 is the upper left corner, C<x> and C<y> encode the coordinates (1|1 is the upper left corner,
just as with cursor positioning): just as with cursor positioning):
=over 4 =over
=item Col = B<< C<< <x> - SPACE >> >> =item Col = B<< C<< <x> - SPACE >> >>
=item Row = B<< C<< <y> - SPACE >> >> =item Row = B<< C<< <y> - SPACE >> >>
=back =back
The parameters include an offset of 32 to ensure that they are The parameters include an offset of 32 to ensure that they are
printable characters. printable characters.
skipping to change at line 2206 skipping to change at line 2211
The largest coordinate that can be represented in this encoding is The largest coordinate that can be represented in this encoding is
223. The range can be extended by using one of the extended mouse 223. The range can be extended by using one of the extended mouse
modes, which should be enabled I<before> enabling mouse reporting, for modes, which should be enabled I<before> enabling mouse reporting, for
semi-obvious reasons. semi-obvious reasons.
=head2 Mode 1005 =head2 Mode 1005
If mode 1005 is active, urxvt sends the sequence If mode 1005 is active, urxvt sends the sequence
=over 4 =over
=item B<< C<< ESC [ M <b> <x> <y> >> >> =item B<< C<< ESC [ M <b> <x> <y> >> >>
=back =back
with the coordinates provided as characters in locale-encoding instead with the coordinates provided as characters in locale-encoding instead
of 1 byte octets. This mode does not work sensibly in non-UTF-8 of 1 byte octets. This mode does not work sensibly in non-UTF-8
locales and should therefore be avoided. locales and should therefore be avoided.
=head2 Mode 1006 =head2 Mode 1006
If mode 1006 is active, urxvt sends the following sequences: If mode 1006 is active, urxvt sends the following sequences:
=over 4 =over
=item B<< C<< ESC [ < <b>;<x>;<y> M >> >> =item B<< C<< ESC [ < <b>;<x>;<y> M >> >>
button press and motion button press and motion
=item B<< C<< ESC [ < <b>;<x>;<y> m >> >> =item B<< C<< ESC [ < <b>;<x>;<y> m >> >>
button release button release
=back =back
skipping to change at line 2247 skipping to change at line 2252
sequence (M or m) specifies the event type (press/motion or release). sequence (M or m) specifies the event type (press/motion or release).
Example: Shift-Button-1 press at top row, column 80. Example: Shift-Button-1 press at top row, column 80.
ESC [ < 4 ; 80 ; 1 M ESC [ < 4 ; 80 ; 1 M
=head2 Mode 1015 =head2 Mode 1015
If mode 1015 is active, urxvt sends the sequence If mode 1015 is active, urxvt sends the sequence
=over 4 =over
=item B<< C<< ESC [ <b>;<x>;<y> M >> >> =item B<< C<< ESC [ <b>;<x>;<y> M >> >>
=back =back
where the parameters are provided as decimal numbers instead of where the parameters are provided as decimal numbers instead of
octets and only C<b> includes an offset of 32. octets and only C<b> includes an offset of 32.
Example: Shift-Button-1 press at top row, column 80. Example: Shift-Button-1 press at top row, column 80.
skipping to change at line 2345 skipping to change at line 2350
=head1 CONFIGURE OPTIONS =head1 CONFIGURE OPTIONS
General hint: if you get compile errors, then likely your configuration General hint: if you get compile errors, then likely your configuration
hasn't been tested well. Either try with C<--enable-everything> or use hasn't been tested well. Either try with C<--enable-everything> or use
the default configuration (i.e. no C<--enable-xxx> or C<--disable-xxx> the default configuration (i.e. no C<--enable-xxx> or C<--disable-xxx>
switches). Of course, you should always report when a combination doesn't switches). Of course, you should always report when a combination doesn't
work, so it can be fixed. Marc Lehmann <rxvt@schmorp.de>. work, so it can be fixed. Marc Lehmann <rxvt@schmorp.de>.
All All
=over 4 =over
=item --enable-everything =item --enable-everything
Add (or remove) support for all non-multichoice options listed Add (or remove) support for all non-multichoice options listed
in C<./configure --help>, except for C<--enable-assert> and in C<./configure --help>, except for C<--enable-assert> and
C<--enable-256-color>. C<--enable-256-color>.
You can specify this and then disable options you do not like by You can specify this and then disable options you do not like by
I<following> this with the appropriate C<--disable-...> arguments, I<following> this with the appropriate C<--disable-...> arguments,
or you can start with a minimal configuration by specifying or you can start with a minimal configuration by specifying
skipping to change at line 2399 skipping to change at line 2404
=end table =end table
=item --enable-xim (default: on) =item --enable-xim (default: on)
Add support for XIM (X Input Method) protocol. This allows using Add support for XIM (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.
=item --enable-unicode3 (default: off) =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.
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.
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).
=item --enable-combining (default: on) =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.
Without --enable-unicode3, the number of additional precomposed Without --enable-unicode3, the number of additional precomposed
skipping to change at line 2447 skipping to change at line 2452
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.
=item --with-res-class=CLASS (default: URxvt) =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.
=item --enable-utmp (default: on)
Write user and tty to utmp file (used by programs like F<w>) at
start of rxvt execution and delete information when rxvt exits.
=item --enable-wtmp (default: on)
Write user and tty to wtmp file (used by programs like F<last>) at
start of rxvt execution and write logout when rxvt exits. This
option requires --enable-utmp to also be specified.
=item --enable-lastlog (default: on)
Write user and tty to lastlog file (used by programs like
F<lastlogin>) at start of rxvt execution. This option requires
=item --enable-pixbuf (default: on) =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 JPG, PNG, It adds support for many file formats including JPG, PNG,
TIFF, GIF, XPM, BMP, ICO and TGA. TIFF, GIF, XPM, BMP, ICO and TGA.
=item --enable-startup-notification (default: on) =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.
skipping to change at line 2545 skipping to change at line 2533
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
It also enables some non-essential features otherwise disabled, such as: It also enables some non-essential features otherwise disabled, such as:
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
view change/zero scrollback escape sequences view change/zero scrollback escape sequences
locale switching escape sequence locale switching escape sequence
skipping to change at line 2637 skipping to change at line 2627
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.
=item --with-name=NAME (default: urxvt) =item --with-name=NAME (default: urxvt)
Set the basename for the installed binaries, resulting Set the basename for the installed binaries, resulting
in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with
C<rxvt>. C<rxvt>.
=item --with-term=NAME (default: rxvt-unicode) =item --with-term=NAME (default: rxvt-unicode)
Change the environmental variable for the terminal to NAME. Sets the default C<TERM> value that @@RXVT_NAME@@ sets. The default is
either C<rxvt-unicode> or C<rxvt-unicode-256color>, as appropriate.
=item --with-terminfo=PATH =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 C<TERMINFO> to
PATH. the given PATH, which can be useful as a last resort if installing the
terminfo entries system-wide is not possible.
=item --with-x =item --with-x
Use the X Window System (pretty much default, eh?). Use the X Window System (pretty much default, eh?).
=back =back
=head1 AUTHORS =head1 AUTHORS
Marc Lehmann <rxvt@schmorp.de> converted this document to pod and Marc Lehmann <rxvt@schmorp.de> converted this document to pod and
 End of changes. 33 change blocks. 
61 lines changed or deleted 55 lines changed or added

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