[ViewVC] Diff of: cvs/rxvt-unicode/doc/rxvt.7.txt

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents):
Revision 1.4 by root, Thu Feb 3 10:24:10 2005 UTC vs.
Revision 1.41 by root, Thu Jan 12 23:11:23 2006 UTC

…		…
1	NAME	1	NAME
2	RXVT REFERENCE - FAQ, command sequences and other background information	2	RXVT REFERENCE - FAQ, command sequences and other background information
3		3
		4	SYNOPSIS
		5	# set a new font set
		6	printf '\33]50;%s\007' 9x15,xft:Kochi" Mincho"
		7
		8	# change the locale and tell rxvt-unicode about it
		9	export LC_CTYPE=ja_JP.EUC-JP; printf "\33]701;$LC_CTYPE\007"
		10
		11	# set window title
		12	printf '\33]2;%s\007' "new window title"
		13
		14	DESCRIPTION
		15	This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
		16	all escape sequences, and other background information.
		17
		18	The newest version of this document is also available on the World Wide
		19	Web at
		20	<http://cvs.schmorp.de/browse/checkout/rxvt-unicode/doc/rxvt.7.html>.
		21
4	FREQUENTLY ASKED QUESTIONS	22	FREQUENTLY ASKED QUESTIONS
		23	The new selection selects pieces that are too big/too small, can I
		24	change this?
		25	Yes. For example, if you want to select smaller pieces ("words") you
		26	can use the following resource:
		27
		28	URxvt.selection.pattern-0: ([[:word:]]+)
		29
		30	If you click more than twice, the selection will be extended more
		31	and more.
		32
		33	To get a selection that is very similar to the old code, try this
		34	pattern:
		35
		36	URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\\\\]^`{\|})]+)
		37
		38	I don't like the new selection/popups/hotkeys/perl, how do I
		39	change/disable it?
		40	You can disable the perl extension completely by setting the
		41	perl-ext-common resource to the empty string, which also keeps
		42	rxvt-unicode from initialising perl, saving memory.
		43
		44	If you only want to disable specific features, you first have to
		45	identify which perl extension is responsible. For this, read the
		46	section PREPACKAGED EXTENSIONS in the rxvtperl(3) manpage. For
		47	example, to disable the selection-popup and option-popup, specify
		48	this perl-ext-common resource:
		49
		50	URxvt.perl-ext-common: default,-selection-popup,-option-popup
		51
		52	This will keep the default extensions, but disable the two popup
		53	extensions. Some extensions can also be configured, for example,
		54	scrollback search mode is triggered by M-s. You can move it to any
		55	other combination either by setting the searchable-scrollback
		56	resource:
		57
		58	URxvt.searchable-scrollback: CM-s
		59
		60	Isn't rxvt supposed to be small? Don't all those features bloat?
		61	I often get asked about this, and I think, no, they didn't cause
		62	extra bloat. If you compare a minimal rxvt and a minimal urxvt, you
		63	can see that the urxvt binary is larger (due to some encoding tables
		64	always being compiled in), but it actually uses less memory (RSS)
		65	after startup. Even with "--disable-everything", this comparison is
		66	a bit unfair, as many features unique to urxvt (locale, encoding
		67	conversion, iso14755 etc.) are already in use in this mode.
		68
		69	text data bss drs rss filename
		70	98398 1664 24 15695 1824 rxvt --disable-everything
		71	188985 9048 66616 18222 1788 urxvt --disable-everything
		72
		73	When you "--enable-everything" (which _is_ unfair, as this involves
		74	xft and full locale/XIM support which are quite bloaty inside libX11
		75	and my libc), the two diverge, but not unreasnobaly so.
		76
		77	text data bss drs rss filename
		78	163431 2152 24 20123 2060 rxvt --enable-everything
		79	1035683 49680 66648 29096 3680 urxvt --enable-everything
		80
		81	The very large size of the text section is explained by the
		82	east-asian encoding tables, which, if unused, take up disk space but
		83	nothing else and can be compiled out unless you rely on X11 core
		84	fonts that use those encodings. The BSS size comes from the 64k
		85	emergency buffer that my c++ compiler allocates (but of course
		86	doesn't use unless you are out of memory). Also, using an xft font
		87	instead of a core font immediately adds a few megabytes of RSS. Xft
		88	indeed is responsible for a lot of RSS even when not used.
		89
		90	Of course, due to every character using two or four bytes instead of
		91	one, a large scrollback buffer will ultimately make rxvt-unicode use
		92	more memory.
		93
		94	Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k),
		95	this still fares rather well. And compared to some monsters like
		96	gnome-terminal (21152k + extra 4204k in separate processes) or
		97	konsole (22200k + extra 43180k in daemons that stay around after
		98	exit, plus half a minute of startup time, including the hundreds of
		99	warnings it spits out), it fares extremely well g.
		100
		101	Why C++, isn't that unportable/bloated/uncool?
		102	Is this a question? :) It comes up very often. The simple answer is:
		103	I had to write it, and C++ allowed me to write and maintain it in a
		104	fraction of the time and effort (which is a scarce resource for me).
		105	Put even shorter: It simply wouldn't exist without C++.
		106
		107	My personal stance on this is that C++ is less portable than C, but
		108	in the case of rxvt-unicode this hardly matters, as its portability
		109	limits are defined by things like X11, pseudo terminals, locale
		110	support and unix domain sockets, which are all less portable than
		111	C++ itself.
		112
		113	Regarding the bloat, see the above question: It's easy to write
		114	programs in C that use gobs of memory, an certainly possible to
		115	write programs in C++ that don't. C++ also often comes with large
		116	libraries, but this is not necessarily the case with GCC. Here is
		117	what rxvt links against on my system with a minimal config:
		118
		119	libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
		120	libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000)
		121	libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000)
		122	/lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
		123
		124	And here is rxvt-unicode:
		125
		126	libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
		127	libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
		128	libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)
		129	libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)
		130	/lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
		131
		132	No large bloated libraries (of course, none were linked in
		133	statically), except maybe libX11 :)
		134
		135	Does it support tabs, can I have a tabbed rxvt-unicode?
		136	rxvt-unicode does not directly support tabs. It will work fine with
		137	tabbing functionality of many window managers or similar tabbing
		138	programs, and its embedding-features allow it to be embedded into
		139	other programs, as witnessed by doc/rxvt-tabbed or the upcoming
		140	"Gtk2::URxvt" perl module, which features a tabbed urxvt (murxvt)
		141	terminal as an example embedding application.
		142
5	How do I know which rxvt-unicode version I'm using?	143	How do I know which rxvt-unicode version I'm using?
6	The version number is displayed with the usage (-h). Also the escape	144	The version number is displayed with the usage (-h). Also the escape
7	sequence "ESC[8n" sets the window title to the version number.	145	sequence "ESC [ 8 n" sets the window title to the version number.
		146	When using the rxvtc client, the version displayed is that of the
		147	daemon.
		148
		149	I am using Debian GNU/Linux and have a problem...
		150	The Debian GNU/Linux package of rxvt-unicode in sarge contains large
		151	patches that considerably change the behaviour of rxvt-unicode.
		152	Before reporting a bug to the original rxvt-unicode author please
		153	download and install the genuine version
		154	(<http://software.schmorp.de#rxvt-unicode>) and try to reproduce the
		155	problem. If you cannot, chances are that the problems are specific
		156	to Debian GNU/Linux, in which case it should be reported via the
		157	Debian Bug Tracking System (use "reportbug" to report the bug).
		158
		159	For other problems that also affect the Debian package, you can and
		160	probably should use the Debian BTS, too, because, after all, it's
		161	also a bug in the Debian version and it serves as a reminder for
		162	other users that might encounter the same issue.
		163
		164	I am maintaining rxvt-unicode for distribution/OS XXX, any
		165	recommendation?
		166	You should build one binary with the default options. configure now
		167	enables most useful options, and the trend goes to making them
		168	runtime-switchable, too, so there is usually no drawback to enbaling
		169	them, except higher disk and possibly memory usage. The perl
		170	interpreter should be enabled, as important functionality (menus,
		171	selection, likely more in the future) depends on it.
		172
		173	You should not overwrite the "perl-ext-common" snd "perl-ext"
		174	resources system-wide (except maybe with "defaults"). This will
		175	result in useful behaviour. If your distribution aims at low memory,
		176	add an empty "perl-ext-common" resource to the app-defaults file.
		177	This will keep the perl interpreter disabled until the user enables
		178	it.
		179
		180	If you can/want build more binaries, I recommend building a minimal
		181	one with "--disable-everything" (very useful) and a maximal one with
		182	"--enable-everything" (less useful, it will be very big due to a lot
		183	of encodings built-in that increase download times and are rarely
		184	used).
		185
		186	I need to make it setuid/setgid to support utmp/ptys on my OS, is this
		187	safe?
		188	Likely not. While I honestly try to make it secure, and am probably
		189	not bad at it, I think it is simply unreasonable to expect all of
		190	freetype + fontconfig + xft + xlib + perl + ... + rxvt-unicode
		191	itself to all be secure. Also, rxvt-unicode disables some options
		192	when it detects that it runs setuid or setgid, which is not nice.
		193	Besides, with the embedded perl interpreter the possibility for
		194	security problems easily multiplies.
		195
		196	Elevated privileges are only required for utmp and pty operations on
		197	some systems (for example, GNU/Linux doesn't need any extra
		198	privileges for ptys, but some need it for utmp support). It is
		199	planned to mvoe this into a forked handler process, but this is not
		200	yet done.
		201
		202	So, while setuid/setgid operation is supported and not a problem on
		203	your typical single-user-no-other-logins unix desktop, always
		204	remember that its an awful lot of code, most of which isn't checked
		205	for security issues regularly.
8		206
9	When I log-in to another system it tells me about missing terminfo data?	207	When I log-in to another system it tells me about missing terminfo data?
10	The terminal description used by rxvt-unicode is not as widely	208	The terminal description used by rxvt-unicode is not as widely
11	available as that for xterm, or even rxvt (for which the same	209	available as that for xterm, or even rxvt (for which the same
12	problem often arises).	210	problem often arises).
24	problems arising, which includes wrong keymapping, less and	222	problems arising, which includes wrong keymapping, less and
25	different colours and some refresh errors in fullscreen	223	different colours and some refresh errors in fullscreen
26	applications. It's a nice quick-and-dirty workaround for rare cases,	224	applications. It's a nice quick-and-dirty workaround for rare cases,
27	though.	225	though.
28		226
29	If you always want to do this you can either recompile rxvt-unicode	227	If you always want to do this (and are fine with the consequences)
30	with the desired TERM value or use a resource to set it:	228	you can either recompile rxvt-unicode with the desired TERM value or
		229	use a resource to set it:
31		230
32	URxvt.termName: rxvt	231	URxvt.termName: rxvt
33		232
34	If you don't plan to use rxvt (quite common...) you could also	233	If you don't plan to use rxvt (quite common...) you could also
35	replace the rxvt terminfo file with the rxvt-unicode one.	234	replace the rxvt terminfo file with the rxvt-unicode one.
36		235
		236	"tic" outputs some error when compiling the terminfo entry.
		237	Most likely it's the empty definition for "enacs=". Just replace it
		238	by "enacs=\E[0@" and try again.
		239
		240	"bash"'s readline does not work correctly under rxvt.
37	I need a termcap file entry.	241	I need a termcap file entry.
		242	One reason you might want this is that some distributions or
		243	operating systems still compile some programs using the
		244	long-obsoleted termcap library (Fedora Core's bash is one example)
		245	and rely on a termcap entry for "rxvt-unicode".
		246
38	You could use rxvt's termcap entry with resonable results in many	247	You could use rxvt's termcap entry with resonable results in many
39	cases. You can also create a termcap entry by using terminfo's	248	cases. You can also create a termcap entry by using terminfo's
40	infocmp program like this:	249	infocmp program like this:
41		250
42	infocmp -C rxvt-unicode	251	infocmp -C rxvt-unicode
43		252
44	OR you could this termcap entry:	253	Or you could use this termcap entry, generated by the command above:
45		254
46	rxvt-unicode\|rxvt-unicode terminal (X Window System):\	255	rxvt-unicode\|rxvt-unicode terminal (X Window System):\
47	:am:bw:eo:km:mi:ms:xn:xo:\	256	:am:bw:eo:km:mi:ms:xn:xo:\
48	:co#80:it#8:li#24:\	257	:co#80:it#8:li#24:lm#0:\
49	:AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\	258	:AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
50	:K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\	259	:K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
51	:RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=^O:al=\E[L:\	260	:RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
52	:as=^N:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:cm=\E[%i%d;%dH:\	261	:as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
53	:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:dl=\E[M:do=^J:\	262	:cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
54	:ec=\E[%dX:ei=\E[4l:ho=\E[H:i1=\E[?47l\E=\E[?1l:ic=\E[@:\	263	:dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
		264	:i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
55	:im=\E[4h:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\	265	:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
56	:k0=\E[21~:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:\	266	:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
57	:k5=\E[15~:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:\	267	:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
58	:kD=\E[3~:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:\	268	:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E>:\
59	:ke=\E[?1l\E>:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:\	269	:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
60	:ku=\EOA:le=^H:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:\	270	:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
61	:nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\	271	:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
62	:st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\	272	:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
63	:up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\	273	:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
64	:vs=\E[?25h:	274	:vs=\E[?25h:
65		275
66	Why does "ls" no longer have coloured output?	276	Why does "ls" no longer have coloured output?
67	The "ls" in the GNU coreutils unfortunately doesn't use terminfo to	277	The "ls" in the GNU coreutils unfortunately doesn't use terminfo to
68	decide wether a terminal has colour, but uses it's own configuration	278	decide wether a terminal has colour, but uses it's own configuration
…		…
87	furthermore fail to even install the "rxvt-unicode" terminfo file,	297	furthermore fail to even install the "rxvt-unicode" terminfo file,
88	so you will need to install it on your own (See the question When I	298	so you will need to install it on your own (See the question When I
89	log-in to another system it tells me about missing terminfo data? on	299	log-in to another system it tells me about missing terminfo data? on
90	how to do this).	300	how to do this).
91		301
		302	My numerical keypad acts weird and generates differing output?
		303	Some Debian GNUL/Linux users seem to have this problem, although no
		304	specific details were reported so far. It is possible that this is
		305	caused by the wrong "TERM" setting, although the details of wether
		306	and how this can happen are unknown, as "TERM=rxvt" should offer a
		307	compatible keymap. See the answer to the previous question, and
		308	please report if that helped.
		309
92	Rxvt-unicode does not seem to understand the selected encoding?	310	Rxvt-unicode does not seem to understand the selected encoding?
93	Unicode does not seem to work?	311	Unicode does not seem to work?
94	If you encounter strange problems like typing an accented character	312	If you encounter strange problems like typing an accented character
95	but getting two unrelated other characters or similar, or if program	313	but getting two unrelated other characters or similar, or if program
96	output is subtly garbled, then you should check your locale	314	output is subtly garbled, then you should check your locale
97	settings.	315	settings.
98		316
99	Rxvt-unicode must be started with the same "LC_CTYPE" setting as the	317	Rxvt-unicode must be started with the same "LC_CTYPE" setting as the
100	programs. Often rxvt-unicode is started in the "C" locale, while the	318	programs. Often rxvt-unicode is started in the "C" locale, while the
101	login script running within the rxvt-unicode window changes the	319	login script running within the rxvt-unicode window changes the
102	locale to sth. else, e.h. "en_GB.UTF-8". Needless to say, this is	320	locale to something else, e.g. "en_GB.UTF-8". Needless to say, this
103	not going to work.	321	is not going to work.
104		322
105	The best thing is to fix your startup environment, as you will	323	The best thing is to fix your startup environment, as you will
106	likely run into other problems. If nothing works you can try this in	324	likely run into other problems. If nothing works you can try this in
107	your .profile.	325	your .profile.
108		326
109	printf '\e]701;%s\007' "$LC_CTYPE"	327	printf '\e]701;%s\007' "$LC_CTYPE"
110		328
111	If this doesn't work, then maybe you use a "LC_CTYPE" specification	329	If this doesn't work, then maybe you use a "LC_CTYPE" specification
112	not supported on your systems. Some systems have a "locale" command	330	not supported on your systems. Some systems have a "locale" command
113	which displays this. If it displays sth. like:	331	which displays this (also, "perl -e0" can be used to check locale
		332	settings, as it will complain loudly if it cannot set the locale).
		333	If it displays something like:
114		334
115	locale: Cannot set LC_CTYPE to default locale: ...	335	locale: Cannot set LC_CTYPE to default locale: ...
116		336
117	Then the locale you specified is not supported on your system.	337	Then the locale you specified is not supported on your system.
118		338
…		…
126	Chances are that the font you (or the admin/package maintainer of	346	Chances are that the font you (or the admin/package maintainer of
127	your system/os) have specified does not cover all the characters you	347	your system/os) have specified does not cover all the characters you
128	want to display.	348	want to display.
129		349
130	rxvt-unicode makes a best-effort try at finding a replacement font.	350	rxvt-unicode makes a best-effort try at finding a replacement font.
131	Often the result is fine, but sometimes the chosen font looks bad.	351	Often the result is fine, but sometimes the chosen font looks
132	Many fonts have totally strange characters that don't resemble the	352	bad/ugly/wrong. Some fonts have totally strange characters that
133	correct glyph at all, and rxvt-unicode lacks the artificial	353	don't resemble the correct glyph at all, and rxvt-unicode lacks the
134	intelligence to detect that a specific glyph is wrong: it has to	354	artificial intelligence to detect that a specific glyph is wrong: it
135	believe the font that the characters it contains indeed look	355	has to believe the font that the characters it claims to contain
136	correct.	356	indeed look correct.
137		357
138	In that case, select a font of your taste and add it to the font	358	In that case, select a font of your taste and add it to the font
139	list, e.g.:	359	list, e.g.:
140		360
141	rxvt -fn basefont,font2,font3...	361	rxvt -fn basefont,font2,font3...
…		…
144	font. If the base font does not contain the character, it will go to	364	font. If the base font does not contain the character, it will go to
145	the next font, and so on. Specifying your own fonts will also speed	365	the next font, and so on. Specifying your own fonts will also speed
146	up this search and use less resources within rxvt-unicode and the	366	up this search and use less resources within rxvt-unicode and the
147	X-server.	367	X-server.
148		368
149	The only limitation is that all the fonts must not be larger than	369	The only limitation is that none of the fonts may be larger than the
150	the base font, as the base font defines the principal cell size,	370	base font, as the base font defines the terminal character cell
151	which must be the same due to the way terminals work.	371	size, which must be the same due to the way terminals work.
152		372
153	Why do some chinese characters look so different than others?	373	Why do some chinese characters look so different than others?
154	This is because there is a difference between script and language --	374	This is because there is a difference between script and language --
155	rxvt-unicode does not know which language the text that is output	375	rxvt-unicode does not know which language the text that is output
156	is, as it only knows the unicode character codes. If rxvt-unicode	376	is, as it only knows the unicode character codes. If rxvt-unicode
157	first sees a japanese character, it might choose a japanese font for	377	first sees a japanese/chinese character, it might choose a japanese
158	it. Subsequent japanese characters will take that font. Now, many	378	font for display. Subsequent japanese characters will use that font.
159	chinese characters aren't represented in japanese fonts, so when the	379	Now, many chinese characters aren't represented in japanese fonts,
160	first non-japanese character comes up, rxvt-unicode will look for a	380	so when the first non-japanese character comes up, rxvt-unicode will
161	chinese font -- unfortunately at this point, it will still use the	381	look for a chinese font -- unfortunately at this point, it will
162	japanese font for japanese characters that are also chinese.	382	still use the japanese font for chinese characters that are also in
		383	the japanese font.
163		384
164	The workaround is easy: just tag a chinese font at the end of your	385	The workaround is easy: just tag a chinese font at the end of your
165	font list (see the previous question). The key is to view the font	386	font list (see the previous question). The key is to view the font
166	list as a preference list: If you expect more japanese, list a	387	list as a preference list: If you expect more japanese, list a
167	japanese font first. If you expect more chinese, put a chinese font	388	japanese font first. If you expect more chinese, put a chinese font
168	first.	389	first.
169		390
170	In the future it might be possible to switch preferences at runtime	391	In the future it might be possible to switch language preferences at
171	(the internal data structure has no problem with using different	392	runtime (the internal data structure has no problem with using
172	fonts for the same character at the same time, but no interface for	393	different fonts for the same character at the same time, but no
173	this has been designed yet).	394	interface for this has been designed yet).
		395
		396	Until then, you might get away with switching fonts at runtime (see
		397	"Can I switch the fonts at runtime?" later in this document).
174		398
175	Why does rxvt-unicode sometimes leave pixel droppings?	399	Why does rxvt-unicode sometimes leave pixel droppings?
176	Most fonts were not designed for terminal use, which means that	400	Most fonts were not designed for terminal use, which means that
177	character size varies a lot. A font that is otherwise fine for	401	character size varies a lot. A font that is otherwise fine for
178	terminal use might contain some characters that are simply too wide.	402	terminal use might contain some characters that are simply too wide.
…		…
192	that doesn't work, you might be forced to use a different font.	416	that doesn't work, you might be forced to use a different font.
193		417
194	All of this is not a problem when using X11 core fonts, as their	418	All of this is not a problem when using X11 core fonts, as their
195	bounding box data is correct.	419	bounding box data is correct.
196		420
		421	On Solaris 9, many line-drawing characters are too wide.
		422	Seems to be a known bug, read
		423	<http://nixdoc.net/files/forum/about34198.html>. Some people use the
		424	following ugly workaround to get non-double-wide-characters working:
		425
		426	#define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
		427
197	My Compose (Multi_key) key is no longer working.	428	My Compose (Multi_key) key is no longer working.
198	The most common causes for this are that either your locale is not	429	The most common causes for this are that either your locale is not
199	set correctly, or you specified a preeditStyle that is not supported	430	set correctly, or you specified a preeditStyle that is not supported
200	by your input method. For example, if you specified OverTheSpot and	431	by your input method. For example, if you specified OverTheSpot and
201	your input method (e.g. the default input method handling Compose	432	your input method (e.g. the default input method handling Compose
…		…
212	advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for	443	advantage, typing <Ctrl-Shift-0> to get a ASCII NUL. This works for
213	other codes, too, such as "Ctrl-Shift-1-d" to type the default	444	other codes, too, such as "Ctrl-Shift-1-d" to type the default
214	telnet escape character and so on.	445	telnet escape character and so on.
215		446
216	How can I keep rxvt-unicode from using reverse video so much?	447	How can I keep rxvt-unicode from using reverse video so much?
217	First of all, make sure you are running with the right terminfo	448	First of all, make sure you are running with the right terminal
218	("urxvt"), which will get rid of most of these effects. Then make	449	settings ("TERM=rxvt-unicode"), which will get rid of most of these
219	sure you have specified colours for italic and bold, as otherwise	450	effects. Then make sure you have specified colours for italic and
220	rxvt-unicode might use reverse video to simulate the effect:	451	bold, as otherwise rxvt-unicode might use reverse video to simulate
		452	the effect:
221		453
222	URxvt*colorBD: white	454	URxvt.colorBD: white
223	URxvt*colorIT: green	455	URxvt.colorIT: green
224		456
225	Some programs assume totally weird colours (red instead of blue), how	457	Some programs assume totally weird colours (red instead of blue), how
226	can I fix that?	458	can I fix that?
227	For some unexplainable reason, some programs (i.e. irssi) assume a	459	For some unexplainable reason, some rare programs assume a very
228	very weird colour palette when confronted with a terminal with more	460	weird colour palette when confronted with a terminal with more than
229	than the standard 8 colours (rxvt-unicode supports 88). The right	461	the standard 8 colours (rxvt-unicode supports 88). The right fix is,
230	fix is, of course, to fix these programs not to assume non-ISO	462	of course, to fix these programs not to assume non-ISO colours
231	colours without very good reasons.	463	without very good reasons.
232		464
233	In the meantime, you can either edit your "urxvt" terminfo	465	In the meantime, you can either edit your "rxvt-unicode" terminfo
234	definition to only claim 8 colour support or use "TERM=rxvt", which	466	definition to only claim 8 colour support or use "TERM=rxvt", which
235	will fix colours but keep you from using other rxvt-unicode	467	will fix colours but keep you from using other rxvt-unicode
236	features.	468	features.
237		469
238	I am on FreeBSD and rxvt-unicode does not seem to work at all.	470	I am on FreeBSD and rxvt-unicode does not seem to work at all.
…		…
241	it, wether it defines the symbol or not. "__STDC_ISO_10646__"	473	it, wether it defines the symbol or not. "__STDC_ISO_10646__"
242	requires that wchar_t is represented as unicode.	474	requires that wchar_t is represented as unicode.
243		475
244	As you might have guessed, FreeBSD does neither define this symobl	476	As you might have guessed, FreeBSD does neither define this symobl
245	nor does it support it. Instead, it uses it's own internal	477	nor does it support it. Instead, it uses it's own internal
246	representation of wchar_t. This is, of course, completely legal.	478	representation of wchar_t. This is, of course, completely fine with
		479	respect to standards.
247		480
		481	However, that means rxvt-unicode only works in "POSIX", "ISO-8859-1"
		482	and "UTF-8" locales under FreeBSD (which all use Unicode as wchar_t.
		483
248	However, "__STDC_ISO_10646__" is the only sane way to support	484	"__STDC_ISO_10646__" is the only sane way to support multi-language
249	multi-language apps in an OS, as using a locale-dependent (and	485	apps in an OS, as using a locale-dependent (and non-standardized)
250	non-standardized) representation of wchar_t makes it impossible to	486	representation of wchar_t makes it impossible to convert between
251	convert between wchar_t (as used by X11 and your applications) and	487	wchar_t (as used by X11 and your applications) and any other
252	any other encoding without implementing OS-specific-wrappers for	488	encoding without implementing OS-specific-wrappers for each and
253	each and every locale. There simply are no APIs to convert wchar_t	489	every locale. There simply are no APIs to convert wchar_t into
254	into anything except the current locale encoding.	490	anything except the current locale encoding.
255		491
256	Some applications (such as the formidable mlterm) work around this	492	Some applications (such as the formidable mlterm) work around this
257	by carrying their own replacement functions for character set	493	by carrying their own replacement functions for character set
258	handling with them, and either implementing OS-dependent hacks or	494	handling with them, and either implementing OS-dependent hacks or
259	doing multiple conversions (which is slow and unreliable in case the	495	doing multiple conversions (which is slow and unreliable in case the
260	OS implements encodings slightly different than the terminal	496	OS implements encodings slightly different than the terminal
261	emulator).	497	emulator).
262		498
263	The rxvt-unicode author insists that the right way to fix this is in	499	The rxvt-unicode author insists that the right way to fix this is in
264	the system libraries once and for all, instead of forcing every app	500	the system libraries once and for all, instead of forcing every app
265	to carry complete replacements.	501	to carry complete replacements for them :)
		502
		503	I use Solaris 9 and it doesn't compile/work/etc.
		504	Try the diff in doc/solaris9.patch as a base. It fixes the worst
		505	problems with "wcwidth" and a compile problem.
		506
		507	How can I use rxvt-unicode under cygwin?
		508	rxvt-unicode should compile and run out of the box on cygwin, using
		509	the X11 libraries that come with cygwin. libW11 emulation is no
		510	longer supported (and makes no sense, either, as it only supported a
		511	single font). I recommend starting the X-server in "-multiwindow" or
		512	"-rootless" mode instead, which will result in similar look&feel as
		513	the old libW11 emulation.
		514
		515	At the time of this writing, cygwin didn't seem to support any
		516	multi-byte encodings (you might try "LC_CTYPE=C-UTF-8"), so you are
		517	likely limited to 8-bit encodings.
266		518
267	How does rxvt-unicode determine the encoding to use?	519	How does rxvt-unicode determine the encoding to use?
268	Is there an option to switch encodings?	520	Is there an option to switch encodings?
269	Unlike some other terminals, rxvt-unicode has no encoding switch,	521	Unlike some other terminals, rxvt-unicode has no encoding switch,
270	and no specific "utf-8" mode, such as xterm. In fact, it doesn't	522	and no specific "utf-8" mode, such as xterm. In fact, it doesn't
…		…
273		525
274	The reasons is that there exists a perfectly fine mechanism for	526	The reasons is that there exists a perfectly fine mechanism for
275	selecting the encoding, doing I/O and (most important) communicating	527	selecting the encoding, doing I/O and (most important) communicating
276	this to all applications so everybody agrees on character properties	528	this to all applications so everybody agrees on character properties
277	such as width and code number. This mechanism is the locale.	529	such as width and code number. This mechanism is the locale.
		530	Applications not using that info will have problems (for example,
		531	"xterm" gets the width of characters wrong as it uses it's own,
		532	locale-independent table under all locales).
278		533
279	Rxvt-unicode uses the "LC_CTYPE" locale category to select encoding.	534	Rxvt-unicode uses the "LC_CTYPE" locale category to select encoding.
280	All programs doing the same (that is, most) will automatically agree	535	All programs doing the same (that is, most) will automatically agree
281	in the interpretation of characters.	536	in the interpretation of characters.
282		537
…		…
290	"language_country.encoding", but other forms (i.e. "de" or "german")	545	"language_country.encoding", but other forms (i.e. "de" or "german")
291	are also common.	546	are also common.
292		547
293	Rxvt-unicode ignores all other locale categories, and except for the	548	Rxvt-unicode ignores all other locale categories, and except for the
294	encoding, ignores country or language-specific settings, i.e.	549	encoding, ignores country or language-specific settings, i.e.
295	"de_DE.UTF-8" and "ja_JP.UTF-8" are the same for rxvt-unicode.	550	"de_DE.UTF-8" and "ja_JP.UTF-8" are the normally same to
		551	rxvt-unicode.
296		552
297	If you want to use a specific encoding you have to make sure you	553	If you want to use a specific encoding you have to make sure you
298	start rxvt-unicode with the correct "LC_CTYPE" category.	554	start rxvt-unicode with the correct "LC_CTYPE" category.
299		555
300	Can I switch locales at runtime?	556	Can I switch locales at runtime?
301	Yes, using an escape sequence. Try sth. like this, which sets	557	Yes, using an escape sequence. Try something like this, which sets
302	rxvt-unicode's idea of "LC_CTYPE".	558	rxvt-unicode's idea of "LC_CTYPE".
303		559
304	printf '\e]701;%s\007' ja_JP.SJIS	560	printf '\e]701;%s\007' ja_JP.SJIS
305		561
306	See also the previous question.	562	See also the previous answer.
307		563
308	Sometimes this capability is rather handy when you want to work in	564	Sometimes this capability is rather handy when you want to work in
309	one locale (e.g. "de_DE.UTF-8") but some programs don't support	565	one locale (e.g. "de_DE.UTF-8") but some programs don't support it
310	UTF-8. For example, I use this script to start "xjdic", which first	566	(e.g. UTF-8). For example, I use this script to start "xjdic", which
311	switches to a locale supported by xjdic and back later:	567	first switches to a locale supported by xjdic and back later:
312		568
313	printf '\e]701;%s\007' ja_JP.SJIS	569	printf '\e]701;%s\007' ja_JP.SJIS
314	xjdic -js	570	xjdic -js
315	printf '\e]701;%s\007' de_DE.UTF-8	571	printf '\e]701;%s\007' de_DE.UTF-8
316		572
		573	You can also use xterm's "luit" program, which usually works fine,
		574	except for some locales where character width differs between
		575	program- and rxvt-unicode-locales.
		576
317	Can I switch the fonts at runtime?	577	Can I switch the fonts at runtime?
318	Yes, using an escape sequence. Try sth. like this, which has the	578	Yes, using an escape sequence. Try something like this, which has
319	same effect as using the "-fn" switch, and takes effect immediately:	579	the same effect as using the "-fn" switch, and takes effect
		580	immediately:
320		581
321	printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic"	582	printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic"
322		583
323	This is useful if you e.g. work primarily with japanese (and prefer	584	This is useful if you e.g. work primarily with japanese (and prefer
324	a japanese font), but you have to switch to chinese temporarily,	585	a japanese font), but you have to switch to chinese temporarily,
…		…
327	You can think of this as a kind of manual ISO-2022 switching.	588	You can think of this as a kind of manual ISO-2022 switching.
328		589
329	Why do italic characters look as if clipped?	590	Why do italic characters look as if clipped?
330	Many fonts have difficulties with italic characters and hinting. For	591	Many fonts have difficulties with italic characters and hinting. For
331	example, the otherwise very nicely hinted font "xft:Bitstream Vera	592	example, the otherwise very nicely hinted font "xft:Bitstream Vera
332	Sans Mono" completely fails in it's italic face. A workaround is to	593	Sans Mono" completely fails in it's italic face. A workaround might
333	enable freetype autohinting, i.e. like this:	594	be to enable freetype autohinting, i.e. like this:
334		595
335	URxvt*italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true	596	URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
336	URxvt*boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true	597	URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
337		598
338	My input method wants <some encoding> but I want UTF-8, what can I do?	599	My input method wants <some encoding> but I want UTF-8, what can I do?
339	You can specify separate locales for the input method and the rest	600	You can specify separate locales for the input method and the rest
340	of the terminal, using the resource "imlocale":	601	of the terminal, using the resource "imlocale":
341		602
…		…
344	Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and	605	Now you can start your terminal with "LC_CTYPE=ja_JP.UTF-8" and
345	still use your input method. Please note, however, that you will not	606	still use your input method. Please note, however, that you will not
346	be able to input characters outside "EUC-JP" in a normal way then,	607	be able to input characters outside "EUC-JP" in a normal way then,
347	as your input method limits you.	608	as your input method limits you.
348		609
		610	Rxvt-unicode crashes when the X Input Method changes or exits.
		611	Unfortunately, this is unavoidable, as the XIM protocol is racy by
		612	design. Applications can avoid some crashes at the expense of memory
		613	leaks, and Input Methods can avoid some crashes by careful ordering
		614	at exit time. kinput2 (and derived input methods) generally
		615	succeeds, while SCIM (or similar input methods) fails. In the end,
		616	however, crashes cannot be completely avoided even if both sides
		617	cooperate.
		618
		619	So the only workaround is not to kill your Input Method Servers.
		620
349	Rxvt-unicode uses gobs of memory, how can I reduce that?	621	Rxvt-unicode uses gobs of memory, how can I reduce that?
350	Rxvt-unicode tries to obey the rule of not charging you for sth. you	622	Rxvt-unicode tries to obey the rule of not charging you for
351	don't use. One thing you should try is to configure out all settings	623	something you don't use. One thing you should try is to configure
352	that you don't need, for example, Xft support is a resource hog by	624	out all settings that you don't need, for example, Xft support is a
353	design, when used. Compiling it out ensures that no Xft font will be	625	resource hog by design, when used. Compiling it out ensures that no
354	loaded accidentally when rxvt-unicode tries to find a font for your	626	Xft font will be loaded accidentally when rxvt-unicode tries to find
355	characters.	627	a font for your characters.
356		628
357	Also, many people (me included) like large windows and even larger	629	Also, many people (me included) like large windows and even larger
358	scrollback buffers: Without "--enable-unicode3", rxvt-unicode will	630	scrollback buffers: Without "--enable-unicode3", rxvt-unicode will
359	use 6 bytes per screen cell. For a 160x?? window this amounts to	631	use 6 bytes per screen cell. For a 160x?? window this amounts to
360	almost a kilobyte per line. A scrollback buffer of 10000 lines will	632	almost a kilobyte per line. A scrollback buffer of 10000 lines will
…		…
362	it gets worse, as rxvt-unicode then uses 8 bytes per screen cell.	634	it gets worse, as rxvt-unicode then uses 8 bytes per screen cell.
363		635
364	Can I speed up Xft rendering somehow?	636	Can I speed up Xft rendering somehow?
365	Yes, the most obvious way to speed it up is to avoid Xft entirely,	637	Yes, the most obvious way to speed it up is to avoid Xft entirely,
366	as it is simply slow. If you still want Xft fonts you might try to	638	as it is simply slow. If you still want Xft fonts you might try to
367	disable antialiasing (by appending ":antialiasing=false"), which	639	disable antialiasing (by appending ":antialias=false"), which saves
368	saves lots of memory and also speeds up rendering considerably.	640	lots of memory and also speeds up rendering considerably.
369		641
370	Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?	642	Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
371	Rxvt-unicode will use whatever you specify as a font. If it needs to	643	Rxvt-unicode will use whatever you specify as a font. If it needs to
372	fall back to it's default font search list it will prefer X11 core	644	fall back to it's default font search list it will prefer X11 core
373	fonts, because they are small and fast, and then use Xft fonts. It	645	fonts, because they are small and fast, and then use Xft fonts. It
…		…
404	resources (or as long-options).	676	resources (or as long-options).
405		677
406	Here are values that are supposed to resemble a VGA screen,	678	Here are values that are supposed to resemble a VGA screen,
407	including the murky brown that passes for low-intensity yellow:	679	including the murky brown that passes for low-intensity yellow:
408		680
409	URxvt*color0: #000000	681	URxvt.color0: #000000
410	URxvt*color1: #A80000	682	URxvt.color1: #A80000
411	URxvt*color2: #00A800	683	URxvt.color2: #00A800
412	URxvt*color3: #A8A800	684	URxvt.color3: #A8A800
413	URxvt*color4: #0000A8	685	URxvt.color4: #0000A8
414	URxvt*color5: #A800A8	686	URxvt.color5: #A800A8
415	URxvt*color6: #00A8A8	687	URxvt.color6: #00A8A8
416	URxvt*color7: #A8A8A8	688	URxvt.color7: #A8A8A8
417		689
418	URxvt*color8: #000054	690	URxvt.color8: #000054
419	URxvt*color9: #FF0054	691	URxvt.color9: #FF0054
420	URxvt*color10: #00FF54	692	URxvt.color10: #00FF54
421	URxvt*color11: #FFFF54	693	URxvt.color11: #FFFF54
422	URxvt*color12: #0000FF	694	URxvt.color12: #0000FF
423	URxvt*color13: #FF00FF	695	URxvt.color13: #FF00FF
424	URxvt*color14: #00FFFF	696	URxvt.color14: #00FFFF
425	URxvt*color15: #FFFFFF	697	URxvt.color15: #FFFFFF
426		698
427	And here is a more complete set of non-standard colors described as	699	And here is a more complete set of non-standard colors described
428	"pretty girly":	700	(not by me) as "pretty girly".
429		701
430	URxvt.cursorColor: #dc74d1	702	URxvt.cursorColor: #dc74d1
431	URxvt.pointerColor: #dc74d1	703	URxvt.pointerColor: #dc74d1
432	URxvt.background: #0e0e0e	704	URxvt.background: #0e0e0e
433	URxvt.foreground: #4ad5e1	705	URxvt.foreground: #4ad5e1
…		…
444	URxvt.color6: #73f7ff	716	URxvt.color6: #73f7ff
445	URxvt.color14: #73f7ff	717	URxvt.color14: #73f7ff
446	URxvt.color7: #e1dddd	718	URxvt.color7: #e1dddd
447	URxvt.color15: #e1dddd	719	URxvt.color15: #e1dddd
448		720
		721	How can I start rxvtd in a race-free way?
		722	Try "rxvtd -f -o", which tells rxvtd to open the display, create the
		723	listening socket and then fork.
		724
449	What's with the strange Backspace/Delete key behaviour?	725	What's with the strange Backspace/Delete key behaviour?
450	Assuming that the physical Backspace key corresponds to the	726	Assuming that the physical Backspace key corresponds to the
451	BackSpace keysym (not likely for Linux ... see the following	727	BackSpace keysym (not likely for Linux ... see the following
452	question) there are two standard values that can be used for	728	question) there are two standard values that can be used for
453	Backspace: "^H" and "^?".	729	Backspace: "^H" and "^?".
…		…
471		747
472	# use Backspace = ^?	748	# use Backspace = ^?
473	$ stty erase ^?	749	$ stty erase ^?
474	$ rxvt	750	$ rxvt
475		751
476	Toggle with "ESC[36h" / "ESC[36l" as documented in rxvt(7).	752	Toggle with "ESC [ 36 h" / "ESC [ 36 l" as documented in rxvt(7).
477		753
478	For an existing rxvt-unicode:	754	For an existing rxvt-unicode:
479		755
480	# use Backspace = ^H	756	# use Backspace = ^H
481	$ stty erase ^H	757	$ stty erase ^H
…		…
490	value properly reflects that.	766	value properly reflects that.
491		767
492	The Delete key is a another casualty of the ill-defined Backspace	768	The Delete key is a another casualty of the ill-defined Backspace
493	problem. To avoid confusion between the Backspace and Delete keys,	769	problem. To avoid confusion between the Backspace and Delete keys,
494	the Delete key has been assigned an escape sequence to match the	770	the Delete key has been assigned an escape sequence to match the
495	vt100 for Execute (ESC[3~) and is in the supplied termcap/terminfo.	771	vt100 for Execute ("ESC [ 3 ~") and is in the supplied
		772	termcap/terminfo.
496		773
497	Some other Backspace problems:	774	Some other Backspace problems:
498		775
499	some editors use termcap/terminfo, some editors (vim I'm told)	776	some editors use termcap/terminfo, some editors (vim I'm told)
500	expect Backspace = ^H, GNU Emacs (and Emacs-like editors) use ^H for	777	expect Backspace = ^H, GNU Emacs (and Emacs-like editors) use ^H for
…		…
506	There are some compile-time selections available via configure.	783	There are some compile-time selections available via configure.
507	Unless you have run "configure" with the "--disable-resources"	784	Unless you have run "configure" with the "--disable-resources"
508	option you can use the `keysym' resource to alter the keystrings	785	option you can use the `keysym' resource to alter the keystrings
509	associated with keysyms.	786	associated with keysyms.
510		787
511	Here's an example for a URxvt session started using `rxvt -name	788	Here's an example for a URxvt session started using "rxvt -name
512	URxvt'	789	URxvt"
513		790
514	URxvt.keysym.Home: \e[1~	791	URxvt.keysym.Home: \033[1~
515	URxvt.keysym.End: \e[4~	792	URxvt.keysym.End: \033[4~
516	URxvt.keysym.C-apostrophe: \e<C-'>	793	URxvt.keysym.C-apostrophe: \033<C-'>
517	URxvt.keysym.C-slash: \e<C-/>	794	URxvt.keysym.C-slash: \033<C-/>
518	URxvt.keysym.C-semicolon: \e<C-;>	795	URxvt.keysym.C-semicolon: \033<C-;>
519	URxvt.keysym.C-grave: \e<C-`>	796	URxvt.keysym.C-grave: \033<C-`>
520	URxvt.keysym.C-comma: \e<C-,>	797	URxvt.keysym.C-comma: \033<C-,>
521	URxvt.keysym.C-period: \e<C-.>	798	URxvt.keysym.C-period: \033<C-.>
522	URxvt.keysym.C-0x60: \e<C-`>	799	URxvt.keysym.C-0x60: \033<C-`>
523	URxvt.keysym.C-Tab: \e<C-Tab>	800	URxvt.keysym.C-Tab: \033<C-Tab>
524	URxvt.keysym.C-Return: \e<C-Return>	801	URxvt.keysym.C-Return: \033<C-Return>
525	URxvt.keysym.S-Return: \e<S-Return>	802	URxvt.keysym.S-Return: \033<S-Return>
526	URxvt.keysym.S-space: \e<S-Space>	803	URxvt.keysym.S-space: \033<S-Space>
527	URxvt.keysym.M-Up: \e<M-Up>	804	URxvt.keysym.M-Up: \033<M-Up>
528	URxvt.keysym.M-Down: \e<M-Down>	805	URxvt.keysym.M-Down: \033<M-Down>
529	URxvt.keysym.M-Left: \e<M-Left>	806	URxvt.keysym.M-Left: \033<M-Left>
530	URxvt.keysym.M-Right: \e<M-Right>	807	URxvt.keysym.M-Right: \033<M-Right>
531	URxvt.keysym.M-C-0: list \e<M-C- 0123456789 >	808	URxvt.keysym.M-C-0: list \033<M-C- 0123456789 >
532	URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >	809	URxvt.keysym.M-C-a: list \033<M-C- abcdefghijklmnopqrstuvwxyz >
533	URxvt.keysym.F12: proto:\033]701;zh_CN.GBK\007	810	URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
534		811
535	See some more examples in the documentation for the keysym resource.	812	See some more examples in the documentation for the keysym resource.
536		813
537	I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How	814	I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How
538	do I make use of them? For example, the Sun Keyboard type 4 has the	815	do I make use of them? For example, the Sun Keyboard type 4 has the
…		…
546		823
547	Rather than have rxvt-unicode try to accommodate all the various	824	Rather than have rxvt-unicode try to accommodate all the various
548	possible keyboard mappings, it is better to use `xmodmap' to remap	825	possible keyboard mappings, it is better to use `xmodmap' to remap
549	the keys as required for your particular machine.	826	the keys as required for your particular machine.
550		827
551	How do I distinguish if I'm running rxvt-unicode or a regular xterm? I	828	How do I distinguish wether I'm running rxvt-unicode or a regular xterm?
552	need this to decide about setting colors etc.	829	I need this to decide about setting colors etc.
553	rxvt and rxvt-unicode always export the variable "COLORTERM", so you	830	rxvt and rxvt-unicode always export the variable "COLORTERM", so you
554	can check and see if that is set. Note that several programs, JED,	831	can check and see if that is set. Note that several programs, JED,
555	slrn, Midnight Commander automatically check this variable to decide	832	slrn, Midnight Commander automatically check this variable to decide
556	whether or not to use color.	833	whether or not to use color.
557		834
…		…
588	Before sending me mail, you could go to IRC: "irc.freenode.net",	865	Before sending me mail, you could go to IRC: "irc.freenode.net",
589	channel "#rxvt-unicode" has some rxvt-unicode enthusiasts that might	866	channel "#rxvt-unicode" has some rxvt-unicode enthusiasts that might
590	be interested in learning about new and exciting problems (but not	867	be interested in learning about new and exciting problems (but not
591	FAQs :).	868	FAQs :).
592		869
593	SYNOPSIS	870	RXVT TECHNICAL REFERENCE
594	# set a new font set
595	printf '\33]50;%s\007' 9x15,xft:Kochi" Mincho"
596
597	# change the locale and tell rxvt-unicode about it
598	export LC_CTYPE=ja_JP.EUC-JP; printf "\33]701;$LC_CTYPE\007"
599
600	# set window title
601	printf '\33]2;%s\007' "new window title"
602
603	DESCRIPTION	871	DESCRIPTION
604	The rest of this document describes various technical aspects of	872	The rest of this document describes various technical aspects of
605	rxvt-unicode. First the description of supported command sequences,	873	rxvt-unicode. First the description of supported command sequences,
606	followed by menu and pixmap support and last by a description of all	874	followed by menu and pixmap support and last by a description of all
607	features selectable at "configure" time.	875	features selectable at "configure" time.
608		876
609	RXVT TECHNICAL REFERENCE
610	Definitions	877	Definitions
611	"c" The literal character c.	878	"c" The literal character c.
612		879
613	"C" A single (required) character.	880	"C" A single (required) character.
614		881
…		…
699	"ESC O"	966	"ESC O"
700	Single Shift Select of G3 Character Set (SS3): affects next	967	Single Shift Select of G3 Character Set (SS3): affects next
701	character only unimplemented	968	character only unimplemented
702		969
703	"ESC Z"	970	"ESC Z"
704	Obsolete form of returns: "ESC[?1;2C" *rxvt-unicode compile-time	971	Obsolete form of returns: "ESC [ ? 1 ; 2 C" *rxvt-unicode
705	option*	972	compile-time option*
706		973
707	"ESC c"	974	"ESC c"
708	Full reset (RIS)	975	Full reset (RIS)
709		976
710	"ESC n"	977	"ESC n"
711	Invoke the G2 Character Set (LS2)	978	Invoke the G2 Character Set (LS2)
712		979
713	"ESC o"	980	"ESC o"
714	Invoke the G3 Character Set (LS3)	981	Invoke the G3 Character Set (LS3)
715		982
716	"ESC" ( C>	983	"ESC ( C"
717	Designate G0 Character Set (ISO 2022), see below for values of "C".	984	Designate G0 Character Set (ISO 2022), see below for values of "C".
718		985
719	"ESC" ) C>	986	"ESC ) C"
720	Designate G1 Character Set (ISO 2022), see below for values of "C".	987	Designate G1 Character Set (ISO 2022), see below for values of "C".
721		988
722	"ESC * C"	989	"ESC * C"
723	Designate G2 Character Set (ISO 2022), see below for values of "C".	990	Designate G2 Character Set (ISO 2022), see below for values of "C".
724		991
…		…
817	"ESC [ Ps a"	1084	"ESC [ Ps a"
818	See "ESC [ Ps C"	1085	See "ESC [ Ps C"
819		1086
820	"ESC [ Ps c"	1087	"ESC [ Ps c"
821	Send Device Attributes (DA) "Ps = 0" (or omitted): request	1088	Send Device Attributes (DA) "Ps = 0" (or omitted): request
822	attributes from terminal returns: "ESC[?1;2c" (``I am a VT100 with	1089	attributes from terminal returns: "ESC [ ? 1 ; 2 c" (``I am a VT100
823	Advanced Video Option'')	1090	with Advanced Video Option'')
824		1091
825	"ESC [ Ps d"	1092	"ESC [ Ps d"
826	Cursor to Line "Ps" (VPA)	1093	Cursor to Line "Ps" (VPA)
827		1094
828	"ESC [ Ps e"	1095	"ESC [ Ps e"
…		…
908	Window Operations	1175	Window Operations
909		1176
910	Ps = 1 Deiconify (map) window	1177	Ps = 1 Deiconify (map) window
911	Ps = 2 Iconify window	1178	Ps = 2 Iconify window
912	Ps = 3 ESC [ 3 ; X ; Y t Move window to (X\|Y)	1179	Ps = 3 ESC [ 3 ; X ; Y t Move window to (X\|Y)
913	Ps = 4 ESC [ 4 ; W ; H t Resize to WxH pixels	1180	Ps = 4 ESC [ 4 ; H ; W t Resize to WxH pixels
914	Ps = 5 Raise window	1181	Ps = 5 Raise window
915	Ps = 6 Lower window	1182	Ps = 6 Lower window
916	Ps = 7 Refresh screen once	1183	Ps = 7 Refresh screen once
917	Ps = 8 ESC [ 4 ; C ; R t Resize to C columns and R rows	1184	Ps = 8 ESC [ 8 ; R ; C t Resize to R rows and C columns
918	Ps = 11 Report window state (responds with Ps = 1 or Ps = 2	1185	Ps = 11 Report window state (responds with Ps = 1 or Ps = 2)
919	Ps = 13 Report window position (responds with Ps = 3)	1186	Ps = 13 Report window position (responds with Ps = 3)
920	Ps = 14 Report window pixel size (responds with Ps = 4)	1187	Ps = 14 Report window pixel size (responds with Ps = 4)
921	Ps = 18 Report window text size (responds with Ps = 7)	1188	Ps = 18 Report window text size (responds with Ps = 7)
922	Ps = 19 Currently the same as Ps = 18, but responds with Ps = 9	1189	Ps = 19 Currently the same as Ps = 18, but responds with Ps = 9
923	Ps = 20 Reports icon label (ESC ] L NAME \234)	1190	Ps = 20 Reports icon label (ESC ] L NAME \234)
…		…
1043	l Scroll to bottom on TTY output	1310	l Scroll to bottom on TTY output
1044		1311
1045	"Ps = 1011" (rxvt)	1312	"Ps = 1011" (rxvt)
1046	h Scroll to bottom when a key is pressed	1313	h Scroll to bottom when a key is pressed
1047	l Don't scroll to bottom when a key is pressed	1314	l Don't scroll to bottom when a key is pressed
		1315
		1316	"Ps = 1021" (rxvt)
		1317	h Bold/italic implies high intensity (see option -is)
		1318	l Font styles have no effect on intensity (Compile styles)
1048		1319
1049	"Ps = 1047"	1320	"Ps = 1047"
1050	h Use Alternate Screen Buffer	1321	h Use Alternate Screen Buffer
1051	l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it	1322	l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
1052		1323
…		…
1075	Ps = 10 Change colour of text foreground to Pt (NB: may change in future)	1346	Ps = 10 Change colour of text foreground to Pt (NB: may change in future)
1076	Ps = 11 Change colour of text background to Pt (NB: may change in future)	1347	Ps = 11 Change colour of text background to Pt (NB: may change in future)
1077	Ps = 12 Change colour of text cursor foreground to Pt	1348	Ps = 12 Change colour of text cursor foreground to Pt
1078	Ps = 13 Change colour of mouse foreground to Pt	1349	Ps = 13 Change colour of mouse foreground to Pt
1079	Ps = 17 Change colour of highlight characters to Pt	1350	Ps = 17 Change colour of highlight characters to Pt
1080	Ps = 18 Change colour of bold characters to Pt	1351	Ps = 18 Change colour of bold characters to Pt [deprecated, see 706]
1081	Ps = 19 Change colour of underlined characters to Pt	1352	Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707]
1082	Ps = 20 Change default background to Pt	1353	Ps = 20 Change default background to Pt
1083	Ps = 39 Change default foreground colour to Pt rxvt compile-time option	1354	Ps = 39 Change default foreground colour to Pt.
1084	Ps = 46 Change Log File to Pt unimplemented	1355	Ps = 46 Change Log File to Pt unimplemented
1085	Ps = 49 Change default background colour to Pt rxvt compile-time option	1356	Ps = 49 Change default background colour to Pt.
1086	Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n	1357	Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n
1087	Ps = 55 Log all scrollback buffer and all of screen to Pt	1358	Ps = 55 Log all scrollback buffer and all of screen to Pt
1088	Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (rxvt extension)	1359	Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
1089	Ps = 703 Menubar command Pt rxvt compile-time option (rxvt-unicode extension)	1360	Ps = 703 Menubar command Pt (Compile menubar).
1090	Ps = 704 Change colour of italic characters to Pt	1361	Ps = 704 Change colour of italic characters to Pt
1091	Ps = 705 Change background pixmap tint colour to Pt	1362	Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
		1363	Ps = 706 Change colour of bold characters to Pt
		1364	Ps = 707 Change colour of underlined characters to Pt
1092	Ps = 710 Set normal fontset to Pt. Same as Ps = 50.	1365	Ps = 710 Set normal fontset to Pt. Same as Ps = 50.
1093	Ps = 711 Set bold fontset to Pt. Similar to Ps = 50.	1366	Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
1094	Ps = 712 Set italic fontset to Pt. Similar to Ps = 50.	1367	Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1095	Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50.	1368	Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
		1369	Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
		1370	Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
		1371	Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
1096		1372
1097		1373
1098		1374
1099	menuBar	1375	menuBar
1100	The exact syntax used is almost solidified. In the menus, DON'T try to	1376	The exact syntax used is almost solidified. In the menus, DON'T try to
…		…
1137	[menu]	1413	[menu]
1138	access the current menuBar for alteration	1414	access the current menuBar for alteration
1139		1415
1140	[title:+string]	1416	[title:+string]
1141	set the current menuBar's title to string, which may contain the	1417	set the current menuBar's title to string, which may contain the
1142	following format specifiers: %% : literal % character %n : rxvt name	1418	following format specifiers:
1143	(as per the -name command-line option) %v : rxvt version	1419
		1420	B<%n> rxvt name (as per the B<-name> command-line option)
		1421	B<%v> rxvt version
		1422	B<%%> literal B<%> character
1144		1423
1145	[done]	1424	[done]
1146	set menuBar access as readonly. End-of-file tag for [read:+file]	1425	set menuBar access as readonly. End-of-file tag for [read:+file]
1147	operations.	1426	operations.
1148		1427
…		…
1252		1531
1253	As a convenience for the many Emacs-type editors, action may start	1532	As a convenience for the many Emacs-type editors, action may start
1254	with M- (eg, M-$ is equivalent to \E$) and a CR will be appended if	1533	with M- (eg, M-$ is equivalent to \E$) and a CR will be appended if
1255	missed from M-x commands.	1534	missed from M-x commands.
1256		1535
1257	As a convenience for issuing XTerm ESC] sequences from a menubar (or	1536	As a convenience for issuing XTerm ESC ] sequences from a menubar (or
1258	quick arrow), a BEL (^G) will be appended if needed.	1537	quick arrow), a BEL (^G) will be appended if needed.
1259		1538
1260	For example,	1539	For example,
1261	M-xapropos is equivalent to \Exapropos\r	1540	M-xapropos is equivalent to \Exapropos\r
1262		1541
…		…
1562	XK_KP_8 8 ESC O x	1841	XK_KP_8 8 ESC O x
1563	XK_KP_9 9 ESC O y	1842	XK_KP_9 9 ESC O y
1564		1843
1565	CONFIGURE OPTIONS	1844	CONFIGURE OPTIONS
1566	General hint: if you get compile errors, then likely your configuration	1845	General hint: if you get compile errors, then likely your configuration
1567	hasn't been tested well. Either try with --enable-everything or use the	1846	hasn't been tested well. Either try with "--enable-everything" or use
1568	./reconf script as a base for experiments. ./reconf is used by myself,	1847	the ./reconf script as a base for experiments. ./reconf is used by
1569	so it should generally be a working config. Of course, you should always	1848	myself, so it should generally be a working config. Of course, you
1570	report when a combination doesn't work, so it can be fixed. Marc Lehmann	1849	should always report when a combination doesn't work, so it can be
1571	<rxvt@schmorp.de>.	1850	fixed. Marc Lehmann <rxvt@schmorp.de>.
		1851
		1852	All
1572		1853
1573	--enable-everything	1854	--enable-everything
1574	Add support for all non-multichoice options listed in "./configure	1855	Add (or remove) support for all non-multichoice options listed in
1575	--help". Note that unlike other enable options this is order	1856	"./configure --help".
1576	dependant. You can specify this and then disable options which this
1577	enables by following this with the appropriate commands.
1578		1857
1579	--enable-xft	1858	You can specify this and then disable options you do not like by
		1859	following this with the appropriate "--disable-..." arguments, or
		1860	you can start with a minimal configuration by specifying
		1861	"--disable-everything" and than adding just the "--enable-..."
		1862	arguments you want.
		1863
		1864	--enable-xft (default: enabled)
1580	Add support for Xft (anti-aliases, among others) fonts. Xft fonts	1865	Add support for Xft (anti-aliases, among others) fonts. Xft fonts
1581	are slower and require lots of memory, but as long as you don't use	1866	are slower and require lots of memory, but as long as you don't use
1582	them, you don't pay for them.	1867	them, you don't pay for them.
1583		1868
1584	--enable-font-styles	1869	--enable-font-styles (default: on)
1585	Add support for bold, italic and bold italic font styles. The	1870	Add support for bold, italic and bold italic font styles. The
1586	fonts can be set manually or automatically.	1871	fonts can be set manually or automatically.
1587		1872
1588	--with-codesets=NAME,...	1873	--with-codesets=NAME,... (default: all)
1589	Compile in support for additional codeset (encoding) groups (eu, vn	1874	Compile in support for additional codeset (encoding) groups ("eu",
1590	are always compiled in, which includes most 8-bit character sets).	1875	"vn" are always compiled in, which includes most 8-bit character
1591	These codeset tables are currently only used for driving X11 core	1876	sets). These codeset tables are used for driving X11 core fonts,
1592	fonts, they are not required for Xft fonts. Compiling them in will	1877	they are not required for Xft fonts, although having them compiled
1593	make your binary bigger (together about 700kB), but it doesn't	1878	in lets rxvt-unicode choose replacement fonts more intelligently.
1594	increase memory usage unless you use an X11 font requiring one of	1879	Compiling them in will make your binary bigger (all of together cost
1595	these encodings.	1880	about 700kB), but it doesn't increase memory usage unless you use a
		1881	font requiring one of these encodings.
1596		1882
1597	all all available codeset groups	1883	all all available codeset groups
1598	zh common chinese encodings	1884	zh common chinese encodings
1599	zh_ext rarely used but very big chinese encodigs	1885	zh_ext rarely used but very big chinese encodigs
1600	jp common japanese encodings	1886	jp common japanese encodings
1601	jp_ext rarely used but big japanese encodings	1887	jp_ext rarely used but big japanese encodings
1602	kr korean encodings	1888	kr korean encodings
1603		1889
1604	--enable-xim	1890	--enable-xim (default: on)
1605	Add support for XIM (X Input Method) protocol. This allows using	1891	Add support for XIM (X Input Method) protocol. This allows using
1606	alternative input methods (e.g. kinput2) and will also correctly set	1892	alternative input methods (e.g. kinput2) and will also correctly set
1607	up the input for people using dead keys or compose keys.	1893	up the input for people using dead keys or compose keys.
1608		1894
1609	--enable-unicode3	1895	--enable-unicode3 (default: off)
1610	Enable direct support for displaying unicode codepoints above 65535	1896	Enable direct support for displaying unicode codepoints above 65535
1611	(the basic multilingual page). This increases storage requirements	1897	(the basic multilingual page). This increases storage requirements
1612	per character from 2 to 4 bytes. X11 fonts do not yet support these	1898	per character from 2 to 4 bytes. X11 fonts do not yet support these
1613	extra characters, but Xft does.	1899	extra characters, but Xft does.
1614		1900
…		…
1616	even without this flag, but the number of such characters is limited	1902	even without this flag, but the number of such characters is limited
1617	to a view thousand (shared with combining characters, see next	1903	to a view thousand (shared with combining characters, see next
1618	switch), and right now rxvt-unicode cannot display them	1904	switch), and right now rxvt-unicode cannot display them
1619	(input/output and cut&paste still work, though).	1905	(input/output and cut&paste still work, though).
1620		1906
1621	--enable-combining	1907	--enable-combining (default: on)
1622	Enable automatic composition of combining characters into composite	1908	Enable automatic composition of combining characters into composite
1623	characters. This is required for proper viewing of text where	1909	characters. This is required for proper viewing of text where
1624	accents are encoded as seperate unicode characters. This is done by	1910	accents are encoded as seperate unicode characters. This is done by
1625	using precomposited characters when available or creating new	1911	using precomposited characters when available or creating new
1626	pseudo-characters when no precomposed form exists.	1912	pseudo-characters when no precomposed form exists.
1627		1913
1628	Without --enable-unicode3, the number of additional precomposed	1914	Without --enable-unicode3, the number of additional precomposed
1629	characters is rather limited (2048, if this is full, rxvt will use	1915	characters is rather limited (2048, if this is full, rxvt-unicode
1630	the private use area, extending the number of combinations to 8448).	1916	will use the private use area, extending the number of combinations
1631	With --enable-unicode3, no practical limit exists. This will also	1917	to 8448). With --enable-unicode3, no practical limit exists.
1632	enable storage of characters >65535.	1918
		1919	This option will also enable storage (but not display) of characters
		1920	beyond plane 0 (>65535) when --enable-unicode3 was not specified.
1633		1921
1634	The combining table also contains entries for arabic presentation	1922	The combining table also contains entries for arabic presentation
1635	forms, but these are not currently used. Bug me if you want these to	1923	forms, but these are not currently used. Bug me if you want these to
1636	be used.	1924	be used (and tell me how these are to be used...).
1637		1925
1638	--enable-fallback(=CLASS)	1926	--enable-fallback(=CLASS) (default: Rxvt)
1639	When reading resource settings, also read settings for class CLASS	1927	When reading resource settings, also read settings for class CLASS.
1640	(default: Rxvt). To disable resource fallback use	1928	To disable resource fallback use --disable-fallback.
1641	--disable-fallback.
1642		1929
1643	--with-res-name=NAME	1930	--with-res-name=NAME (default: urxvt)
1644	Use the given name (default: urxvt) as default application name when	1931	Use the given name as default application name when reading
1645	reading resources. Specify --with-res-name=rxvt to replace rxvt.	1932	resources. Specify --with-res-name=rxvt to replace rxvt.
1646		1933
1647	--with-res-class=CLASS	1934	--with-res-class=CLASS /default: URxvt)
1648	Use the given class (default: URxvt) as default application class	1935	Use the given class as default application class when reading
1649	when reading resources. Specify --with-res-class=Rxvt to replace	1936	resources. Specify --with-res-class=Rxvt to replace rxvt.
1650	rxvt.
1651		1937
1652	--enable-utmp	1938	--enable-utmp (default: on)
1653	Write user and tty to utmp file (used by programs like w) at start	1939	Write user and tty to utmp file (used by programs like w) at start
1654	of rxvt execution and delete information when rxvt exits.	1940	of rxvt execution and delete information when rxvt exits.
1655		1941
1656	--enable-wtmp	1942	--enable-wtmp (default: on)
1657	Write user and tty to wtmp file (used by programs like last) at	1943	Write user and tty to wtmp file (used by programs like last) at
1658	start of rxvt execution and write logout when rxvt exits. This	1944	start of rxvt execution and write logout when rxvt exits. This
1659	option requires --enable-utmp to also be specified.	1945	option requires --enable-utmp to also be specified.
1660		1946
1661	--enable-lastlog	1947	--enable-lastlog (default: on)
1662	Write user and tty to lastlog file (used by programs like lastlogin)	1948	Write user and tty to lastlog file (used by programs like lastlogin)
1663	at start of rxvt execution. This option requires --enable-utmp to	1949	at start of rxvt execution. This option requires --enable-utmp to
1664	also be specified.	1950	also be specified.
1665		1951
1666	--enable-xpm-background	1952	--enable-xpm-background (default: on)
1667	Add support for XPM background pixmaps.	1953	Add support for XPM background pixmaps.
1668		1954
1669	--enable-transparency	1955	--enable-transparency (default: on)
1670	Add support for inheriting parent backgrounds thus giving a fake	1956	Add support for inheriting parent backgrounds thus giving a fake
1671	transparency to the term.	1957	transparency to the term.
1672		1958
1673	--enable-fading	1959	--enable-fading (default: on)
1674	Add support for fading the text when focus is lost.	1960	Add support for fading the text when focus is lost (requires
		1961	"--enable-transparency").
1675		1962
1676	--enable-tinting	1963	--enable-tinting (default: on)
1677	Add support for tinting of transparent backgrounds.	1964	Add support for tinting of transparent backgrounds (requires
		1965	"--enable-transparency").
1678		1966
1679	--enable-menubar	1967	--enable-menubar (default: off) [DEPRECATED]
1680	Add support for our menu bar system (this interacts badly with	1968	Add support for our menu bar system (this interacts badly with
1681	dynamic locale switching currently).	1969	dynamic locale switching currently). This option is DEPRECATED and
		1970	will be removed in the future.
1682		1971
1683	--enable-rxvt-scroll	1972	--enable-rxvt-scroll (default: on)
1684	Add support for the original rxvt scrollbar.	1973	Add support for the original rxvt scrollbar.
1685		1974
1686	--enable-next-scroll	1975	--enable-next-scroll (default: on)
1687	Add support for a NeXT-like scrollbar.	1976	Add support for a NeXT-like scrollbar.
1688		1977
1689	--enable-xterm-scroll	1978	--enable-xterm-scroll (default: on)
1690	Add support for an Xterm-like scrollbar.	1979	Add support for an Xterm-like scrollbar.
1691		1980
1692	--enable-plain-scroll	1981	--enable-plain-scroll (default: on)
1693	Add support for a very unobtrusive, plain-looking scrollbar that is	1982	Add support for a very unobtrusive, plain-looking scrollbar that is
1694	the favourite of the rxvt-unicode author, having used it for many	1983	the favourite of the rxvt-unicode author, having used it for many
1695	years.	1984	years.
1696		1985
1697	--enable-half-shadow	1986	--enable-half-shadow (default: off)
1698	Make shadows on the scrollbar only half the normal width & height.	1987	Make shadows on the scrollbar only half the normal width & height.
1699	only applicable to rxvt scrollbars.	1988	only applicable to rxvt scrollbars.
1700		1989
1701	--enable-ttygid	1990	--enable-ttygid (default: off)
1702	Change tty device setting to group "tty" - only use this if your	1991	Change tty device setting to group "tty" - only use this if your
1703	system uses this type of security.	1992	system uses this type of security.
1704		1993
1705	--disable-backspace-key	1994	--disable-backspace-key
1706	Disable any handling of the backspace key by us - let the X server	1995	Removes any handling of the backspace key by us - let the X server
1707	do it.	1996	do it.
1708		1997
1709	--disable-delete-key	1998	--disable-delete-key
1710	Disable any handling of the delete key by us - let the X server do	1999	Removes any handling of the delete key by us - let the X server do
1711	it.	2000	it.
1712		2001
1713	--disable-resources	2002	--disable-resources
1714	Remove all resources checking.	2003	Removes any support for resource checking.
1715		2004
1716	--enable-xgetdefault	2005	--enable-strings (default: off)
1717	Make resources checking via XGetDefault() instead of our small
1718	version which only checks ~/.Xdefaults, or if that doesn't exist
1719	then ~/.Xresources.
1720
1721	--enable-strings
1722	Add support for our possibly faster memset() function and other	2006	Add support for our possibly faster memset() function and other
1723	various routines, overriding your system's versions which may have	2007	various routines, overriding your system's versions which may have
1724	been hand-crafted in assembly or may require extra libraries to link	2008	been hand-crafted in assembly or may require extra libraries to link
1725	in. (this breaks ANSI-C rules and has problems on many GNU/Linux	2009	in. (this breaks ANSI-C rules and has problems on many GNU/Linux
1726	systems).	2010	systems).
1727		2011
1728	--disable-swapscreen	2012	--disable-swapscreen
1729	Remove support for swap screen.	2013	Remove support for secondary/swap screen.
1730		2014
1731	--enable-frills	2015	--enable-frills (default: on)
1732	Add support for many small features that are not essential but nice	2016	Add support for many small features that are not essential but nice
1733	to have. Normally you want this, but for very small binaries you may	2017	to have. Normally you want this, but for very small binaries you may
1734	want to disable this.	2018	want to disable this.
1735		2019
1736	A non-exhaustive list of features enabled by "--enable-frills"	2020	A non-exhaustive list of features enabled by "--enable-frills"
1737	(possibly in combination with other switches) is:	2021	(possibly in combination with other switches) is:
1738		2022
1739	MWM-hints	2023	MWM-hints
		2024	EWMH-hints (pid, utf8 names) and protocols (ping)
1740	seperate underline colour	2025	seperate underline colour (-underlineColor)
1741	settable border widths and borderless switch	2026	settable border widths and borderless switch (-w, -b, -bl)
1742	settable extra linespacing	2027	settable extra linespacing /-lsp)
1743	extra window properties (e.g. UTF-8 window names and PID)
1744	iso-14755-2 and -3, and visual feedback	2028	iso-14755-2 and -3, and visual feedback
1745	backindex and forwardindex escape sequence	2029	backindex and forwardindex escape sequence
1746	window op and locale change escape sequences	2030	window op and some xterm/OSC escape sequences
1747	tripleclickwords	2031	tripleclickwords (-tcw)
1748	settable insecure mode	2032	settable insecure mode (-insecure)
		2033	keysym remapping support
		2034	cursor blinking and underline cursor (-cb, -uc)
		2035	XEmbed support (-embed)
		2036	user-pty (-pty-fd)
		2037	hold on exit (-hold)
		2038	skip builtin block graphics (-sbg)
		2039	sgr modes 90..97 and 100..107
1749		2040
1750	--enable-iso14755	2041	--enable-iso14755 (default: on)
1751	Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt).	2042	Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt).
1752	Basic support (section 5.1) is enabled by "--enable-frills", while	2043	Basic support (section 5.1) is enabled by "--enable-frills", while
1753	support for 5.2, 5.3 and 5.4 is enabled with this switch.	2044	support for 5.2, 5.3 and 5.4 is enabled with this switch.
1754		2045
1755	--enable-keepscrolling	2046	--enable-keepscrolling (default: on)
1756	Add support for continual scrolling of the display when you hold the	2047	Add support for continual scrolling of the display when you hold the
1757	mouse button down on a scrollbar arrow.	2048	mouse button down on a scrollbar arrow.
1758		2049
1759	--enable-mousewheel	2050	--enable-mousewheel (default: on)
1760	Add support for scrolling via mouse wheel or buttons 4 & 5.	2051	Add support for scrolling via mouse wheel or buttons 4 & 5.
1761		2052
1762	--enable-slipwheeling	2053	--enable-slipwheeling (default: on)
1763	Add support for continual scrolling (using the mouse wheel as an	2054	Add support for continual scrolling (using the mouse wheel as an
1764	accelerator) while the control key is held down. This option	2055	accelerator) while the control key is held down. This option
1765	requires --enable-mousewheel to also be specified.	2056	requires --enable-mousewheel to also be specified.
1766		2057
1767	--disable-new-selection	2058	--disable-new-selection
1768	Remove support for mouse selection style like that of xterm.	2059	Remove support for mouse selection style like that of xterm.
1769		2060
1770	--enable-dmalloc	2061	--enable-dmalloc (default: off)
1771	Use Gray Watson's malloc - which is good for debugging See	2062	Use Gray Watson's malloc - which is good for debugging See
1772	http://www.letters.com/dmalloc/ for details If you use either this	2063	http://www.letters.com/dmalloc/ for details If you use either this
1773	or the next option, you may need to edit src/Makefile after	2064	or the next option, you may need to edit src/Makefile after
1774	compiling to point DINCLUDE and DLIB to the right places.	2065	compiling to point DINCLUDE and DLIB to the right places.
1775		2066
1776	You can only use either this option and the following (should you	2067	You can only use either this option and the following (should you
1777	use either) .	2068	use either) .
1778		2069
1779	--enable-dlmalloc	2070	--enable-dlmalloc (default: off)
1780	Use Doug Lea's malloc - which is good for a production version See	2071	Use Doug Lea's malloc - which is good for a production version See
1781	<http://g.oswego.edu/dl/html/malloc.html> for details.	2072	<http://g.oswego.edu/dl/html/malloc.html> for details.
1782		2073
1783	--enable-smart-resize	2074	--enable-smart-resize (default: on)
1784	Add smart growth/shrink behaviour when changing font size via from	2075	Add smart growth/shrink behaviour when changing font size via hot
1785	hot keys. This should keep in a fixed position the rxvt corner which	2076	keys. This should keep the window corner which is closest to a
1786	is closest to a corner of the screen.	2077	corner of the screen in a fixed position.
1787		2078
1788	--enable-cursor-blink
1789	Add support for a blinking cursor.
1790
1791	--enable-pointer-blank	2079	--enable-pointer-blank (default: on)
1792	Add support to have the pointer disappear when typing or inactive.	2080	Add support to have the pointer disappear when typing or inactive.
1793		2081
1794	--with-name=NAME	2082	--enable-perl (default: off)
		2083	Enable an embedded perl interpreter. See the rxvtperl(3) manpage
		2084	(doc/rxvtperl.txt) for more info on this feature, or the files in
		2085	src/perl-ext/ for the extensions that are installed by default. The
		2086	perl interpreter that is used can be specified via the "PERL"
		2087	environment variable when running configure.
		2088
		2089	--with-name=NAME (default: urxvt)
1795	Set the basename for the installed binaries (default: "urxvt",	2090	Set the basename for the installed binaries, resulting in "urxvt",
1796	resulting in "urxvt", "urxvtd" etc.). Specify "--with-name=rxvt" to	2091	"urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt".
1797	replace with "rxvt".
1798		2092
1799	--with-term=NAME	2093	--with-term=NAME (default: rxvt-unicode)
1800	Change the environmental variable for the terminal to NAME (default	2094	Change the environmental variable for the terminal to NAME.
1801	"rxvt-unicode")
1802		2095
1803	--with-terminfo=PATH	2096	--with-terminfo=PATH
1804	Change the environmental variable for the path to the terminfo tree	2097	Change the environmental variable for the path to the terminfo tree
1805	to PATH.	2098	to PATH.
1806		2099

Diff Legend

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents): Revision 1.4 by root, Thu Feb 3 10:24:10 2005 UTC vs. Revision 1.41 by root, Thu Jan 12 23:11:23 2006 UTC

Diff Legend

Comparing rxvt-unicode/doc/rxvt.7.txt (file contents):
Revision 1.4 by root, Thu Feb 3 10:24:10 2005 UTC vs.
Revision 1.41 by root, Thu Jan 12 23:11:23 2006 UTC