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.64 by root, Sat Dec 24 12:55:17 2005 UTC vs.
Revision 1.100 by root, Tue Jan 31 01:00:49 2006 UTC

16=head1 DESCRIPTION 16=head1 DESCRIPTION
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 21The newest version of this document is also available on the World Wide Web at
22also available on the World Wide Web at
23L<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>. 22L<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>.
24 23
25=head1 FREQUENTLY ASKED QUESTIONS 24=head1 FREQUENTLY ASKED QUESTIONS
26 25
27=over 4 26=head2 The new selection selects pieces that are too big, how can I select
27single words?
28 28
29If you want to select e.g. alphanumeric words, you can use the following
30setting:
31
32 URxvt.selection.pattern-0: ([[:word:]]+)
33
34If you click more than twice, the selection will be extended
35more and more.
36
37To get a selection that is very similar to the old code, try this pattern:
38
39 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+)
40
41Please also note that the I<LeftClick Shift-LeftClik> combination also
42selects words like the old code.
43
44=head2 I don't like the new selection/popups/hotkeys/perl, how do I
45change/disable it?
46
47You can disable the perl extension completely by setting the
48B<perl-ext-common> resource to the empty string, which also keeps
49rxvt-unicode from initialising perl, saving memory.
50
51If you only want to disable specific features, you first have to
52identify which perl extension is responsible. For this, read the section
53B<PREPACKAGED EXTENSIONS> in the @@RXVT_NAME@@perl(3) manpage. For
54example, to disable the B<selection-popup> and B<option-popup>, specify
55this B<perl-ext-common> resource:
56
57 URxvt.perl-ext-common: default,-selection-popup,-option-popup
58
59This will keep the default extensions, but disable the two popup
60extensions. Some extensions can also be configured, for example,
61scrollback search mode is triggered by B<M-s>. You can move it to any
62other combination either by setting the B<searchable-scrollback> resource:
63
64 URxvt.searchable-scrollback: CM-s
65
66=head3 The cursor moves when selecting text in the current input line, how
67do I switch this off?
68
69See next entry.
70
71=head2 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
84
85=head2 Why doesn't rxvt-unicode read my resources?
86
87Well, why, indeed? It does, in a way very similar to other X
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
93If you have or use an F<$HOME/.Xresources> file, chances are that
94resources are loaded into your X-server. In this case, you have to
95re-login after every change (or run F<xrdb -merge $HOME/.Xresources>).
96
97Also consider the form resources have to use:
98
99 URxvt.resource: value
100
101If you want to use another form (there are lots of different ways of
102specifying resources), make sure you understand wether and why it
103works. If unsure, use the form above.
104
105=head2 I can't get transparency working, what am I doing wrong?
106
107First of all, transparency isn't officially supported in rxvt-unicode, so
108you are mostly on your own. Do not bug the author about it (but you may
109bug everybody else). Also, if you can't get it working consider it a rite
110of passage: ... and you failed.
111
112Here are four ways to get transparency. B<Do> read the manpage and option
113descriptions for the programs mentioned and rxvt-unicode. Really, do it!
114
1151. Use inheritPixmap:
116
117 Esetroot wallpaper.jpg
118 @@RXVT_NAME@@ -ip -tint red -sh 40
119
120That works. If you think it doesn't, you lack transparency and tinting
121support, or you are unable to read.
122
1232. Use a simple pixmap and emulate pseudo-transparency. This enables you
124to use effects other than tinting and shading: Just shade/tint/whatever
125your picture with gimp:
126
127 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
128 @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
129
130That works. If you think it doesn't, you lack XPM and Perl support, or you
131are unable to read.
132
1333. Use an ARGB visual:
134
135 @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
136
137This requires XFT support, and the support of your X-server. If that
138doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
139there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
140bugfixes and workarounds for Xft and Xlib to make it work, but that
141doesn't mean that your WM has the required kludges in place.
142
1434. Use xcompmgr and let it do the job:
144
145 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \
146 -set _NET_WM_WINDOW_OPACITY 0xc0000000
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
29=item Isn't rxvt supposed to be small? Don't all those features bloat? 152=head2 Isn't rxvt supposed to be small? Don't all those features bloat?
30 153
31I often get asked about this, and I think, no, they didn't cause extra 154I often get asked about this, and I think, no, they didn't cause extra
32bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 155bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
33that the urxvt binary is larger (due to some encoding tables always being 156that the urxvt binary is larger (due to some encoding tables always being
34compiled in), but it actually uses less memory (RSS) after startup. Even 157compiled in), but it actually uses less memory (RSS) after startup. Even
62memory. 185memory.
63 186
64Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this 187Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this
65still fares rather well. And compared to some monsters like gnome-terminal 188still fares rather well. And compared to some monsters like gnome-terminal
66(21152k + extra 4204k in separate processes) or konsole (22200k + extra 189(21152k + extra 4204k in separate processes) or konsole (22200k + extra
6743180k in daemons that stay around after exit, plus half aminute of 19043180k in daemons that stay around after exit, plus half a minute of
68startup time, including the hundreds of warnings it spits out), it fares 191startup time, including the hundreds of warnings it spits out), it fares
69extremely well *g*. 192extremely well *g*.
70 193
71=item Why C++, isn't that unportable/bloated/uncool? 194=head2 Why C++, isn't that unportable/bloated/uncool?
72 195
73Is this a question? :) It comes up very often. The simple answer is: I had 196Is this a question? :) It comes up very often. The simple answer is: I had
74to write it, and C++ allowed me to write and maintain it in a fraction 197to write it, and C++ allowed me to write and maintain it in a fraction
75of the time and effort (which is a scarce resource for me). Put even 198of the time and effort (which is a scarce resource for me). Put even
76shorter: It simply wouldn't exist without C++. 199shorter: It simply wouldn't exist without C++.
100 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 223 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
101 224
102No large bloated libraries (of course, none were linked in statically), 225No large bloated libraries (of course, none were linked in statically),
103except maybe libX11 :) 226except maybe libX11 :)
104 227
105=item Does it support tabs, can I have a tabbed rxvt-unicode? 228=head2 Does it support tabs, can I have a tabbed rxvt-unicode?
106 229
107rxvt-unicode does not directly support tabs. It will work fine with 230Beginning with version 7.3, there is a perl extension that implements a
108tabbing functionality of many window managers or similar tabbing programs, 231simple tabbed terminal. It is installed by default, so any of these should
109and its embedding-features allow it to be embedded into other programs, 232give you tabs:
110as witnessed by F<doc/rxvt-tabbed> or the upcoming C<Gtk2::URxvt> perl
111module, which features a tabbed urxvt (murxvt) terminal as an example
112embedding application.
113 233
234 @@RXVT_NAME@@ -pe tabbed
235
236 URxvt.perl-ext-common: default,tabbed
237
238It will also work fine with tabbing functionality of many window managers
239or similar tabbing programs, and its embedding-features allow it to be
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
114=item How do I know which rxvt-unicode version I'm using? 244=head2 How do I know which rxvt-unicode version I'm using?
115 245
116The version number is displayed with the usage (-h). Also the escape 246The version number is displayed with the usage (-h). Also the escape
117sequence C<ESC [ 8 n> sets the window title to the version number. When 247sequence C<ESC [ 8 n> sets the window title to the version number. When
118using the @@RXVT_NAME@@c client, the version displayed is that of the 248using the @@RXVT_NAME@@c client, the version displayed is that of the
119daemon. 249daemon.
120 250
121=item I am using Debian GNU/Linux and have a problem... 251=head2 I am using Debian GNU/Linux and have a problem...
122 252
123The Debian GNU/Linux package of rxvt-unicode in sarge contains large 253The Debian GNU/Linux package of rxvt-unicode in sarge contains large
124patches that considerably change the behaviour of rxvt-unicode. Before 254patches that considerably change the behaviour of rxvt-unicode (but
125reporting a bug to the original rxvt-unicode author please download and 255unfortunately this notice has been removed). Before reporting a bug to
126install the genuine version (L<http://software.schmorp.de#rxvt-unicode>) 256the original rxvt-unicode author please download and install the genuine
127and try to reproduce the problem. If you cannot, chances are that the 257version (L<http://software.schmorp.de#rxvt-unicode>) and try to reproduce
128problems are specific to Debian GNU/Linux, in which case it should be 258the problem. If you cannot, chances are that the problems are specific to
129reported via the Debian Bug Tracking System (use C<reportbug> to report 259Debian GNU/Linux, in which case it should be reported via the Debian Bug
130the bug). 260Tracking System (use C<reportbug> to report the bug).
131 261
132For other problems that also affect the Debian package, you can and 262For other problems that also affect the Debian package, you can and
133probably should use the Debian BTS, too, because, after all, it's also a 263probably should use the Debian BTS, too, because, after all, it's also a
134bug in the Debian version and it serves as a reminder for other users that 264bug in the Debian version and it serves as a reminder for other users that
135might encounter the same issue. 265might encounter the same issue.
136 266
267=head2 I am maintaining rxvt-unicode for distribution/OS XXX, any
268recommendation?
269
270You should build one binary with the default options. F<configure>
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
277You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources
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
283If you can/want build more binaries, I recommend building a minimal
284one with C<--disable-everything> (very useful) and a maximal one with
285C<--enable-everything> (less useful, it will be very big due to a lot of
286encodings built-in that increase download times and are rarely used).
287
288=head2 I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?
289
290It should be, starting with release 7.1. You are encouraged to properly
291install urxvt with privileges necessary for your OS now.
292
293When rxvt-unicode detects that it runs setuid or setgid, it will fork
294into a helper process for privileged operations (pty handling on some
295systems, utmp/wtmp/lastlog handling on others) and drop privileges
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
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
137=item When I log-in to another system it tells me about missing terminfo data? 305=head2 When I log-in to another system it tells me about missing terminfo data?
138 306
139The terminal description used by rxvt-unicode is not as widely available 307The terminal description used by rxvt-unicode is not as widely available
140as that for xterm, or even rxvt (for which the same problem often arises). 308as that for xterm, or even rxvt (for which the same problem often arises).
141 309
142The correct solution for this problem is to install the terminfo, this can 310The correct solution for this problem is to install the terminfo, this can
160 URxvt.termName: rxvt 328 URxvt.termName: rxvt
161 329
162If you don't plan to use B<rxvt> (quite common...) you could also replace 330If you don't plan to use B<rxvt> (quite common...) you could also replace
163the rxvt terminfo file with the rxvt-unicode one. 331the rxvt terminfo file with the rxvt-unicode one.
164 332
165=item C<tic> outputs some error when compiling the terminfo entry. 333=head2 C<tic> outputs some error when compiling the terminfo entry.
166 334
167Most likely it's the empty definition for C<enacs=>. Just replace it by 335Most likely it's the empty definition for C<enacs=>. Just replace it by
168C<enacs=\E[0@> and try again. 336C<enacs=\E[0@> and try again.
169 337
170=item C<bash>'s readline does not work correctly under @@RXVT_NAME@@. 338=head2 C<bash>'s readline does not work correctly under @@RXVT_NAME@@.
171 339
340See next entry.
341
172=item I need a termcap file entry. 342=head2 I need a termcap file entry.
173 343
174One reason you might want this is that some distributions or operating 344One reason you might want this is that some distributions or operating
175systems still compile some programs using the long-obsoleted termcap 345systems still compile some programs using the long-obsoleted termcap
176library (Fedora Core's bash is one example) and rely on a termcap entry 346library (Fedora Core's bash is one example) and rely on a termcap entry
177for C<rxvt-unicode>. 347for C<rxvt-unicode>.
203 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\ 373 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
204 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\ 374 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
205 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ 375 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
206 :vs=\E[?25h: 376 :vs=\E[?25h:
207 377
208=item Why does C<ls> no longer have coloured output? 378=head2 Why does C<ls> no longer have coloured output?
209 379
210The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to 380The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to
211decide wether a terminal has colour, but uses it's own configuration 381decide wether a terminal has colour, but uses it's own configuration
212file. Needless to say, C<rxvt-unicode> is not in it's default file (among 382file. Needless to say, C<rxvt-unicode> is not in it's default file (among
213with most other terminals supporting colour). Either add: 383with most other terminals supporting colour). Either add:
218 388
219 alias ls='ls --color=auto' 389 alias ls='ls --color=auto'
220 390
221to your C<.profile> or C<.bashrc>. 391to your C<.profile> or C<.bashrc>.
222 392
223=item Why doesn't vim/emacs etc. use the 88 colour mode? 393=head2 Why doesn't vim/emacs etc. use the 88 colour mode?
224 394
395See next entry.
396
225=item Why doesn't vim/emacs etc. make use of italic? 397=head2 Why doesn't vim/emacs etc. make use of italic?
226 398
399See next entry.
400
227=item Why are the secondary screen-related options not working properly? 401=head2 Why are the secondary screen-related options not working properly?
228 402
229Make sure you are using C<TERM=rxvt-unicode>. Some pre-packaged 403Make sure you are using C<TERM=rxvt-unicode>. Some pre-packaged
230distributions (most notably Debian GNU/Linux) break rxvt-unicode 404distributions (most notably Debian GNU/Linux) break rxvt-unicode
231by setting C<TERM> to C<rxvt>, which doesn't have these extra 405by setting C<TERM> to C<rxvt>, which doesn't have these extra
232features. Unfortunately, some of these (most notably, again, Debian 406features. Unfortunately, some of these (most notably, again, Debian
233GNU/Linux) furthermore fail to even install the C<rxvt-unicode> terminfo 407GNU/Linux) furthermore fail to even install the C<rxvt-unicode> terminfo
234file, so you will need to install it on your own (See the question B<When 408file, so you will need to install it on your own (See the question B<When
235I log-in to another system it tells me about missing terminfo data?> on 409I log-in to another system it tells me about missing terminfo data?> on
236how to do this). 410how to do this).
237 411
238=item My numerical keypad acts weird and generates differing output? 412=head2 My numerical keypad acts weird and generates differing output?
239 413
240Some Debian GNUL/Linux users seem to have this problem, although no 414Some Debian GNUL/Linux users seem to have this problem, although no
241specific details were reported so far. It is possible that this is caused 415specific details were reported so far. It is possible that this is caused
242by the wrong C<TERM> setting, although the details of wether and how 416by the wrong C<TERM> setting, although the details of wether and how
243this can happen are unknown, as C<TERM=rxvt> should offer a compatible 417this can happen are unknown, as C<TERM=rxvt> should offer a compatible
244keymap. See the answer to the previous question, and please report if that 418keymap. See the answer to the previous question, and please report if that
245helped. 419helped.
246 420
247=item Rxvt-unicode does not seem to understand the selected encoding? 421=head2 Rxvt-unicode does not seem to understand the selected encoding?
248 422
423See next entry.
424
249=item Unicode does not seem to work? 425=head2 Unicode does not seem to work?
250 426
251If you encounter strange problems like typing an accented character but 427If you encounter strange problems like typing an accented character but
252getting two unrelated other characters or similar, or if program output is 428getting two unrelated other characters or similar, or if program output is
253subtly garbled, then you should check your locale settings. 429subtly garbled, then you should check your locale settings.
254 430
274 450
275If nothing works and you are sure that everything is set correctly then 451If nothing works and you are sure that everything is set correctly then
276you will need to remember a little known fact: Some programs just don't 452you will need to remember a little known fact: Some programs just don't
277support locales :( 453support locales :(
278 454
279=item Why do some characters look so much different than others? 455=head2 Why do some characters look so much different than others?
280 456
457See next entry.
458
281=item How does rxvt-unicode choose fonts? 459=head2 How does rxvt-unicode choose fonts?
282 460
283Most fonts do not contain the full range of Unicode, which is 461Most fonts do not contain the full range of Unicode, which is
284fine. Chances are that the font you (or the admin/package maintainer of 462fine. Chances are that the font you (or the admin/package maintainer of
285your system/os) have specified does not cover all the characters you want 463your system/os) have specified does not cover all the characters you want
286to display. 464to display.
304 482
305The only limitation is that none of the fonts may be larger than the base 483The only limitation is that none of the fonts may be larger than the base
306font, as the base font defines the terminal character cell size, which 484font, as the base font defines the terminal character cell size, which
307must be the same due to the way terminals work. 485must be the same due to the way terminals work.
308 486
309=item Why do some chinese characters look so different than others? 487=head2 Why do some chinese characters look so different than others?
310 488
311This is because there is a difference between script and language -- 489This is because there is a difference between script and language --
312rxvt-unicode does not know which language the text that is output is, 490rxvt-unicode does not know which language the text that is output is,
313as it only knows the unicode character codes. If rxvt-unicode first 491as it only knows the unicode character codes. If rxvt-unicode first
314sees a japanese/chinese character, it might choose a japanese font for 492sees a japanese/chinese character, it might choose a japanese font for
329has been designed yet). 507has been designed yet).
330 508
331Until then, you might get away with switching fonts at runtime (see L<Can 509Until then, you might get away with switching fonts at runtime (see L<Can
332I switch the fonts at runtime?> later in this document). 510I switch the fonts at runtime?> later in this document).
333 511
334=item Why does rxvt-unicode sometimes leave pixel droppings? 512=head2 Why does rxvt-unicode sometimes leave pixel droppings?
335 513
336Most fonts were not designed for terminal use, which means that character 514Most fonts were not designed for terminal use, which means that character
337size varies a lot. A font that is otherwise fine for terminal use might 515size varies a lot. A font that is otherwise fine for terminal use might
338contain some characters that are simply too wide. Rxvt-unicode will avoid 516contain some characters that are simply too wide. Rxvt-unicode will avoid
339these characters. For characters that are just "a bit" too wide a special 517these characters. For characters that are just "a bit" too wide a special
351might be forced to use a different font. 529might be forced to use a different font.
352 530
353All of this is not a problem when using X11 core fonts, as their bounding 531All of this is not a problem when using X11 core fonts, as their bounding
354box data is correct. 532box data is correct.
355 533
356=item On Solaris 9, many line-drawing characters are too wide. 534=head2 On Solaris 9, many line-drawing characters are too wide.
357 535
358Seems to be a known bug, read 536Seems to be a known bug, read
359L<http://nixdoc.net/files/forum/about34198.html>. Some people use the 537L<http://nixdoc.net/files/forum/about34198.html>. Some people use the
360following ugly workaround to get non-double-wide-characters working: 538following ugly workaround to get non-double-wide-characters working:
361 539
362 #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x) 540 #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
363 541
364=item My Compose (Multi_key) key is no longer working. 542=head2 My Compose (Multi_key) key is no longer working.
365 543
366The most common causes for this are that either your locale is not set 544The most common causes for this are that either your locale is not set
367correctly, or you specified a B<preeditStyle> that is not supported by 545correctly, or you specified a B<preeditStyle> that is not supported by
368your input method. For example, if you specified B<OverTheSpot> and 546your input method. For example, if you specified B<OverTheSpot> and
369your input method (e.g. the default input method handling Compose keys) 547your input method (e.g. the default input method handling Compose keys)
371rxvt-unicode will continue without an input method. 549rxvt-unicode will continue without an input method.
372 550
373In this case either do not specify a B<preeditStyle> or specify more than 551In this case either do not specify a B<preeditStyle> or specify more than
374one pre-edit style, such as B<OverTheSpot,Root,None>. 552one pre-edit style, such as B<OverTheSpot,Root,None>.
375 553
376=item I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755 554=head2 I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755
377 555
378Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on 556Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on
379international keyboards) or simply use ISO 14755 support to your 557international keyboards) or simply use ISO 14755 support to your
380advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for other 558advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for other
381codes, too, such as C<Ctrl-Shift-1-d> to type the default telnet escape 559codes, too, such as C<Ctrl-Shift-1-d> to type the default telnet escape
382character and so on. 560character and so on.
383 561
384=item How can I keep rxvt-unicode from using reverse video so much? 562=head2 How can I keep rxvt-unicode from using reverse video so much?
385 563
386First of all, make sure you are running with the right terminal settings 564First of all, make sure you are running with the right terminal settings
387(C<TERM=rxvt-unicode>), which will get rid of most of these effects. Then 565(C<TERM=rxvt-unicode>), which will get rid of most of these effects. Then
388make sure you have specified colours for italic and bold, as otherwise 566make sure you have specified colours for italic and bold, as otherwise
389rxvt-unicode might use reverse video to simulate the effect: 567rxvt-unicode might use reverse video to simulate the effect:
390 568
391 URxvt.colorBD: white 569 URxvt.colorBD: white
392 URxvt.colorIT: green 570 URxvt.colorIT: green
393 571
394=item Some programs assume totally weird colours (red instead of blue), how can I fix that? 572=head2 Some programs assume totally weird colours (red instead of blue), how can I fix that?
395 573
396For some unexplainable reason, some rare programs assume a very weird 574For some unexplainable reason, some rare programs assume a very weird
397colour palette when confronted with a terminal with more than the standard 575colour palette when confronted with a terminal with more than the standard
3988 colours (rxvt-unicode supports 88). The right fix is, of course, to fix 5768 colours (rxvt-unicode supports 88). The right fix is, of course, to fix
399these programs not to assume non-ISO colours without very good reasons. 577these programs not to assume non-ISO colours without very good reasons.
400 578
401In the meantime, you can either edit your C<rxvt-unicode> terminfo 579In the meantime, you can either edit your C<rxvt-unicode> terminfo
402definition to only claim 8 colour support or use C<TERM=rxvt>, which will 580definition to only claim 8 colour support or use C<TERM=rxvt>, which will
403fix colours but keep you from using other rxvt-unicode features. 581fix colours but keep you from using other rxvt-unicode features.
404 582
405=item I am on FreeBSD and rxvt-unicode does not seem to work at all. 583=head2 I am on FreeBSD and rxvt-unicode does not seem to work at all.
406 584
407Rxvt-unicode requires the symbol C<__STDC_ISO_10646__> to be defined 585Rxvt-unicode requires the symbol C<__STDC_ISO_10646__> to be defined
408in your compile environment, or an implementation that implements it, 586in your compile environment, or an implementation that implements it,
409wether it defines the symbol or not. C<__STDC_ISO_10646__> requires that 587wether it defines the symbol or not. C<__STDC_ISO_10646__> requires that
410B<wchar_t> is represented as unicode. 588B<wchar_t> is represented as unicode.
432 610
433The rxvt-unicode author insists that the right way to fix this is in the 611The rxvt-unicode author insists that the right way to fix this is in the
434system libraries once and for all, instead of forcing every app to carry 612system libraries once and for all, instead of forcing every app to carry
435complete replacements for them :) 613complete replacements for them :)
436 614
437=item I use Solaris 9 and it doesn't compile/work/etc. 615=head2 I use Solaris 9 and it doesn't compile/work/etc.
438 616
439Try the diff in F<doc/solaris9.patch> as a base. It fixes the worst 617Try the diff in F<doc/solaris9.patch> as a base. It fixes the worst
440problems with C<wcwidth> and a compile problem. 618problems with C<wcwidth> and a compile problem.
441 619
442=item How can I use rxvt-unicode under cygwin? 620=head2 How can I use rxvt-unicode under cygwin?
443 621
444rxvt-unicode should compile and run out of the box on cygwin, using 622rxvt-unicode should compile and run out of the box on cygwin, using
445the X11 libraries that come with cygwin. libW11 emulation is no 623the X11 libraries that come with cygwin. libW11 emulation is no
446longer supported (and makes no sense, either, as it only supported a 624longer supported (and makes no sense, either, as it only supported a
447single font). I recommend starting the X-server in C<-multiwindow> or 625single font). I recommend starting the X-server in C<-multiwindow> or
450 628
451At the time of this writing, cygwin didn't seem to support any multi-byte 629At the time of this writing, cygwin didn't seem to support any multi-byte
452encodings (you might try C<LC_CTYPE=C-UTF-8>), so you are likely limited 630encodings (you might try C<LC_CTYPE=C-UTF-8>), so you are likely limited
453to 8-bit encodings. 631to 8-bit encodings.
454 632
455=item How does rxvt-unicode determine the encoding to use? 633=head2 How does rxvt-unicode determine the encoding to use?
456 634
635See next entry.
636
457=item Is there an option to switch encodings? 637=head2 Is there an option to switch encodings?
458 638
459Unlike some other terminals, rxvt-unicode has no encoding switch, and no 639Unlike some other terminals, rxvt-unicode has no encoding switch, and no
460specific "utf-8" mode, such as xterm. In fact, it doesn't even know about 640specific "utf-8" mode, such as xterm. In fact, it doesn't even know about
461UTF-8 or any other encodings with respect to terminal I/O. 641UTF-8 or any other encodings with respect to terminal I/O.
462 642
487rxvt-unicode. 667rxvt-unicode.
488 668
489If you want to use a specific encoding you have to make sure you start 669If you want to use a specific encoding you have to make sure you start
490rxvt-unicode with the correct C<LC_CTYPE> category. 670rxvt-unicode with the correct C<LC_CTYPE> category.
491 671
492=item Can I switch locales at runtime? 672=head2 Can I switch locales at runtime?
493 673
494Yes, using an escape sequence. Try something like this, which sets 674Yes, using an escape sequence. Try something like this, which sets
495rxvt-unicode's idea of C<LC_CTYPE>. 675rxvt-unicode's idea of C<LC_CTYPE>.
496 676
497 printf '\e]701;%s\007' ja_JP.SJIS 677 printf '\e]701;%s\007' ja_JP.SJIS
509 689
510You can also use xterm's C<luit> program, which usually works fine, except 690You can also use xterm's C<luit> program, which usually works fine, except
511for some locales where character width differs between program- and 691for some locales where character width differs between program- and
512rxvt-unicode-locales. 692rxvt-unicode-locales.
513 693
514=item Can I switch the fonts at runtime? 694=head2 Can I switch the fonts at runtime?
515 695
516Yes, using an escape sequence. Try something like this, which has the same 696Yes, using an escape sequence. Try something like this, which has the same
517effect as using the C<-fn> switch, and takes effect immediately: 697effect as using the C<-fn> switch, and takes effect immediately:
518 698
519 printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic" 699 printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic"
522japanese font), but you have to switch to chinese temporarily, where 702japanese font), but you have to switch to chinese temporarily, where
523japanese fonts would only be in your way. 703japanese fonts would only be in your way.
524 704
525You can think of this as a kind of manual ISO-2022 switching. 705You can think of this as a kind of manual ISO-2022 switching.
526 706
527=item Why do italic characters look as if clipped? 707=head2 Why do italic characters look as if clipped?
528 708
529Many fonts have difficulties with italic characters and hinting. For 709Many fonts have difficulties with italic characters and hinting. For
530example, the otherwise very nicely hinted font C<xft:Bitstream Vera Sans 710example, the otherwise very nicely hinted font C<xft:Bitstream Vera Sans
531Mono> completely fails in it's italic face. A workaround might be to 711Mono> completely fails in it's italic face. A workaround might be to
532enable freetype autohinting, i.e. like this: 712enable freetype autohinting, i.e. like this:
533 713
534 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true 714 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
535 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true 715 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
536 716
537=item My input method wants <some encoding> but I want UTF-8, what can I do? 717=head2 My input method wants <some encoding> but I want UTF-8, what can I do?
538 718
539You can specify separate locales for the input method and the rest of the 719You can specify separate locales for the input method and the rest of the
540terminal, using the resource C<imlocale>: 720terminal, using the resource C<imlocale>:
541 721
542 URxvt*imlocale: ja_JP.EUC-JP 722 URxvt.imlocale: ja_JP.EUC-JP
543 723
544Now you can start your terminal with C<LC_CTYPE=ja_JP.UTF-8> and still 724Now you can start your terminal with C<LC_CTYPE=ja_JP.UTF-8> and still
545use your input method. Please note, however, that you will not be able to 725use your input method. Please note, however, that you will not be able to
546input characters outside C<EUC-JP> in a normal way then, as your input 726input characters outside C<EUC-JP> in a normal way then, as your input
547method limits you. 727method limits you.
548 728
549=item Rxvt-unicode crashes when the X Input Method changes or exits. 729=head2 Rxvt-unicode crashes when the X Input Method changes or exits.
550 730
551Unfortunately, this is unavoidable, as the XIM protocol is racy by 731Unfortunately, this is unavoidable, as the XIM protocol is racy by
552design. Applications can avoid some crashes at the expense of memory 732design. Applications can avoid some crashes at the expense of memory
553leaks, and Input Methods can avoid some crashes by careful ordering at 733leaks, and Input Methods can avoid some crashes by careful ordering at
554exit time. B<kinput2> (and derived input methods) generally succeeds, 734exit time. B<kinput2> (and derived input methods) generally succeeds,
555while B<SCIM> (or similar input methods) fails. In the end, however, 735while B<SCIM> (or similar input methods) fails. In the end, however,
556crashes cannot be completely avoided even if both sides cooperate. 736crashes cannot be completely avoided even if both sides cooperate.
557 737
558So the only workaround is not to kill your Input Method Servers. 738So the only workaround is not to kill your Input Method Servers.
559 739
560=item Rxvt-unicode uses gobs of memory, how can I reduce that? 740=head2 Rxvt-unicode uses gobs of memory, how can I reduce that?
561 741
562Rxvt-unicode tries to obey the rule of not charging you for something you 742Rxvt-unicode tries to obey the rule of not charging you for something you
563don't use. One thing you should try is to configure out all settings that 743don't use. One thing you should try is to configure out all settings that
564you don't need, for example, Xft support is a resource hog by design, 744you don't need, for example, Xft support is a resource hog by design,
565when used. Compiling it out ensures that no Xft font will be loaded 745when used. Compiling it out ensures that no Xft font will be loaded
5706 bytes per screen cell. For a 160x?? window this amounts to almost a 7506 bytes per screen cell. For a 160x?? window this amounts to almost a
571kilobyte per line. A scrollback buffer of 10000 lines will then (if full) 751kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
572use 10 Megabytes of memory. With C<--enable-unicode3> it gets worse, as 752use 10 Megabytes of memory. With C<--enable-unicode3> it gets worse, as
573rxvt-unicode then uses 8 bytes per screen cell. 753rxvt-unicode then uses 8 bytes per screen cell.
574 754
575=item Can I speed up Xft rendering somehow? 755=head2 Can I speed up Xft rendering somehow?
576 756
577Yes, the most obvious way to speed it up is to avoid Xft entirely, as 757Yes, the most obvious way to speed it up is to avoid Xft entirely, as
578it is simply slow. If you still want Xft fonts you might try to disable 758it is simply slow. If you still want Xft fonts you might try to disable
579antialiasing (by appending C<:antialias=false>), which saves lots of 759antialiasing (by appending C<:antialias=false>), which saves lots of
580memory and also speeds up rendering considerably. 760memory and also speeds up rendering considerably.
581 761
582=item Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? 762=head2 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
583 763
584Rxvt-unicode will use whatever you specify as a font. If it needs to 764Rxvt-unicode will use whatever you specify as a font. If it needs to
585fall back to it's default font search list it will prefer X11 core 765fall back to it's default font search list it will prefer X11 core
586fonts, because they are small and fast, and then use Xft fonts. It has 766fonts, because they are small and fast, and then use Xft fonts. It has
587antialiasing disabled for most of them, because the author thinks they 767antialiasing disabled for most of them, because the author thinks they
588look best that way. 768look best that way.
589 769
590If you want antialiasing, you have to specify the fonts manually. 770If you want antialiasing, you have to specify the fonts manually.
591 771
592=item Mouse cut/paste suddenly no longer works. 772=head2 Mouse cut/paste suddenly no longer works.
593 773
594Make sure that mouse reporting is actually turned off since killing 774Make sure that mouse reporting is actually turned off since killing
595some editors prematurely may leave the mouse in mouse report mode. I've 775some editors prematurely may leave the mouse in mouse report mode. I've
596heard that tcsh may use mouse reporting unless it otherwise specified. A 776heard that tcsh may use mouse reporting unless it otherwise specified. A
597quick check is to see if cut/paste works when the Alt or Shift keys are 777quick check is to see if cut/paste works when the Alt or Shift keys are
598depressed. See @@RXVT_NAME@@(7) 778depressed.
599 779
600=item What's with this bold/blink stuff? 780=head2 What's with this bold/blink stuff?
601 781
602If no bold colour is set via C<colorBD:>, bold will invert text using the 782If no bold colour is set via C<colorBD:>, bold will invert text using the
603standard foreground colour. 783standard foreground colour.
604 784
605For the standard background colour, blinking will actually make the 785For the standard background colour, blinking will actually make the
612 792
613color0-7 are the low-intensity colors. 793color0-7 are the low-intensity colors.
614 794
615color8-15 are the corresponding high-intensity colors. 795color8-15 are the corresponding high-intensity colors.
616 796
617=item I don't like the screen colors. How do I change them? 797=head2 I don't like the screen colors. How do I change them?
618 798
619You can change the screen colors at run-time using F<~/.Xdefaults> 799You can change the screen colors at run-time using F<~/.Xdefaults>
620resources (or as long-options). 800resources (or as long-options).
621 801
622Here are values that are supposed to resemble a VGA screen, 802Here are values that are supposed to resemble a VGA screen,
660 URxvt.color6: #73f7ff 840 URxvt.color6: #73f7ff
661 URxvt.color14: #73f7ff 841 URxvt.color14: #73f7ff
662 URxvt.color7: #e1dddd 842 URxvt.color7: #e1dddd
663 URxvt.color15: #e1dddd 843 URxvt.color15: #e1dddd
664 844
665=item How can I start @@RXVT_NAME@@d in a race-free way? 845=head2 How can I start @@RXVT_NAME@@d in a race-free way?
666 846
667Try C<@@RXVT_NAME@@d -f -o>, which tells @@RXVT_NAME@@d to open the 847Try C<@@RXVT_NAME@@d -f -o>, which tells @@RXVT_NAME@@d to open the
668display, create the listening socket and then fork. 848display, create the listening socket and then fork.
669 849
670=item What's with the strange Backspace/Delete key behaviour? 850=head2 What's with the strange Backspace/Delete key behaviour?
671 851
672Assuming that the physical Backspace key corresponds to the 852Assuming that the physical Backspace key corresponds to the
673BackSpace keysym (not likely for Linux ... see the following 853BackSpace keysym (not likely for Linux ... see the following
674question) there are two standard values that can be used for 854question) there are two standard values that can be used for
675Backspace: C<^H> and C<^?>. 855Backspace: C<^H> and C<^?>.
692 872
693 # use Backspace = ^? 873 # use Backspace = ^?
694 $ stty erase ^? 874 $ stty erase ^?
695 $ @@RXVT_NAME@@ 875 $ @@RXVT_NAME@@
696 876
697Toggle with C<ESC [ 36 h> / C<ESC [ 36 l> as documented in @@RXVT_NAME@@(7). 877Toggle with C<ESC [ 36 h> / C<ESC [ 36 l>.
698 878
699For an existing rxvt-unicode: 879For an existing rxvt-unicode:
700 880
701 # use Backspace = ^H 881 # use Backspace = ^H
702 $ stty erase ^H 882 $ stty erase ^H
721some editors (vim I'm told) expect Backspace = ^H, 901some editors (vim I'm told) expect Backspace = ^H,
722GNU Emacs (and Emacs-like editors) use ^H for help. 902GNU Emacs (and Emacs-like editors) use ^H for help.
723 903
724Perhaps someday this will all be resolved in a consistent manner. 904Perhaps someday this will all be resolved in a consistent manner.
725 905
726=item I don't like the key-bindings. How do I change them? 906=head2 I don't like the key-bindings. How do I change them?
727 907
728There are some compile-time selections available via configure. Unless 908There are some compile-time selections available via configure. Unless
729you have run "configure" with the C<--disable-resources> option you can 909you have run "configure" with the C<--disable-resources> option you can
730use the `keysym' resource to alter the keystrings associated with keysyms. 910use the `keysym' resource to alter the keystrings associated with keysyms.
731 911
752 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz > 932 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >
753 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007 933 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
754 934
755See some more examples in the documentation for the B<keysym> resource. 935See some more examples in the documentation for the B<keysym> resource.
756 936
757=item I'm using keyboard model XXX that has extra Prior/Next/Insert keys. 937=head2 I'm using keyboard model XXX that has extra Prior/Next/Insert keys.
758How do I make use of them? For example, the Sun Keyboard type 4 938How do I make use of them? For example, the Sun Keyboard type 4
759has the following mappings that rxvt-unicode doesn't recognize. 939has the following mappings that rxvt-unicode doesn't recognize.
760 940
761 KP_Insert == Insert 941 KP_Insert == Insert
762 F22 == Print 942 F22 == Print
767 947
768Rather than have rxvt-unicode try to accommodate all the various possible 948Rather than have rxvt-unicode try to accommodate all the various possible
769keyboard mappings, it is better to use `xmodmap' to remap the keys as 949keyboard mappings, it is better to use `xmodmap' to remap the keys as
770required for your particular machine. 950required for your particular machine.
771 951
772=item How do I distinguish wether I'm running rxvt-unicode or a regular xterm? 952=head2 How do I distinguish wether I'm running rxvt-unicode or a regular xterm?
773I need this to decide about setting colors etc. 953I need this to decide about setting colors etc.
774 954
775rxvt and rxvt-unicode always export the variable "COLORTERM", so you can 955rxvt and rxvt-unicode always export the variable "COLORTERM", so you can
776check and see if that is set. Note that several programs, JED, slrn, 956check and see if that is set. Note that several programs, JED, slrn,
777Midnight Commander automatically check this variable to decide whether or 957Midnight Commander automatically check this variable to decide whether or
778not to use color. 958not to use color.
779 959
780=item How do I set the correct, full IP address for the DISPLAY variable? 960=head2 How do I set the correct, full IP address for the DISPLAY variable?
781 961
782If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled 962If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
783insecure mode then it is possible to use the following shell script 963insecure mode then it is possible to use the following shell script
784snippets to correctly set the display. If your version of rxvt-unicode 964snippets to correctly set the display. If your version of rxvt-unicode
785wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then 965wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then
800 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string 980 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
801 read DISPLAY # set it in our local shell 981 read DISPLAY # set it in our local shell
802 fi 982 fi
803 fi 983 fi
804 984
805=item How do I compile the manual pages for myself? 985=head2 How do I compile the manual pages for myself?
806 986
807You need to have a recent version of perl installed as F</usr/bin/perl>, 987You need to have a recent version of perl installed as F</usr/bin/perl>,
808one that comes with F<pod2man>, F<pod2text> and F<pod2html>. Then go to 988one that comes with F<pod2man>, F<pod2text> and F<pod2html>. Then go to
809the doc subdirectory and enter C<make alldoc>. 989the doc subdirectory and enter C<make alldoc>.
810 990
811=item My question isn't answered here, can I ask a human? 991=head2 My question isn't answered here, can I ask a human?
812 992
813Before sending me mail, you could go to IRC: C<irc.freenode.net>, 993Before sending me mail, you could go to IRC: C<irc.freenode.net>,
814channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be 994channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be
815interested in learning about new and exciting problems (but not FAQs :). 995interested in learning about new and exciting problems (but not FAQs :).
816 996
817=back
818
819=head1 RXVT TECHNICAL REFERENCE 997=head1 RXVT TECHNICAL REFERENCE
820 998
821=head1 DESCRIPTION 999=head1 DESCRIPTION
822 1000
823The rest of this document describes various technical aspects of 1001The rest of this document describes various technical aspects of
824B<rxvt-unicode>. First the description of supported command sequences, 1002B<rxvt-unicode>. First the description of supported command sequences,
825followed by menu and pixmap support and last by a description of all 1003followed by pixmap support and last by a description of all features
826features selectable at C<configure> time. 1004selectable at C<configure> time.
827 1005
828=head1 Definitions 1006=head1 Definitions
829 1007
830=over 4 1008=over 4
831 1009
1399 B<< C<h> >> Send Mouse X & Y on button press. 1577 B<< C<h> >> Send Mouse X & Y on button press.
1400 B<< C<l> >> No mouse reporting. 1578 B<< C<l> >> No mouse reporting.
1401 1579
1402=end table 1580=end table
1403 1581
1404=item B<< C<Ps = 10> >> (B<rxvt>)
1405
1406=begin table
1407
1408 B<< C<h> >> menuBar visible
1409 B<< C<l> >> menuBar invisible
1410
1411=end table
1412
1413=item B<< C<Ps = 25> >> 1582=item B<< C<Ps = 25> >>
1414 1583
1415=begin table 1584=begin table
1416 1585
1417 B<< C<h> >> Visible cursor {cnorm/cvvis} 1586 B<< C<h> >> Visible cursor {cnorm/cvvis}
1530 1699
1531=begin table 1700=begin table
1532 1701
1533 B<< C<h> >> Scroll to bottom when a key is pressed 1702 B<< C<h> >> Scroll to bottom when a key is pressed
1534 B<< C<l> >> Don't scroll to bottom when a key is pressed 1703 B<< C<l> >> Don't scroll to bottom when a key is pressed
1704
1705=end table
1706
1707=item B<< C<Ps = 1021> >> (B<rxvt>)
1708
1709=begin table
1710
1711 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>)
1712 B<< C<l> >> Font styles have no effect on intensity (Compile styles)
1535 1713
1536=end table 1714=end table
1537 1715
1538=item B<< C<Ps = 1047> >> 1716=item B<< C<Ps = 1047> >>
1539 1717
1588 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<(NB: may change in future)> 1766 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<(NB: may change in future)>
1589 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> B<(NB: may change in future)> 1767 B<< C<Ps = 11> >> Change colour of text background to B<< C<Pt> >> B<(NB: may change in future)>
1590 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >> 1768 B<< C<Ps = 12> >> Change colour of text cursor foreground to B<< C<Pt> >>
1591 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >> 1769 B<< C<Ps = 13> >> Change colour of mouse foreground to B<< C<Pt> >>
1592 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >> 1770 B<< C<Ps = 17> >> Change colour of highlight characters to B<< C<Pt> >>
1593 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> 1771 B<< C<Ps = 18> >> Change colour of bold characters to B<< C<Pt> >> [deprecated, see 706]
1594 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> 1772 B<< C<Ps = 19> >> Change colour of underlined characters to B<< C<Pt> >> [deprecated, see 707]
1595 B<< C<Ps = 20> >> Change default background to B<< C<Pt> >> 1773 B<< C<Ps = 20> >> Change background pixmap parameters (see section XPM) (Compile XPM).
1596 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>. 1774 B<< C<Ps = 39> >> Change default foreground colour to B<< C<Pt> >>.
1597 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> 1775 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
1598 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. 1776 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>.
1599 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> >> 1777 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> >>
1600 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> 1778 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >>
1601 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). 1779 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).
1602 B<< C<Ps = 703> >> Menubar command B<< C<Pt> >> (Compile menubar). 1780 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>.
1603 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> 1781 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >>
1604 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). 1782 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency).
1783 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
1784 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >>
1605 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. 1785 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>.
1606 B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 1786 B<< C<Ps = 711> >> Set bold fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
1607 B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 1787 B<< C<Ps = 712> >> Set italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
1608 B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles). 1788 B<< C<Ps = 713> >> Set bold-italic fontset to B<< C<Pt> >>. Similar to C<Ps = 50> (Compile styles).
1609 B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). 1789 B<< C<Ps = 720> >> Move viewing window up by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
1610 B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills). 1790 B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
1791 B<< C<Ps = 777> >> Call the perl extension with the given string, which should be of the form C<extension:parameters> (Compile perl).
1611 1792
1612=end table 1793=end table
1613 1794
1614=back 1795=back
1615 1796
1616X<menuBar>
1617
1618=head1 menuBar
1619
1620B<< The exact syntax used is I<almost> solidified. >>
1621In the menus, B<DON'T> try to use menuBar commands that add or remove a
1622menuBar.
1623
1624Note that in all of the commands, the B<< I</path/> >> I<cannot> be
1625omitted: use B<./> to specify a menu relative to the current menu.
1626
1627=head2 Overview of menuBar operation
1628
1629For the menuBar XTerm escape sequence C<ESC ] 703 ; Pt ST>, the syntax
1630of C<Pt> can be used for a variety of tasks:
1631
1632At the top level is the current menuBar which is a member of a circular
1633linked-list of other such menuBars.
1634
1635The menuBar acts as a parent for the various drop-down menus, which in
1636turn, may have labels, separator lines, menuItems and subMenus.
1637
1638The menuItems are the useful bits: you can use them to mimic keyboard
1639input or even to send text or escape sequences back to rxvt.
1640
1641The menuBar syntax is intended to provide a simple yet robust method of
1642constructing and manipulating menus and navigating through the
1643menuBars.
1644
1645The first step is to use the tag B<< [menu:I<name>] >> which creates
1646the menuBar called I<name> and allows access. You may now or menus,
1647subMenus, and menuItems. Finally, use the tag B<[done]> to set the
1648menuBar access as B<readonly> to prevent accidental corruption of the
1649menus. To re-access the current menuBar for alterations, use the tag
1650B<[menu]>, make the alterations and then use B<[done]>
1651
1652X<menuBarCommands>
1653
1654=head2 Commands
1655
1656=over 4
1657
1658=item B<< [menu:+I<name>] >>
1659
1660access the named menuBar for creation or alteration. If a new menuBar
1661is created, it is called I<name> (max of 15 chars) and the current
1662menuBar is pushed onto the stack
1663
1664=item B<[menu]>
1665
1666access the current menuBar for alteration
1667
1668=item B<< [title:+I<string>] >>
1669
1670set the current menuBar's title to I<string>, which may contain the
1671following format specifiers:
1672
1673 B<%n> rxvt name (as per the B<-name> command-line option)
1674 B<%v> rxvt version
1675 B<%%> literal B<%> character
1676
1677=item B<[done]>
1678
1679set menuBar access as B<readonly>.
1680End-of-file tag for B<< [read:+I<file>] >> operations.
1681
1682=item B<< [read:+I<file>] >>
1683
1684read menu commands directly from I<file> (extension ".menu" will be
1685appended if required.) Start reading at a line with B<[menu]> or B<<
1686[menu:+I<name> >> and continuing until B<[done]> is encountered.
1687
1688Blank and comment lines (starting with B<#>) are ignored. Actually,
1689since any invalid menu commands are also ignored, almost anything could
1690be construed as a comment line, but this may be tightened up in the
1691future ... so don't count on it!.
1692
1693=item B<< [read:+I<file>;+I<name>] >>
1694
1695The same as B<< [read:+I<file>] >>, but start reading at a line with
1696B<< [menu:+I<name>] >> and continuing until B<< [done:+I<name>] >> or
1697B<[done]> is encountered.
1698
1699=item B<[dump]>
1700
1701dump all menuBars to the file B</tmp/rxvt-PID> in a format suitable for
1702later rereading.
1703
1704=item B<[rm:name]>
1705
1706remove the named menuBar
1707
1708=item B<[rm] [rm:]>
1709
1710remove the current menuBar
1711
1712=item B<[rm*] [rm:*]>
1713
1714remove all menuBars
1715
1716=item B<[swap]>
1717
1718swap the top two menuBars
1719
1720=item B<[prev]>
1721
1722access the previous menuBar
1723
1724=item B<[next]>
1725
1726access the next menuBar
1727
1728=item B<[show]>
1729
1730Enable display of the menuBar
1731
1732=item B<[hide]>
1733
1734Disable display of the menuBar
1735
1736=item B<< [pixmap:+I<name>] >>
1737
1738=item B<< [pixmap:+I<name>;I<scaling>] >>
1739
1740(set the background pixmap globally
1741
1742B<< A Future implementation I<may> make this local to the menubar >>)
1743
1744=item B<< [:+I<command>:] >>
1745
1746ignore the menu readonly status and issue a I<command> to or a menu or
1747menuitem or change the ; a useful shortcut for setting the quick arrows
1748from a menuBar.
1749
1750=back
1751
1752X<menuBarAdd>
1753
1754=head2 Adding and accessing menus
1755
1756The following commands may also be B<+> prefixed.
1757
1758=over 4
1759
1760=item B</+>
1761
1762access menuBar top level
1763
1764=item B<./+>
1765
1766access current menu level
1767
1768=item B<../+>
1769
1770access parent menu (1 level up)
1771
1772=item B<../../>
1773
1774access parent menu (multiple levels up)
1775
1776=item B<< I</path/>menu >>
1777
1778add/access menu
1779
1780=item B<< I</path/>menu/* >>
1781
1782add/access menu and clear it if it exists
1783
1784=item B<< I</path/>{-} >>
1785
1786add separator
1787
1788=item B<< I</path/>{item} >>
1789
1790add B<item> as a label
1791
1792=item B<< I</path/>{item} action >>
1793
1794add/alter I<menuitem> with an associated I<action>
1795
1796=item B<< I</path/>{item}{right-text} >>
1797
1798add/alter I<menuitem> with B<right-text> as the right-justified text
1799and as the associated I<action>
1800
1801=item B<< I</path/>{item}{rtext} action >>
1802
1803add/alter I<menuitem> with an associated I<action> and with B<rtext> as
1804the right-justified text.
1805
1806=back
1807
1808=over 4
1809
1810=item Special characters in I<action> must be backslash-escaped:
1811
1812B<\a \b \E \e \n \r \t \octal>
1813
1814=item or in control-character notation:
1815
1816B<^@, ^A .. ^Z .. ^_, ^?>
1817
1818=back
1819
1820To send a string starting with a B<NUL> (B<^@>) character to the
1821program, start I<action> with a pair of B<NUL> characters (B<^@^@>),
1822the first of which will be stripped off and the balance directed to the
1823program. Otherwise if I<action> begins with B<NUL> followed by
1824non-+B<NUL> characters, the leading B<NUL> is stripped off and the
1825balance is sent back to rxvt.
1826
1827As a convenience for the many Emacs-type editors, I<action> may start
1828with B<M-> (eg, B<M-$> is equivalent to B<\E$>) and a B<CR> will be
1829appended if missed from B<M-x> commands.
1830
1831As a convenience for issuing XTerm B<ESC ]> sequences from a menubar (or
1832quick arrow), a B<BEL> (B<^G>) will be appended if needed.
1833
1834=over 4
1835
1836=item For example,
1837
1838B<M-xapropos> is equivalent to B<\Exapropos\r>
1839
1840=item and
1841
1842B<\E]703;mona;100> is equivalent to B<\E]703;mona;100\a>
1843
1844=back
1845
1846The option B<< {I<right-rtext>} >> will be right-justified. In the
1847absence of a specified action, this text will be used as the I<action>
1848as well.
1849
1850=over 4
1851
1852=item For example,
1853
1854B</File/{Open}{^X^F}> is equivalent to B</File/{Open}{^X^F} ^X^F>
1855
1856=back
1857
1858The left label I<is> necessary, since it's used for matching, but
1859implicitly hiding the left label (by using same name for both left and
1860right labels), or explicitly hiding the left label (by preceeding it
1861with a dot), makes it possible to have right-justified text only.
1862
1863=over 4
1864
1865=item For example,
1866
1867B</File/{Open}{Open} Open-File-Action>
1868
1869=item or hiding it
1870
1871B</File/{.anylabel}{Open} Open-File-Action>
1872
1873=back
1874
1875X<menuBarRemove>
1876
1877=head2 Removing menus
1878
1879=over 4
1880
1881=item B<< -/*+ >>
1882
1883remove all menus from the menuBar, the same as B<[clear]>
1884
1885=item B<< -+I</path>menu+ >>
1886
1887remove menu
1888
1889=item B<< -+I</path>{item}+ >>
1890
1891remove item
1892
1893=item B<< -+I</path>{-} >>
1894
1895remove separator)
1896
1897=item B<-/path/menu/*>
1898
1899remove all items, separators and submenus from menu
1900
1901=back
1902
1903X<menuBarArrows>
1904
1905=head2 Quick Arrows
1906
1907The menus also provide a hook for I<quick arrows> to provide easier
1908user access. If nothing has been explicitly set, the default is to
1909emulate the curror keys. The syntax permits each arrow to be altered
1910individually or all four at once without re-entering their common
1911beginning/end text. For example, to explicitly associate cursor actions
1912with the arrows, any of the following forms could be used:
1913
1914=over 4
1915
1916=item B<< <r>+I<Right> >>
1917
1918=item B<< <l>+I<Left> >>
1919
1920=item B<< <u>+I<Up> >>
1921
1922=item B<< <d>+I<Down> >>
1923
1924Define actions for the respective arrow buttons
1925
1926=item B<< <b>+I<Begin> >>
1927
1928=item B<< <e>+I<End> >>
1929
1930Define common beginning/end parts for I<quick arrows> which used in
1931conjunction with the above <r> <l> <u> <d> constructs
1932
1933=back
1934
1935=over 4
1936
1937=item For example, define arrows individually,
1938
1939 <u>\E[A
1940
1941 <d>\E[B
1942
1943 <r>\E[C
1944
1945 <l>\E[D
1946
1947=item or all at once
1948
1949 <u>\E[AZ<><d>\E[BZ<><r>\E[CZ<><l>\E[D
1950
1951=item or more compactly (factoring out common parts)
1952
1953 <b>\E[<u>AZ<><d>BZ<><r>CZ<><l>D
1954
1955=back
1956
1957X<menuBarSummary>
1958
1959=head2 Command Summary
1960
1961A short summary of the most I<common> commands:
1962
1963=over 4
1964
1965=item [menu:name]
1966
1967use an existing named menuBar or start a new one
1968
1969=item [menu]
1970
1971use the current menuBar
1972
1973=item [title:string]
1974
1975set menuBar title
1976
1977=item [done]
1978
1979set menu access to readonly and, if reading from a file, signal EOF
1980
1981=item [done:name]
1982
1983if reading from a file using [read:file;name] signal EOF
1984
1985=item [rm:name]
1986
1987remove named menuBar(s)
1988
1989=item [rm] [rm:]
1990
1991remove current menuBar
1992
1993=item [rm*] [rm:*]
1994
1995remove all menuBar(s)
1996
1997=item [swap]
1998
1999swap top two menuBars
2000
2001=item [prev]
2002
2003access the previous menuBar
2004
2005=item [next]
2006
2007access the next menuBar
2008
2009=item [show]
2010
2011map menuBar
2012
2013=item [hide]
2014
2015unmap menuBar
2016
2017=item [pixmap;file]
2018
2019=item [pixmap;file;scaling]
2020
2021set a background pixmap
2022
2023=item [read:file]
2024
2025=item [read:file;name]
2026
2027read in a menu from a file
2028
2029=item [dump]
2030
2031dump out all menuBars to /tmp/rxvt-PID
2032
2033=item /
2034
2035access menuBar top level
2036
2037=item ./
2038
2039=item ../
2040
2041=item ../../
2042
2043access current or parent menu level
2044
2045=item /path/menu
2046
2047add/access menu
2048
2049=item /path/{-}
2050
2051add separator
2052
2053=item /path/{item}{rtext} action
2054
2055add/alter menu item
2056
2057=item -/*
2058
2059remove all menus from the menuBar
2060
2061=item -/path/menu
2062
2063remove menu items, separators and submenus from menu
2064
2065=item -/path/menu
2066
2067remove menu
2068
2069=item -/path/{item}
2070
2071remove item
2072
2073=item -/path/{-}
2074
2075remove separator
2076
2077=item <b>Begin<r>Right<l>Left<u>Up<d>Down<e>End
2078
2079menu quick arrows
2080
2081=back
2082X<XPM> 1797X<XPM>
2083 1798
2084=head1 XPM 1799=head1 XPM
2085 1800
2086For the XPM XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value 1801For the XPM XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value
2333alternative input methods (e.g. kinput2) and will also correctly 2048alternative input methods (e.g. kinput2) and will also correctly
2334set up the input for people using dead keys or compose keys. 2049set up the input for people using dead keys or compose keys.
2335 2050
2336=item --enable-unicode3 (default: off) 2051=item --enable-unicode3 (default: off)
2337 2052
2053Recommended to stay off unless you really need non-BMP characters.
2054
2338Enable direct support for displaying unicode codepoints above 2055Enable direct support for displaying unicode codepoints above
233965535 (the basic multilingual page). This increases storage 205665535 (the basic multilingual page). This increases storage
2340requirements per character from 2 to 4 bytes. X11 fonts do not yet 2057requirements per character from 2 to 4 bytes. X11 fonts do not yet
2341support these extra characters, but Xft does. 2058support these extra characters, but Xft does.
2342 2059
2352composite characters. This is required for proper viewing of text 2069composite characters. This is required for proper viewing of text
2353where accents are encoded as seperate unicode characters. This is 2070where accents are encoded as seperate unicode characters. This is
2354done by using precomposited characters when available or creating 2071done by using precomposited characters when available or creating
2355new pseudo-characters when no precomposed form exists. 2072new pseudo-characters when no precomposed form exists.
2356 2073
2357Without --enable-unicode3, the number of additional precomposed characters 2074Without --enable-unicode3, the number of additional precomposed
2358is rather limited (2048, if this is full, rxvt-unicode will use the 2075characters is somewhat limited (the 6400 private use characters will be
2359private use area, extending the number of combinations to 8448). With
2360--enable-unicode3, no practical limit exists. 2076(ab-)used). With --enable-unicode3, no practical limit exists.
2361 2077
2362This option will also enable storage (but not display) of characters 2078This option will also enable storage (but not display) of characters
2363beyond plane 0 (>65535) when --enable-unicode3 was not specified. 2079beyond plane 0 (>65535) when --enable-unicode3 was not specified.
2364 2080
2365The combining table also contains entries for arabic presentation forms, 2081The combining table also contains entries for arabic presentation forms,
2366but these are not currently used. Bug me if you want these to be used (and 2082but these are not currently used. Bug me if you want these to be used (and
2367tell me how these are to be used...). 2083tell me how these are to be used...).
2368 2084
2369=item --enable-fallback(=CLASS) (default: Rxvt) 2085=item --enable-fallback(=CLASS) (default: Rxvt)
2370 2086
2371When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. 2087When reading resource settings, also read settings for class CLASS. To
2088disable resource fallback use --disable-fallback.
2372 2089
2373=item --with-res-name=NAME (default: urxvt) 2090=item --with-res-name=NAME (default: urxvt)
2374 2091
2375Use the given name as default application name when 2092Use the given name as default application name when
2376reading resources. Specify --with-res-name=rxvt to replace rxvt. 2093reading resources. Specify --with-res-name=rxvt to replace rxvt.
2396 2113
2397Write user and tty to lastlog file (used by programs like 2114Write user and tty to lastlog file (used by programs like
2398F<lastlogin>) at start of rxvt execution. This option requires 2115F<lastlogin>) at start of rxvt execution. This option requires
2399--enable-utmp to also be specified. 2116--enable-utmp to also be specified.
2400 2117
2401=item --enable-xpm-background (default: off) 2118=item --enable-xpm-background (default: on)
2402 2119
2403Add support for XPM background pixmaps. 2120Add support for XPM background pixmaps.
2404 2121
2405=item --enable-transparency (default: off) 2122=item --enable-transparency (default: on)
2406 2123
2407Add support for inheriting parent backgrounds thus giving a fake 2124Add support for inheriting parent backgrounds thus giving a fake
2408transparency to the term. 2125transparency to the term.
2409 2126
2410=item --enable-fading (default: on) 2127=item --enable-fading (default: on)
2412Add support for fading the text when focus is lost (requires C<--enable-transparency>). 2129Add support for fading the text when focus is lost (requires C<--enable-transparency>).
2413 2130
2414=item --enable-tinting (default: on) 2131=item --enable-tinting (default: on)
2415 2132
2416Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). 2133Add support for tinting of transparent backgrounds (requires C<--enable-transparency>).
2417
2418=item --enable-menubar (default: off)
2419
2420Add support for our menu bar system (this interacts badly with
2421dynamic locale switching currently).
2422 2134
2423=item --enable-rxvt-scroll (default: on) 2135=item --enable-rxvt-scroll (default: on)
2424 2136
2425Add support for the original rxvt scrollbar. 2137Add support for the original rxvt scrollbar.
2426 2138
2436 2148
2437Add support for a very unobtrusive, plain-looking scrollbar that 2149Add support for a very unobtrusive, plain-looking scrollbar that
2438is the favourite of the rxvt-unicode author, having used it for 2150is the favourite of the rxvt-unicode author, having used it for
2439many years. 2151many years.
2440 2152
2441=item --enable-half-shadow (default: off)
2442
2443Make shadows on the scrollbar only half the normal width & height.
2444only applicable to rxvt scrollbars.
2445
2446=item --enable-ttygid (default: off) 2153=item --enable-ttygid (default: off)
2447 2154
2448Change tty device setting to group "tty" - only use this if 2155Change tty device setting to group "tty" - only use this if
2449your system uses this type of security. 2156your system uses this type of security.
2450 2157
2458do it. 2165do it.
2459 2166
2460=item --disable-resources 2167=item --disable-resources
2461 2168
2462Removes any support for resource checking. 2169Removes any support for resource checking.
2463
2464=item --enable-xgetdefault
2465
2466Make resources checking via XGetDefault() instead of our small
2467version which only checks ~/.Xdefaults, or if that doesn't exist then
2468~/.Xresources.
2469
2470Please note that nowadays, things like XIM will automatically pull in and
2471use the full X resource manager, so the overhead of using it might be very
2472small, if nonexistant.
2473
2474=item --enable-strings (default: off)
2475
2476Add support for our possibly faster memset() function and other
2477various routines, overriding your system's versions which may
2478have been hand-crafted in assembly or may require extra libraries
2479to link in. (this breaks ANSI-C rules and has problems on many
2480GNU/Linux systems).
2481 2170
2482=item --disable-swapscreen 2171=item --disable-swapscreen
2483 2172
2484Remove support for secondary/swap screen. 2173Remove support for secondary/swap screen.
2485 2174
2492A non-exhaustive list of features enabled by C<--enable-frills> (possibly 2181A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2493in combination with other switches) is: 2182in combination with other switches) is:
2494 2183
2495 MWM-hints 2184 MWM-hints
2496 EWMH-hints (pid, utf8 names) and protocols (ping) 2185 EWMH-hints (pid, utf8 names) and protocols (ping)
2497 seperate underline colour 2186 seperate underline colour (-underlineColor)
2498 settable border widths and borderless switch 2187 settable border widths and borderless switch (-w, -b, -bl)
2188 visual depth selection (-depth)
2499 settable extra linespacing 2189 settable extra linespacing /-lsp)
2500 iso-14755-2 and -3, and visual feedback 2190 iso-14755-2 and -3, and visual feedback
2191 tripleclickwords (-tcw)
2192 settable insecure mode (-insecure)
2193 keysym remapping support
2194 cursor blinking and underline cursor (-cb, -uc)
2195 XEmbed support (-embed)
2196 user-pty (-pty-fd)
2197 hold on exit (-hold)
2198 skip builtin block graphics (-sbg)
2199
2200It also enabled some non-essential features otherwise disabled, such as:
2201
2202 some round-trip time optimisations
2203 nearest color allocation on pseudocolor screens
2204 UTF8_STRING supporr for selection
2205 sgr modes 90..97 and 100..107
2501 backindex and forwardindex escape sequence 2206 backindex and forwardindex escape sequences
2207 view change/zero scorllback esacpe sequences
2208 locale switching escape sequence
2502 window op and some xterm/OSC escape sequences 2209 window op and some xterm/OSC escape sequences
2503 tripleclickwords 2210 rectangular selections
2504 settable insecure mode 2211 trailing space removal for selections
2505 keysym remapping support 2212 verbose X error handling
2506 cursor blinking and underline cursor
2507 -embed, -pty-fd and -hold options
2508 2213
2509=item --enable-iso14755 (default: on) 2214=item --enable-iso14755 (default: on)
2510 2215
2511Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2216Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2512F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2217F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by
2555 2260
2556=item --enable-pointer-blank (default: on) 2261=item --enable-pointer-blank (default: on)
2557 2262
2558Add support to have the pointer disappear when typing or inactive. 2263Add support to have the pointer disappear when typing or inactive.
2559 2264
2265=item --enable-perl (default: on)
2266
2267Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2268manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files
2269in F<src/perl-ext/> for the extensions that are installed by default. The
2270perl interpreter that is used can be specified via the C<PERL> environment
2271variable when running configure.
2272
2560=item --with-name=NAME (default: urxvt) 2273=item --with-name=NAME (default: urxvt)
2561 2274
2562Set the basename for the installed binaries, resulting 2275Set the basename for the installed binaries, resulting
2563in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with 2276in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with
2564C<rxvt>. 2277C<rxvt>.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines