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.101 by root, Tue Jan 31 01:02:19 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 single words?
28 27
28If you want to select e.g. alphanumeric words, you can use the following
29setting:
30
31 URxvt.selection.pattern-0: ([[:word:]]+)
32
33If you click more than twice, the selection will be extended
34more and more.
35
36To get a selection that is very similar to the old code, try this pattern:
37
38 URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{|})]+)
39
40Please also note that the I<LeftClick Shift-LeftClik> combination also
41selects words like the old code.
42
43=head2 I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?
44
45You can disable the perl extension completely by setting the
46B<perl-ext-common> resource to the empty string, which also keeps
47rxvt-unicode from initialising perl, saving memory.
48
49If you only want to disable specific features, you first have to
50identify which perl extension is responsible. For this, read the section
51B<PREPACKAGED EXTENSIONS> in the @@RXVT_NAME@@perl(3) manpage. For
52example, to disable the B<selection-popup> and B<option-popup>, specify
53this B<perl-ext-common> resource:
54
55 URxvt.perl-ext-common: default,-selection-popup,-option-popup
56
57This will keep the default extensions, but disable the two popup
58extensions. Some extensions can also be configured, for example,
59scrollback search mode is triggered by B<M-s>. You can move it to any
60other combination either by setting the B<searchable-scrollback> resource:
61
62 URxvt.searchable-scrollback: CM-s
63
64=head2 The cursor moves when selecting text in the current input line, how do I switch this off?
65
66See next entry.
67
68=head2 During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?
69
70These are caused by the C<readline> perl extension. Under normal
71circumstances, it will move your cursor around when you click into the
72line that contains it. It tries hard not to do this at the wrong moment,
73but when running a program that doesn't parse cursor movements or in some
74cases during rlogin sessions, it fails to detect this properly.
75
76You can permamently switch this feature off by disabling the C<readline>
77extension:
78
79 URxvt.perl-ext-common: default,-readline
80
81=head2 Why doesn't rxvt-unicode read my resources?
82
83Well, why, indeed? It does, in a way very similar to other X
84applications. Most importantly, this means that if you or your OS loads
85resources into the X display (the right way to do it), rxvt-unicode will
86ignore any resource files in your home directory. It will only read
87F<$HOME/.Xdefaults> when no resources are attached to the display.
88
89If you have or use an F<$HOME/.Xresources> file, chances are that
90resources are loaded into your X-server. In this case, you have to
91re-login after every change (or run F<xrdb -merge $HOME/.Xresources>).
92
93Also consider the form resources have to use:
94
95 URxvt.resource: value
96
97If you want to use another form (there are lots of different ways of
98specifying resources), make sure you understand wether and why it
99works. If unsure, use the form above.
100
101=head2 I can't get transparency working, what am I doing wrong?
102
103First of all, transparency isn't officially supported in rxvt-unicode, so
104you are mostly on your own. Do not bug the author about it (but you may
105bug everybody else). Also, if you can't get it working consider it a rite
106of passage: ... and you failed.
107
108Here are four ways to get transparency. B<Do> read the manpage and option
109descriptions for the programs mentioned and rxvt-unicode. Really, do it!
110
1111. Use inheritPixmap:
112
113 Esetroot wallpaper.jpg
114 @@RXVT_NAME@@ -ip -tint red -sh 40
115
116That works. If you think it doesn't, you lack transparency and tinting
117support, or you are unable to read.
118
1192. Use a simple pixmap and emulate pseudo-transparency. This enables you
120to use effects other than tinting and shading: Just shade/tint/whatever
121your picture with gimp:
122
123 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
124 @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
125
126That works. If you think it doesn't, you lack XPM and Perl support, or you
127are unable to read.
128
1293. Use an ARGB visual:
130
131 @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
132
133This requires XFT support, and the support of your X-server. If that
134doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
135there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
136bugfixes and workarounds for Xft and Xlib to make it work, but that
137doesn't mean that your WM has the required kludges in place.
138
1394. Use xcompmgr and let it do the job:
140
141 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \
142 -set _NET_WM_WINDOW_OPACITY 0xc0000000
143
144Then click on a window you want to make transparent. Replace C<0xc0000000>
145by other values to change the degree of opacity. If it doesn't work and
146your server crashes, you got to keep the pieces.
147
29=item Isn't rxvt supposed to be small? Don't all those features bloat? 148=head2 Isn't rxvt supposed to be small? Don't all those features bloat?
30 149
31I 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
32bloat. 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
33that 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
34compiled in), but it actually uses less memory (RSS) after startup. Even 153compiled in), but it actually uses less memory (RSS) after startup. Even
62memory. 181memory.
63 182
64Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this 183Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this
65still fares rather well. And compared to some monsters like gnome-terminal 184still fares rather well. And compared to some monsters like gnome-terminal
66(21152k + extra 4204k in separate processes) or konsole (22200k + extra 185(21152k + extra 4204k in separate processes) or konsole (22200k + extra
6743180k in daemons that stay around after exit, plus half aminute of 18643180k in daemons that stay around after exit, plus half a minute of
68startup time, including the hundreds of warnings it spits out), it fares 187startup time, including the hundreds of warnings it spits out), it fares
69extremely well *g*. 188extremely well *g*.
70 189
71=item Why C++, isn't that unportable/bloated/uncool? 190=head2 Why C++, isn't that unportable/bloated/uncool?
72 191
73Is 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
74to 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
75of 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
76shorter: It simply wouldn't exist without C++. 195shorter: It simply wouldn't exist without C++.
100 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000) 219 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
101 220
102No large bloated libraries (of course, none were linked in statically), 221No large bloated libraries (of course, none were linked in statically),
103except maybe libX11 :) 222except maybe libX11 :)
104 223
105=item Does it support tabs, can I have a tabbed rxvt-unicode? 224=head2 Does it support tabs, can I have a tabbed rxvt-unicode?
106 225
107rxvt-unicode does not directly support tabs. It will work fine with 226Beginning with version 7.3, there is a perl extension that implements a
108tabbing functionality of many window managers or similar tabbing programs, 227simple tabbed terminal. It is installed by default, so any of these should
109and its embedding-features allow it to be embedded into other programs, 228give 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 229
230 @@RXVT_NAME@@ -pe tabbed
231
232 URxvt.perl-ext-common: default,tabbed
233
234It will also work fine with tabbing functionality of many window managers
235or similar tabbing programs, and its embedding-features allow it to be
236embedded into other programs, as witnessed by F<doc/rxvt-tabbed> or
237the upcoming C<Gtk2::URxvt> perl module, which features a tabbed urxvt
238(murxvt) terminal as an example embedding application.
239
114=item How do I know which rxvt-unicode version I'm using? 240=head2 How do I know which rxvt-unicode version I'm using?
115 241
116The version number is displayed with the usage (-h). Also the escape 242The 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 243sequence 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 244using the @@RXVT_NAME@@c client, the version displayed is that of the
119daemon. 245daemon.
120 246
121=item I am using Debian GNU/Linux and have a problem... 247=head2 I am using Debian GNU/Linux and have a problem...
122 248
123The Debian GNU/Linux package of rxvt-unicode in sarge contains large 249The Debian GNU/Linux package of rxvt-unicode in sarge contains large
124patches that considerably change the behaviour of rxvt-unicode. Before 250patches that considerably change the behaviour of rxvt-unicode (but
125reporting a bug to the original rxvt-unicode author please download and 251unfortunately this notice has been removed). Before reporting a bug to
126install the genuine version (L<http://software.schmorp.de#rxvt-unicode>) 252the original rxvt-unicode author please download and install the genuine
127and try to reproduce the problem. If you cannot, chances are that the 253version (L<http://software.schmorp.de#rxvt-unicode>) and try to reproduce
128problems are specific to Debian GNU/Linux, in which case it should be 254the problem. If you cannot, chances are that the problems are specific to
129reported via the Debian Bug Tracking System (use C<reportbug> to report 255Debian GNU/Linux, in which case it should be reported via the Debian Bug
130the bug). 256Tracking System (use C<reportbug> to report the bug).
131 257
132For other problems that also affect the Debian package, you can and 258For 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 259probably 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 260bug in the Debian version and it serves as a reminder for other users that
135might encounter the same issue. 261might encounter the same issue.
136 262
263=head2 I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
264
265You should build one binary with the default options. F<configure>
266now enables most useful options, and the trend goes to making them
267runtime-switchable, too, so there is usually no drawback to enbaling them,
268except higher disk and possibly memory usage. The perl interpreter should
269be enabled, as important functionality (menus, selection, likely more in
270the future) depends on it.
271
272You should not overwrite the C<perl-ext-common> snd C<perl-ext> resources
273system-wide (except maybe with C<defaults>). This will result in useful
274behaviour. If your distribution aims at low memory, add an empty
275C<perl-ext-common> resource to the app-defaults file. This will keep the
276perl interpreter disabled until the user enables it.
277
278If you can/want build more binaries, I recommend building a minimal
279one with C<--disable-everything> (very useful) and a maximal one with
280C<--enable-everything> (less useful, it will be very big due to a lot of
281encodings built-in that increase download times and are rarely used).
282
283=head2 I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?
284
285It should be, starting with release 7.1. You are encouraged to properly
286install urxvt with privileges necessary for your OS now.
287
288When rxvt-unicode detects that it runs setuid or setgid, it will fork
289into a helper process for privileged operations (pty handling on some
290systems, utmp/wtmp/lastlog handling on others) and drop privileges
291immediately. This is much safer than most other terminals that keep
292privileges while running (but is more relevant to urxvt, as it contains
293things as perl interpreters, which might be "helpful" to attackers).
294
295This forking is done as the very first within main(), which is very early
296and reduces possible bugs to initialisation code run before main(), or
297things like the dynamic loader of your system, which should result in very
298little risk.
299
137=item When I log-in to another system it tells me about missing terminfo data? 300=head2 When I log-in to another system it tells me about missing terminfo data?
138 301
139The terminal description used by rxvt-unicode is not as widely available 302The 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). 303as that for xterm, or even rxvt (for which the same problem often arises).
141 304
142The correct solution for this problem is to install the terminfo, this can 305The correct solution for this problem is to install the terminfo, this can
160 URxvt.termName: rxvt 323 URxvt.termName: rxvt
161 324
162If you don't plan to use B<rxvt> (quite common...) you could also replace 325If you don't plan to use B<rxvt> (quite common...) you could also replace
163the rxvt terminfo file with the rxvt-unicode one. 326the rxvt terminfo file with the rxvt-unicode one.
164 327
165=item C<tic> outputs some error when compiling the terminfo entry. 328=head2 C<tic> outputs some error when compiling the terminfo entry.
166 329
167Most likely it's the empty definition for C<enacs=>. Just replace it by 330Most likely it's the empty definition for C<enacs=>. Just replace it by
168C<enacs=\E[0@> and try again. 331C<enacs=\E[0@> and try again.
169 332
170=item C<bash>'s readline does not work correctly under @@RXVT_NAME@@. 333=head2 C<bash>'s readline does not work correctly under @@RXVT_NAME@@.
171 334
335See next entry.
336
172=item I need a termcap file entry. 337=head2 I need a termcap file entry.
173 338
174One reason you might want this is that some distributions or operating 339One reason you might want this is that some distributions or operating
175systems still compile some programs using the long-obsoleted termcap 340systems still compile some programs using the long-obsoleted termcap
176library (Fedora Core's bash is one example) and rely on a termcap entry 341library (Fedora Core's bash is one example) and rely on a termcap entry
177for C<rxvt-unicode>. 342for C<rxvt-unicode>.
203 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\ 368 :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:\ 369 :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:\ 370 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
206 :vs=\E[?25h: 371 :vs=\E[?25h:
207 372
208=item Why does C<ls> no longer have coloured output? 373=head2 Why does C<ls> no longer have coloured output?
209 374
210The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to 375The C<ls> in the GNU coreutils unfortunately doesn't use terminfo to
211decide wether a terminal has colour, but uses it's own configuration 376decide 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 377file. Needless to say, C<rxvt-unicode> is not in it's default file (among
213with most other terminals supporting colour). Either add: 378with most other terminals supporting colour). Either add:
218 383
219 alias ls='ls --color=auto' 384 alias ls='ls --color=auto'
220 385
221to your C<.profile> or C<.bashrc>. 386to your C<.profile> or C<.bashrc>.
222 387
223=item Why doesn't vim/emacs etc. use the 88 colour mode? 388=head2 Why doesn't vim/emacs etc. use the 88 colour mode?
224 389
390See next entry.
391
225=item Why doesn't vim/emacs etc. make use of italic? 392=head2 Why doesn't vim/emacs etc. make use of italic?
226 393
394See next entry.
395
227=item Why are the secondary screen-related options not working properly? 396=head2 Why are the secondary screen-related options not working properly?
228 397
229Make sure you are using C<TERM=rxvt-unicode>. Some pre-packaged 398Make sure you are using C<TERM=rxvt-unicode>. Some pre-packaged
230distributions (most notably Debian GNU/Linux) break rxvt-unicode 399distributions (most notably Debian GNU/Linux) break rxvt-unicode
231by setting C<TERM> to C<rxvt>, which doesn't have these extra 400by setting C<TERM> to C<rxvt>, which doesn't have these extra
232features. Unfortunately, some of these (most notably, again, Debian 401features. Unfortunately, some of these (most notably, again, Debian
233GNU/Linux) furthermore fail to even install the C<rxvt-unicode> terminfo 402GNU/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 403file, 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 404I log-in to another system it tells me about missing terminfo data?> on
236how to do this). 405how to do this).
237 406
238=item My numerical keypad acts weird and generates differing output? 407=head2 My numerical keypad acts weird and generates differing output?
239 408
240Some Debian GNUL/Linux users seem to have this problem, although no 409Some Debian GNUL/Linux users seem to have this problem, although no
241specific details were reported so far. It is possible that this is caused 410specific 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 411by 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 412this 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 413keymap. See the answer to the previous question, and please report if that
245helped. 414helped.
246 415
247=item Rxvt-unicode does not seem to understand the selected encoding? 416=head2 Rxvt-unicode does not seem to understand the selected encoding?
248 417
418See next entry.
419
249=item Unicode does not seem to work? 420=head2 Unicode does not seem to work?
250 421
251If you encounter strange problems like typing an accented character but 422If you encounter strange problems like typing an accented character but
252getting two unrelated other characters or similar, or if program output is 423getting two unrelated other characters or similar, or if program output is
253subtly garbled, then you should check your locale settings. 424subtly garbled, then you should check your locale settings.
254 425
274 445
275If nothing works and you are sure that everything is set correctly then 446If 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 447you will need to remember a little known fact: Some programs just don't
277support locales :( 448support locales :(
278 449
279=item Why do some characters look so much different than others? 450=head2 Why do some characters look so much different than others?
280 451
452See next entry.
453
281=item How does rxvt-unicode choose fonts? 454=head2 How does rxvt-unicode choose fonts?
282 455
283Most fonts do not contain the full range of Unicode, which is 456Most fonts do not contain the full range of Unicode, which is
284fine. Chances are that the font you (or the admin/package maintainer of 457fine. 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 458your system/os) have specified does not cover all the characters you want
286to display. 459to display.
304 477
305The only limitation is that none of the fonts may be larger than the base 478The 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 479font, as the base font defines the terminal character cell size, which
307must be the same due to the way terminals work. 480must be the same due to the way terminals work.
308 481
309=item Why do some chinese characters look so different than others? 482=head2 Why do some chinese characters look so different than others?
310 483
311This is because there is a difference between script and language -- 484This is because there is a difference between script and language --
312rxvt-unicode does not know which language the text that is output is, 485rxvt-unicode does not know which language the text that is output is,
313as it only knows the unicode character codes. If rxvt-unicode first 486as it only knows the unicode character codes. If rxvt-unicode first
314sees a japanese/chinese character, it might choose a japanese font for 487sees a japanese/chinese character, it might choose a japanese font for
329has been designed yet). 502has been designed yet).
330 503
331Until then, you might get away with switching fonts at runtime (see L<Can 504Until then, you might get away with switching fonts at runtime (see L<Can
332I switch the fonts at runtime?> later in this document). 505I switch the fonts at runtime?> later in this document).
333 506
334=item Why does rxvt-unicode sometimes leave pixel droppings? 507=head2 Why does rxvt-unicode sometimes leave pixel droppings?
335 508
336Most fonts were not designed for terminal use, which means that character 509Most 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 510size 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 511contain some characters that are simply too wide. Rxvt-unicode will avoid
339these characters. For characters that are just "a bit" too wide a special 512these characters. For characters that are just "a bit" too wide a special
351might be forced to use a different font. 524might be forced to use a different font.
352 525
353All of this is not a problem when using X11 core fonts, as their bounding 526All of this is not a problem when using X11 core fonts, as their bounding
354box data is correct. 527box data is correct.
355 528
356=item On Solaris 9, many line-drawing characters are too wide. 529=head2 On Solaris 9, many line-drawing characters are too wide.
357 530
358Seems to be a known bug, read 531Seems to be a known bug, read
359L<http://nixdoc.net/files/forum/about34198.html>. Some people use the 532L<http://nixdoc.net/files/forum/about34198.html>. Some people use the
360following ugly workaround to get non-double-wide-characters working: 533following ugly workaround to get non-double-wide-characters working:
361 534
362 #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x) 535 #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
363 536
364=item My Compose (Multi_key) key is no longer working. 537=head2 My Compose (Multi_key) key is no longer working.
365 538
366The most common causes for this are that either your locale is not set 539The 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 540correctly, or you specified a B<preeditStyle> that is not supported by
368your input method. For example, if you specified B<OverTheSpot> and 541your input method. For example, if you specified B<OverTheSpot> and
369your input method (e.g. the default input method handling Compose keys) 542your input method (e.g. the default input method handling Compose keys)
371rxvt-unicode will continue without an input method. 544rxvt-unicode will continue without an input method.
372 545
373In this case either do not specify a B<preeditStyle> or specify more than 546In this case either do not specify a B<preeditStyle> or specify more than
374one pre-edit style, such as B<OverTheSpot,Root,None>. 547one pre-edit style, such as B<OverTheSpot,Root,None>.
375 548
376=item I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755 549=head2 I cannot type C<Ctrl-Shift-2> to get an ASCII NUL character due to ISO 14755
377 550
378Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on 551Either try C<Ctrl-2> alone (it often is mapped to ASCII NUL even on
379international keyboards) or simply use ISO 14755 support to your 552international keyboards) or simply use ISO 14755 support to your
380advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for other 553advantage, 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 554codes, too, such as C<Ctrl-Shift-1-d> to type the default telnet escape
382character and so on. 555character and so on.
383 556
384=item How can I keep rxvt-unicode from using reverse video so much? 557=head2 How can I keep rxvt-unicode from using reverse video so much?
385 558
386First of all, make sure you are running with the right terminal settings 559First 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 560(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 561make sure you have specified colours for italic and bold, as otherwise
389rxvt-unicode might use reverse video to simulate the effect: 562rxvt-unicode might use reverse video to simulate the effect:
390 563
391 URxvt.colorBD: white 564 URxvt.colorBD: white
392 URxvt.colorIT: green 565 URxvt.colorIT: green
393 566
394=item Some programs assume totally weird colours (red instead of blue), how can I fix that? 567=head2 Some programs assume totally weird colours (red instead of blue), how can I fix that?
395 568
396For some unexplainable reason, some rare programs assume a very weird 569For some unexplainable reason, some rare programs assume a very weird
397colour palette when confronted with a terminal with more than the standard 570colour 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 5718 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. 572these programs not to assume non-ISO colours without very good reasons.
400 573
401In the meantime, you can either edit your C<rxvt-unicode> terminfo 574In 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 575definition to only claim 8 colour support or use C<TERM=rxvt>, which will
403fix colours but keep you from using other rxvt-unicode features. 576fix colours but keep you from using other rxvt-unicode features.
404 577
405=item I am on FreeBSD and rxvt-unicode does not seem to work at all. 578=head2 I am on FreeBSD and rxvt-unicode does not seem to work at all.
406 579
407Rxvt-unicode requires the symbol C<__STDC_ISO_10646__> to be defined 580Rxvt-unicode requires the symbol C<__STDC_ISO_10646__> to be defined
408in your compile environment, or an implementation that implements it, 581in your compile environment, or an implementation that implements it,
409wether it defines the symbol or not. C<__STDC_ISO_10646__> requires that 582wether it defines the symbol or not. C<__STDC_ISO_10646__> requires that
410B<wchar_t> is represented as unicode. 583B<wchar_t> is represented as unicode.
432 605
433The rxvt-unicode author insists that the right way to fix this is in the 606The 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 607system libraries once and for all, instead of forcing every app to carry
435complete replacements for them :) 608complete replacements for them :)
436 609
437=item I use Solaris 9 and it doesn't compile/work/etc. 610=head2 I use Solaris 9 and it doesn't compile/work/etc.
438 611
439Try the diff in F<doc/solaris9.patch> as a base. It fixes the worst 612Try the diff in F<doc/solaris9.patch> as a base. It fixes the worst
440problems with C<wcwidth> and a compile problem. 613problems with C<wcwidth> and a compile problem.
441 614
442=item How can I use rxvt-unicode under cygwin? 615=head2 How can I use rxvt-unicode under cygwin?
443 616
444rxvt-unicode should compile and run out of the box on cygwin, using 617rxvt-unicode should compile and run out of the box on cygwin, using
445the X11 libraries that come with cygwin. libW11 emulation is no 618the X11 libraries that come with cygwin. libW11 emulation is no
446longer supported (and makes no sense, either, as it only supported a 619longer supported (and makes no sense, either, as it only supported a
447single font). I recommend starting the X-server in C<-multiwindow> or 620single font). I recommend starting the X-server in C<-multiwindow> or
450 623
451At the time of this writing, cygwin didn't seem to support any multi-byte 624At 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 625encodings (you might try C<LC_CTYPE=C-UTF-8>), so you are likely limited
453to 8-bit encodings. 626to 8-bit encodings.
454 627
455=item How does rxvt-unicode determine the encoding to use? 628=head2 How does rxvt-unicode determine the encoding to use?
456 629
630See next entry.
631
457=item Is there an option to switch encodings? 632=head2 Is there an option to switch encodings?
458 633
459Unlike some other terminals, rxvt-unicode has no encoding switch, and no 634Unlike 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 635specific "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. 636UTF-8 or any other encodings with respect to terminal I/O.
462 637
487rxvt-unicode. 662rxvt-unicode.
488 663
489If you want to use a specific encoding you have to make sure you start 664If you want to use a specific encoding you have to make sure you start
490rxvt-unicode with the correct C<LC_CTYPE> category. 665rxvt-unicode with the correct C<LC_CTYPE> category.
491 666
492=item Can I switch locales at runtime? 667=head2 Can I switch locales at runtime?
493 668
494Yes, using an escape sequence. Try something like this, which sets 669Yes, using an escape sequence. Try something like this, which sets
495rxvt-unicode's idea of C<LC_CTYPE>. 670rxvt-unicode's idea of C<LC_CTYPE>.
496 671
497 printf '\e]701;%s\007' ja_JP.SJIS 672 printf '\e]701;%s\007' ja_JP.SJIS
509 684
510You can also use xterm's C<luit> program, which usually works fine, except 685You can also use xterm's C<luit> program, which usually works fine, except
511for some locales where character width differs between program- and 686for some locales where character width differs between program- and
512rxvt-unicode-locales. 687rxvt-unicode-locales.
513 688
514=item Can I switch the fonts at runtime? 689=head2 Can I switch the fonts at runtime?
515 690
516Yes, using an escape sequence. Try something like this, which has the same 691Yes, using an escape sequence. Try something like this, which has the same
517effect as using the C<-fn> switch, and takes effect immediately: 692effect as using the C<-fn> switch, and takes effect immediately:
518 693
519 printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic" 694 printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic"
522japanese font), but you have to switch to chinese temporarily, where 697japanese font), but you have to switch to chinese temporarily, where
523japanese fonts would only be in your way. 698japanese fonts would only be in your way.
524 699
525You can think of this as a kind of manual ISO-2022 switching. 700You can think of this as a kind of manual ISO-2022 switching.
526 701
527=item Why do italic characters look as if clipped? 702=head2 Why do italic characters look as if clipped?
528 703
529Many fonts have difficulties with italic characters and hinting. For 704Many fonts have difficulties with italic characters and hinting. For
530example, the otherwise very nicely hinted font C<xft:Bitstream Vera Sans 705example, the otherwise very nicely hinted font C<xft:Bitstream Vera Sans
531Mono> completely fails in it's italic face. A workaround might be to 706Mono> completely fails in it's italic face. A workaround might be to
532enable freetype autohinting, i.e. like this: 707enable freetype autohinting, i.e. like this:
533 708
534 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true 709 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
535 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true 710 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
536 711
537=item My input method wants <some encoding> but I want UTF-8, what can I do? 712=head2 My input method wants <some encoding> but I want UTF-8, what can I do?
538 713
539You can specify separate locales for the input method and the rest of the 714You can specify separate locales for the input method and the rest of the
540terminal, using the resource C<imlocale>: 715terminal, using the resource C<imlocale>:
541 716
542 URxvt*imlocale: ja_JP.EUC-JP 717 URxvt.imlocale: ja_JP.EUC-JP
543 718
544Now you can start your terminal with C<LC_CTYPE=ja_JP.UTF-8> and still 719Now 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 720use 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 721input characters outside C<EUC-JP> in a normal way then, as your input
547method limits you. 722method limits you.
548 723
549=item Rxvt-unicode crashes when the X Input Method changes or exits. 724=head2 Rxvt-unicode crashes when the X Input Method changes or exits.
550 725
551Unfortunately, this is unavoidable, as the XIM protocol is racy by 726Unfortunately, this is unavoidable, as the XIM protocol is racy by
552design. Applications can avoid some crashes at the expense of memory 727design. Applications can avoid some crashes at the expense of memory
553leaks, and Input Methods can avoid some crashes by careful ordering at 728leaks, and Input Methods can avoid some crashes by careful ordering at
554exit time. B<kinput2> (and derived input methods) generally succeeds, 729exit time. B<kinput2> (and derived input methods) generally succeeds,
555while B<SCIM> (or similar input methods) fails. In the end, however, 730while B<SCIM> (or similar input methods) fails. In the end, however,
556crashes cannot be completely avoided even if both sides cooperate. 731crashes cannot be completely avoided even if both sides cooperate.
557 732
558So the only workaround is not to kill your Input Method Servers. 733So the only workaround is not to kill your Input Method Servers.
559 734
560=item Rxvt-unicode uses gobs of memory, how can I reduce that? 735=head2 Rxvt-unicode uses gobs of memory, how can I reduce that?
561 736
562Rxvt-unicode tries to obey the rule of not charging you for something you 737Rxvt-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 738don'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, 739you 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 740when 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 7456 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) 746kilobyte 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 747use 10 Megabytes of memory. With C<--enable-unicode3> it gets worse, as
573rxvt-unicode then uses 8 bytes per screen cell. 748rxvt-unicode then uses 8 bytes per screen cell.
574 749
575=item Can I speed up Xft rendering somehow? 750=head2 Can I speed up Xft rendering somehow?
576 751
577Yes, the most obvious way to speed it up is to avoid Xft entirely, as 752Yes, 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 753it is simply slow. If you still want Xft fonts you might try to disable
579antialiasing (by appending C<:antialias=false>), which saves lots of 754antialiasing (by appending C<:antialias=false>), which saves lots of
580memory and also speeds up rendering considerably. 755memory and also speeds up rendering considerably.
581 756
582=item Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong? 757=head2 Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
583 758
584Rxvt-unicode will use whatever you specify as a font. If it needs to 759Rxvt-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 760fall 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 761fonts, because they are small and fast, and then use Xft fonts. It has
587antialiasing disabled for most of them, because the author thinks they 762antialiasing disabled for most of them, because the author thinks they
588look best that way. 763look best that way.
589 764
590If you want antialiasing, you have to specify the fonts manually. 765If you want antialiasing, you have to specify the fonts manually.
591 766
592=item Mouse cut/paste suddenly no longer works. 767=head2 Mouse cut/paste suddenly no longer works.
593 768
594Make sure that mouse reporting is actually turned off since killing 769Make sure that mouse reporting is actually turned off since killing
595some editors prematurely may leave the mouse in mouse report mode. I've 770some editors prematurely may leave the mouse in mouse report mode. I've
596heard that tcsh may use mouse reporting unless it otherwise specified. A 771heard 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 772quick check is to see if cut/paste works when the Alt or Shift keys are
598depressed. See @@RXVT_NAME@@(7) 773depressed.
599 774
600=item What's with this bold/blink stuff? 775=head2 What's with this bold/blink stuff?
601 776
602If no bold colour is set via C<colorBD:>, bold will invert text using the 777If no bold colour is set via C<colorBD:>, bold will invert text using the
603standard foreground colour. 778standard foreground colour.
604 779
605For the standard background colour, blinking will actually make the 780For the standard background colour, blinking will actually make the
612 787
613color0-7 are the low-intensity colors. 788color0-7 are the low-intensity colors.
614 789
615color8-15 are the corresponding high-intensity colors. 790color8-15 are the corresponding high-intensity colors.
616 791
617=item I don't like the screen colors. How do I change them? 792=head2 I don't like the screen colors. How do I change them?
618 793
619You can change the screen colors at run-time using F<~/.Xdefaults> 794You can change the screen colors at run-time using F<~/.Xdefaults>
620resources (or as long-options). 795resources (or as long-options).
621 796
622Here are values that are supposed to resemble a VGA screen, 797Here are values that are supposed to resemble a VGA screen,
660 URxvt.color6: #73f7ff 835 URxvt.color6: #73f7ff
661 URxvt.color14: #73f7ff 836 URxvt.color14: #73f7ff
662 URxvt.color7: #e1dddd 837 URxvt.color7: #e1dddd
663 URxvt.color15: #e1dddd 838 URxvt.color15: #e1dddd
664 839
665=item How can I start @@RXVT_NAME@@d in a race-free way? 840=head2 How can I start @@RXVT_NAME@@d in a race-free way?
666 841
667Try C<@@RXVT_NAME@@d -f -o>, which tells @@RXVT_NAME@@d to open the 842Try C<@@RXVT_NAME@@d -f -o>, which tells @@RXVT_NAME@@d to open the
668display, create the listening socket and then fork. 843display, create the listening socket and then fork.
669 844
670=item What's with the strange Backspace/Delete key behaviour? 845=head2 What's with the strange Backspace/Delete key behaviour?
671 846
672Assuming that the physical Backspace key corresponds to the 847Assuming that the physical Backspace key corresponds to the
673BackSpace keysym (not likely for Linux ... see the following 848BackSpace keysym (not likely for Linux ... see the following
674question) there are two standard values that can be used for 849question) there are two standard values that can be used for
675Backspace: C<^H> and C<^?>. 850Backspace: C<^H> and C<^?>.
692 867
693 # use Backspace = ^? 868 # use Backspace = ^?
694 $ stty erase ^? 869 $ stty erase ^?
695 $ @@RXVT_NAME@@ 870 $ @@RXVT_NAME@@
696 871
697Toggle with C<ESC [ 36 h> / C<ESC [ 36 l> as documented in @@RXVT_NAME@@(7). 872Toggle with C<ESC [ 36 h> / C<ESC [ 36 l>.
698 873
699For an existing rxvt-unicode: 874For an existing rxvt-unicode:
700 875
701 # use Backspace = ^H 876 # use Backspace = ^H
702 $ stty erase ^H 877 $ stty erase ^H
721some editors (vim I'm told) expect Backspace = ^H, 896some editors (vim I'm told) expect Backspace = ^H,
722GNU Emacs (and Emacs-like editors) use ^H for help. 897GNU Emacs (and Emacs-like editors) use ^H for help.
723 898
724Perhaps someday this will all be resolved in a consistent manner. 899Perhaps someday this will all be resolved in a consistent manner.
725 900
726=item I don't like the key-bindings. How do I change them? 901=head2 I don't like the key-bindings. How do I change them?
727 902
728There are some compile-time selections available via configure. Unless 903There are some compile-time selections available via configure. Unless
729you have run "configure" with the C<--disable-resources> option you can 904you have run "configure" with the C<--disable-resources> option you can
730use the `keysym' resource to alter the keystrings associated with keysyms. 905use the `keysym' resource to alter the keystrings associated with keysyms.
731 906
752 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz > 927 URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >
753 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007 928 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
754 929
755See some more examples in the documentation for the B<keysym> resource. 930See some more examples in the documentation for the B<keysym> resource.
756 931
757=item I'm using keyboard model XXX that has extra Prior/Next/Insert keys. 932=head2 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 mappings that rxvt-unicode doesn't recognize.
758How do I make use of them? For example, the Sun Keyboard type 4
759has the following mappings that rxvt-unicode doesn't recognize.
760 933
761 KP_Insert == Insert 934 KP_Insert == Insert
762 F22 == Print 935 F22 == Print
763 F27 == Home 936 F27 == Home
764 F29 == Prior 937 F29 == Prior
767 940
768Rather than have rxvt-unicode try to accommodate all the various possible 941Rather than have rxvt-unicode try to accommodate all the various possible
769keyboard mappings, it is better to use `xmodmap' to remap the keys as 942keyboard mappings, it is better to use `xmodmap' to remap the keys as
770required for your particular machine. 943required for your particular machine.
771 944
772=item How do I distinguish wether I'm running rxvt-unicode or a regular xterm? 945=head2 How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.
773I need this to decide about setting colors etc.
774 946
775rxvt and rxvt-unicode always export the variable "COLORTERM", so you can 947rxvt and rxvt-unicode always export the variable "COLORTERM", so you can
776check and see if that is set. Note that several programs, JED, slrn, 948check and see if that is set. Note that several programs, JED, slrn,
777Midnight Commander automatically check this variable to decide whether or 949Midnight Commander automatically check this variable to decide whether or
778not to use color. 950not to use color.
779 951
780=item How do I set the correct, full IP address for the DISPLAY variable? 952=head2 How do I set the correct, full IP address for the DISPLAY variable?
781 953
782If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled 954If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
783insecure mode then it is possible to use the following shell script 955insecure mode then it is possible to use the following shell script
784snippets to correctly set the display. If your version of rxvt-unicode 956snippets to correctly set the display. If your version of rxvt-unicode
785wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then 957wasn'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 972 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
801 read DISPLAY # set it in our local shell 973 read DISPLAY # set it in our local shell
802 fi 974 fi
803 fi 975 fi
804 976
805=item How do I compile the manual pages for myself? 977=head2 How do I compile the manual pages for myself?
806 978
807You need to have a recent version of perl installed as F</usr/bin/perl>, 979You 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 980one that comes with F<pod2man>, F<pod2text> and F<pod2html>. Then go to
809the doc subdirectory and enter C<make alldoc>. 981the doc subdirectory and enter C<make alldoc>.
810 982
811=item My question isn't answered here, can I ask a human? 983=head2 My question isn't answered here, can I ask a human?
812 984
813Before sending me mail, you could go to IRC: C<irc.freenode.net>, 985Before sending me mail, you could go to IRC: C<irc.freenode.net>,
814channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be 986channel C<#rxvt-unicode> has some rxvt-unicode enthusiasts that might be
815interested in learning about new and exciting problems (but not FAQs :). 987interested in learning about new and exciting problems (but not FAQs :).
816 988
817=back
818
819=head1 RXVT TECHNICAL REFERENCE 989=head1 RXVT TECHNICAL REFERENCE
820 990
821=head1 DESCRIPTION 991=head1 DESCRIPTION
822 992
823The rest of this document describes various technical aspects of 993The rest of this document describes various technical aspects of
824B<rxvt-unicode>. First the description of supported command sequences, 994B<rxvt-unicode>. First the description of supported command sequences,
825followed by menu and pixmap support and last by a description of all 995followed by pixmap support and last by a description of all features
826features selectable at C<configure> time. 996selectable at C<configure> time.
827 997
828=head1 Definitions 998=head1 Definitions
829 999
830=over 4 1000=over 4
831 1001
1399 B<< C<h> >> Send Mouse X & Y on button press. 1569 B<< C<h> >> Send Mouse X & Y on button press.
1400 B<< C<l> >> No mouse reporting. 1570 B<< C<l> >> No mouse reporting.
1401 1571
1402=end table 1572=end table
1403 1573
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> >> 1574=item B<< C<Ps = 25> >>
1414 1575
1415=begin table 1576=begin table
1416 1577
1417 B<< C<h> >> Visible cursor {cnorm/cvvis} 1578 B<< C<h> >> Visible cursor {cnorm/cvvis}
1530 1691
1531=begin table 1692=begin table
1532 1693
1533 B<< C<h> >> Scroll to bottom when a key is pressed 1694 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 1695 B<< C<l> >> Don't scroll to bottom when a key is pressed
1696
1697=end table
1698
1699=item B<< C<Ps = 1021> >> (B<rxvt>)
1700
1701=begin table
1702
1703 B<< C<h> >> Bold/italic implies high intensity (see option B<-is>)
1704 B<< C<l> >> Font styles have no effect on intensity (Compile styles)
1535 1705
1536=end table 1706=end table
1537 1707
1538=item B<< C<Ps = 1047> >> 1708=item B<< C<Ps = 1047> >>
1539 1709
1588 B<< C<Ps = 10> >> Change colour of text foreground to B<< C<Pt> >> B<(NB: may change in future)> 1758 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)> 1759 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> >> 1760 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> >> 1761 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> >> 1762 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> >> 1763 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> >> 1764 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> >> 1765 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> >>. 1766 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> 1767 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> >>. 1768 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> >> 1769 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> >> 1770 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). 1771 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). 1772 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> >> 1773 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). 1774 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency).
1775 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
1776 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>. 1777 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). 1778 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). 1779 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). 1780 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). 1781 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). 1782 B<< C<Ps = 721> >> Move viewing window down by B<< C<Pt> >> lines, or clear scrollback buffer if C<Pt = 0> (Compile frills).
1783 B<< C<Ps = 777> >> Call the perl extension with the given string, which should be of the form C<extension:parameters> (Compile perl).
1611 1784
1612=end table 1785=end table
1613 1786
1614=back 1787=back
1615 1788
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> 1789X<XPM>
2083 1790
2084=head1 XPM 1791=head1 XPM
2085 1792
2086For the XPM XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value 1793For the XPM XTerm escape sequence B<< C<ESC ] 20 ; Pt ST> >> then value
2333alternative input methods (e.g. kinput2) and will also correctly 2040alternative input methods (e.g. kinput2) and will also correctly
2334set up the input for people using dead keys or compose keys. 2041set up the input for people using dead keys or compose keys.
2335 2042
2336=item --enable-unicode3 (default: off) 2043=item --enable-unicode3 (default: off)
2337 2044
2045Recommended to stay off unless you really need non-BMP characters.
2046
2338Enable direct support for displaying unicode codepoints above 2047Enable direct support for displaying unicode codepoints above
233965535 (the basic multilingual page). This increases storage 204865535 (the basic multilingual page). This increases storage
2340requirements per character from 2 to 4 bytes. X11 fonts do not yet 2049requirements per character from 2 to 4 bytes. X11 fonts do not yet
2341support these extra characters, but Xft does. 2050support these extra characters, but Xft does.
2342 2051
2352composite characters. This is required for proper viewing of text 2061composite characters. This is required for proper viewing of text
2353where accents are encoded as seperate unicode characters. This is 2062where accents are encoded as seperate unicode characters. This is
2354done by using precomposited characters when available or creating 2063done by using precomposited characters when available or creating
2355new pseudo-characters when no precomposed form exists. 2064new pseudo-characters when no precomposed form exists.
2356 2065
2357Without --enable-unicode3, the number of additional precomposed characters 2066Without --enable-unicode3, the number of additional precomposed
2358is rather limited (2048, if this is full, rxvt-unicode will use the 2067characters 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. 2068(ab-)used). With --enable-unicode3, no practical limit exists.
2361 2069
2362This option will also enable storage (but not display) of characters 2070This option will also enable storage (but not display) of characters
2363beyond plane 0 (>65535) when --enable-unicode3 was not specified. 2071beyond plane 0 (>65535) when --enable-unicode3 was not specified.
2364 2072
2365The combining table also contains entries for arabic presentation forms, 2073The 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 2074but these are not currently used. Bug me if you want these to be used (and
2367tell me how these are to be used...). 2075tell me how these are to be used...).
2368 2076
2369=item --enable-fallback(=CLASS) (default: Rxvt) 2077=item --enable-fallback(=CLASS) (default: Rxvt)
2370 2078
2371When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. 2079When reading resource settings, also read settings for class CLASS. To
2080disable resource fallback use --disable-fallback.
2372 2081
2373=item --with-res-name=NAME (default: urxvt) 2082=item --with-res-name=NAME (default: urxvt)
2374 2083
2375Use the given name as default application name when 2084Use the given name as default application name when
2376reading resources. Specify --with-res-name=rxvt to replace rxvt. 2085reading resources. Specify --with-res-name=rxvt to replace rxvt.
2396 2105
2397Write user and tty to lastlog file (used by programs like 2106Write user and tty to lastlog file (used by programs like
2398F<lastlogin>) at start of rxvt execution. This option requires 2107F<lastlogin>) at start of rxvt execution. This option requires
2399--enable-utmp to also be specified. 2108--enable-utmp to also be specified.
2400 2109
2401=item --enable-xpm-background (default: off) 2110=item --enable-xpm-background (default: on)
2402 2111
2403Add support for XPM background pixmaps. 2112Add support for XPM background pixmaps.
2404 2113
2405=item --enable-transparency (default: off) 2114=item --enable-transparency (default: on)
2406 2115
2407Add support for inheriting parent backgrounds thus giving a fake 2116Add support for inheriting parent backgrounds thus giving a fake
2408transparency to the term. 2117transparency to the term.
2409 2118
2410=item --enable-fading (default: on) 2119=item --enable-fading (default: on)
2412Add support for fading the text when focus is lost (requires C<--enable-transparency>). 2121Add support for fading the text when focus is lost (requires C<--enable-transparency>).
2413 2122
2414=item --enable-tinting (default: on) 2123=item --enable-tinting (default: on)
2415 2124
2416Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). 2125Add 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 2126
2423=item --enable-rxvt-scroll (default: on) 2127=item --enable-rxvt-scroll (default: on)
2424 2128
2425Add support for the original rxvt scrollbar. 2129Add support for the original rxvt scrollbar.
2426 2130
2436 2140
2437Add support for a very unobtrusive, plain-looking scrollbar that 2141Add support for a very unobtrusive, plain-looking scrollbar that
2438is the favourite of the rxvt-unicode author, having used it for 2142is the favourite of the rxvt-unicode author, having used it for
2439many years. 2143many years.
2440 2144
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) 2145=item --enable-ttygid (default: off)
2447 2146
2448Change tty device setting to group "tty" - only use this if 2147Change tty device setting to group "tty" - only use this if
2449your system uses this type of security. 2148your system uses this type of security.
2450 2149
2458do it. 2157do it.
2459 2158
2460=item --disable-resources 2159=item --disable-resources
2461 2160
2462Removes any support for resource checking. 2161Removes 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 2162
2482=item --disable-swapscreen 2163=item --disable-swapscreen
2483 2164
2484Remove support for secondary/swap screen. 2165Remove support for secondary/swap screen.
2485 2166
2492A non-exhaustive list of features enabled by C<--enable-frills> (possibly 2173A non-exhaustive list of features enabled by C<--enable-frills> (possibly
2493in combination with other switches) is: 2174in combination with other switches) is:
2494 2175
2495 MWM-hints 2176 MWM-hints
2496 EWMH-hints (pid, utf8 names) and protocols (ping) 2177 EWMH-hints (pid, utf8 names) and protocols (ping)
2497 seperate underline colour 2178 seperate underline colour (-underlineColor)
2498 settable border widths and borderless switch 2179 settable border widths and borderless switch (-w, -b, -bl)
2180 visual depth selection (-depth)
2499 settable extra linespacing 2181 settable extra linespacing /-lsp)
2500 iso-14755-2 and -3, and visual feedback 2182 iso-14755-2 and -3, and visual feedback
2183 tripleclickwords (-tcw)
2184 settable insecure mode (-insecure)
2185 keysym remapping support
2186 cursor blinking and underline cursor (-cb, -uc)
2187 XEmbed support (-embed)
2188 user-pty (-pty-fd)
2189 hold on exit (-hold)
2190 skip builtin block graphics (-sbg)
2191
2192It also enabled some non-essential features otherwise disabled, such as:
2193
2194 some round-trip time optimisations
2195 nearest color allocation on pseudocolor screens
2196 UTF8_STRING supporr for selection
2197 sgr modes 90..97 and 100..107
2501 backindex and forwardindex escape sequence 2198 backindex and forwardindex escape sequences
2199 view change/zero scorllback esacpe sequences
2200 locale switching escape sequence
2502 window op and some xterm/OSC escape sequences 2201 window op and some xterm/OSC escape sequences
2503 tripleclickwords 2202 rectangular selections
2504 settable insecure mode 2203 trailing space removal for selections
2505 keysym remapping support 2204 verbose X error handling
2506 cursor blinking and underline cursor
2507 -embed, -pty-fd and -hold options
2508 2205
2509=item --enable-iso14755 (default: on) 2206=item --enable-iso14755 (default: on)
2510 2207
2511Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2208Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2512F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2209F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by
2555 2252
2556=item --enable-pointer-blank (default: on) 2253=item --enable-pointer-blank (default: on)
2557 2254
2558Add support to have the pointer disappear when typing or inactive. 2255Add support to have the pointer disappear when typing or inactive.
2559 2256
2257=item --enable-perl (default: on)
2258
2259Enable an embedded perl interpreter. See the B<@@RXVT_NAME@@perl(3)>
2260manpage (F<doc/rxvtperl.txt>) for more info on this feature, or the files
2261in F<src/perl-ext/> for the extensions that are installed by default. The
2262perl interpreter that is used can be specified via the C<PERL> environment
2263variable when running configure.
2264
2560=item --with-name=NAME (default: urxvt) 2265=item --with-name=NAME (default: urxvt)
2561 2266
2562Set the basename for the installed binaries, resulting 2267Set the basename for the installed binaries, resulting
2563in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with 2268in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with
2564C<rxvt>. 2269C<rxvt>.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines