ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.pod
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.98 by root, Tue Jan 31 00:56:07 2006 UTC vs.
Revision 1.177 by root, Sat May 30 08:53:48 2009 UTC

17 17
18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting 18This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
19all escape sequences, and other background information. 19all escape sequences, and other background information.
20 20
21The newest version of this document is also available on the World Wide Web at 21The newest version of this document is also available on the World Wide Web at
22L<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>. 22L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.7.pod>.
23 23
24The main manual page for @@RXVT_NAME@@ itself is available at
25L<http://pod.tst.eu/http://cvs.schmorp.de/rxvt-unicode/doc/rxvt.1.pod>.
26
24=head1 FREQUENTLY ASKED QUESTIONS 27=head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
25 28
26=head2 The new selection selects pieces that are too big, how can I select
27single words?
28 29
29Yes. For example, if you want to select alphanumeric words, you can use 30=head2 Meta, Features & Commandline Issues
30the following resource:
31 31
32 URxvt.selection.pattern-0: ([[:word:]]+) 32=head3 My question isn't answered here, can I ask a human?
33 33
34If you click more than twice, the selection will be extended 34Before sending me mail, you could go to IRC: C<irc.freenode.net>,
35more and more. 35channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be
36interested in learning about new and exciting problems (but not FAQs :).
36 37
37To get a selection that is very similar to the old code, try this pattern: 38=head3 I use Gentoo, and I have a problem...
38 39
39 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+) 40There are three big problems with Gentoo Linux: first of all, most if not
41all Gentoo systems are completely broken (missing or mismatched header
42files, broken compiler etc. are just the tip of the iceberg); secondly,
43the Gentoo maintainer thinks it is a good idea to add broken patches to
44the code; and lastly, it should be called Gentoo GNU/Linux.
40 45
41Please also note that the I<LeftClick Shift-LeftClik> combination also 46For these reasons, it is impossible to support rxvt-unicode on
42selects words like the old code. 47Gentoo. Problems appearing on Gentoo systems will usually simply be
48ignored unless they can be reproduced on non-Gentoo systems.
43 49
44=over 4 50=head3 Does it support tabs, can I have a tabbed rxvt-unicode?
45 51
46=item I don't like the new selection/popups/hotkeys/perl, how do I 52Beginning with version 7.3, there is a perl extension that implements a
47change/disable it? 53simple tabbed terminal. It is installed by default, so any of these should
54give you tabs:
48 55
49You can disable the perl extension completely by setting the 56 @@URXVT_NAME@@ -pe tabbed
50B<perl-ext-common> resource to the empty string, which also keeps
51rxvt-unicode from initialising perl, saving memory.
52 57
53If you only want to disable specific features, you first have to
54identify which perl extension is responsible. For this, read the section
55B<PREPACKAGED EXTENSIONS> in the @@RXVT_NAME@@perl(3) manpage. For
56example, to disable the B<selection-popup> and B<option-popup>, specify
57this B<perl-ext-common> resource:
58
59 URxvt.perl-ext-common: default,-selection-popup,-option-popup
60
61This will keep the default extensions, but disable the two popup
62extensions. Some extensions can also be configured, for example,
63scrollback search mode is triggered by B<M-s>. You can move it to any
64other combination either by setting the B<searchable-scrollback> resource:
65
66 URxvt.searchable-scrollback: CM-s
67
68=item The cursor moves when selecting text in the current input line, how
69do I switch this off?
70
71=item During rlogin/ssh/telnet/etc. sessions, clicking near the cursor
72outputs strange escape sequences, how do I fix this?
73
74These are caused by the C<readline> perl extension. Under normal
75circumstances, it will move your cursor around when you click into the
76line that contains it. It tries hard not to do this at the wrong moment,
77but when running a program that doesn't parse cursor movements or in some
78cases during rlogin sessions, it fails to detect this properly.
79
80You can permamently switch this feature off by disabling the C<readline>
81extension:
82
83 URxvt.perl-ext-common: default,-readline 58 URxvt.perl-ext-common: default,tabbed
84 59
85=item Why doesn't rxvt-unicode read my resources? 60It will also work fine with tabbing functionality of many window managers
61or similar tabbing programs, and its embedding-features allow it to be
62embedded into other programs, as witnessed by F<doc/rxvt-tabbed> or
63the upcoming C<Gtk2::URxvt> perl module, which features a tabbed urxvt
64(murxvt) terminal as an example embedding application.
86 65
87Well, why, indeed? It does, in a way very similar to other X 66=head3 How do I know which rxvt-unicode version I'm using?
88applications. Most importantly, this means that if you or your OS loads
89resources into the X display (the right way to do it), rxvt-unicode will
90ignore any resource files in your home directory. It will only read
91F<$HOME/.Xdefaults> when no resources are attached to the display.
92 67
93If you have or use an F<$HOME/.Xresources> file, chances are that 68The version number is displayed with the usage (-h). Also the escape
94resources are loaded into your X-server. In this case, you have to 69sequence C<ESC [ 8 n> sets the window title to the version number. When
95re-login after every change (or run F<xrdb -merge $HOME/.Xresources>). 70using the @@URXVT_NAME@@c client, the version displayed is that of the
71daemon.
96 72
97Also consider the form resources have to use: 73=head3 Rxvt-unicode uses gobs of memory, how can I reduce that?
98 74
99 URxvt.resource: value 75Rxvt-unicode tries to obey the rule of not charging you for something you
76don't use. One thing you should try is to configure out all settings that
77you don't need, for example, Xft support is a resource hog by design,
78when used. Compiling it out ensures that no Xft font will be loaded
79accidentally when rxvt-unicode tries to find a font for your characters.
100 80
101If you want to use another form (there are lots of different ways of 81Also, many people (me included) like large windows and even larger
102specifying resources), make sure you understand wether and why it 82scrollback buffers: Without C<--enable-unicode3>, rxvt-unicode will use
103works. If unsure, use the form above. 836 bytes per screen cell. For a 160x?? window this amounts to almost a
84kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
85use 10 Megabytes of memory. With C<--enable-unicode3> it gets worse, as
86rxvt-unicode then uses 8 bytes per screen cell.
104 87
105=item I can't get transparency working, what am I doing wrong? 88=head3 How can I start @@URXVT_NAME@@d in a race-free way?
106 89
107First of all, transparency isn't officially supported in rxvt-unicode, so 90Try C<@@URXVT_NAME@@d -f -o>, which tells @@URXVT_NAME@@d to open the
108you are mostly on your own. Do not bug the author about it (but you may 91display, create the listening socket and then fork.
109bug everybody else). Also, if you can't get it working consider it a rite
110of passage: ... and you failed.
111 92
112Here are four ways to get transparency. B<Do> read the manpage and option 93=head3 How can I start @@URXVT_NAME@@d automatically when I run @@URXVT_NAME@@c?
113descriptions for the programs mentioned and rxvt-unicode. Really, do it!
114 94
1151. Use inheritPixmap: 95If you want to start @@URXVT_NAME@@d automatically whenever you run
96@@URXVT_NAME@@c and the daemon isn't running yet, use this script:
116 97
117 Esetroot wallpaper.jpg 98 #!/bin/sh
118 @@RXVT_NAME@@ -ip -tint red -sh 40 99 @@URXVT_NAME@@c "$@"
100 if [ $? -eq 2 ]; then
101 @@URXVT_NAME@@d -q -o -f
102 @@URXVT_NAME@@c "$@"
103 fi
119 104
120That works. If you think it doesn't, you lack transparency and tinting 105This tries to create a new terminal, and if fails with exit status 2,
121support, or you are unable to read. 106meaning it couldn't connect to the daemon, it will start the daemon and
107re-run the command. Subsequent invocations of the script will re-use the
108existing daemon.
122 109
1232. Use a simple pixmap and emulate pseudo-transparency. This enables you 110=head3 How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.
124to use effects other than tinting and shading: Just shade/tint/whatever
125your picture with gimp:
126 111
127 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 112The original rxvt and rxvt-unicode always export the variable "COLORTERM",
128 @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background 113so you can check and see if that is set. Note that several programs, JED,
114slrn, Midnight Commander automatically check this variable to decide
115whether or not to use color.
129 116
130That works. If you think it doesn't, you lack XPM and Perl support, or you 117=head3 How do I set the correct, full IP address for the DISPLAY variable?
131are unable to read.
132 118
1333. Use an ARGB visual: 119If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
120insecure mode then it is possible to use the following shell script
121snippets to correctly set the display. If your version of rxvt-unicode
122wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then
123the COLORTERM variable can be used to distinguish rxvt-unicode from a
124regular xterm.
134 125
135 @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 126Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script
127snippets:
136 128
137This requires XFT support, and the support of your X-server. If that 129 # Bourne/Korn/POSIX family of shells:
138doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't 130 [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
139there yet, no matter what they claim. Rxvt-Unicode contains the neccessary 131 if [ ${TERM:-foo} = xterm ]; then
140bugfixes and workarounds for Xft and Xlib to make it work, but that 132 stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
141doesn't mean that your WM has the required kludges in place. 133 echo -n '^[Z'
134 read term_id
135 stty icanon echo
136 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
137 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
138 read DISPLAY # set it in our local shell
139 fi
140 fi
142 141
1434. Use xcompmgr and let it do the job: 142=head3 How do I compile the manual pages on my own?
144 143
145 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \ 144You need to have a recent version of perl installed as F</usr/bin/perl>,
146 -set _NET_WM_WINDOW_OPACITY 0xc0000000 145one that comes with F<pod2man>, F<pod2text> and F<pod2xhtml> (from
146F<Pod::Xhtml>). Then go to the doc subdirectory and enter C<make alldoc>.
147 147
148Then click on a window you want to make transparent. Replace C<0xc0000000>
149by other values to change the degree of opacity. If it doesn't work and
150your server crashes, you got to keep the pieces.
151
152=item Isn't rxvt supposed to be small? Don't all those features bloat? 148=head3 Isn't rxvt-unicode supposed to be small? Don't all those features bloat?
153 149
154I often get asked about this, and I think, no, they didn't cause extra 150I often get asked about this, and I think, no, they didn't cause extra
155bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 151bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
156that the urxvt binary is larger (due to some encoding tables always being 152that the urxvt binary is larger (due to some encoding tables always being
157compiled in), but it actually uses less memory (RSS) after startup. Even 153compiled in), but it actually uses less memory (RSS) after startup. Even
161 157
162 text data bss drs rss filename 158 text data bss drs rss filename
163 98398 1664 24 15695 1824 rxvt --disable-everything 159 98398 1664 24 15695 1824 rxvt --disable-everything
164 188985 9048 66616 18222 1788 urxvt --disable-everything 160 188985 9048 66616 18222 1788 urxvt --disable-everything
165 161
166When you C<--enable-everything> (which _is_ unfair, as this involves xft 162When you C<--enable-everything> (which I<is> unfair, as this involves xft
167and full locale/XIM support which are quite bloaty inside libX11 and my 163and full locale/XIM support which are quite bloaty inside libX11 and my
168libc), the two diverge, but not unreasnobaly so. 164libc), the two diverge, but not unreasonably so.
169 165
170 text data bss drs rss filename 166 text data bss drs rss filename
171 163431 2152 24 20123 2060 rxvt --enable-everything 167 163431 2152 24 20123 2060 rxvt --enable-everything
172 1035683 49680 66648 29096 3680 urxvt --enable-everything 168 1035683 49680 66648 29096 3680 urxvt --enable-everything
173 169
189(21152k + extra 4204k in separate processes) or konsole (22200k + extra 185(21152k + extra 4204k in separate processes) or konsole (22200k + extra
19043180k in daemons that stay around after exit, plus half a minute of 18643180k in daemons that stay around after exit, plus half a minute of
191startup time, including the hundreds of warnings it spits out), it fares 187startup time, including the hundreds of warnings it spits out), it fares
192extremely well *g*. 188extremely well *g*.
193 189
194=item Why C++, isn't that unportable/bloated/uncool? 190=head3 Why C++, isn't that unportable/bloated/uncool?
195 191
196Is this a question? :) It comes up very often. The simple answer is: I had 192Is this a question? :) It comes up very often. The simple answer is: I had
197to write it, and C++ allowed me to write and maintain it in a fraction 193to write it, and C++ allowed me to write and maintain it in a fraction
198of the time and effort (which is a scarce resource for me). Put even 194of the time and effort (which is a scarce resource for me). Put even
199shorter: It simply wouldn't exist without C++. 195shorter: It simply wouldn't exist without C++.
216 212
217And here is rxvt-unicode: 213And here is rxvt-unicode:
218 214
219 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 215 libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
220 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000) 216 libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
221 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000) 217 libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)
222 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000) 218 libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)
223 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 219 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
224 220
225No large bloated libraries (of course, none were linked in statically), 221No large bloated libraries (of course, none were linked in statically),
226except maybe libX11 :) 222except maybe libX11 :)
227 223
228=item Does it support tabs, can I have a tabbed rxvt-unicode?
229 224
230Beginning with version 7.3, there is a perl extension that implements a 225=head2 Rendering, Font & Look and Feel Issues
231simple tabbed terminal. It is installed by default, so any of these should
232give you tabs:
233 226
234 @@RXVT_NAME@@ -pe tabbed 227=head3 I can't get transparency working, what am I doing wrong?
235 228
236 URxvt.perl-ext-common: default,tabbed 229First of all, please address all transparency related issues to Sasha Vasko at
230sasha@aftercode.net and do not bug the author about it. Also, if you can't
231get it working consider it a rite of passage: ... and you failed.
237 232
238It will also work fine with tabbing functionality of many window managers 233Here are four ways to get transparency. B<Do> read the manpage and option
239or similar tabbing programs, and its embedding-features allow it to be 234descriptions for the programs mentioned and rxvt-unicode. Really, do it!
240embedded into other programs, as witnessed by F<doc/rxvt-tabbed> or
241the upcoming C<Gtk2::URxvt> perl module, which features a tabbed urxvt
242(murxvt) terminal as an example embedding application.
243 235
244=item How do I know which rxvt-unicode version I'm using? 2361. Use transparent mode:
245 237
246The version number is displayed with the usage (-h). Also the escape 238 Esetroot wallpaper.jpg
247sequence C<ESC [ 8 n> sets the window title to the version number. When 239 @@URXVT_NAME@@ -tr -tint red -sh 40
248using the @@RXVT_NAME@@c client, the version displayed is that of the
249daemon.
250 240
251=item I am using Debian GNU/Linux and have a problem... 241That works. If you think it doesn't, you lack transparency and tinting
242support, or you are unable to read.
252 243
253The Debian GNU/Linux package of rxvt-unicode in sarge contains large 2442. Use a simple pixmap and emulate pseudo-transparency. This enables you
254patches that considerably change the behaviour of rxvt-unicode (but 245to use effects other than tinting and shading: Just shade/tint/whatever
255unfortunately this notice has been removed). Before reporting a bug to 246your picture with gimp or any other tool:
256the original rxvt-unicode author please download and install the genuine
257version (L<http://software.schmorp.de#rxvt-unicode>) and try to reproduce
258the problem. If you cannot, chances are that the problems are specific to
259Debian GNU/Linux, in which case it should be reported via the Debian Bug
260Tracking System (use C<reportbug> to report the bug).
261 247
262For other problems that also affect the Debian package, you can and 248 convert wallpaper.jpg -blur 20x20 -modulate 30 background.jpg
263probably should use the Debian BTS, too, because, after all, it's also a 249 @@URXVT_NAME@@ -pixmap "background.jpg;:root"
264bug in the Debian version and it serves as a reminder for other users that
265might encounter the same issue.
266 250
267=item I am maintaining rxvt-unicode for distribution/OS XXX, any 251That works. If you think it doesn't, you lack AfterImage support, or you
268recommendation? 252are unable to read.
269 253
270You should build one binary with the default options. F<configure> 2543. Use an ARGB visual:
271now enables most useful options, and the trend goes to making them
272runtime-switchable, too, so there is usually no drawback to enbaling them,
273except higher disk and possibly memory usage. The perl interpreter should
274be enabled, as important functionality (menus, selection, likely more in
275the future) depends on it.
276 255
277You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources 256 @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
278system-wide (except maybe with C<defaults>). This will result in useful
279behaviour. If your distribution aims at low memory, add an empty
280C<perl-ext-common> resource to the app-defaults file. This will keep the
281perl interpreter disabled until the user enables it.
282 257
283If you can/want build more binaries, I recommend building a minimal 258This requires XFT support, and the support of your X-server. If that
284one with C<--disable-everything> (very useful) and a maximal one with 259doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
285C<--enable-everything> (less useful, it will be very big due to a lot of 260there yet, no matter what they claim. Rxvt-Unicode contains the necessary
286encodings built-in that increase download times and are rarely used). 261bugfixes and workarounds for Xft and Xlib to make it work, but that
262doesn't mean that your WM has the required kludges in place.
287 263
288=item I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe? 2644. Use xcompmgr and let it do the job:
289 265
290It should be, starting with release 7.1. You are encouraged to properly 266 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \
291install urxvt with privileges necessary for your OS now. 267 -set _NET_WM_WINDOW_OPACITY 0xc0000000
292 268
293When rxvt-unicode detects that it runs setuid or setgid, it will fork 269Then click on a window you want to make transparent. Replace C<0xc0000000>
294into a helper process for privileged operations (pty handling on some 270by other values to change the degree of opacity. If it doesn't work and
295systems, utmp/wtmp/lastlog handling on others) and drop privileges 271your server crashes, you got to keep the pieces.
296immediately. This is much safer than most other terminals that keep
297privileges while running (but is more relevant to urxvt, as it contains
298things as perl interpreters, which might be "helpful" to attackers).
299 272
300This forking is done as the very first within main(), which is very early
301and reduces possible bugs to initialisation code run before main(), or
302things like the dynamic loader of your system, which should result in very
303little risk.
304
305=item When I log-in to another system it tells me about missing terminfo data?
306
307The terminal description used by rxvt-unicode is not as widely available
308as that for xterm, or even rxvt (for which the same problem often arises).
309
310The correct solution for this problem is to install the terminfo, this can
311be done like this (with ncurses' infocmp):
312
313 REMOTE=remotesystem.domain
314 infocmp rxvt-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti"
315
316... or by installing rxvt-unicode normally on the remote system,
317
318If you cannot or do not want to do this, then you can simply set
319C<TERM=rxvt> or even C<TERM=xterm>, and live with the small number of
320problems arising, which includes wrong keymapping, less and different
321colours and some refresh errors in fullscreen applications. It's a nice
322quick-and-dirty workaround for rare cases, though.
323
324If you always want to do this (and are fine with the consequences) you
325can either recompile rxvt-unicode with the desired TERM value or use a
326resource to set it:
327
328 URxvt.termName: rxvt
329
330If you don't plan to use B<rxvt> (quite common...) you could also replace
331the rxvt terminfo file with the rxvt-unicode one.
332
333=item C<tic> outputs some error when compiling the terminfo entry.
334
335Most likely it's the empty definition for C<enacs=>. Just replace it by
336C<enacs=\E[0@> and try again.
337
338=item C<bash>'s readline does not work correctly under @@RXVT_NAME@@.
339
340=item I need a termcap file entry.
341
342One reason you might want this is that some distributions or operating
343systems still compile some programs using the long-obsoleted termcap
344library (Fedora Core's bash is one example) and rely on a termcap entry
345for C<rxvt-unicode>.
346
347You could use rxvt's termcap entry with resonable results in many cases.
348You can also create a termcap entry by using terminfo's infocmp program
349like this:
350
351 infocmp -C rxvt-unicode
352
353Or you could use this termcap entry, generated by the command above:
354
355 rxvt-unicode|rxvt-unicode terminal (X Window System):\
356 :am:bw:eo:km:mi:ms:xn:xo:\
357 :co#80:it#8:li#24:lm#0:\
358 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
359 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
360 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
361 :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
362 :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
363 :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
364 :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
365 :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
366 :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
367 :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
368 :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
369 :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
370 :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
371 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
372 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
373 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
374 :vs=\E[?25h:
375
376=item Why does C<ls> no longer have coloured output?
377
378The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to
379decide wether a terminal has colour, but uses it's own configuration
380file. Needless to say, C<rxvt-unicode> is not in it's default file (among
381with most other terminals supporting colour). Either add:
382
383 TERM rxvt-unicode
384
385to C</etc/DIR_COLORS> or simply add:
386
387 alias ls='ls --color=auto'
388
389to your C<.profile> or C<.bashrc>.
390
391=item Why doesn't vim/emacs etc. use the 88 colour mode?
392
393=item Why doesn't vim/emacs etc. make use of italic?
394
395=item Why are the secondary screen-related options not working properly?
396
397Make sure you are using C<TERM=rxvt-unicode>. Some pre-packaged
398distributions (most notably Debian GNU/Linux) break rxvt-unicode
399by setting C<TERM> to C<rxvt>, which doesn't have these extra
400features. Unfortunately, some of these (most notably, again, Debian
401GNU/Linux) furthermore fail to even install the C<rxvt-unicode> terminfo
402file, so you will need to install it on your own (See the question B<When
403I log-in to another system it tells me about missing terminfo data?> on
404how to do this).
405
406=item My numerical keypad acts weird and generates differing output?
407
408Some Debian GNUL/Linux users seem to have this problem, although no
409specific details were reported so far. It is possible that this is caused
410by the wrong C<TERM> setting, although the details of wether and how
411this can happen are unknown, as C<TERM=rxvt> should offer a compatible
412keymap. See the answer to the previous question, and please report if that
413helped.
414
415=item Rxvt-unicode does not seem to understand the selected encoding?
416
417=item Unicode does not seem to work?
418
419If you encounter strange problems like typing an accented character but
420getting two unrelated other characters or similar, or if program output is
421subtly garbled, then you should check your locale settings.
422
423Rxvt-unicode must be started with the same C<LC_CTYPE> setting as the
424programs. Often rxvt-unicode is started in the C<C> locale, while the
425login script running within the rxvt-unicode window changes the locale to
426something else, e.g. C<en_GB.UTF-8>. Needless to say, this is not going to work.
427
428The best thing is to fix your startup environment, as you will likely run
429into other problems. If nothing works you can try this in your .profile.
430
431 printf '\e]701;%s\007' "$LC_CTYPE"
432
433If this doesn't work, then maybe you use a C<LC_CTYPE> specification not
434supported on your systems. Some systems have a C<locale> command which
435displays this (also, C<perl -e0> can be used to check locale settings, as
436it will complain loudly if it cannot set the locale). If it displays something
437like:
438
439 locale: Cannot set LC_CTYPE to default locale: ...
440
441Then the locale you specified is not supported on your system.
442
443If nothing works and you are sure that everything is set correctly then
444you will need to remember a little known fact: Some programs just don't
445support locales :(
446
447=item Why do some characters look so much different than others?
448
449=item How does rxvt-unicode choose fonts?
450
451Most fonts do not contain the full range of Unicode, which is
452fine. Chances are that the font you (or the admin/package maintainer of
453your system/os) have specified does not cover all the characters you want
454to display.
455
456B<rxvt-unicode> makes a best-effort try at finding a replacement
457font. Often the result is fine, but sometimes the chosen font looks
458bad/ugly/wrong. Some fonts have totally strange characters that don't
459resemble the correct glyph at all, and rxvt-unicode lacks the artificial
460intelligence to detect that a specific glyph is wrong: it has to believe
461the font that the characters it claims to contain indeed look correct.
462
463In that case, select a font of your taste and add it to the font list,
464e.g.:
465
466 @@RXVT_NAME@@ -fn basefont,font2,font3...
467
468When rxvt-unicode sees a character, it will first look at the base
469font. If the base font does not contain the character, it will go to the
470next font, and so on. Specifying your own fonts will also speed up this
471search and use less resources within rxvt-unicode and the X-server.
472
473The only limitation is that none of the fonts may be larger than the base
474font, as the base font defines the terminal character cell size, which
475must be the same due to the way terminals work.
476
477=item Why do some chinese characters look so different than others?
478
479This is because there is a difference between script and language --
480rxvt-unicode does not know which language the text that is output is,
481as it only knows the unicode character codes. If rxvt-unicode first
482sees a japanese/chinese character, it might choose a japanese font for
483display. Subsequent japanese characters will use that font. Now, many
484chinese characters aren't represented in japanese fonts, so when the first
485non-japanese character comes up, rxvt-unicode will look for a chinese font
486-- unfortunately at this point, it will still use the japanese font for
487chinese characters that are also in the japanese font.
488
489The workaround is easy: just tag a chinese font at the end of your font
490list (see the previous question). The key is to view the font list as
491a preference list: If you expect more japanese, list a japanese font
492first. If you expect more chinese, put a chinese font first.
493
494In the future it might be possible to switch language preferences at
495runtime (the internal data structure has no problem with using different
496fonts for the same character at the same time, but no interface for this
497has been designed yet).
498
499Until then, you might get away with switching fonts at runtime (see L<Can
500I switch the fonts at runtime?> later in this document).
501
502=item Why does rxvt-unicode sometimes leave pixel droppings? 273=head3 Why does rxvt-unicode sometimes leave pixel droppings?
503 274
504Most fonts were not designed for terminal use, which means that character 275Most fonts were not designed for terminal use, which means that character
505size varies a lot. A font that is otherwise fine for terminal use might 276size varies a lot. A font that is otherwise fine for terminal use might
506contain some characters that are simply too wide. Rxvt-unicode will avoid 277contain some characters that are simply too wide. Rxvt-unicode will avoid
507these characters. For characters that are just "a bit" too wide a special 278these characters. For characters that are just "a bit" too wide a special
511however: Xft fonts often draw glyphs larger than their acclaimed bounding 282however: Xft fonts often draw glyphs larger than their acclaimed bounding
512box, and rxvt-unicode has no way of detecting this (the correct way is to 283box, and rxvt-unicode has no way of detecting this (the correct way is to
513ask for the character bounding box, which unfortunately is wrong in these 284ask for the character bounding box, which unfortunately is wrong in these
514cases). 285cases).
515 286
516It's not clear (to me at least), wether this is a bug in Xft, freetype, 287It's not clear (to me at least), whether this is a bug in Xft, freetype,
517or the respective font. If you encounter this problem you might try using 288or the respective font. If you encounter this problem you might try using
518the C<-lsp> option to give the font more height. If that doesn't work, you 289the C<-lsp> option to give the font more height. If that doesn't work, you
519might be forced to use a different font. 290might be forced to use a different font.
520 291
521All of this is not a problem when using X11 core fonts, as their bounding 292All of this is not a problem when using X11 core fonts, as their bounding
522box data is correct. 293box data is correct.
523 294
524=item On Solaris 9, many line-drawing characters are too wide.
525
526Seems to be a known bug, read
527L<http://nixdoc.net/files/forum/about34198.html>. Some people use the
528following ugly workaround to get non-double-wide-characters working:
529
530 #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
531
532=item My Compose (Multi_key) key is no longer working.
533
534The most common causes for this are that either your locale is not set
535correctly, or you specified a B<preeditStyle> that is not supported by
536your input method. For example, if you specified B<OverTheSpot> and
537your input method (e.g. the default input method handling Compose keys)
538does not support this (for instance because it is not visual), then
539rxvt-unicode will continue without an input method.
540
541In this case either do not specify a B<preeditStyle> or specify more than
542one pre-edit style, such as B<OverTheSpot,Root,None>.
543
544=item I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755
545
546Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on
547international keyboards) or simply use ISO 14755 support to your
548advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for other
549codes, too, such as C<Ctrl-Shift-1-d> to type the default telnet escape
550character and so on.
551
552=item How can I keep rxvt-unicode from using reverse video so much? 295=head3 How can I keep rxvt-unicode from using reverse video so much?
553 296
554First of all, make sure you are running with the right terminal settings 297First of all, make sure you are running with the right terminal settings
555(C<TERM=rxvt-unicode>), which will get rid of most of these effects. Then 298(C<TERM=rxvt-unicode>), which will get rid of most of these effects. Then
556make sure you have specified colours for italic and bold, as otherwise 299make sure you have specified colours for italic and bold, as otherwise
557rxvt-unicode might use reverse video to simulate the effect: 300rxvt-unicode might use reverse video to simulate the effect:
558 301
559 URxvt.colorBD: white 302 URxvt.colorBD: white
560 URxvt.colorIT: green 303 URxvt.colorIT: green
561 304
562=item Some programs assume totally weird colours (red instead of blue), how can I fix that? 305=head3 Some programs assume totally weird colours (red instead of blue), how can I fix that?
563 306
564For some unexplainable reason, some rare programs assume a very weird 307For some unexplainable reason, some rare programs assume a very weird
565colour palette when confronted with a terminal with more than the standard 308colour palette when confronted with a terminal with more than the standard
5668 colours (rxvt-unicode supports 88). The right fix is, of course, to fix 3098 colours (rxvt-unicode supports 88). The right fix is, of course, to fix
567these programs not to assume non-ISO colours without very good reasons. 310these programs not to assume non-ISO colours without very good reasons.
568 311
569In the meantime, you can either edit your C<rxvt-unicode> terminfo 312In the meantime, you can either edit your C<rxvt-unicode> terminfo
570definition to only claim 8 colour support or use C<TERM=rxvt>, which will 313definition to only claim 8 colour support or use C<TERM=rxvt>, which will
571fix colours but keep you from using other rxvt-unicode features. 314fix colours but keep you from using other rxvt-unicode features.
572 315
573=item I am on FreeBSD and rxvt-unicode does not seem to work at all.
574
575Rxvt-unicode requires the symbol C<__STDC_ISO_10646__> to be defined
576in your compile environment, or an implementation that implements it,
577wether it defines the symbol or not. C<__STDC_ISO_10646__> requires that
578B<wchar_t> is represented as unicode.
579
580As you might have guessed, FreeBSD does neither define this symobl nor
581does it support it. Instead, it uses it's own internal representation of
582B<wchar_t>. This is, of course, completely fine with respect to standards.
583
584However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and
585C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>.
586
587C<__STDC_ISO_10646__> is the only sane way to support multi-language
588apps in an OS, as using a locale-dependent (and non-standardized)
589representation of B<wchar_t> makes it impossible to convert between
590B<wchar_t> (as used by X11 and your applications) and any other encoding
591without implementing OS-specific-wrappers for each and every locale. There
592simply are no APIs to convert B<wchar_t> into anything except the current
593locale encoding.
594
595Some applications (such as the formidable B<mlterm>) work around this
596by carrying their own replacement functions for character set handling
597with them, and either implementing OS-dependent hacks or doing multiple
598conversions (which is slow and unreliable in case the OS implements
599encodings slightly different than the terminal emulator).
600
601The rxvt-unicode author insists that the right way to fix this is in the
602system libraries once and for all, instead of forcing every app to carry
603complete replacements for them :)
604
605=item I use Solaris 9 and it doesn't compile/work/etc.
606
607Try the diff in F<doc/solaris9.patch> as a base. It fixes the worst
608problems with C<wcwidth> and a compile problem.
609
610=item How can I use rxvt-unicode under cygwin?
611
612rxvt-unicode should compile and run out of the box on cygwin, using
613the X11 libraries that come with cygwin. libW11 emulation is no
614longer supported (and makes no sense, either, as it only supported a
615single font). I recommend starting the X-server in C<-multiwindow> or
616C<-rootless> mode instead, which will result in similar look&feel as the
617old libW11 emulation.
618
619At the time of this writing, cygwin didn't seem to support any multi-byte
620encodings (you might try C<LC_CTYPE=C-UTF-8>), so you are likely limited
621to 8-bit encodings.
622
623=item How does rxvt-unicode determine the encoding to use?
624
625=item Is there an option to switch encodings?
626
627Unlike some other terminals, rxvt-unicode has no encoding switch, and no
628specific "utf-8" mode, such as xterm. In fact, it doesn't even know about
629UTF-8 or any other encodings with respect to terminal I/O.
630
631The reasons is that there exists a perfectly fine mechanism for selecting
632the encoding, doing I/O and (most important) communicating this to all
633applications so everybody agrees on character properties such as width
634and code number. This mechanism is the I<locale>. Applications not using
635that info will have problems (for example, C<xterm> gets the width of
636characters wrong as it uses it's own, locale-independent table under all
637locales).
638
639Rxvt-unicode uses the C<LC_CTYPE> locale category to select encoding. All
640programs doing the same (that is, most) will automatically agree in the
641interpretation of characters.
642
643Unfortunately, there is no system-independent way to select locales, nor
644is there a standard on how locale specifiers will look like.
645
646On most systems, the content of the C<LC_CTYPE> environment variable
647contains an arbitrary string which corresponds to an already-installed
648locale. Common names for locales are C<en_US.UTF-8>, C<de_DE.ISO-8859-15>,
649C<ja_JP.EUC-JP>, i.e. C<language_country.encoding>, but other forms
650(i.e. C<de> or C<german>) are also common.
651
652Rxvt-unicode ignores all other locale categories, and except for
653the encoding, ignores country or language-specific settings,
654i.e. C<de_DE.UTF-8> and C<ja_JP.UTF-8> are the normally same to
655rxvt-unicode.
656
657If you want to use a specific encoding you have to make sure you start
658rxvt-unicode with the correct C<LC_CTYPE> category.
659
660=item Can I switch locales at runtime?
661
662Yes, using an escape sequence. Try something like this, which sets
663rxvt-unicode's idea of C<LC_CTYPE>.
664
665 printf '\e]701;%s\007' ja_JP.SJIS
666
667See also the previous answer.
668
669Sometimes this capability is rather handy when you want to work in
670one locale (e.g. C<de_DE.UTF-8>) but some programs don't support it
671(e.g. UTF-8). For example, I use this script to start C<xjdic>, which
672first switches to a locale supported by xjdic and back later:
673
674 printf '\e]701;%s\007' ja_JP.SJIS
675 xjdic -js
676 printf '\e]701;%s\007' de_DE.UTF-8
677
678You can also use xterm's C<luit> program, which usually works fine, except
679for some locales where character width differs between program- and
680rxvt-unicode-locales.
681
682=item Can I switch the fonts at runtime? 316=head3 Can I switch the fonts at runtime?
683 317
684Yes, using an escape sequence. Try something like this, which has the same 318Yes, using an escape sequence. Try something like this, which has the same
685effect as using the C<-fn> switch, and takes effect immediately: 319effect as using the C<-fn> switch, and takes effect immediately:
686 320
687 printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic" 321 printf '\33]50;%s\007' "9x15bold,xft:Kochi Gothic"
688 322
689This is useful if you e.g. work primarily with japanese (and prefer a 323This is useful if you e.g. work primarily with japanese (and prefer a
690japanese font), but you have to switch to chinese temporarily, where 324japanese font), but you have to switch to chinese temporarily, where
691japanese fonts would only be in your way. 325japanese fonts would only be in your way.
692 326
693You can think of this as a kind of manual ISO-2022 switching. 327You can think of this as a kind of manual ISO-2022 switching.
694 328
695=item Why do italic characters look as if clipped? 329=head3 Why do italic characters look as if clipped?
696 330
697Many fonts have difficulties with italic characters and hinting. For 331Many fonts have difficulties with italic characters and hinting. For
698example, the otherwise very nicely hinted font C<xft:Bitstream Vera Sans 332example, the otherwise very nicely hinted font C<xft:Bitstream Vera Sans
699Mono> completely fails in it's italic face. A workaround might be to 333Mono> completely fails in its italic face. A workaround might be to
700enable freetype autohinting, i.e. like this: 334enable freetype autohinting, i.e. like this:
701 335
702 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true 336 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
703 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true 337 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
704 338
705=item My input method wants <some encoding> but I want UTF-8, what can I do?
706
707You can specify separate locales for the input method and the rest of the
708terminal, using the resource C<imlocale>:
709
710 URxvt.imlocale: ja_JP.EUC-JP
711
712Now you can start your terminal with C<LC_CTYPE=ja_JP.UTF-8> and still
713use your input method. Please note, however, that you will not be able to
714input characters outside C<EUC-JP> in a normal way then, as your input
715method limits you.
716
717=item Rxvt-unicode crashes when the X Input Method changes or exits.
718
719Unfortunately, this is unavoidable, as the XIM protocol is racy by
720design. Applications can avoid some crashes at the expense of memory
721leaks, and Input Methods can avoid some crashes by careful ordering at
722exit time. B<kinput2> (and derived input methods) generally succeeds,
723while B<SCIM> (or similar input methods) fails. In the end, however,
724crashes cannot be completely avoided even if both sides cooperate.
725
726So the only workaround is not to kill your Input Method Servers.
727
728=item Rxvt-unicode uses gobs of memory, how can I reduce that?
729
730Rxvt-unicode tries to obey the rule of not charging you for something you
731don't use. One thing you should try is to configure out all settings that
732you don't need, for example, Xft support is a resource hog by design,
733when used. Compiling it out ensures that no Xft font will be loaded
734accidentally when rxvt-unicode tries to find a font for your characters.
735
736Also, many people (me included) like large windows and even larger
737scrollback buffers: Without C<--enable-unicode3>, rxvt-unicode will use
7386 bytes per screen cell. For a 160x?? window this amounts to almost a
739kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
740use 10 Megabytes of memory. With C<--enable-unicode3> it gets worse, as
741rxvt-unicode then uses 8 bytes per screen cell.
742
743=item Can I speed up Xft rendering somehow? 339=head3 Can I speed up Xft rendering somehow?
744 340
745Yes, the most obvious way to speed it up is to avoid Xft entirely, as 341Yes, the most obvious way to speed it up is to avoid Xft entirely, as
746it is simply slow. If you still want Xft fonts you might try to disable 342it is simply slow. If you still want Xft fonts you might try to disable
747antialiasing (by appending C<:antialias=false>), which saves lots of 343antialiasing (by appending C<:antialias=false>), which saves lots of
748memory and also speeds up rendering considerably. 344memory and also speeds up rendering considerably.
749 345
750=item Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? 346=head3 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
751 347
752Rxvt-unicode will use whatever you specify as a font. If it needs to 348Rxvt-unicode will use whatever you specify as a font. If it needs to
753fall back to it's default font search list it will prefer X11 core 349fall back to its default font search list it will prefer X11 core
754fonts, because they are small and fast, and then use Xft fonts. It has 350fonts, because they are small and fast, and then use Xft fonts. It has
755antialiasing disabled for most of them, because the author thinks they 351antialiasing disabled for most of them, because the author thinks they
756look best that way. 352look best that way.
757 353
758If you want antialiasing, you have to specify the fonts manually. 354If you want antialiasing, you have to specify the fonts manually.
759 355
760=item Mouse cut/paste suddenly no longer works.
761
762Make sure that mouse reporting is actually turned off since killing
763some editors prematurely may leave the mouse in mouse report mode. I've
764heard that tcsh may use mouse reporting unless it otherwise specified. A
765quick check is to see if cut/paste works when the Alt or Shift keys are
766depressed.
767
768=item What's with this bold/blink stuff? 356=head3 What's with this bold/blink stuff?
769 357
770If no bold colour is set via C<colorBD:>, bold will invert text using the 358If no bold colour is set via C<colorBD:>, bold will invert text using the
771standard foreground colour. 359standard foreground colour.
772 360
773For the standard background colour, blinking will actually make the 361For the standard background colour, blinking will actually make
774text blink when compiled with C<--enable-blinking>. with standard 362the text blink when compiled with C<--enable-text-blink>. Without
775colours. Without C<--enable-blinking>, the blink attribute will be 363C<--enable-text-blink>, the blink attribute will be ignored.
776ignored.
777 364
778On ANSI colours, bold/blink attributes are used to set high-intensity 365On ANSI colours, bold/blink attributes are used to set high-intensity
779foreground/background colors. 366foreground/background colors.
780 367
781color0-7 are the low-intensity colors. 368color0-7 are the low-intensity colors.
782 369
783color8-15 are the corresponding high-intensity colors. 370color8-15 are the corresponding high-intensity colors.
784 371
785=item I don't like the screen colors. How do I change them? 372=head3 I don't like the screen colors. How do I change them?
786 373
787You can change the screen colors at run-time using F<~/.Xdefaults> 374You can change the screen colors at run-time using F<~/.Xdefaults>
788resources (or as long-options). 375resources (or as long-options).
789 376
790Here are values that are supposed to resemble a VGA screen, 377Here are values that are supposed to resemble a VGA screen,
806 URxvt.color12: #0000FF 393 URxvt.color12: #0000FF
807 URxvt.color13: #FF00FF 394 URxvt.color13: #FF00FF
808 URxvt.color14: #00FFFF 395 URxvt.color14: #00FFFF
809 URxvt.color15: #FFFFFF 396 URxvt.color15: #FFFFFF
810 397
811And here is a more complete set of non-standard colors described (not by 398And here is a more complete set of non-standard colors.
812me) as "pretty girly".
813 399
814 URxvt.cursorColor: #dc74d1 400 URxvt.cursorColor: #dc74d1
815 URxvt.pointerColor: #dc74d1 401 URxvt.pointerColor: #dc74d1
816 URxvt.background: #0e0e0e 402 URxvt.background: #0e0e0e
817 URxvt.foreground: #4ad5e1 403 URxvt.foreground: #4ad5e1
828 URxvt.color6: #73f7ff 414 URxvt.color6: #73f7ff
829 URxvt.color14: #73f7ff 415 URxvt.color14: #73f7ff
830 URxvt.color7: #e1dddd 416 URxvt.color7: #e1dddd
831 URxvt.color15: #e1dddd 417 URxvt.color15: #e1dddd
832 418
833=item How can I start @@RXVT_NAME@@d in a race-free way? 419They have been described (not by me) as "pretty girly".
834 420
835Try C<@@RXVT_NAME@@d -f -o>, which tells @@RXVT_NAME@@d to open the 421=head3 Why do some characters look so much different than others?
836display, create the listening socket and then fork.
837 422
423See next entry.
424
425=head3 How does rxvt-unicode choose fonts?
426
427Most fonts do not contain the full range of Unicode, which is
428fine. Chances are that the font you (or the admin/package maintainer of
429your system/os) have specified does not cover all the characters you want
430to display.
431
432B<rxvt-unicode> makes a best-effort try at finding a replacement
433font. Often the result is fine, but sometimes the chosen font looks
434bad/ugly/wrong. Some fonts have totally strange characters that don't
435resemble the correct glyph at all, and rxvt-unicode lacks the artificial
436intelligence to detect that a specific glyph is wrong: it has to believe
437the font that the characters it claims to contain indeed look correct.
438
439In that case, select a font of your taste and add it to the font list,
440e.g.:
441
442 @@URXVT_NAME@@ -fn basefont,font2,font3...
443
444When rxvt-unicode sees a character, it will first look at the base
445font. If the base font does not contain the character, it will go to the
446next font, and so on. Specifying your own fonts will also speed up this
447search and use less resources within rxvt-unicode and the X-server.
448
449The only limitation is that none of the fonts may be larger than the base
450font, as the base font defines the terminal character cell size, which
451must be the same due to the way terminals work.
452
453=head3 Why do some chinese characters look so different than others?
454
455This is because there is a difference between script and language --
456rxvt-unicode does not know which language the text that is output is,
457as it only knows the unicode character codes. If rxvt-unicode first
458sees a japanese/chinese character, it might choose a japanese font for
459display. Subsequent japanese characters will use that font. Now, many
460chinese characters aren't represented in japanese fonts, so when the first
461non-japanese character comes up, rxvt-unicode will look for a chinese font
462-- unfortunately at this point, it will still use the japanese font for
463chinese characters that are also in the japanese font.
464
465The workaround is easy: just tag a chinese font at the end of your font
466list (see the previous question). The key is to view the font list as
467a preference list: If you expect more japanese, list a japanese font
468first. If you expect more chinese, put a chinese font first.
469
470In the future it might be possible to switch language preferences at
471runtime (the internal data structure has no problem with using different
472fonts for the same character at the same time, but no interface for this
473has been designed yet).
474
475Until then, you might get away with switching fonts at runtime (see L<Can
476I switch the fonts at runtime?> later in this document).
477
478=head3 How can I make mplayer display video correctly?
479
480We are working on it, in the meantime, as a workaround, use something like:
481
482 @@URXVT_NAME@@ -b 600 -geometry 20x1 -e sh -c 'mplayer -wid $WINDOWID file...'
483
484
485=head2 Keyboard, Mouse & User Interaction
486
487=head3 The new selection selects pieces that are too big, how can I select single words?
488
489If you want to select e.g. alphanumeric words, you can use the following
490setting:
491
492 URxvt.selection.pattern-0: ([[:word:]]+)
493
494If you click more than twice, the selection will be extended
495more and more.
496
497To get a selection that is very similar to the old code, try this pattern:
498
499 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+)
500
501Please also note that the I<LeftClick Shift-LeftClick> combination also
502selects words like the old code.
503
504=head3 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?
505
506You can disable the perl extension completely by setting the
507B<perl-ext-common> resource to the empty string, which also keeps
508rxvt-unicode from initialising perl, saving memory.
509
510If you only want to disable specific features, you first have to
511identify which perl extension is responsible. For this, read the section
512B<PREPACKAGED EXTENSIONS> in the @@URXVT_NAME@@perl(3) manpage. For
513example, to disable the B<selection-popup> and B<option-popup>, specify
514this B<perl-ext-common> resource:
515
516 URxvt.perl-ext-common: default,-selection-popup,-option-popup
517
518This will keep the default extensions, but disable the two popup
519extensions. Some extensions can also be configured, for example,
520scrollback search mode is triggered by B<M-s>. You can move it to any
521other combination either by setting the B<searchable-scrollback> resource:
522
523 URxvt.searchable-scrollback: CM-s
524
525=head3 The cursor moves when selecting text in the current input line, how do I switch this off?
526
527See next entry.
528
529=head3 During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?
530
531These are caused by the C<readline> perl extension. Under normal
532circumstances, it will move your cursor around when you click into the
533line that contains it. It tries hard not to do this at the wrong moment,
534but when running a program that doesn't parse cursor movements or in some
535cases during rlogin sessions, it fails to detect this properly.
536
537You can permanently switch this feature off by disabling the C<readline>
538extension:
539
540 URxvt.perl-ext-common: default,-readline
541
542=head3 My numerical keypad acts weird and generates differing output?
543
544Some Debian GNUL/Linux users seem to have this problem, although no
545specific details were reported so far. It is possible that this is caused
546by the wrong C<TERM> setting, although the details of whether and how
547this can happen are unknown, as C<TERM=rxvt> should offer a compatible
548keymap. See the answer to the previous question, and please report if that
549helped.
550
551=head3 My Compose (Multi_key) key is no longer working.
552
553The most common causes for this are that either your locale is not set
554correctly, or you specified a B<preeditStyle> that is not supported by
555your input method. For example, if you specified B<OverTheSpot> and
556your input method (e.g. the default input method handling Compose keys)
557does not support this (for instance because it is not visual), then
558rxvt-unicode will continue without an input method.
559
560In this case either do not specify a B<preeditStyle> or specify more than
561one pre-edit style, such as B<OverTheSpot,Root,None>.
562
563=head3 I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755
564
565Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on
566international keyboards) or simply use ISO 14755 support to your
567advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for other
568codes, too, such as C<Ctrl-Shift-1-d> to type the default telnet escape
569character and so on.
570
571=head3 Mouse cut/paste suddenly no longer works.
572
573Make sure that mouse reporting is actually turned off since killing
574some editors prematurely may leave the mouse in mouse report mode. I've
575heard that tcsh may use mouse reporting unless it otherwise specified. A
576quick check is to see if cut/paste works when the Alt or Shift keys are
577depressed.
578
838=item What's with the strange Backspace/Delete key behaviour? 579=head3 What's with the strange Backspace/Delete key behaviour?
839 580
840Assuming that the physical Backspace key corresponds to the 581Assuming that the physical Backspace key corresponds to the
841BackSpace keysym (not likely for Linux ... see the following 582Backspace keysym (not likely for Linux ... see the following
842question) there are two standard values that can be used for 583question) there are two standard values that can be used for
843Backspace: C<^H> and C<^?>. 584Backspace: C<^H> and C<^?>.
844 585
845Historically, either value is correct, but rxvt-unicode adopts the debian 586Historically, either value is correct, but rxvt-unicode adopts the debian
846policy of using C<^?> when unsure, because it's the one only only correct 587policy of using C<^?> when unsure, because it's the one and only correct
847choice :). 588choice :).
848 589
849Rxvt-unicode tries to inherit the current stty settings and uses the value 590Rxvt-unicode tries to inherit the current stty settings and uses the value
850of `erase' to guess the value for backspace. If rxvt-unicode wasn't 591of `erase' to guess the value for backspace. If rxvt-unicode wasn't
851started from a terminal (say, from a menu or by remote shell), then the 592started from a terminal (say, from a menu or by remote shell), then the
854 595
855For starting a new rxvt-unicode: 596For starting a new rxvt-unicode:
856 597
857 # use Backspace = ^H 598 # use Backspace = ^H
858 $ stty erase ^H 599 $ stty erase ^H
859 $ @@RXVT_NAME@@ 600 $ @@URXVT_NAME@@
860 601
861 # use Backspace = ^? 602 # use Backspace = ^?
862 $ stty erase ^? 603 $ stty erase ^?
863 $ @@RXVT_NAME@@ 604 $ @@URXVT_NAME@@
864 605
865Toggle with C<ESC [ 36 h> / C<ESC [ 36 l>. 606Toggle with C<ESC [ 36 h> / C<ESC [ 36 l>.
866 607
867For an existing rxvt-unicode: 608For an existing rxvt-unicode:
868 609
889some editors (vim I'm told) expect Backspace = ^H, 630some editors (vim I'm told) expect Backspace = ^H,
890GNU Emacs (and Emacs-like editors) use ^H for help. 631GNU Emacs (and Emacs-like editors) use ^H for help.
891 632
892Perhaps someday this will all be resolved in a consistent manner. 633Perhaps someday this will all be resolved in a consistent manner.
893 634
894=item I don't like the key-bindings. How do I change them? 635=head3 I don't like the key-bindings. How do I change them?
895 636
896There are some compile-time selections available via configure. Unless 637There are some compile-time selections available via configure. Unless
897you have run "configure" with the C<--disable-resources> option you can 638you have run "configure" with the C<--disable-resources> option you can
898use the `keysym' resource to alter the keystrings associated with keysyms. 639use the `keysym' resource to alter the keystrings associated with keysyms.
899 640
900Here's an example for a URxvt session started using C<@@RXVT_NAME@@ -name URxvt> 641Here's an example for a URxvt session started using C<@@URXVT_NAME@@ -name URxvt>
901 642
902 URxvt.keysym.Home: \033[1~ 643 URxvt.keysym.Home: \033[1~
903 URxvt.keysym.End: \033[4~ 644 URxvt.keysym.End: \033[4~
904 URxvt.keysym.C-apostrophe: \033<C-'> 645 URxvt.keysym.C-apostrophe: \033<C-'>
905 URxvt.keysym.C-slash: \033<C-/> 646 URxvt.keysym.C-slash: \033<C-/>
920 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz > 661 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >
921 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007 662 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
922 663
923See some more examples in the documentation for the B<keysym> resource. 664See some more examples in the documentation for the B<keysym> resource.
924 665
925=item I'm using keyboard model XXX that has extra Prior/Next/Insert keys. 666=head3 I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map
926How do I make use of them? For example, the Sun Keyboard type 4
927has the following mappings that rxvt-unicode doesn't recognize.
928 667
929 KP_Insert == Insert 668 KP_Insert == Insert
930 F22 == Print 669 F22 == Print
931 F27 == Home 670 F27 == Home
932 F29 == Prior 671 F29 == Prior
935 674
936Rather than have rxvt-unicode try to accommodate all the various possible 675Rather than have rxvt-unicode try to accommodate all the various possible
937keyboard mappings, it is better to use `xmodmap' to remap the keys as 676keyboard mappings, it is better to use `xmodmap' to remap the keys as
938required for your particular machine. 677required for your particular machine.
939 678
940=item How do I distinguish wether I'm running rxvt-unicode or a regular xterm?
941I need this to decide about setting colors etc.
942 679
943rxvt and rxvt-unicode always export the variable "COLORTERM", so you can 680=head2 Terminal Configuration
944check and see if that is set. Note that several programs, JED, slrn,
945Midnight Commander automatically check this variable to decide whether or
946not to use color.
947 681
948=item How do I set the correct, full IP address for the DISPLAY variable? 682=head3 Can I see a typical configuration?
949 683
950If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled 684The default configuration tries to be xterm-like, which I don't like that
951insecure mode then it is possible to use the following shell script 685much, but it's least surprise to regular users.
952snippets to correctly set the display. If your version of rxvt-unicode
953wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then
954the COLORTERM variable can be used to distinguish rxvt-unicode from a
955regular xterm.
956 686
957Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script 687As a rxvt or rxvt-unicode user, you are practically supposed to invest
958snippets: 688time into customising your terminal. To get you started, here is the
689author's .Xdefaults entries, with comments on what they do. It's certainly
690not I<typical>, but what's typical...
959 691
960 # Bourne/Korn/POSIX family of shells: 692 URxvt.cutchars: "()*,<>[]{}|'
961 [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know 693 URxvt.print-pipe: cat >/tmp/xxx
962 if [ ${TERM:-foo} = xterm ]; then
963 stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
964 echo -n '^[Z'
965 read term_id
966 stty icanon echo
967 if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
968 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
969 read DISPLAY # set it in our local shell
970 fi
971 fi
972 694
973=item How do I compile the manual pages for myself? 695These are just for testing stuff.
974 696
975You need to have a recent version of perl installed as F</usr/bin/perl>, 697 URxvt.imLocale: ja_JP.UTF-8
976one that comes with F<pod2man>, F<pod2text> and F<pod2html>. Then go to 698 URxvt.preeditType: OnTheSpot,None
977the doc subdirectory and enter C<make alldoc>.
978 699
979=item My question isn't answered here, can I ask a human? 700This tells rxvt-unicode to use a special locale when communicating with
701the X Input Method, and also tells it to only use the OnTheSpot pre-edit
702type, which requires the C<xim-onthespot> perl extension but rewards me
703with correct-looking fonts.
980 704
981Before sending me mail, you could go to IRC: C<irc.freenode.net>, 705 URxvt.perl-lib: /root/lib/urxvt
982channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be 706 URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard
983interested in learning about new and exciting problems (but not FAQs :). 707 URxvt.selection.pattern-0: ( at .*? line \\d+)
708 URxvt.selection.pattern-1: ^(/[^:]+):\
709 URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/
710 URxvt.selection-autotransform.1: s/^ at (.*?) line (\\d+)$/:e \\Q$1\\E\\x0d:$2\\x0d/
711
712This is my perl configuration. The first two set the perl library
713directory and also tells urxvt to use a large number of extensions. I
714develop for myself mostly, so I actually use most of the extensions I
715write.
716
717The selection stuff mainly makes the selection perl-error-message aware
718and tells it to convert perl error messages into vi-commands to load the
719relevant file and go tot he error line number.
720
721 URxvt.scrollstyle: plain
722 URxvt.secondaryScroll: true
723
724As the documentation says: plain is the preferred scrollbar for the
725author. The C<secondaryScroll> configures urxvt to scroll in full-screen
726apps, like screen, so lines scrolled out of screen end up in urxvt's
727scrollback buffer.
728
729 URxvt.background: #000000
730 URxvt.foreground: gray90
731 URxvt.color7: gray90
732 URxvt.colorBD: #ffffff
733 URxvt.cursorColor: #e0e080
734 URxvt.throughColor: #8080f0
735 URxvt.highlightColor: #f0f0f0
736
737Some colours. Not sure which ones are being used or even non-defaults, but
738these are in my .Xdefaults. Most notably, they set foreground/background
739to light gray/black, and also make sure that the colour 7 matches the
740default foreground colour.
741
742 URxvt.underlineColor: yellow
743
744Another colour, makes underline lines look different. Sometimes hurts, but
745is mostly a nice effect.
746
747 URxvt.geometry: 154x36
748 URxvt.loginShell: false
749 URxvt.meta: ignore
750 URxvt.utmpInhibit: true
751
752Uh, well, should be mostly self-explanatory. By specifying some defaults
753manually, I can quickly switch them for testing.
754
755 URxvt.saveLines: 8192
756
757A large scrollback buffer is essential. Really.
758
759 URxvt.mapAlert: true
760
761The only case I use it is for my IRC window, which I like to keep
762iconified till people msg me (which beeps).
763
764 URxvt.visualBell: true
765
766The audible bell is often annoying, especially when in a crowd.
767
768 URxvt.insecure: true
769
770Please don't hack my mutt! Ooops...
771
772 URxvt.pastableTabs: false
773
774I once thought this is a great idea.
775
776 urxvt.font: 9x15bold,\
777 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
778 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
779 [codeset=JISX0208]xft:Kochi Gothic, \
780 xft:Bitstream Vera Sans Mono:autohint=true, \
781 xft:Code2000:antialias=false
782 urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
783 urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
784 urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
785
786I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
787overwhelmed. A special note: the C<9x15bold> mentioned above is actually
788the version from XFree-3.3, as XFree-4 replaced it by a totally different
789font (different glyphs for C<;> and many other harmless characters),
790while the second font is actually the C<9x15bold> from XFree4/XOrg. The
791bold version has less chars than the medium version, so I use it for rare
792characters, too. When editing sources with vim, I use italic for comments
793and other stuff, which looks quite good with Bitstream Vera anti-aliased.
794
795Terminus is a quite bad font (many very wrong glyphs), but for most of my
796purposes, it works, and gives a different look, as my normal (Non-bold)
797font is already bold, and I want to see a difference between bold and
798normal fonts.
799
800Please note that I used the C<urxvt> instance name and not the C<URxvt>
801class name. Thats because I use different configs for different purposes,
802for example, my IRC window is started with C<-name IRC>, and uses these
803defaults:
804
805 IRC*title: IRC
806 IRC*geometry: 87x12+535+542
807 IRC*saveLines: 0
808 IRC*mapAlert: true
809 IRC*font: suxuseuro
810 IRC*boldFont: suxuseuro
811 IRC*colorBD: white
812 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
813 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
814
815C<Alt-Ctrl-1> and C<Alt-Ctrl-2> switch between two different font
816sizes. C<suxuseuro> allows me to keep an eye (and actually read)
817stuff while keeping a very small window. If somebody pastes something
818complicated (e.g. japanese), I temporarily switch to a larger font.
819
820The above is all in my C<.Xdefaults> (I don't use C<.Xresources> nor
821C<xrdb>). I also have some resources in a separate C<.Xdefaults-hostname>
822file for different hosts, for example, on ym main desktop, I use:
823
824 URxvt.keysym.C-M-q: command:\033[3;5;5t
825 URxvt.keysym.C-M-y: command:\033[3;5;606t
826 URxvt.keysym.C-M-e: command:\033[3;1605;5t
827 URxvt.keysym.C-M-c: command:\033[3;1605;606t
828 URxvt.keysym.C-M-p: perl:test
829
830The first for keysym definitions allow me to quickly bring some windows
831in the layout I like most. Ion users might start laughing but will stop
832immediately when I tell them that I use my own Fvwm2 module for much the
833same effect as Ion provides, and I only very rarely use the above key
834combinations :->
835
836=head3 Why doesn't rxvt-unicode read my resources?
837
838Well, why, indeed? It does, in a way very similar to other X
839applications. Most importantly, this means that if you or your OS loads
840resources into the X display (the right way to do it), rxvt-unicode will
841ignore any resource files in your home directory. It will only read
842F<$HOME/.Xdefaults> when no resources are attached to the display.
843
844If you have or use an F<$HOME/.Xresources> file, chances are that
845resources are loaded into your X-server. In this case, you have to
846re-login after every change (or run F<xrdb -merge $HOME/.Xresources>).
847
848Also consider the form resources have to use:
849
850 URxvt.resource: value
851
852If you want to use another form (there are lots of different ways of
853specifying resources), make sure you understand whether and why it
854works. If unsure, use the form above.
855
856=head3 When I log-in to another system it tells me about missing terminfo data?
857
858The terminal description used by rxvt-unicode is not as widely available
859as that for xterm, or even rxvt (for which the same problem often arises).
860
861The correct solution for this problem is to install the terminfo, this can
862be done by simply installing rxvt-unicode on the remote system as well
863(in case you have a nice package manager ready), or you can install the
864terminfo database manually like this (with ncurses infocmp. works as
865user and root):
866
867 REMOTE=remotesystem.domain
868 infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
869
870One some systems you might need to set C<$TERMINFO> to the full path of
871F<$HOME/.terminfo> for this to work.
872
873If you cannot or do not want to do this, then you can simply set
874C<TERM=rxvt> or even C<TERM=xterm>, and live with the small number of
875problems arising, which includes wrong keymapping, less and different
876colours and some refresh errors in fullscreen applications. It's a nice
877quick-and-dirty workaround for rare cases, though.
878
879If you always want to do this (and are fine with the consequences) you
880can either recompile rxvt-unicode with the desired TERM value or use a
881resource to set it:
882
883 URxvt.termName: rxvt
884
885If you don't plan to use B<rxvt> (quite common...) you could also replace
886the rxvt terminfo file with the rxvt-unicode one and use C<TERM=rxvt>.
887
888=head3 nano fails with "Error opening terminal: rxvt-unicode"
889
890This exceptionally confusing and useless error message is printed by nano
891when it can't find the terminfo database. Nothing is wrong with your
892terminal, read the previous answer for a solution.
893
894=head3 C<tic> outputs some error when compiling the terminfo entry.
895
896Most likely it's the empty definition for C<enacs=>. Just replace it by
897C<enacs=\E[0@> and try again.
898
899=head3 C<bash>'s readline does not work correctly under @@URXVT_NAME@@.
900
901See next entry.
902
903=head3 I need a termcap file entry.
904
905One reason you might want this is that some distributions or operating
906systems still compile some programs using the long-obsoleted termcap
907library (Fedora Core's bash is one example) and rely on a termcap entry
908for C<rxvt-unicode>.
909
910You could use rxvt's termcap entry with reasonable results in many cases.
911You can also create a termcap entry by using terminfo's infocmp program
912like this:
913
914 infocmp -C rxvt-unicode
915
916Or you could use the termcap entry in doc/etc/rxvt-unicode.termcap,
917generated by the command above.
918
919=head3 Why does C<ls> no longer have coloured output?
920
921The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to
922decide whether a terminal has colour, but uses its own configuration
923file. Needless to say, C<rxvt-unicode> is not in its default file (among
924with most other terminals supporting colour). Either add:
925
926 TERM rxvt-unicode
927
928to C</etc/DIR_COLORS> or simply add:
929
930 alias ls='ls --color=auto'
931
932to your C<.profile> or C<.bashrc>.
933
934=head3 Why doesn't vim/emacs etc. use the 88 colour mode?
935
936See next entry.
937
938=head3 Why doesn't vim/emacs etc. make use of italic?
939
940See next entry.
941
942=head3 Why are the secondary screen-related options not working properly?
943
944Make sure you are using C<TERM=rxvt-unicode>. Some pre-packaged
945distributions (most notably Debian GNU/Linux) break rxvt-unicode
946by setting C<TERM> to C<rxvt>, which doesn't have these extra
947features. Unfortunately, some of these (most notably, again, Debian
948GNU/Linux) furthermore fail to even install the C<rxvt-unicode> terminfo
949file, so you will need to install it on your own (See the question B<When
950I log-in to another system it tells me about missing terminfo data?> on
951how to do this).
952
953
954=head2 Encoding / Locale / Input Method Issues
955
956=head3 Rxvt-unicode does not seem to understand the selected encoding?
957
958See next entry.
959
960=head3 Unicode does not seem to work?
961
962If you encounter strange problems like typing an accented character but
963getting two unrelated other characters or similar, or if program output is
964subtly garbled, then you should check your locale settings.
965
966Rxvt-unicode must be started with the same C<LC_CTYPE> setting as the
967programs running in it. Often rxvt-unicode is started in the C<C> locale,
968while the login script running within the rxvt-unicode window changes the
969locale to something else, e.g. C<en_GB.UTF-8>. Needless to say, this is
970not going to work, and is the most common cause for problems.
971
972The best thing is to fix your startup environment, as you will likely run
973into other problems. If nothing works you can try this in your .profile.
974
975 printf '\33]701;%s\007' "$LC_CTYPE" # $LANG or $LC_ALL are worth a try, too
976
977If this doesn't work, then maybe you use a C<LC_CTYPE> specification not
978supported on your systems. Some systems have a C<locale> command which
979displays this (also, C<perl -e0> can be used to check locale settings, as
980it will complain loudly if it cannot set the locale). If it displays something
981like:
982
983 locale: Cannot set LC_CTYPE to default locale: ...
984
985Then the locale you specified is not supported on your system.
986
987If nothing works and you are sure that everything is set correctly then
988you will need to remember a little known fact: Some programs just don't
989support locales :(
990
991=head3 How does rxvt-unicode determine the encoding to use?
992
993See next entry.
994
995=head3 Is there an option to switch encodings?
996
997Unlike some other terminals, rxvt-unicode has no encoding switch, and no
998specific "utf-8" mode, such as xterm. In fact, it doesn't even know about
999UTF-8 or any other encodings with respect to terminal I/O.
1000
1001The reasons is that there exists a perfectly fine mechanism for selecting
1002the encoding, doing I/O and (most important) communicating this to all
1003applications so everybody agrees on character properties such as width
1004and code number. This mechanism is the I<locale>. Applications not using
1005that info will have problems (for example, C<xterm> gets the width of
1006characters wrong as it uses its own, locale-independent table under all
1007locales).
1008
1009Rxvt-unicode uses the C<LC_CTYPE> locale category to select encoding. All
1010programs doing the same (that is, most) will automatically agree in the
1011interpretation of characters.
1012
1013Unfortunately, there is no system-independent way to select locales, nor
1014is there a standard on how locale specifiers will look like.
1015
1016On most systems, the content of the C<LC_CTYPE> environment variable
1017contains an arbitrary string which corresponds to an already-installed
1018locale. Common names for locales are C<en_US.UTF-8>, C<de_DE.ISO-8859-15>,
1019C<ja_JP.EUC-JP>, i.e. C<language_country.encoding>, but other forms
1020(i.e. C<de> or C<german>) are also common.
1021
1022Rxvt-unicode ignores all other locale categories, and except for
1023the encoding, ignores country or language-specific settings,
1024i.e. C<de_DE.UTF-8> and C<ja_JP.UTF-8> are the normally same to
1025rxvt-unicode.
1026
1027If you want to use a specific encoding you have to make sure you start
1028rxvt-unicode with the correct C<LC_CTYPE> category.
1029
1030=head3 Can I switch locales at runtime?
1031
1032Yes, using an escape sequence. Try something like this, which sets
1033rxvt-unicode's idea of C<LC_CTYPE>.
1034
1035 printf '\33]701;%s\007' ja_JP.SJIS
1036
1037See also the previous answer.
1038
1039Sometimes this capability is rather handy when you want to work in
1040one locale (e.g. C<de_DE.UTF-8>) but some programs don't support it
1041(e.g. UTF-8). For example, I use this script to start C<xjdic>, which
1042first switches to a locale supported by xjdic and back later:
1043
1044 printf '\33]701;%s\007' ja_JP.SJIS
1045 xjdic -js
1046 printf '\33]701;%s\007' de_DE.UTF-8
1047
1048You can also use xterm's C<luit> program, which usually works fine, except
1049for some locales where character width differs between program- and
1050rxvt-unicode-locales.
1051
1052=head3 I have problems getting my input method working.
1053
1054Try a search engine, as this is slightly different for every input method server.
1055
1056Here is a checklist:
1057
1058=over 4
1059
1060=item - Make sure your locale I<and> the imLocale are supported on your OS.
1061
1062Try C<locale -a> or check the documentation for your OS.
1063
1064=item - Make sure your locale or imLocale matches a locale supported by your XIM.
1065
1066For example, B<kinput2> does not support UTF-8 locales, you should use
1067C<ja_JP.EUC-JP> or equivalent.
1068
1069=item - Make sure your XIM server is actually running.
1070
1071=item - Make sure the C<XMODIFIERS> environment variable is set correctly when I<starting> rxvt-unicode.
1072
1073When you want to use e.g. B<kinput2>, it must be set to
1074C<@im=kinput2>. For B<scim>, use C<@im=SCIM>. You can see what input
1075method servers are running with this command:
1076
1077 xprop -root XIM_SERVERS
1078
1079=item
984 1080
985=back 1081=back
986 1082
1083=head3 My input method wants <some encoding> but I want UTF-8, what can I do?
1084
1085You can specify separate locales for the input method and the rest of the
1086terminal, using the resource C<imlocale>:
1087
1088 URxvt.imlocale: ja_JP.EUC-JP
1089
1090Now you can start your terminal with C<LC_CTYPE=ja_JP.UTF-8> and still
1091use your input method. Please note, however, that, depending on your Xlib
1092version, you may not be able to input characters outside C<EUC-JP> in a
1093normal way then, as your input method limits you.
1094
1095=head3 Rxvt-unicode crashes when the X Input Method changes or exits.
1096
1097Unfortunately, this is unavoidable, as the XIM protocol is racy by
1098design. Applications can avoid some crashes at the expense of memory
1099leaks, and Input Methods can avoid some crashes by careful ordering at
1100exit time. B<kinput2> (and derived input methods) generally succeeds,
1101while B<SCIM> (or similar input methods) fails. In the end, however,
1102crashes cannot be completely avoided even if both sides cooperate.
1103
1104So the only workaround is not to kill your Input Method Servers.
1105
1106
1107=head2 Operating Systems / Package Maintaining
1108
1109=head3 I am using Debian GNU/Linux and have a problem...
1110
1111The Debian GNU/Linux package of rxvt-unicode in sarge contains large
1112patches that considerably change the behaviour of rxvt-unicode (but
1113unfortunately this notice has been removed). Before reporting a bug to
1114the original rxvt-unicode author please download and install the genuine
1115version (L<http://software.schmorp.de#rxvt-unicode>) and try to reproduce
1116the problem. If you cannot, chances are that the problems are specific to
1117Debian GNU/Linux, in which case it should be reported via the Debian Bug
1118Tracking System (use C<reportbug> to report the bug).
1119
1120For other problems that also affect the Debian package, you can and
1121probably should use the Debian BTS, too, because, after all, it's also a
1122bug in the Debian version and it serves as a reminder for other users that
1123might encounter the same issue.
1124
1125=head3 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
1126
1127You should build one binary with the default options. F<configure>
1128now enables most useful options, and the trend goes to making them
1129runtime-switchable, too, so there is usually no drawback to enabling them,
1130except higher disk and possibly memory usage. The perl interpreter should
1131be enabled, as important functionality (menus, selection, likely more in
1132the future) depends on it.
1133
1134You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources
1135system-wide (except maybe with C<defaults>). This will result in useful
1136behaviour. If your distribution aims at low memory, add an empty
1137C<perl-ext-common> resource to the app-defaults file. This will keep the
1138perl interpreter disabled until the user enables it.
1139
1140If you can/want build more binaries, I recommend building a minimal
1141one with C<--disable-everything> (very useful) and a maximal one with
1142C<--enable-everything> (less useful, it will be very big due to a lot of
1143encodings built-in that increase download times and are rarely used).
1144
1145=head3 I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?
1146
1147It should be, starting with release 7.1. You are encouraged to properly
1148install urxvt with privileges necessary for your OS now.
1149
1150When rxvt-unicode detects that it runs setuid or setgid, it will fork
1151into a helper process for privileged operations (pty handling on some
1152systems, utmp/wtmp/lastlog handling on others) and drop privileges
1153immediately. This is much safer than most other terminals that keep
1154privileges while running (but is more relevant to urxvt, as it contains
1155things as perl interpreters, which might be "helpful" to attackers).
1156
1157This forking is done as the very first within main(), which is very early
1158and reduces possible bugs to initialisation code run before main(), or
1159things like the dynamic loader of your system, which should result in very
1160little risk.
1161
1162=head3 I am on FreeBSD and rxvt-unicode does not seem to work at all.
1163
1164Rxvt-unicode requires the symbol C<__STDC_ISO_10646__> to be defined
1165in your compile environment, or an implementation that implements it,
1166whether it defines the symbol or not. C<__STDC_ISO_10646__> requires that
1167B<wchar_t> is represented as unicode.
1168
1169As you might have guessed, FreeBSD does neither define this symbol nor
1170does it support it. Instead, it uses its own internal representation of
1171B<wchar_t>. This is, of course, completely fine with respect to standards.
1172
1173However, that means rxvt-unicode only works in C<POSIX>, C<ISO-8859-1> and
1174C<UTF-8> locales under FreeBSD (which all use Unicode as B<wchar_t>).
1175
1176C<__STDC_ISO_10646__> is the only sane way to support multi-language
1177apps in an OS, as using a locale-dependent (and non-standardized)
1178representation of B<wchar_t> makes it impossible to convert between
1179B<wchar_t> (as used by X11 and your applications) and any other encoding
1180without implementing OS-specific-wrappers for each and every locale. There
1181simply are no APIs to convert B<wchar_t> into anything except the current
1182locale encoding.
1183
1184Some applications (such as the formidable B<mlterm>) work around this
1185by carrying their own replacement functions for character set handling
1186with them, and either implementing OS-dependent hacks or doing multiple
1187conversions (which is slow and unreliable in case the OS implements
1188encodings slightly different than the terminal emulator).
1189
1190The rxvt-unicode author insists that the right way to fix this is in the
1191system libraries once and for all, instead of forcing every app to carry
1192complete replacements for them :)
1193
1194=head3 How can I use rxvt-unicode under cygwin?
1195
1196rxvt-unicode should compile and run out of the box on cygwin, using
1197the X11 libraries that come with cygwin. libW11 emulation is no
1198longer supported (and makes no sense, either, as it only supported a
1199single font). I recommend starting the X-server in C<-multiwindow> or
1200C<-rootless> mode instead, which will result in similar look&feel as the
1201old libW11 emulation.
1202
1203At the time of this writing, cygwin didn't seem to support any multi-byte
1204encodings (you might try C<LC_CTYPE=C-UTF-8>), so you are likely limited
1205to 8-bit encodings.
1206
1207=head3 Character widths are not correct.
1208
1209urxvt uses the system wcwidth function to know the information about
1210the width of characters, so on systems with incorrect locale data you
1211will likely get bad results. Two notorious examples are Solaris 9,
1212where single-width characters like U+2514 are reported as double-width,
1213and Darwin 8, where combining chars are reported having width 1.
1214
1215The solution is to upgrade your system or switch to a better one. A
1216possibly working workaround is to use a wcwidth implementation like
1217
1218http://www.cl.cam.ac.uk/~mgk25/ucs/wcwidth.c
1219
1220=head3 I want 256 colors
1221
1222Are you sure you need 256 colors? 88 colors should be enough for most
1223purposes. If you really need more, there is an unsupported patch for
1224it in the doc directory, but please do not ask for it to be applied.
1225
987=head1 RXVT TECHNICAL REFERENCE 1226=head1 RXVT-UNICODE TECHNICAL REFERENCE
988
989=head1 DESCRIPTION
990 1227
991The rest of this document describes various technical aspects of 1228The rest of this document describes various technical aspects of
992B<rxvt-unicode>. First the description of supported command sequences, 1229B<rxvt-unicode>. First the description of supported command sequences,
993followed by pixmap support and last by a description of all features 1230followed by pixmap support and last by a description of all features
994selectable at C<configure> time. 1231selectable at C<configure> time.
995 1232
996=head1 Definitions 1233=head2 Definitions
997 1234
998=over 4 1235=over 4
999 1236
1000=item B<< C<c> >> 1237=item B<< C<c> >>
1001 1238
1019 1256
1020A text parameter composed of printable characters. 1257A text parameter composed of printable characters.
1021 1258
1022=back 1259=back
1023 1260
1024=head1 Values 1261=head2 Values
1025 1262
1026=over 4 1263=over 4
1027 1264
1028=item B<< C<ENQ> >> 1265=item B<< C<ENQ> >>
1029 1266
1072 1309
1073Space Character 1310Space Character
1074 1311
1075=back 1312=back
1076 1313
1077=head1 Escape Sequences 1314=head2 Escape Sequences
1078 1315
1079=over 4 1316=over 4
1080 1317
1081=item B<< C<ESC # 8> >> 1318=item B<< C<ESC # 8> >>
1082 1319
1180 1417
1181=back 1418=back
1182 1419
1183X<CSI> 1420X<CSI>
1184 1421
1185=head1 CSI (Command Sequence Introducer) Sequences 1422=head2 CSI (Command Sequence Introducer) Sequences
1186 1423
1187=over 4 1424=over 4
1188 1425
1189=item B<< C<ESC [ Ps @> >> 1426=item B<< C<ESC [ Ps @> >>
1190 1427
1245=begin table 1482=begin table
1246 1483
1247 B<< C<Ps = 0> >> Clear to Right (default) 1484 B<< C<Ps = 0> >> Clear to Right (default)
1248 B<< C<Ps = 1> >> Clear to Left 1485 B<< C<Ps = 1> >> Clear to Left
1249 B<< C<Ps = 2> >> Clear All 1486 B<< C<Ps = 2> >> Clear All
1487 B<< C<Ps = 3> >> Like Ps = 0, but is ignored when wrapped
1488 (@@RXVT_NAME@@ extension)
1250 1489
1251=end table 1490=end table
1252 1491
1253=item B<< C<ESC [ Ps L> >> 1492=item B<< C<ESC [ Ps L> >>
1254 1493
1460 1699
1461=back 1700=back
1462 1701
1463X<PrivateModes> 1702X<PrivateModes>
1464 1703
1465=head1 DEC Private Modes 1704=head2 DEC Private Modes
1466 1705
1467=over 4 1706=over 4
1468 1707
1469=item B<< C<ESC [ ? Pm h> >> 1708=item B<< C<ESC [ ? Pm h> >>
1470 1709
1486 1725
1487Toggle DEC Private Mode Values (rxvt extension). I<where> 1726Toggle DEC Private Mode Values (rxvt extension). I<where>
1488 1727
1489=over 4 1728=over 4
1490 1729
1491=item B<< C<Ps = 1> >> (DECCKM) 1730=item B<< C<Pm = 1> >> (DECCKM)
1492 1731
1493=begin table 1732=begin table
1494 1733
1495 B<< C<h> >> Application Cursor Keys 1734 B<< C<h> >> Application Cursor Keys
1496 B<< C<l> >> Normal Cursor Keys 1735 B<< C<l> >> Normal Cursor Keys
1497 1736
1498=end table 1737=end table
1499 1738
1500=item B<< C<Ps = 2> >> (ANSI/VT52 mode) 1739=item B<< C<Pm = 2> >> (ANSI/VT52 mode)
1501 1740
1502=begin table 1741=begin table
1503 1742
1504 B<< C<h> >> Enter VT52 mode 1743 B<< C<h> >> Enter VT52 mode
1505 B<< C<l> >> Enter VT52 mode 1744 B<< C<l> >> Enter VT52 mode
1506 1745
1507=end table 1746=end table
1508 1747
1509=item B<< C<Ps = 3> >> 1748=item B<< C<Pm = 3> >>
1510 1749
1511=begin table 1750=begin table
1512 1751
1513 B<< C<h> >> 132 Column Mode (DECCOLM) 1752 B<< C<h> >> 132 Column Mode (DECCOLM)
1514 B<< C<l> >> 80 Column Mode (DECCOLM) 1753 B<< C<l> >> 80 Column Mode (DECCOLM)
1515 1754
1516=end table 1755=end table
1517 1756
1518=item B<< C<Ps = 4> >> 1757=item B<< C<Pm = 4> >>
1519 1758
1520=begin table 1759=begin table
1521 1760
1522 B<< C<h> >> Smooth (Slow) Scroll (DECSCLM) 1761 B<< C<h> >> Smooth (Slow) Scroll (DECSCLM)
1523 B<< C<l> >> Jump (Fast) Scroll (DECSCLM) 1762 B<< C<l> >> Jump (Fast) Scroll (DECSCLM)
1524 1763
1525=end table 1764=end table
1526 1765
1527=item B<< C<Ps = 5> >> 1766=item B<< C<Pm = 5> >>
1528 1767
1529=begin table 1768=begin table
1530 1769
1531 B<< C<h> >> Reverse Video (DECSCNM) 1770 B<< C<h> >> Reverse Video (DECSCNM)
1532 B<< C<l> >> Normal Video (DECSCNM) 1771 B<< C<l> >> Normal Video (DECSCNM)
1533 1772
1534=end table 1773=end table
1535 1774
1536=item B<< C<Ps = 6> >> 1775=item B<< C<Pm = 6> >>
1537 1776
1538=begin table 1777=begin table
1539 1778
1540 B<< C<h> >> Origin Mode (DECOM) 1779 B<< C<h> >> Origin Mode (DECOM)
1541 B<< C<l> >> Normal Cursor Mode (DECOM) 1780 B<< C<l> >> Normal Cursor Mode (DECOM)
1542 1781
1543=end table 1782=end table
1544 1783
1545=item B<< C<Ps = 7> >> 1784=item B<< C<Pm = 7> >>
1546 1785
1547=begin table 1786=begin table
1548 1787
1549 B<< C<h> >> Wraparound Mode (DECAWM) 1788 B<< C<h> >> Wraparound Mode (DECAWM)
1550 B<< C<l> >> No Wraparound Mode (DECAWM) 1789 B<< C<l> >> No Wraparound Mode (DECAWM)
1551 1790
1552=end table 1791=end table
1553 1792
1554=item B<< C<Ps = 8> >> I<unimplemented> 1793=item B<< C<Pm = 8> >> I<unimplemented>
1555 1794
1556=begin table 1795=begin table
1557 1796
1558 B<< C<h> >> Auto-repeat Keys (DECARM) 1797 B<< C<h> >> Auto-repeat Keys (DECARM)
1559 B<< C<l> >> No Auto-repeat Keys (DECARM) 1798 B<< C<l> >> No Auto-repeat Keys (DECARM)
1560 1799
1561=end table 1800=end table
1562 1801
1563=item B<< C<Ps = 9> >> X10 XTerm 1802=item B<< C<Pm = 9> >> X10 XTerm
1564 1803
1565=begin table 1804=begin table
1566 1805
1567 B<< C<h> >> Send Mouse X & Y on button press. 1806 B<< C<h> >> Send Mouse X & Y on button press.
1568 B<< C<l> >> No mouse reporting. 1807 B<< C<l> >> No mouse reporting.
1569 1808
1570=end table 1809=end table
1571 1810
1572=item B<< C<Ps = 25> >> 1811=item B<< C<Pm = 25> >>
1573 1812
1574=begin table 1813=begin table
1575 1814
1576 B<< C<h> >> Visible cursor {cnorm/cvvis} 1815 B<< C<h> >> Visible cursor {cnorm/cvvis}
1577 B<< C<l> >> Invisible cursor {civis} 1816 B<< C<l> >> Invisible cursor {civis}
1578 1817
1579=end table 1818=end table
1580 1819
1581=item B<< C<Ps = 30> >> 1820=item B<< C<Pm = 30> >>
1582 1821
1583=begin table 1822=begin table
1584 1823
1585 B<< C<h> >> scrollBar visisble 1824 B<< C<h> >> scrollBar visible
1586 B<< C<l> >> scrollBar invisisble 1825 B<< C<l> >> scrollBar invisible
1587 1826
1588=end table 1827=end table
1589 1828
1590=item B<< C<Ps = 35> >> (B<rxvt>) 1829=item B<< C<Pm = 35> >> (B<rxvt>)
1591 1830
1592=begin table 1831=begin table
1593 1832
1594 B<< C<h> >> Allow XTerm Shift+key sequences 1833 B<< C<h> >> Allow XTerm Shift+key sequences
1595 B<< C<l> >> Disallow XTerm Shift+key sequences 1834 B<< C<l> >> Disallow XTerm Shift+key sequences
1596 1835
1597=end table 1836=end table
1598 1837
1599=item B<< C<Ps = 38> >> I<unimplemented> 1838=item B<< C<Pm = 38> >> I<unimplemented>
1600 1839
1601Enter Tektronix Mode (DECTEK) 1840Enter Tektronix Mode (DECTEK)
1602 1841
1603=item B<< C<Ps = 40> >> 1842=item B<< C<Pm = 40> >>
1604 1843
1605=begin table 1844=begin table
1606 1845
1607 B<< C<h> >> Allow 80/132 Mode 1846 B<< C<h> >> Allow 80/132 Mode
1608 B<< C<l> >> Disallow 80/132 Mode 1847 B<< C<l> >> Disallow 80/132 Mode
1609 1848
1610=end table 1849=end table
1611 1850
1612=item B<< C<Ps = 44> >> I<unimplemented> 1851=item B<< C<Pm = 44> >> I<unimplemented>
1613 1852
1614=begin table 1853=begin table
1615 1854
1616 B<< C<h> >> Turn On Margin Bell 1855 B<< C<h> >> Turn On Margin Bell
1617 B<< C<l> >> Turn Off Margin Bell 1856 B<< C<l> >> Turn Off Margin Bell
1618 1857
1619=end table 1858=end table
1620 1859
1621=item B<< C<Ps = 45> >> I<unimplemented> 1860=item B<< C<Pm = 45> >> I<unimplemented>
1622 1861
1623=begin table 1862=begin table
1624 1863
1625 B<< C<h> >> Reverse-wraparound Mode 1864 B<< C<h> >> Reverse-wraparound Mode
1626 B<< C<l> >> No Reverse-wraparound Mode 1865 B<< C<l> >> No Reverse-wraparound Mode
1627 1866
1628=end table 1867=end table
1629 1868
1630=item B<< C<Ps = 46> >> I<unimplemented> 1869=item B<< C<Pm = 46> >> I<unimplemented>
1631 1870
1632=item B<< C<Ps = 47> >> 1871=item B<< C<Pm = 47> >>
1633 1872
1634=begin table 1873=begin table
1635 1874
1636 B<< C<h> >> Use Alternate Screen Buffer 1875 B<< C<h> >> Use Alternate Screen Buffer
1637 B<< C<l> >> Use Normal Screen Buffer 1876 B<< C<l> >> Use Normal Screen Buffer
1638 1877
1639=end table 1878=end table
1640 1879
1641X<Priv66> 1880X<Priv66>
1642 1881
1643=item B<< C<Ps = 66> >> 1882=item B<< C<Pm = 66> >>
1644 1883
1645=begin table 1884=begin table
1646 1885
1647 B<< C<h> >> Application Keypad (DECPAM) == C<ESC => 1886 B<< C<h> >> Application Keypad (DECPAM) == C<ESC =>
1648 B<< C<l> >> Normal Keypad (DECPNM) == C<< ESC > >> 1887 B<< C<l> >> Normal Keypad (DECPNM) == C<< ESC > >>
1649 1888
1650=end table 1889=end table
1651 1890
1652=item B<< C<Ps = 67> >> 1891=item B<< C<Pm = 67> >>
1653 1892
1654=begin table 1893=begin table
1655 1894
1656 B<< C<h> >> Backspace key sends B<< C<BS> (DECBKM) >> 1895 B<< C<h> >> Backspace key sends B<< C<BS> (DECBKM) >>
1657 B<< C<l> >> Backspace key sends B<< C<DEL> >> 1896 B<< C<l> >> Backspace key sends B<< C<DEL> >>
1658 1897
1659=end table 1898=end table
1660 1899
1661=item B<< C<Ps = 1000> >> (X11 XTerm) 1900=item B<< C<Pm = 1000> >> (X11 XTerm)
1662 1901
1663=begin table 1902=begin table
1664 1903
1665 B<< C<h> >> Send Mouse X & Y on button press and release. 1904 B<< C<h> >> Send Mouse X & Y on button press and release.
1666 B<< C<l> >> No mouse reporting. 1905 B<< C<l> >> No mouse reporting.
1667 1906
1668=end table 1907=end table
1669 1908
1670=item B<< C<Ps = 1001> >> (X11 XTerm) I<unimplemented> 1909=item B<< C<Pm = 1001> >> (X11 XTerm) I<unimplemented>
1671 1910
1672=begin table 1911=begin table
1673 1912
1674 B<< C<h> >> Use Hilite Mouse Tracking. 1913 B<< C<h> >> Use Hilite Mouse Tracking.
1675 B<< C<l> >> No mouse reporting. 1914 B<< C<l> >> No mouse reporting.
1676 1915
1677=end table 1916=end table
1678 1917
1918=item B<< C<Pm = 1002> >> (X11 XTerm)
1919
1920=begin table
1921
1922 B<< C<h> >> Send Mouse X & Y on button press and release, and motion with a button pressed.
1923 B<< C<l> >> No mouse reporting.
1924
1925=end table
1926
1927=item B<< C<Pm = 1003> >> (X11 XTerm)
1928
1929=begin table
1930
1931 B<< C<h> >> Send Mouse X & Y on button press and release, and motion.
1932 B<< C<l> >> No mouse reporting.
1933
1934=end table
1935
1679=item B<< C<Ps = 1010> >> (B<rxvt>) 1936=item B<< C<Pm = 1010> >> (B<rxvt>)
1680 1937
1681=begin table 1938=begin table
1682 1939
1683 B<< C<h> >> Don't scroll to bottom on TTY output 1940 B<< C<h> >> Don't scroll to bottom on TTY output
1684 B<< C<l> >> Scroll to bottom on TTY output 1941 B<< C<l> >> Scroll to bottom on TTY output
1685 1942
1686=end table 1943=end table
1687 1944
1688=item B<< C<Ps = 1011> >> (B<rxvt>) 1945=item B<< C<Pm = 1011> >> (B<rxvt>)
1689 1946
1690=begin table 1947=begin table
1691 1948
1692 B<< C<h> >> Scroll to bottom when a key is pressed 1949 B<< C<h> >> Scroll to bottom when a key is pressed
1693 B<< C<l> >> Don't scroll to bottom when a key is pressed 1950 B<< C<l> >> Don't scroll to bottom when a key is pressed
1694 1951
1695=end table 1952=end table
1696 1953
1697=item B<< C<Ps = 1021> >> (B<rxvt>) 1954=item B<< C<Pm = 1021> >> (B<rxvt>)
1698 1955
1699=begin table 1956=begin table
1700 1957
1701 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>) 1958 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>)
1702 B<< C<l> >> Font styles have no effect on intensity (Compile styles) 1959 B<< C<l> >> Font styles have no effect on intensity (Compile styles)
1703 1960
1704=end table 1961=end table
1705 1962
1706=item B<< C<Ps = 1047> >> 1963=item B<< C<Pm = 1047> >>
1707 1964
1708=begin table 1965=begin table
1709 1966
1710 B<< C<h> >> Use Alternate Screen Buffer 1967 B<< C<h> >> Use Alternate Screen Buffer
1711 B<< C<l> >> Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it 1968 B<< C<l> >> Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
1712 1969
1713=end table 1970=end table
1714 1971
1715=item B<< C<Ps = 1048> >> 1972=item B<< C<Pm = 1048> >>
1716 1973
1717=begin table 1974=begin table
1718 1975
1719 B<< C<h> >> Save cursor position 1976 B<< C<h> >> Save cursor position
1720 B<< C<l> >> Restore cursor position 1977 B<< C<l> >> Restore cursor position
1721 1978
1722=end table 1979=end table
1723 1980
1724=item B<< C<Ps = 1049> >> 1981=item B<< C<Pm = 1049> >>
1725 1982
1726=begin table 1983=begin table
1727 1984
1728 B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it 1985 B<< C<h> >> Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
1729 B<< C<l> >> Use Normal Screen Buffer 1986 B<< C<l> >> Use Normal Screen Buffer
1730 1987
1731=end table 1988=end table
1732 1989
1990=item B<< C<Pm = 2004> >>
1991
1992=begin table
1993
1994 B<< C<h> >> Enable bracketed paste mode - prepend / append to the pasted text the control sequences C<ESC [ 200 ~> / C<ESC [ 201 ~>
1995 B<< C<l> >> Disable bracketed paste mode
1996
1997=end table
1998
1733=back 1999=back
1734 2000
1735=back 2001=back
1736 2002
1737X<XTerm> 2003X<XTerm>
1738 2004
1739=head1 XTerm Operating System Commands 2005=head2 XTerm Operating System Commands
1740 2006
1741=over 4 2007=over 4
1742 2008
1743=item B<< C<ESC ] Ps;Pt ST> >> 2009=item B<< C<ESC ] Ps;Pt ST> >>
1744 2010
1751 B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >> 2017 B<< C<Ps = 0> >> Change Icon Name and Window Title to B<< C<Pt> >>
1752 B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >> 2018 B<< C<Ps = 1> >> Change Icon Name to B<< C<Pt> >>
1753 B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >> 2019 B<< C<Ps = 2> >> Change Window Title to B<< C<Pt> >>
1754 B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it. If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property. 2020 B<< C<Ps = 3> >> If B<< C<Pt> >> starts with a B<< C<?> >>, query the (STRING) property of the window and return it. If B<< C<Pt> >> contains a B<< C<=> >>, set the named property to the given value, else delete the specified property.
1755 B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an 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-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 2021 B<< C<Ps = 4> >> B<< C<Pt> >> is a semi-colon separated sequence of one or more semi-colon separated B<number>/B<name> pairs, where B<number> is an 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-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
1756 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<(NB: may change in future)> 2022 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >>
1757 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> B<(NB: may change in future)> 2023 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >>
1758 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> 2024 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >>
1759 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> 2025 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >>
1760 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> 2026 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >>
1761 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706] 2027 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706]
1762 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707] 2028 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707]
1763 B<< C<Ps = 20> >> Change background pixmap parameters (see section XPM) (Compile XPM). 2029 B<< C<Ps = 20> >> Change background pixmap parameters (see section BACKGROUND IMAGE) (Compile AfterImage).
1764 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. 2030 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. [deprecated, use 10]
1765 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> 2031 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
1766 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. 2032 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. [deprecated, use 11]
1767 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special 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 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> 2033 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special 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 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >>
1768 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> 2034 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> [disabled]
1769 B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills). 2035 B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills).
1770 B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>. 2036 B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>.
1771 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> 2037 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >>
1772 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). 2038 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency).
1773 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> 2039 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
1774 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >> 2040 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >>
2041 B<< C<Ps = 708> >> Change colour of the border to B<< C<Pt> >>
1775 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. 2042 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>.
1776 B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 2043 B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
1777 B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 2044 B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
1778 B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 2045 B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
1779 B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). 2046 B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
1782 2049
1783=end table 2050=end table
1784 2051
1785=back 2052=back
1786 2053
1787X<XPM> 2054=head1 BACKGROUND IMAGE
1788 2055
1789=head1 XPM
1790
1791For the XPM XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value 2056For the BACKGROUND IMAGE XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> the value
1792of B<< C<Pt> >> can be the name of the background pixmap followed by a 2057of B<< C<Pt> >> can be the name of the background image file followed by a
1793sequence of scaling/positioning commands separated by semi-colons. The 2058sequence of scaling/positioning commands separated by semi-colons. The
1794scaling/positioning commands are as follows: 2059scaling/positioning commands are as follows:
1795 2060
1796=over 4 2061=over 4
1797 2062
1835 2100
1836For example: 2101For example:
1837 2102
1838=over 4 2103=over 4
1839 2104
1840=item B<\E]20;funky\a> 2105=item B<\E]20;funky.jpg\a>
1841 2106
1842load B<funky.xpm> as a tiled image 2107load B<funky.jpg> as a tiled image
1843 2108
1844=item B<\E]20;mona;100\a> 2109=item B<\E]20;mona.jpg;100\a>
1845 2110
1846load B<mona.xpm> with a scaling of 100% 2111load B<mona.jpg> with a scaling of 100%
1847 2112
1848=item B<\E]20;;200;?\a> 2113=item B<\E]20;;200;?\a>
1849 2114
1850rescale the current pixmap to 200% and display the image geometry in 2115rescale the current pixmap to 200% and display the image geometry in
1851the title 2116the title
1852 2117
1853=back 2118=back
2119
1854X<Mouse> 2120X<Mouse>
1855 2121
1856=head1 Mouse Reporting 2122=head1 Mouse Reporting
1857 2123
1858=over 4 2124=over 4
1890=begin table 2156=begin table
1891 2157
1892 4 Shift 2158 4 Shift
1893 8 Meta 2159 8 Meta
1894 16 Control 2160 16 Control
1895 32 Double Click I<(Rxvt extension)> 2161 32 Double Click I<(rxvt extension)>
1896 2162
1897=end table 2163=end table
1898 2164
1899Col = B<< C<< <x> - SPACE >> >> 2165Col = B<< C<< <x> - SPACE >> >>
1900 2166
1901Row = B<< C<< <y> - SPACE >> >> 2167Row = B<< C<< <y> - SPACE >> >>
1902 2168
1903=back 2169=back
2170
2171=head1 Key Codes
2172
1904X<KeyCodes> 2173X<KeyCodes>
1905
1906=head1 Key Codes
1907 2174
1908Note: B<Shift> + B<F1>-B<F10> generates B<F11>-B<F20> 2175Note: B<Shift> + B<F1>-B<F10> generates B<F11>-B<F20>
1909 2176
1910For the keypad, use B<Shift> to temporarily override Application-Keypad 2177For the keypad, use B<Shift> to temporarily override Application-Keypad
1911setting use B<Num_Lock> to toggle Application-Keypad setting if 2178setting use B<Num_Lock> to toggle Application-Keypad setting if
1978 2245
1979=head1 CONFIGURE OPTIONS 2246=head1 CONFIGURE OPTIONS
1980 2247
1981General hint: if you get compile errors, then likely your configuration 2248General hint: if you get compile errors, then likely your configuration
1982hasn't been tested well. Either try with C<--enable-everything> or use 2249hasn't been tested well. Either try with C<--enable-everything> or use
1983the F<./reconf> script as a base for experiments. F<./reconf> is used by 2250the default configuration (i.e. no C<--enable-xxx> or C<--disable-xxx>
1984myself, so it should generally be a working config. Of course, you should 2251switches). Of course, you should always report when a combination doesn't
1985always report when a combination doesn't work, so it can be fixed. Marc 2252work, so it can be fixed. Marc Lehmann <rxvt@schmorp.de>.
1986Lehmann <rxvt@schmorp.de>.
1987 2253
1988All 2254All
1989 2255
1990=over 4 2256=over 4
1991 2257
2023 2289
2024=begin table 2290=begin table
2025 2291
2026 all all available codeset groups 2292 all all available codeset groups
2027 zh common chinese encodings 2293 zh common chinese encodings
2028 zh_ext rarely used but very big chinese encodigs 2294 zh_ext rarely used but very big chinese encodings
2029 jp common japanese encodings 2295 jp common japanese encodings
2030 jp_ext rarely used but big japanese encodings 2296 jp_ext rarely used but big japanese encodings
2031 kr korean encodings 2297 kr korean encodings
2032 2298
2033=end table 2299=end table
2047requirements per character from 2 to 4 bytes. X11 fonts do not yet 2313requirements per character from 2 to 4 bytes. X11 fonts do not yet
2048support these extra characters, but Xft does. 2314support these extra characters, but Xft does.
2049 2315
2050Please note that rxvt-unicode can store unicode code points >65535 2316Please note that rxvt-unicode can store unicode code points >65535
2051even without this flag, but the number of such characters is 2317even without this flag, but the number of such characters is
2052limited to a view thousand (shared with combining characters, 2318limited to a few thousand (shared with combining characters,
2053see next switch), and right now rxvt-unicode cannot display them 2319see next switch), and right now rxvt-unicode cannot display them
2054(input/output and cut&paste still work, though). 2320(input/output and cut&paste still work, though).
2055 2321
2056=item --enable-combining (default: on) 2322=item --enable-combining (default: on)
2057 2323
2080=item --with-res-name=NAME (default: urxvt) 2346=item --with-res-name=NAME (default: urxvt)
2081 2347
2082Use the given name as default application name when 2348Use the given name as default application name when
2083reading resources. Specify --with-res-name=rxvt to replace rxvt. 2349reading resources. Specify --with-res-name=rxvt to replace rxvt.
2084 2350
2085=item --with-res-class=CLASS /default: URxvt) 2351=item --with-res-class=CLASS (default: URxvt)
2086 2352
2087Use the given class as default application class 2353Use the given class as default application class
2088when reading resources. Specify --with-res-class=Rxvt to replace 2354when reading resources. Specify --with-res-class=Rxvt to replace
2089rxvt. 2355rxvt.
2090 2356
2103 2369
2104Write user and tty to lastlog file (used by programs like 2370Write user and tty to lastlog file (used by programs like
2105F<lastlogin>) at start of rxvt execution. This option requires 2371F<lastlogin>) at start of rxvt execution. This option requires
2106--enable-utmp to also be specified. 2372--enable-utmp to also be specified.
2107 2373
2108=item --enable-xpm-background (default: on) 2374=item --enable-afterimage (default: on)
2109 2375
2110Add support for XPM background pixmaps. 2376Add support for libAfterImage to be used for transparency and background
2377images. It adds support for many file formats including JPG, PNG,
2378SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep image XML
2379(L<http://www.afterstep.org/visualdoc.php?show=asimagexml>).
2380
2381This option also adds such eye candy as blending an image over the root
2382background, as well as dynamic scaling and bluring of background images.
2383
2384Note that with this option enabled, @@RXVT_NAME@@'s memory footprint might
2385increase by a few megabytes even if no extra features are used (mostly due
2386to third-party libraries used by libAI). Memory footprint may somewhat be
2387lowered if libAfterImage is configured without support for SVG.
2111 2388
2112=item --enable-transparency (default: on) 2389=item --enable-transparency (default: on)
2113 2390
2114Add support for inheriting parent backgrounds thus giving a fake 2391Add support for backgrounds, creating illusion of transparency in the term.
2115transparency to the term.
2116 2392
2117=item --enable-fading (default: on) 2393=item --enable-fading (default: on)
2118 2394
2119Add support for fading the text when focus is lost (requires C<--enable-transparency>). 2395Add support for fading the text when focus is lost.
2120
2121=item --enable-tinting (default: on)
2122
2123Add support for tinting of transparent backgrounds (requires C<--enable-transparency>).
2124 2396
2125=item --enable-rxvt-scroll (default: on) 2397=item --enable-rxvt-scroll (default: on)
2126 2398
2127Add support for the original rxvt scrollbar. 2399Add support for the original rxvt scrollbar.
2128 2400
2131Add support for a NeXT-like scrollbar. 2403Add support for a NeXT-like scrollbar.
2132 2404
2133=item --enable-xterm-scroll (default: on) 2405=item --enable-xterm-scroll (default: on)
2134 2406
2135Add support for an Xterm-like scrollbar. 2407Add support for an Xterm-like scrollbar.
2136
2137=item --enable-plain-scroll (default: on)
2138
2139Add support for a very unobtrusive, plain-looking scrollbar that
2140is the favourite of the rxvt-unicode author, having used it for
2141many years.
2142
2143=item --enable-ttygid (default: off)
2144
2145Change tty device setting to group "tty" - only use this if
2146your system uses this type of security.
2147 2408
2148=item --disable-backspace-key 2409=item --disable-backspace-key
2149 2410
2150Removes any handling of the backspace key by us - let the X server do it. 2411Removes any handling of the backspace key by us - let the X server do it.
2151 2412
2171A non-exhaustive list of features enabled by C<--enable-frills> (possibly 2432A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2172in combination with other switches) is: 2433in combination with other switches) is:
2173 2434
2174 MWM-hints 2435 MWM-hints
2175 EWMH-hints (pid, utf8 names) and protocols (ping) 2436 EWMH-hints (pid, utf8 names) and protocols (ping)
2437 urgency hint
2176 seperate underline colour (-underlineColor) 2438 seperate underline colour (-underlineColor)
2177 settable border widths and borderless switch (-w, -b, -bl) 2439 settable border widths and borderless switch (-w, -b, -bl)
2178 visual depth selection (-depth) 2440 visual depth selection (-depth)
2179 settable extra linespacing /-lsp) 2441 settable extra linespacing /-lsp)
2180 iso-14755-2 and -3, and visual feedback 2442 iso-14755 5.1 (basic) support
2181 tripleclickwords (-tcw) 2443 tripleclickwords (-tcw)
2182 settable insecure mode (-insecure) 2444 settable insecure mode (-insecure)
2183 keysym remapping support 2445 keysym remapping support
2184 cursor blinking and underline cursor (-cb, -uc) 2446 cursor blinking and underline cursor (-bc, -uc)
2185 XEmbed support (-embed) 2447 XEmbed support (-embed)
2186 user-pty (-pty-fd) 2448 user-pty (-pty-fd)
2187 hold on exit (-hold) 2449 hold on exit (-hold)
2450 compile in built-in block graphics
2188 skip builtin block graphics (-sbg) 2451 skip builtin block graphics (-sbg)
2452 separate highlightcolor support (-hc)
2189 2453
2190It also enabled some non-essential features otherwise disabled, such as: 2454It also enables some non-essential features otherwise disabled, such as:
2191 2455
2192 some round-trip time optimisations 2456 some round-trip time optimisations
2193 nearest color allocation on pseudocolor screens 2457 nearest color allocation on pseudocolor screens
2194 UTF8_STRING supporr for selection 2458 UTF8_STRING support for selection
2195 sgr modes 90..97 and 100..107 2459 sgr modes 90..97 and 100..107
2196 backindex and forwardindex escape sequences 2460 backindex and forwardindex escape sequences
2197 view change/zero scorllback esacpe sequences 2461 view change/zero scrollback escape sequences
2198 locale switching escape sequence 2462 locale switching escape sequence
2199 window op and some xterm/OSC escape sequences 2463 window op and some xterm/OSC escape sequences
2200 rectangular selections 2464 rectangular selections
2201 trailing space removal for selections 2465 trailing space removal for selections
2202 verbose X error handling 2466 verbose X error handling
2203 2467
2204=item --enable-iso14755 (default: on) 2468=item --enable-iso14755 (default: on)
2205 2469
2206Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2470Enable extended ISO 14755 support (see @@RXVT_NAME@@(1)).
2207F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2471Basic support (section 5.1) is enabled by C<--enable-frills>, while
2208C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with 2472support for 5.2, 5.3 and 5.4 is enabled with this switch.
2209this switch.
2210 2473
2211=item --enable-keepscrolling (default: on) 2474=item --enable-keepscrolling (default: on)
2212 2475
2213Add support for continual scrolling of the display when you hold 2476Add support for continual scrolling of the display when you hold
2214the mouse button down on a scrollbar arrow. 2477the mouse button down on a scrollbar arrow.
2478
2479=item --enable-selectionscrolling (default: on)
2480
2481Add support for scrolling when the selection moves to the top or
2482bottom of the screen.
2215 2483
2216=item --enable-mousewheel (default: on) 2484=item --enable-mousewheel (default: on)
2217 2485
2218Add support for scrolling via mouse wheel or buttons 4 & 5. 2486Add support for scrolling via mouse wheel or buttons 4 & 5.
2219 2487
2221 2489
2222Add support for continual scrolling (using the mouse wheel as an 2490Add support for continual scrolling (using the mouse wheel as an
2223accelerator) while the control key is held down. This option 2491accelerator) while the control key is held down. This option
2224requires --enable-mousewheel to also be specified. 2492requires --enable-mousewheel to also be specified.
2225 2493
2226=item --disable-new-selection
2227
2228Remove support for mouse selection style like that of xterm.
2229
2230=item --enable-dmalloc (default: off)
2231
2232Use Gray Watson's malloc - which is good for debugging See
2233http://www.letters.com/dmalloc/ for details If you use either this or the
2234next option, you may need to edit src/Makefile after compiling to point
2235DINCLUDE and DLIB to the right places.
2236
2237You can only use either this option and the following (should
2238you use either) .
2239
2240=item --enable-dlmalloc (default: off)
2241
2242Use Doug Lea's malloc - which is good for a production version
2243See L<http://g.oswego.edu/dl/html/malloc.html> for details.
2244
2245=item --enable-smart-resize (default: on) 2494=item --enable-smart-resize (default: off)
2246 2495
2247Add smart growth/shrink behaviour when changing font size via hot 2496Add smart growth/shrink behaviour when resizing.
2248keys. This should keep the window corner which is closest to a corner of 2497This should keep the window corner which is closest to a corner of
2249the screen in a fixed position. 2498the screen in a fixed position.
2250 2499
2500=item --enable-text-blink (default: on)
2501
2502Add support for blinking text.
2503
2251=item --enable-pointer-blank (default: on) 2504=item --enable-pointer-blank (default: on)
2252 2505
2253Add support to have the pointer disappear when typing or inactive. 2506Add support to have the pointer disappear when typing or inactive.
2254 2507
2255=item --enable-perl (default: on) 2508=item --enable-perl (default: on)
2256 2509
2257Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)> 2510Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2258manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files 2511manpage for more info on this feature, or the files in F<src/perl/>
2259in F<src/perl-ext/> for the extensions that are installed by default. The 2512for the extensions that are installed by default.
2260perl interpreter that is used can be specified via the C<PERL> environment 2513The perl interpreter that is used can be specified via the C<PERL>
2261variable when running configure. 2514environment variable when running configure. Even when compiled in,
2515perl will I<not> be initialised when all extensions have been disabled
2516C<-pe "" --perl-ext-common "">, so it should be safe to enable from a
2517resource standpoint.
2518
2519=item --with-afterimage-config=DIR
2520
2521Look for the libAfterImage config script in DIR.
2262 2522
2263=item --with-name=NAME (default: urxvt) 2523=item --with-name=NAME (default: urxvt)
2264 2524
2265Set the basename for the installed binaries, resulting 2525Set the basename for the installed binaries, resulting
2266in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with 2526in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with
2276PATH. 2536PATH.
2277 2537
2278=item --with-x 2538=item --with-x
2279 2539
2280Use the X Window System (pretty much default, eh?). 2540Use the X Window System (pretty much default, eh?).
2281
2282=item --with-xpm-includes=DIR
2283
2284Look for the XPM includes in DIR.
2285
2286=item --with-xpm-library=DIR
2287
2288Look for the XPM library in DIR.
2289
2290=item --with-xpm
2291
2292Not needed - define via --enable-xpm-background.
2293 2541
2294=back 2542=back
2295 2543
2296=head1 AUTHORS 2544=head1 AUTHORS
2297 2545

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines