ViewVC Help

View File | Revision Log | Show Annotations | Download File

/cvs/rxvt-unicode/doc/rxvt.7.man.in

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.61 by root, Tue Jan 31 01:02:19 2006 UTC vs.
Revision 1.69 by root, Tue Jan 31 21:10:44 2006 UTC

…		…
153	This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting	153	This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting
154	all escape sequences, and other background information.	154	all escape sequences, and other background information.
155	.PP	155	.PP
156	The newest version of this document is also available on the World Wide Web at	156	The newest version of this document is also available on the World Wide Web at
157	<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>.	157	<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>.
158	.SH "FREQUENTLY ASKED QUESTIONS"	158	.SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS"
159	.IX Header "FREQUENTLY ASKED QUESTIONS"	159	.IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS"
160	.Sh "The new selection selects pieces that are too big, how can I select single words?"	160	.Sh "Meta, Features & Commandline Issues"
161	.IX Subsection "The new selection selects pieces that are too big, how can I select single words?"	161	.IX Subsection "Meta, Features & Commandline Issues"
162	If you want to select e.g. alphanumeric words, you can use the following	162	\fIMy question isn't answered here, can I ask a human?\fR
163	setting:	163	.IX Subsection "My question isn't answered here, can I ask a human?"
		164	.PP
		165	Before sending me mail, you could go to \s-1IRC:\s0 \f(CW\*(C`irc.freenode.net\*(C'\fR,
		166	channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be
		167	interested in learning about new and exciting problems (but not FAQs :).
		168	.PP
		169	\fIDoes it support tabs, can I have a tabbed rxvt\-unicode?\fR
		170	.IX Subsection "Does it support tabs, can I have a tabbed rxvt-unicode?"
		171	.PP
		172	Beginning with version 7.3, there is a perl extension that implements a
		173	simple tabbed terminal. It is installed by default, so any of these should
		174	give you tabs:
164	.PP	175	.PP
165	.Vb 1	176	.Vb 1
166	\& URxvt.selection.pattern-0: ([[:word:]]+)	177	\& @@URXVT_NAME@@ -pe tabbed
167	.Ve	178	.Ve
168	.PP
169	If you click more than twice, the selection will be extended
170	more and more.
171	.PP
172	To get a selection that is very similar to the old code, try this pattern:
173	.PP	179	.PP
174	.Vb 1	180	.Vb 1
175	\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+)	181	\& URxvt.perl-ext-common: default,tabbed
176	.Ve	182	.Ve
177	.PP	183	.PP
178	Please also note that the \fILeftClick Shift-LeftClik\fR combination also	184	It will also work fine with tabbing functionality of many window managers
179	selects words like the old code.	185	or similar tabbing programs, and its embedding-features allow it to be
180	.Sh "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?"	186	embedded into other programs, as witnessed by \fIdoc/rxvt\-tabbed\fR or
181	.IX Subsection "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?"	187	the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl module, which features a tabbed urxvt
182	You can disable the perl extension completely by setting the	188	(murxvt) terminal as an example embedding application.
183	\&\fBperl-ext-common\fR resource to the empty string, which also keeps
184	rxvt-unicode from initialising perl, saving memory.
185	.PP	189	.PP
186	If you only want to disable specific features, you first have to	190	\fIHow do I know which rxvt-unicode version I'm using?\fR
187	identify which perl extension is responsible. For this, read the section	191	.IX Subsection "How do I know which rxvt-unicode version I'm using?"
188	\&\fB\s-1PREPACKAGED\s0 \s-1EXTENSIONS\s0\fR in the @@RXVT_NAME@@\fIperl\fR\|(3) manpage. For
189	example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify
190	this \fBperl-ext-common\fR resource:
191	.PP	192	.PP
		193	The version number is displayed with the usage (\-h). Also the escape
		194	sequence \f(CW\*(C`ESC [ 8 n\*(C'\fR sets the window title to the version number. When
		195	using the @@URXVT_NAME@@c client, the version displayed is that of the
		196	daemon.
		197	.PP
		198	\fIRxvt-unicode uses gobs of memory, how can I reduce that?\fR
		199	.IX Subsection "Rxvt-unicode uses gobs of memory, how can I reduce that?"
		200	.PP
		201	Rxvt-unicode tries to obey the rule of not charging you for something you
		202	don't use. One thing you should try is to configure out all settings that
		203	you don't need, for example, Xft support is a resource hog by design,
		204	when used. Compiling it out ensures that no Xft font will be loaded
		205	accidentally when rxvt-unicode tries to find a font for your characters.
		206	.PP
		207	Also, many people (me included) like large windows and even larger
		208	scrollback buffers: Without \f(CW\*(C`\-\-enable\-unicode3\*(C'\fR, rxvt-unicode will use
		209	6 bytes per screen cell. For a 160x?? window this amounts to almost a
		210	kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
		211	use 10 Megabytes of memory. With \f(CW\*(C`\-\-enable\-unicode3\*(C'\fR it gets worse, as
		212	rxvt-unicode then uses 8 bytes per screen cell.
		213	.PP
		214	\fIHow can I start @@URXVT_NAME@@d in a race-free way?\fR
		215	.IX Subsection "How can I start @@URXVT_NAME@@d in a race-free way?"
		216	.PP
		217	Try \f(CW\*(C`@@URXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@URXVT_NAME@@d to open the
		218	display, create the listening socket and then fork.
		219	.PP
		220	\fIHow do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR
		221	.IX Subsection "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc."
		222	.PP
		223	The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R",
		224	so you can check and see if that is set. Note that several programs, \s-1JED\s0,
		225	slrn, Midnight Commander automatically check this variable to decide
		226	whether or not to use color.
		227	.PP
		228	\fIHow do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?\fR
		229	.IX Subsection "How do I set the correct, full IP address for the DISPLAY variable?"
		230	.PP
		231	If you've compiled rxvt-unicode with \s-1DISPLAY_IS_IP\s0 and have enabled
		232	insecure mode then it is possible to use the following shell script
		233	snippets to correctly set the display. If your version of rxvt-unicode
		234	wasn't also compiled with \s-1ESCZ_ANSWER\s0 (as assumed in these snippets) then
		235	the \s-1COLORTERM\s0 variable can be used to distinguish rxvt-unicode from a
		236	regular xterm.
		237	.PP
		238	Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script
		239	snippets:
		240	.PP
192	.Vb 1	241	.Vb 12
193	\& URxvt.perl-ext-common: default,-selection-popup,-option-popup	242	\& # Bourne/Korn/POSIX family of shells:
		243	\& [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
		244	\& if [ ${TERM:-foo} = xterm ]; then
		245	\& stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
		246	\& echo -n '^[Z'
		247	\& read term_id
		248	\& stty icanon echo
		249	\& if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
		250	\& echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
		251	\& read DISPLAY # set it in our local shell
		252	\& fi
		253	\& fi
194	.Ve	254	.Ve
195	.PP	255	.PP
196	This will keep the default extensions, but disable the two popup	256	\fIHow do I compile the manual pages on my own?\fR
197	extensions. Some extensions can also be configured, for example,	257	.IX Subsection "How do I compile the manual pages on my own?"
198	scrollback search mode is triggered by \fBM\-s\fR. You can move it to any
199	other combination either by setting the \fBsearchable-scrollback\fR resource:
200	.PP	258	.PP
201	.Vb 1	259	You need to have a recent version of perl installed as \fI/usr/bin/perl\fR,
202	\& URxvt.searchable-scrollback: CM-s	260	one that comes with \fIpod2man\fR, \fIpod2text\fR and \fIpod2html\fR. Then go to
203	.Ve	261	the doc subdirectory and enter \f(CW\*(C`make alldoc\*(C'\fR.
204	.Sh "The cursor moves when selecting text in the current input line, how do I switch this off?"
205	.IX Subsection "The cursor moves when selecting text in the current input line, how do I switch this off?"
206	See next entry.
207	.Sh "During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?"
208	.IX Subsection "During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?"
209	These are caused by the \f(CW\*(C`readline\*(C'\fR perl extension. Under normal
210	circumstances, it will move your cursor around when you click into the
211	line that contains it. It tries hard not to do this at the wrong moment,
212	but when running a program that doesn't parse cursor movements or in some
213	cases during rlogin sessions, it fails to detect this properly.
214	.PP	262	.PP
215	You can permamently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR
216	extension:
217	.PP
218	.Vb 1
219	\& URxvt.perl-ext-common: default,-readline
220	.Ve
221	.Sh "Why doesn't rxvt-unicode read my resources?"
222	.IX Subsection "Why doesn't rxvt-unicode read my resources?"
223	Well, why, indeed? It does, in a way very similar to other X
224	applications. Most importantly, this means that if you or your \s-1OS\s0 loads
225	resources into the X display (the right way to do it), rxvt-unicode will
226	ignore any resource files in your home directory. It will only read
227	\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display.
228	.PP
229	If you have or use an \fI$HOME/.Xresources\fR file, chances are that
230	resources are loaded into your X\-server. In this case, you have to
231	re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR).
232	.PP
233	Also consider the form resources have to use:
234	.PP
235	.Vb 1
236	\& URxvt.resource: value
237	.Ve
238	.PP
239	If you want to use another form (there are lots of different ways of
240	specifying resources), make sure you understand wether and why it
241	works. If unsure, use the form above.
242	.Sh "I can't get transparency working, what am I doing wrong?"
243	.IX Subsection "I can't get transparency working, what am I doing wrong?"
244	First of all, transparency isn't officially supported in rxvt\-unicode, so
245	you are mostly on your own. Do not bug the author about it (but you may
246	bug everybody else). Also, if you can't get it working consider it a rite
247	of passage: ... and you failed.
248	.PP
249	Here are four ways to get transparency. \fBDo\fR read the manpage and option
250	descriptions for the programs mentioned and rxvt\-unicode. Really, do it!
251	.PP
252	1. Use inheritPixmap:
253	.PP
254	.Vb 2
255	\& Esetroot wallpaper.jpg
256	\& @@RXVT_NAME@@ -ip -tint red -sh 40
257	.Ve
258	.PP
259	That works. If you think it doesn't, you lack transparency and tinting
260	support, or you are unable to read.
261	.PP
262	2. Use a simple pixmap and emulate pseudo\-transparency. This enables you
263	to use effects other than tinting and shading: Just shade/tint/whatever
264	your picture with gimp:
265	.PP
266	.Vb 2
267	\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
268	\& @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
269	.Ve
270	.PP
271	That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you
272	are unable to read.
273	.PP
274	3. Use an \s-1ARGB\s0 visual:
275	.PP
276	.Vb 1
277	\& @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
278	.Ve
279	.PP
280	This requires \s-1XFT\s0 support, and the support of your X\-server. If that
281	doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't
282	there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
283	bugfixes and workarounds for Xft and Xlib to make it work, but that
284	doesn't mean that your \s-1WM\s0 has the required kludges in place.
285	.PP
286	4. Use xcompmgr and let it do the job:
287	.PP
288	.Vb 2
289	\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e
290	\& -set _NET_WM_WINDOW_OPACITY 0xc0000000
291	.Ve
292	.PP
293	Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR
294	by other values to change the degree of opacity. If it doesn't work and
295	your server crashes, you got to keep the pieces.
296	.Sh "Isn't rxvt supposed to be small? Don't all those features bloat?"	263	\fIIsn't rxvt-unicode supposed to be small? Don't all those features bloat?\fR
297	.IX Subsection "Isn't rxvt supposed to be small? Don't all those features bloat?"	264	.IX Subsection "Isn't rxvt-unicode supposed to be small? Don't all those features bloat?"
		265	.PP
298	I often get asked about this, and I think, no, they didn't cause extra	266	I often get asked about this, and I think, no, they didn't cause extra
299	bloat. If you compare a minimal rxvt and a minimal urxvt, you can see	267	bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
300	that the urxvt binary is larger (due to some encoding tables always being	268	that the urxvt binary is larger (due to some encoding tables always being
301	compiled in), but it actually uses less memory (\s-1RSS\s0) after startup. Even	269	compiled in), but it actually uses less memory (\s-1RSS\s0) after startup. Even
302	with \f(CW\*(C`\-\-disable\-everything\*(C'\fR, this comparison is a bit unfair, as many	270	with \f(CW\*(C`\-\-disable\-everything\*(C'\fR, this comparison is a bit unfair, as many
…		…
307	\& text data bss drs rss filename	275	\& text data bss drs rss filename
308	\& 98398 1664 24 15695 1824 rxvt --disable-everything	276	\& 98398 1664 24 15695 1824 rxvt --disable-everything
309	\& 188985 9048 66616 18222 1788 urxvt --disable-everything	277	\& 188985 9048 66616 18222 1788 urxvt --disable-everything
310	.Ve	278	.Ve
311	.PP	279	.PP
312	When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which _is_ unfair, as this involves xft	280	When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft
313	and full locale/XIM support which are quite bloaty inside libX11 and my	281	and full locale/XIM support which are quite bloaty inside libX11 and my
314	libc), the two diverge, but not unreasnobaly so.	282	libc), the two diverge, but not unreasnobaly so.
315	.PP	283	.PP
316	.Vb 3	284	.Vb 3
317	\& text data bss drs rss filename	285	\& text data bss drs rss filename
…		…
336	still fares rather well. And compared to some monsters like gnome-terminal	304	still fares rather well. And compared to some monsters like gnome-terminal
337	(21152k + extra 4204k in separate processes) or konsole (22200k + extra	305	(21152k + extra 4204k in separate processes) or konsole (22200k + extra
338	43180k in daemons that stay around after exit, plus half a minute of	306	43180k in daemons that stay around after exit, plus half a minute of
339	startup time, including the hundreds of warnings it spits out), it fares	307	startup time, including the hundreds of warnings it spits out), it fares
340	extremely well *g*.	308	extremely well *g*.
		309	.PP
341	.Sh "Why \*(C+, isn't that unportable/bloated/uncool?"	310	\fIWhy \*(C+, isn't that unportable/bloated/uncool?\fR
342	.IX Subsection "Why , isn't that unportable/bloated/uncool?"	311	.IX Subsection "Why , isn't that unportable/bloated/uncool?"
		312	.PP
343	Is this a question? :) It comes up very often. The simple answer is: I had	313	Is this a question? :) It comes up very often. The simple answer is: I had
344	to write it, and \*(C+ allowed me to write and maintain it in a fraction	314	to write it, and \*(C+ allowed me to write and maintain it in a fraction
345	of the time and effort (which is a scarce resource for me). Put even	315	of the time and effort (which is a scarce resource for me). Put even
346	shorter: It simply wouldn't exist without \*(C+.	316	shorter: It simply wouldn't exist without \*(C+.
347	.PP	317	.PP
…		…
373	\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)	343	\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
374	.Ve	344	.Ve
375	.PP	345	.PP
376	No large bloated libraries (of course, none were linked in statically),	346	No large bloated libraries (of course, none were linked in statically),
377	except maybe libX11 :)	347	except maybe libX11 :)
378	.Sh "Does it support tabs, can I have a tabbed rxvt\-unicode?"	348	.Sh "Rendering, Font & Look and Feel Issues"
379	.IX Subsection "Does it support tabs, can I have a tabbed rxvt-unicode?"	349	.IX Subsection "Rendering, Font & Look and Feel Issues"
380	Beginning with version 7.3, there is a perl extension that implements a	350	\fII can't get transparency working, what am I doing wrong?\fR
381	simple tabbed terminal. It is installed by default, so any of these should	351	.IX Subsection "I can't get transparency working, what am I doing wrong?"
382	give you tabs:	352	.PP
		353	First of all, transparency isn't officially supported in rxvt\-unicode, so
		354	you are mostly on your own. Do not bug the author about it (but you may
		355	bug everybody else). Also, if you can't get it working consider it a rite
		356	of passage: ... and you failed.
		357	.PP
		358	Here are four ways to get transparency. \fBDo\fR read the manpage and option
		359	descriptions for the programs mentioned and rxvt\-unicode. Really, do it!
		360	.PP
		361	1. Use inheritPixmap:
		362	.PP
		363	.Vb 2
		364	\& Esetroot wallpaper.jpg
		365	\& @@URXVT_NAME@@ -ip -tint red -sh 40
		366	.Ve
		367	.PP
		368	That works. If you think it doesn't, you lack transparency and tinting
		369	support, or you are unable to read.
		370	.PP
		371	2. Use a simple pixmap and emulate pseudo\-transparency. This enables you
		372	to use effects other than tinting and shading: Just shade/tint/whatever
		373	your picture with gimp or any other tool:
		374	.PP
		375	.Vb 2
		376	\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
		377	\& @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background
		378	.Ve
		379	.PP
		380	That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you
		381	are unable to read.
		382	.PP
		383	3. Use an \s-1ARGB\s0 visual:
383	.PP	384	.PP
384	.Vb 1	385	.Vb 1
385	\& @@RXVT_NAME@@ -pe tabbed	386	\& @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
386	.Ve	387	.Ve
		388	.PP
		389	This requires \s-1XFT\s0 support, and the support of your X\-server. If that
		390	doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't
		391	there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
		392	bugfixes and workarounds for Xft and Xlib to make it work, but that
		393	doesn't mean that your \s-1WM\s0 has the required kludges in place.
		394	.PP
		395	4. Use xcompmgr and let it do the job:
		396	.PP
		397	.Vb 2
		398	\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e
		399	\& -set _NET_WM_WINDOW_OPACITY 0xc0000000
		400	.Ve
		401	.PP
		402	Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR
		403	by other values to change the degree of opacity. If it doesn't work and
		404	your server crashes, you got to keep the pieces.
		405	.PP
		406	\fIWhy does rxvt-unicode sometimes leave pixel droppings?\fR
		407	.IX Subsection "Why does rxvt-unicode sometimes leave pixel droppings?"
		408	.PP
		409	Most fonts were not designed for terminal use, which means that character
		410	size varies a lot. A font that is otherwise fine for terminal use might
		411	contain some characters that are simply too wide. Rxvt-unicode will avoid
		412	these characters. For characters that are just \*(L"a bit\*(R" too wide a special
		413	\&\*(L"careful\*(R" rendering mode is used that redraws adjacent characters.
		414	.PP
		415	All of this requires that fonts do not lie about character sizes,
		416	however: Xft fonts often draw glyphs larger than their acclaimed bounding
		417	box, and rxvt-unicode has no way of detecting this (the correct way is to
		418	ask for the character bounding box, which unfortunately is wrong in these
		419	cases).
		420	.PP
		421	It's not clear (to me at least), wether this is a bug in Xft, freetype,
		422	or the respective font. If you encounter this problem you might try using
		423	the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you
		424	might be forced to use a different font.
		425	.PP
		426	All of this is not a problem when using X11 core fonts, as their bounding
		427	box data is correct.
		428	.PP
		429	\fIHow can I keep rxvt-unicode from using reverse video so much?\fR
		430	.IX Subsection "How can I keep rxvt-unicode from using reverse video so much?"
		431	.PP
		432	First of all, make sure you are running with the right terminal settings
		433	(\f(CW\*(C`TERM=rxvt\-unicode\*(C'\fR), which will get rid of most of these effects. Then
		434	make sure you have specified colours for italic and bold, as otherwise
		435	rxvt-unicode might use reverse video to simulate the effect:
		436	.PP
		437	.Vb 2
		438	\& URxvt.colorBD: white
		439	\& URxvt.colorIT: green
		440	.Ve
		441	.PP
		442	\fISome programs assume totally weird colours (red instead of blue), how can I fix that?\fR
		443	.IX Subsection "Some programs assume totally weird colours (red instead of blue), how can I fix that?"
		444	.PP
		445	For some unexplainable reason, some rare programs assume a very weird
		446	colour palette when confronted with a terminal with more than the standard
		447	8 colours (rxvt\-unicode supports 88). The right fix is, of course, to fix
		448	these programs not to assume non-ISO colours without very good reasons.
		449	.PP
		450	In the meantime, you can either edit your \f(CW\*(C`rxvt\-unicode\*(C'\fR terminfo
		451	definition to only claim 8 colour support or use \f(CW\*(C`TERM=rxvt\*(C'\fR, which will
		452	fix colours but keep you from using other rxvt-unicode features.
		453	.PP
		454	\fICan I switch the fonts at runtime?\fR
		455	.IX Subsection "Can I switch the fonts at runtime?"
		456	.PP
		457	Yes, using an escape sequence. Try something like this, which has the same
		458	effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately:
387	.PP	459	.PP
388	.Vb 1	460	.Vb 1
		461	\& printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic"
		462	.Ve
		463	.PP
		464	This is useful if you e.g. work primarily with japanese (and prefer a
		465	japanese font), but you have to switch to chinese temporarily, where
		466	japanese fonts would only be in your way.
		467	.PP
		468	You can think of this as a kind of manual \s-1ISO\-2022\s0 switching.
		469	.PP
		470	\fIWhy do italic characters look as if clipped?\fR
		471	.IX Subsection "Why do italic characters look as if clipped?"
		472	.PP
		473	Many fonts have difficulties with italic characters and hinting. For
		474	example, the otherwise very nicely hinted font \f(CW\*(C`xft:Bitstream Vera Sans
		475	Mono\*(C'\fR completely fails in it's italic face. A workaround might be to
		476	enable freetype autohinting, i.e. like this:
		477	.PP
		478	.Vb 2
		479	\& URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
		480	\& URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
		481	.Ve
		482	.PP
		483	\fICan I speed up Xft rendering somehow?\fR
		484	.IX Subsection "Can I speed up Xft rendering somehow?"
		485	.PP
		486	Yes, the most obvious way to speed it up is to avoid Xft entirely, as
		487	it is simply slow. If you still want Xft fonts you might try to disable
		488	antialiasing (by appending \f(CW\*(C`:antialias=false\*(C'\fR), which saves lots of
		489	memory and also speeds up rendering considerably.
		490	.PP
		491	\fIRxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?\fR
		492	.IX Subsection "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?"
		493	.PP
		494	Rxvt-unicode will use whatever you specify as a font. If it needs to
		495	fall back to it's default font search list it will prefer X11 core
		496	fonts, because they are small and fast, and then use Xft fonts. It has
		497	antialiasing disabled for most of them, because the author thinks they
		498	look best that way.
		499	.PP
		500	If you want antialiasing, you have to specify the fonts manually.
		501	.PP
		502	\fIWhat's with this bold/blink stuff?\fR
		503	.IX Subsection "What's with this bold/blink stuff?"
		504	.PP
		505	If no bold colour is set via \f(CW\*(C`colorBD:\*(C'\fR, bold will invert text using the
		506	standard foreground colour.
		507	.PP
		508	For the standard background colour, blinking will actually make the
		509	text blink when compiled with \f(CW\*(C`\-\-enable\-blinking\*(C'\fR. with standard
		510	colours. Without \f(CW\*(C`\-\-enable\-blinking\*(C'\fR, the blink attribute will be
		511	ignored.
		512	.PP
		513	On \s-1ANSI\s0 colours, bold/blink attributes are used to set high-intensity
		514	foreground/background colors.
		515	.PP
		516	color0\-7 are the low-intensity colors.
		517	.PP
		518	color8\-15 are the corresponding high-intensity colors.
		519	.PP
		520	\fII don't like the screen colors. How do I change them?\fR
		521	.IX Subsection "I don't like the screen colors. How do I change them?"
		522	.PP
		523	You can change the screen colors at run-time using \fI~/.Xdefaults\fR
		524	resources (or as long\-options).
		525	.PP
		526	Here are values that are supposed to resemble a \s-1VGA\s0 screen,
		527	including the murky brown that passes for low-intensity yellow:
		528	.PP
		529	.Vb 8
		530	\& URxvt.color0: #000000
		531	\& URxvt.color1: #A80000
		532	\& URxvt.color2: #00A800
		533	\& URxvt.color3: #A8A800
		534	\& URxvt.color4: #0000A8
		535	\& URxvt.color5: #A800A8
		536	\& URxvt.color6: #00A8A8
		537	\& URxvt.color7: #A8A8A8
		538	.Ve
		539	.PP
		540	.Vb 8
		541	\& URxvt.color8: #000054
		542	\& URxvt.color9: #FF0054
		543	\& URxvt.color10: #00FF54
		544	\& URxvt.color11: #FFFF54
		545	\& URxvt.color12: #0000FF
		546	\& URxvt.color13: #FF00FF
		547	\& URxvt.color14: #00FFFF
		548	\& URxvt.color15: #FFFFFF
		549	.Ve
		550	.PP
		551	And here is a more complete set of non-standard colors.
		552	.PP
		553	.Vb 18
		554	\& URxvt.cursorColor: #dc74d1
		555	\& URxvt.pointerColor: #dc74d1
		556	\& URxvt.background: #0e0e0e
		557	\& URxvt.foreground: #4ad5e1
		558	\& URxvt.color0: #000000
		559	\& URxvt.color8: #8b8f93
		560	\& URxvt.color1: #dc74d1
		561	\& URxvt.color9: #dc74d1
		562	\& URxvt.color2: #0eb8c7
		563	\& URxvt.color10: #0eb8c7
		564	\& URxvt.color3: #dfe37e
		565	\& URxvt.color11: #dfe37e
		566	\& URxvt.color5: #9e88f0
		567	\& URxvt.color13: #9e88f0
		568	\& URxvt.color6: #73f7ff
		569	\& URxvt.color14: #73f7ff
		570	\& URxvt.color7: #e1dddd
		571	\& URxvt.color15: #e1dddd
		572	.Ve
		573	.PP
		574	They have been described (not by me) as \*(L"pretty girly\*(R".
		575	.PP
		576	\fIWhy do some characters look so much different than others?\fR
		577	.IX Subsection "Why do some characters look so much different than others?"
		578	.PP
		579	See next entry.
		580	.PP
		581	\fIHow does rxvt-unicode choose fonts?\fR
		582	.IX Subsection "How does rxvt-unicode choose fonts?"
		583	.PP
		584	Most fonts do not contain the full range of Unicode, which is
		585	fine. Chances are that the font you (or the admin/package maintainer of
		586	your system/os) have specified does not cover all the characters you want
		587	to display.
		588	.PP
		589	\&\fBrxvt-unicode\fR makes a best-effort try at finding a replacement
		590	font. Often the result is fine, but sometimes the chosen font looks
		591	bad/ugly/wrong. Some fonts have totally strange characters that don't
		592	resemble the correct glyph at all, and rxvt-unicode lacks the artificial
		593	intelligence to detect that a specific glyph is wrong: it has to believe
		594	the font that the characters it claims to contain indeed look correct.
		595	.PP
		596	In that case, select a font of your taste and add it to the font list,
		597	e.g.:
		598	.PP
		599	.Vb 1
		600	\& @@URXVT_NAME@@ -fn basefont,font2,font3...
		601	.Ve
		602	.PP
		603	When rxvt-unicode sees a character, it will first look at the base
		604	font. If the base font does not contain the character, it will go to the
		605	next font, and so on. Specifying your own fonts will also speed up this
		606	search and use less resources within rxvt-unicode and the X\-server.
		607	.PP
		608	The only limitation is that none of the fonts may be larger than the base
		609	font, as the base font defines the terminal character cell size, which
		610	must be the same due to the way terminals work.
		611	.PP
		612	\fIWhy do some chinese characters look so different than others?\fR
		613	.IX Subsection "Why do some chinese characters look so different than others?"
		614	.PP
		615	This is because there is a difference between script and language \*(--
		616	rxvt-unicode does not know which language the text that is output is,
		617	as it only knows the unicode character codes. If rxvt-unicode first
		618	sees a japanese/chinese character, it might choose a japanese font for
		619	display. Subsequent japanese characters will use that font. Now, many
		620	chinese characters aren't represented in japanese fonts, so when the first
		621	non-japanese character comes up, rxvt-unicode will look for a chinese font
		622	\&\*(-- unfortunately at this point, it will still use the japanese font for
		623	chinese characters that are also in the japanese font.
		624	.PP
		625	The workaround is easy: just tag a chinese font at the end of your font
		626	list (see the previous question). The key is to view the font list as
		627	a preference list: If you expect more japanese, list a japanese font
		628	first. If you expect more chinese, put a chinese font first.
		629	.PP
		630	In the future it might be possible to switch language preferences at
		631	runtime (the internal data structure has no problem with using different
		632	fonts for the same character at the same time, but no interface for this
		633	has been designed yet).
		634	.PP
		635	Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document).
		636	.Sh "Keyboard, Mouse & User Interaction"
		637	.IX Subsection "Keyboard, Mouse & User Interaction"
		638	\fIThe new selection selects pieces that are too big, how can I select single words?\fR
		639	.IX Subsection "The new selection selects pieces that are too big, how can I select single words?"
		640	.PP
		641	If you want to select e.g. alphanumeric words, you can use the following
		642	setting:
		643	.PP
		644	.Vb 1
		645	\& URxvt.selection.pattern-0: ([[:word:]]+)
		646	.Ve
		647	.PP
		648	If you click more than twice, the selection will be extended
		649	more and more.
		650	.PP
		651	To get a selection that is very similar to the old code, try this pattern:
		652	.PP
		653	.Vb 1
		654	\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+)
		655	.Ve
		656	.PP
		657	Please also note that the \fILeftClick Shift-LeftClik\fR combination also
		658	selects words like the old code.
		659	.PP
		660	\fII don't like the new selection/popups/hotkeys/perl, how do I change/disable it?\fR
		661	.IX Subsection "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?"
		662	.PP
		663	You can disable the perl extension completely by setting the
		664	\&\fBperl-ext-common\fR resource to the empty string, which also keeps
		665	rxvt-unicode from initialising perl, saving memory.
		666	.PP
		667	If you only want to disable specific features, you first have to
		668	identify which perl extension is responsible. For this, read the section
		669	\&\fB\s-1PREPACKAGED\s0 \s-1EXTENSIONS\s0\fR in the @@URXVT_NAME@@\fIperl\fR\|(3) manpage. For
		670	example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify
		671	this \fBperl-ext-common\fR resource:
		672	.PP
		673	.Vb 1
		674	\& URxvt.perl-ext-common: default,-selection-popup,-option-popup
		675	.Ve
		676	.PP
		677	This will keep the default extensions, but disable the two popup
		678	extensions. Some extensions can also be configured, for example,
		679	scrollback search mode is triggered by \fBM\-s\fR. You can move it to any
		680	other combination either by setting the \fBsearchable-scrollback\fR resource:
		681	.PP
		682	.Vb 1
		683	\& URxvt.searchable-scrollback: CM-s
		684	.Ve
		685	.PP
		686	\fIThe cursor moves when selecting text in the current input line, how do I switch this off?\fR
		687	.IX Subsection "The cursor moves when selecting text in the current input line, how do I switch this off?"
		688	.PP
		689	See next entry.
		690	.PP
		691	\fIDuring rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?\fR
		692	.IX Subsection "During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?"
		693	.PP
		694	These are caused by the \f(CW\*(C`readline\*(C'\fR perl extension. Under normal
		695	circumstances, it will move your cursor around when you click into the
		696	line that contains it. It tries hard not to do this at the wrong moment,
		697	but when running a program that doesn't parse cursor movements or in some
		698	cases during rlogin sessions, it fails to detect this properly.
		699	.PP
		700	You can permamently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR
		701	extension:
		702	.PP
		703	.Vb 1
389	\& URxvt.perl-ext-common: default,tabbed	704	\& URxvt.perl-ext-common: default,-readline
390	.Ve	705	.Ve
391	.PP	706	.PP
392	It will also work fine with tabbing functionality of many window managers	707	\fIMy numerical keypad acts weird and generates differing output?\fR
393	or similar tabbing programs, and its embedding-features allow it to be	708	.IX Subsection "My numerical keypad acts weird and generates differing output?"
394	embedded into other programs, as witnessed by \fIdoc/rxvt\-tabbed\fR or
395	the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl module, which features a tabbed urxvt
396	(murxvt) terminal as an example embedding application.
397	.Sh "How do I know which rxvt-unicode version I'm using?"
398	.IX Subsection "How do I know which rxvt-unicode version I'm using?"
399	The version number is displayed with the usage (\-h). Also the escape
400	sequence \f(CW\*(C`ESC [ 8 n\*(C'\fR sets the window title to the version number. When
401	using the @@RXVT_NAME@@c client, the version displayed is that of the
402	daemon.
403	.Sh "I am using Debian GNU/Linux and have a problem..."
404	.IX Subsection "I am using Debian GNU/Linux and have a problem..."
405	The Debian GNU/Linux package of rxvt-unicode in sarge contains large
406	patches that considerably change the behaviour of rxvt-unicode (but
407	unfortunately this notice has been removed). Before reporting a bug to
408	the original rxvt-unicode author please download and install the genuine
409	version (<http://software.schmorp.de#rxvt\-unicode>) and try to reproduce
410	the problem. If you cannot, chances are that the problems are specific to
411	Debian GNU/Linux, in which case it should be reported via the Debian Bug
412	Tracking System (use \f(CW\*(C`reportbug\*(C'\fR to report the bug).
413	.PP	709	.PP
414	For other problems that also affect the Debian package, you can and	710	Some Debian GNUL/Linux users seem to have this problem, although no
415	probably should use the Debian \s-1BTS\s0, too, because, after all, it's also a	711	specific details were reported so far. It is possible that this is caused
416	bug in the Debian version and it serves as a reminder for other users that	712	by the wrong \f(CW\*(C`TERM\*(C'\fR setting, although the details of wether and how
417	might encounter the same issue.	713	this can happen are unknown, as \f(CW\*(C`TERM=rxvt\*(C'\fR should offer a compatible
418	.Sh "I am maintaining rxvt-unicode for distribution/OS \s-1XXX\s0, any recommendation?"	714	keymap. See the answer to the previous question, and please report if that
419	.IX Subsection "I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?"	715	helped.
420	You should build one binary with the default options. \fIconfigure\fR
421	now enables most useful options, and the trend goes to making them
422	runtime\-switchable, too, so there is usually no drawback to enbaling them,
423	except higher disk and possibly memory usage. The perl interpreter should
424	be enabled, as important functionality (menus, selection, likely more in
425	the future) depends on it.
426	.PP	716	.PP
427	You should not overwrite the \f(CW\*(C`perl\-ext\-common\*(C'\fR snd \f(CW\*(C`perl\-ext\*(C'\fR resources	717	\fIMy Compose (Multi_key) key is no longer working.\fR
428	system-wide (except maybe with \f(CW\*(C`defaults\*(C'\fR). This will result in useful	718	.IX Subsection "My Compose (Multi_key) key is no longer working."
429	behaviour. If your distribution aims at low memory, add an empty
430	\&\f(CW\*(C`perl\-ext\-common\*(C'\fR resource to the app-defaults file. This will keep the
431	perl interpreter disabled until the user enables it.
432	.PP	719	.PP
433	If you can/want build more binaries, I recommend building a minimal	720	The most common causes for this are that either your locale is not set
434	one with \f(CW\*(C`\-\-disable\-everything\*(C'\fR (very useful) and a maximal one with	721	correctly, or you specified a \fBpreeditStyle\fR that is not supported by
435	\&\f(CW\*(C`\-\-enable\-everything\*(C'\fR (less useful, it will be very big due to a lot of	722	your input method. For example, if you specified \fBOverTheSpot\fR and
436	encodings built-in that increase download times and are rarely used).	723	your input method (e.g. the default input method handling Compose keys)
437	.Sh "I need to make it setuid/setgid to support utmp/ptys on my \s-1OS\s0, is this safe?"	724	does not support this (for instance because it is not visual), then
438	.IX Subsection "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?"	725	rxvt-unicode will continue without an input method.
439	It should be, starting with release 7.1. You are encouraged to properly
440	install urxvt with privileges necessary for your \s-1OS\s0 now.
441	.PP	726	.PP
442	When rxvt-unicode detects that it runs setuid or setgid, it will fork	727	In this case either do not specify a \fBpreeditStyle\fR or specify more than
443	into a helper process for privileged operations (pty handling on some	728	one pre-edit style, such as \fBOverTheSpot,Root,None\fR.
444	systems, utmp/wtmp/lastlog handling on others) and drop privileges
445	immediately. This is much safer than most other terminals that keep
446	privileges while running (but is more relevant to urxvt, as it contains
447	things as perl interpreters, which might be \*(L"helpful\*(R" to attackers).
448	.PP	729	.PP
449	This forking is done as the very first within \fImain()\fR, which is very early	730	\fII cannot type \f(CI\*(C`Ctrl\-Shift\-2\*(C'\fI to get an \s-1ASCII\s0 \s-1NUL\s0 character due to \s-1ISO\s0 14755\fR
450	and reduces possible bugs to initialisation code run before \fImain()\fR, or	731	.IX Subsection "I cannot type Ctrl-Shift-2 to get an ASCII NUL character due to ISO 14755"
451	things like the dynamic loader of your system, which should result in very	732	.PP
452	little risk.	733	Either try \f(CW\*(C`Ctrl\-2\*(C'\fR alone (it often is mapped to \s-1ASCII\s0 \s-1NUL\s0 even on
		734	international keyboards) or simply use \s-1ISO\s0 14755 support to your
		735	advantage, typing <Ctrl\-Shift\-0> to get a \s-1ASCII\s0 \s-1NUL\s0. This works for other
		736	codes, too, such as \f(CW\*(C`Ctrl\-Shift\-1\-d\*(C'\fR to type the default telnet escape
		737	character and so on.
		738	.PP
		739	\fIMouse cut/paste suddenly no longer works.\fR
		740	.IX Subsection "Mouse cut/paste suddenly no longer works."
		741	.PP
		742	Make sure that mouse reporting is actually turned off since killing
		743	some editors prematurely may leave the mouse in mouse report mode. I've
		744	heard that tcsh may use mouse reporting unless it otherwise specified. A
		745	quick check is to see if cut/paste works when the Alt or Shift keys are
		746	depressed.
		747	.PP
		748	\fIWhat's with the strange Backspace/Delete key behaviour?\fR
		749	.IX Subsection "What's with the strange Backspace/Delete key behaviour?"
		750	.PP
		751	Assuming that the physical Backspace key corresponds to the
		752	BackSpace keysym (not likely for Linux ... see the following
		753	question) there are two standard values that can be used for
		754	Backspace: \f(CW\*(C`^H\*(C'\fR and \f(CW\*(C`^?\*(C'\fR.
		755	.PP
		756	Historically, either value is correct, but rxvt-unicode adopts the debian
		757	policy of using \f(CW\*(C`^?\*(C'\fR when unsure, because it's the one only only correct
		758	choice :).
		759	.PP
		760	Rxvt-unicode tries to inherit the current stty settings and uses the value
		761	of `erase' to guess the value for backspace. If rxvt-unicode wasn't
		762	started from a terminal (say, from a menu or by remote shell), then the
		763	system value of `erase', which corresponds to \s-1CERASE\s0 in <termios.h>, will
		764	be used (which may not be the same as your stty setting).
		765	.PP
		766	For starting a new rxvt\-unicode:
		767	.PP
		768	.Vb 3
		769	\& # use Backspace = ^H
		770	\& $ stty erase ^H
		771	\& $ @@URXVT_NAME@@
		772	.Ve
		773	.PP
		774	.Vb 3
		775	\& # use Backspace = ^?
		776	\& $ stty erase ^?
		777	\& $ @@URXVT_NAME@@
		778	.Ve
		779	.PP
		780	Toggle with \f(CW\*(C`ESC [ 36 h\*(C'\fR / \f(CW\*(C`ESC [ 36 l\*(C'\fR.
		781	.PP
		782	For an existing rxvt\-unicode:
		783	.PP
		784	.Vb 3
		785	\& # use Backspace = ^H
		786	\& $ stty erase ^H
		787	\& $ echo -n "^[[36h"
		788	.Ve
		789	.PP
		790	.Vb 3
		791	\& # use Backspace = ^?
		792	\& $ stty erase ^?
		793	\& $ echo -n "^[[36l"
		794	.Ve
		795	.PP
		796	This helps satisfy some of the Backspace discrepancies that occur, but
		797	if you use Backspace = \f(CW\*(C`^H\*(C'\fR, make sure that the termcap/terminfo value
		798	properly reflects that.
		799	.PP
		800	The Delete key is a another casualty of the ill-defined Backspace problem.
		801	To avoid confusion between the Backspace and Delete keys, the Delete
		802	key has been assigned an escape sequence to match the vt100 for Execute
		803	(\f(CW\*(C`ESC [ 3 ~\*(C'\fR) and is in the supplied termcap/terminfo.
		804	.PP
		805	Some other Backspace problems:
		806	.PP
		807	some editors use termcap/terminfo,
		808	some editors (vim I'm told) expect Backspace = ^H,
		809	\&\s-1GNU\s0 Emacs (and Emacs-like editors) use ^H for help.
		810	.PP
		811	Perhaps someday this will all be resolved in a consistent manner.
		812	.PP
		813	\fII don't like the key\-bindings. How do I change them?\fR
		814	.IX Subsection "I don't like the key-bindings. How do I change them?"
		815	.PP
		816	There are some compile-time selections available via configure. Unless
		817	you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can
		818	use the `keysym' resource to alter the keystrings associated with keysyms.
		819	.PP
		820	Here's an example for a URxvt session started using \f(CW\*(C`@@URXVT_NAME@@ \-name URxvt\*(C'\fR
		821	.PP
		822	.Vb 20
		823	\& URxvt.keysym.Home: \e033[1~
		824	\& URxvt.keysym.End: \e033[4~
		825	\& URxvt.keysym.C-apostrophe: \e033<C-'>
		826	\& URxvt.keysym.C-slash: \e033<C-/>
		827	\& URxvt.keysym.C-semicolon: \e033<C-;>
		828	\& URxvt.keysym.C-grave: \e033<C-`>
		829	\& URxvt.keysym.C-comma: \e033<C-,>
		830	\& URxvt.keysym.C-period: \e033<C-.>
		831	\& URxvt.keysym.C-0x60: \e033<C-`>
		832	\& URxvt.keysym.C-Tab: \e033<C-Tab>
		833	\& URxvt.keysym.C-Return: \e033<C-Return>
		834	\& URxvt.keysym.S-Return: \e033<S-Return>
		835	\& URxvt.keysym.S-space: \e033<S-Space>
		836	\& URxvt.keysym.M-Up: \e033<M-Up>
		837	\& URxvt.keysym.M-Down: \e033<M-Down>
		838	\& URxvt.keysym.M-Left: \e033<M-Left>
		839	\& URxvt.keysym.M-Right: \e033<M-Right>
		840	\& URxvt.keysym.M-C-0: list \e033<M-C- 0123456789 >
		841	\& URxvt.keysym.M-C-a: list \e033<M-C- abcdefghijklmnopqrstuvwxyz >
		842	\& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007
		843	.Ve
		844	.PP
		845	See some more examples in the documentation for the \fBkeysym\fR resource.
		846	.PP
		847	\fII'm using keyboard model \s-1XXX\s0 that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map\fR
		848	.IX Subsection "I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map"
		849	.PP
		850	.Vb 6
		851	\& KP_Insert == Insert
		852	\& F22 == Print
		853	\& F27 == Home
		854	\& F29 == Prior
		855	\& F33 == End
		856	\& F35 == Next
		857	.Ve
		858	.PP
		859	Rather than have rxvt-unicode try to accommodate all the various possible
		860	keyboard mappings, it is better to use `xmodmap' to remap the keys as
		861	required for your particular machine.
		862	.Sh "Terminal Configuration"
		863	.IX Subsection "Terminal Configuration"
		864	\fIWhy doesn't rxvt-unicode read my resources?\fR
		865	.IX Subsection "Why doesn't rxvt-unicode read my resources?"
		866	.PP
		867	Well, why, indeed? It does, in a way very similar to other X
		868	applications. Most importantly, this means that if you or your \s-1OS\s0 loads
		869	resources into the X display (the right way to do it), rxvt-unicode will
		870	ignore any resource files in your home directory. It will only read
		871	\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display.
		872	.PP
		873	If you have or use an \fI$HOME/.Xresources\fR file, chances are that
		874	resources are loaded into your X\-server. In this case, you have to
		875	re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR).
		876	.PP
		877	Also consider the form resources have to use:
		878	.PP
		879	.Vb 1
		880	\& URxvt.resource: value
		881	.Ve
		882	.PP
		883	If you want to use another form (there are lots of different ways of
		884	specifying resources), make sure you understand wether and why it
		885	works. If unsure, use the form above.
		886	.PP
453	.Sh "When I log-in to another system it tells me about missing terminfo data?"	887	\fIWhen I log-in to another system it tells me about missing terminfo data?\fR
454	.IX Subsection "When I log-in to another system it tells me about missing terminfo data?"	888	.IX Subsection "When I log-in to another system it tells me about missing terminfo data?"
		889	.PP
455	The terminal description used by rxvt-unicode is not as widely available	890	The terminal description used by rxvt-unicode is not as widely available
456	as that for xterm, or even rxvt (for which the same problem often arises).	891	as that for xterm, or even rxvt (for which the same problem often arises).
457	.PP	892	.PP
458	The correct solution for this problem is to install the terminfo, this can	893	The correct solution for this problem is to install the terminfo, this can
459	be done like this (with ncurses' infocmp):	894	be done like this (with ncurses' infocmp):
…		…
478	.Vb 1	913	.Vb 1
479	\& URxvt.termName: rxvt	914	\& URxvt.termName: rxvt
480	.Ve	915	.Ve
481	.PP	916	.PP
482	If you don't plan to use \fBrxvt\fR (quite common...) you could also replace	917	If you don't plan to use \fBrxvt\fR (quite common...) you could also replace
483	the rxvt terminfo file with the rxvt-unicode one.	918	the rxvt terminfo file with the rxvt-unicode one and use \f(CW\*(C`TERM=rxvt\*(C'\fR.
484	.ie n .Sh """tic"" outputs some error when compiling the terminfo entry."	919	.PP
485	.el .Sh "\f(CWtic\fP outputs some error when compiling the terminfo entry."	920	\fI\f(CI\*(C`tic\*(C'\fI outputs some error when compiling the terminfo entry.\fR
486	.IX Subsection "tic outputs some error when compiling the terminfo entry."	921	.IX Subsection "tic outputs some error when compiling the terminfo entry."
		922	.PP
487	Most likely it's the empty definition for \f(CW\*(C`enacs=\*(C'\fR. Just replace it by	923	Most likely it's the empty definition for \f(CW\*(C`enacs=\*(C'\fR. Just replace it by
488	\&\f(CW\*(C`enacs=\eE[0@\*(C'\fR and try again.	924	\&\f(CW\*(C`enacs=\eE[0@\*(C'\fR and try again.
489	.ie n .Sh """bash""'s readline does not work correctly under @@RXVT_NAME@@."	925	.PP
490	.el .Sh "\f(CWbash\fP's readline does not work correctly under @@RXVT_NAME@@."	926	\fI\f(CI\*(C`bash\*(C'\fI's readline does not work correctly under @@URXVT_NAME@@.\fR
491	.IX Subsection "bash's readline does not work correctly under @@RXVT_NAME@@."	927	.IX Subsection "bash's readline does not work correctly under @@URXVT_NAME@@."
		928	.PP
492	See next entry.	929	See next entry.
		930	.PP
493	.Sh "I need a termcap file entry."	931	\fII need a termcap file entry.\fR
494	.IX Subsection "I need a termcap file entry."	932	.IX Subsection "I need a termcap file entry."
		933	.PP
495	One reason you might want this is that some distributions or operating	934	One reason you might want this is that some distributions or operating
496	systems still compile some programs using the long-obsoleted termcap	935	systems still compile some programs using the long-obsoleted termcap
497	library (Fedora Core's bash is one example) and rely on a termcap entry	936	library (Fedora Core's bash is one example) and rely on a termcap entry
498	for \f(CW\*(C`rxvt\-unicode\*(C'\fR.	937	for \f(CW\*(C`rxvt\-unicode\*(C'\fR.
499	.PP	938	.PP
…		…
527	\& :sc=\eE7:se=\eE[27m:sf=^J:so=\eE[7m:sr=\eEM:st=\eEH:ta=^I:\e	966	\& :sc=\eE7:se=\eE[27m:sf=^J:so=\eE[7m:sr=\eEM:st=\eEH:ta=^I:\e
528	\& :te=\eE[r\eE[?1049l:ti=\eE[?1049h:ue=\eE[24m:up=\eE[A:\e	967	\& :te=\eE[r\eE[?1049l:ti=\eE[?1049h:ue=\eE[24m:up=\eE[A:\e
529	\& :us=\eE[4m:vb=\eE[?5h\eE[?5l:ve=\eE[?25h:vi=\eE[?25l:\e	968	\& :us=\eE[4m:vb=\eE[?5h\eE[?5l:ve=\eE[?25h:vi=\eE[?25l:\e
530	\& :vs=\eE[?25h:	969	\& :vs=\eE[?25h:
531	.Ve	970	.Ve
532	.ie n .Sh "Why does ""ls"" no longer have coloured output?"	971	.PP
533	.el .Sh "Why does \f(CWls\fP no longer have coloured output?"	972	\fIWhy does \f(CI\*(C`ls\*(C'\fI no longer have coloured output?\fR
534	.IX Subsection "Why does ls no longer have coloured output?"	973	.IX Subsection "Why does ls no longer have coloured output?"
		974	.PP
535	The \f(CW\*(C`ls\*(C'\fR in the \s-1GNU\s0 coreutils unfortunately doesn't use terminfo to	975	The \f(CW\*(C`ls\*(C'\fR in the \s-1GNU\s0 coreutils unfortunately doesn't use terminfo to
536	decide wether a terminal has colour, but uses it's own configuration	976	decide wether a terminal has colour, but uses it's own configuration
537	file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in it's default file (among	977	file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in it's default file (among
538	with most other terminals supporting colour). Either add:	978	with most other terminals supporting colour). Either add:
539	.PP	979	.PP
…		…
546	.Vb 1	986	.Vb 1
547	\& alias ls='ls --color=auto'	987	\& alias ls='ls --color=auto'
548	.Ve	988	.Ve
549	.PP	989	.PP
550	to your \f(CW\*(C`.profile\*(C'\fR or \f(CW\*(C`.bashrc\*(C'\fR.	990	to your \f(CW\*(C`.profile\*(C'\fR or \f(CW\*(C`.bashrc\*(C'\fR.
		991	.PP
551	.Sh "Why doesn't vim/emacs etc. use the 88 colour mode?"	992	\fIWhy doesn't vim/emacs etc. use the 88 colour mode?\fR
552	.IX Subsection "Why doesn't vim/emacs etc. use the 88 colour mode?"	993	.IX Subsection "Why doesn't vim/emacs etc. use the 88 colour mode?"
		994	.PP
553	See next entry.	995	See next entry.
		996	.PP
554	.Sh "Why doesn't vim/emacs etc. make use of italic?"	997	\fIWhy doesn't vim/emacs etc. make use of italic?\fR
555	.IX Subsection "Why doesn't vim/emacs etc. make use of italic?"	998	.IX Subsection "Why doesn't vim/emacs etc. make use of italic?"
		999	.PP
556	See next entry.	1000	See next entry.
		1001	.PP
557	.Sh "Why are the secondary screen-related options not working properly?"	1002	\fIWhy are the secondary screen-related options not working properly?\fR
558	.IX Subsection "Why are the secondary screen-related options not working properly?"	1003	.IX Subsection "Why are the secondary screen-related options not working properly?"
		1004	.PP
559	Make sure you are using \f(CW\*(C`TERM=rxvt\-unicode\*(C'\fR. Some pre-packaged	1005	Make sure you are using \f(CW\*(C`TERM=rxvt\-unicode\*(C'\fR. Some pre-packaged
560	distributions (most notably Debian GNU/Linux) break rxvt-unicode	1006	distributions (most notably Debian GNU/Linux) break rxvt-unicode
561	by setting \f(CW\*(C`TERM\*(C'\fR to \f(CW\*(C`rxvt\*(C'\fR, which doesn't have these extra	1007	by setting \f(CW\*(C`TERM\*(C'\fR to \f(CW\*(C`rxvt\*(C'\fR, which doesn't have these extra
562	features. Unfortunately, some of these (most notably, again, Debian	1008	features. Unfortunately, some of these (most notably, again, Debian
563	GNU/Linux) furthermore fail to even install the \f(CW\*(C`rxvt\-unicode\*(C'\fR terminfo	1009	GNU/Linux) furthermore fail to even install the \f(CW\*(C`rxvt\-unicode\*(C'\fR terminfo
564	file, so you will need to install it on your own (See the question \fBWhen	1010	file, so you will need to install it on your own (See the question \fBWhen
565	I log-in to another system it tells me about missing terminfo data?\fR on	1011	I log-in to another system it tells me about missing terminfo data?\fR on
566	how to do this).	1012	how to do this).
567	.Sh "My numerical keypad acts weird and generates differing output?"	1013	.Sh "Encoding / Locale / Input Method Issues"
568	.IX Subsection "My numerical keypad acts weird and generates differing output?"	1014	.IX Subsection "Encoding / Locale / Input Method Issues"
569	Some Debian GNUL/Linux users seem to have this problem, although no
570	specific details were reported so far. It is possible that this is caused
571	by the wrong \f(CW\*(C`TERM\*(C'\fR setting, although the details of wether and how
572	this can happen are unknown, as \f(CW\*(C`TERM=rxvt\*(C'\fR should offer a compatible
573	keymap. See the answer to the previous question, and please report if that
574	helped.
575	.Sh "Rxvt-unicode does not seem to understand the selected encoding?"	1015	\fIRxvt-unicode does not seem to understand the selected encoding?\fR
576	.IX Subsection "Rxvt-unicode does not seem to understand the selected encoding?"	1016	.IX Subsection "Rxvt-unicode does not seem to understand the selected encoding?"
		1017	.PP
577	See next entry.	1018	See next entry.
		1019	.PP
578	.Sh "Unicode does not seem to work?"	1020	\fIUnicode does not seem to work?\fR
579	.IX Subsection "Unicode does not seem to work?"	1021	.IX Subsection "Unicode does not seem to work?"
		1022	.PP
580	If you encounter strange problems like typing an accented character but	1023	If you encounter strange problems like typing an accented character but
581	getting two unrelated other characters or similar, or if program output is	1024	getting two unrelated other characters or similar, or if program output is
582	subtly garbled, then you should check your locale settings.	1025	subtly garbled, then you should check your locale settings.
583	.PP	1026	.PP
584	Rxvt-unicode must be started with the same \f(CW\*(C`LC_CTYPE\*(C'\fR setting as the	1027	Rxvt-unicode must be started with the same \f(CW\*(C`LC_CTYPE\*(C'\fR setting as the
…		…
606	Then the locale you specified is not supported on your system.	1049	Then the locale you specified is not supported on your system.
607	.PP	1050	.PP
608	If nothing works and you are sure that everything is set correctly then	1051	If nothing works and you are sure that everything is set correctly then
609	you will need to remember a little known fact: Some programs just don't	1052	you will need to remember a little known fact: Some programs just don't
610	support locales :(	1053	support locales :(
611	.Sh "Why do some characters look so much different than others?"	1054	.PP
612	.IX Subsection "Why do some characters look so much different than others?"	1055	\fIHow does rxvt-unicode determine the encoding to use?\fR
		1056	.IX Subsection "How does rxvt-unicode determine the encoding to use?"
		1057	.PP
613	See next entry.	1058	See next entry.
614	.Sh "How does rxvt-unicode choose fonts?"
615	.IX Subsection "How does rxvt-unicode choose fonts?"
616	Most fonts do not contain the full range of Unicode, which is
617	fine. Chances are that the font you (or the admin/package maintainer of
618	your system/os) have specified does not cover all the characters you want
619	to display.
620	.PP	1059	.PP
621	\&\fBrxvt-unicode\fR makes a best-effort try at finding a replacement	1060	\fIIs there an option to switch encodings?\fR
622	font. Often the result is fine, but sometimes the chosen font looks	1061	.IX Subsection "Is there an option to switch encodings?"
623	bad/ugly/wrong. Some fonts have totally strange characters that don't
624	resemble the correct glyph at all, and rxvt-unicode lacks the artificial
625	intelligence to detect that a specific glyph is wrong: it has to believe
626	the font that the characters it claims to contain indeed look correct.
627	.PP	1062	.PP
628	In that case, select a font of your taste and add it to the font list,	1063	Unlike some other terminals, rxvt-unicode has no encoding switch, and no
629	e.g.:	1064	specific \*(L"utf\-8\*(R" mode, such as xterm. In fact, it doesn't even know about
		1065	\&\s-1UTF\-8\s0 or any other encodings with respect to terminal I/O.
		1066	.PP
		1067	The reasons is that there exists a perfectly fine mechanism for selecting
		1068	the encoding, doing I/O and (most important) communicating this to all
		1069	applications so everybody agrees on character properties such as width
		1070	and code number. This mechanism is the \fIlocale\fR. Applications not using
		1071	that info will have problems (for example, \f(CW\*(C`xterm\*(C'\fR gets the width of
		1072	characters wrong as it uses it's own, locale-independent table under all
		1073	locales).
		1074	.PP
		1075	Rxvt-unicode uses the \f(CW\*(C`LC_CTYPE\*(C'\fR locale category to select encoding. All
		1076	programs doing the same (that is, most) will automatically agree in the
		1077	interpretation of characters.
		1078	.PP
		1079	Unfortunately, there is no system-independent way to select locales, nor
		1080	is there a standard on how locale specifiers will look like.
		1081	.PP
		1082	On most systems, the content of the \f(CW\*(C`LC_CTYPE\*(C'\fR environment variable
		1083	contains an arbitrary string which corresponds to an already-installed
		1084	locale. Common names for locales are \f(CW\*(C`en_US.UTF\-8\*(C'\fR, \f(CW\*(C`de_DE.ISO\-8859\-15\*(C'\fR,
		1085	\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR, i.e. \f(CW\*(C`language_country.encoding\*(C'\fR, but other forms
		1086	(i.e. \f(CW\*(C`de\*(C'\fR or \f(CW\*(C`german\*(C'\fR) are also common.
		1087	.PP
		1088	Rxvt-unicode ignores all other locale categories, and except for
		1089	the encoding, ignores country or language-specific settings,
		1090	i.e. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR and \f(CW\*(C`ja_JP.UTF\-8\*(C'\fR are the normally same to
		1091	rxvt\-unicode.
		1092	.PP
		1093	If you want to use a specific encoding you have to make sure you start
		1094	rxvt-unicode with the correct \f(CW\*(C`LC_CTYPE\*(C'\fR category.
		1095	.PP
		1096	\fICan I switch locales at runtime?\fR
		1097	.IX Subsection "Can I switch locales at runtime?"
		1098	.PP
		1099	Yes, using an escape sequence. Try something like this, which sets
		1100	rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR.
630	.PP	1101	.PP
631	.Vb 1	1102	.Vb 1
632	\& @@RXVT_NAME@@ -fn basefont,font2,font3...	1103	\& printf '\ee]701;%s\e007' ja_JP.SJIS
633	.Ve	1104	.Ve
634	.PP	1105	.PP
635	When rxvt-unicode sees a character, it will first look at the base	1106	See also the previous answer.
636	font. If the base font does not contain the character, it will go to the
637	next font, and so on. Specifying your own fonts will also speed up this
638	search and use less resources within rxvt-unicode and the X\-server.
639	.PP	1107	.PP
640	The only limitation is that none of the fonts may be larger than the base	1108	Sometimes this capability is rather handy when you want to work in
641	font, as the base font defines the terminal character cell size, which	1109	one locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support it
642	must be the same due to the way terminals work.	1110	(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which
643	.Sh "Why do some chinese characters look so different than others?"	1111	first switches to a locale supported by xjdic and back later:
644	.IX Subsection "Why do some chinese characters look so different than others?"
645	This is because there is a difference between script and language \*(--
646	rxvt-unicode does not know which language the text that is output is,
647	as it only knows the unicode character codes. If rxvt-unicode first
648	sees a japanese/chinese character, it might choose a japanese font for
649	display. Subsequent japanese characters will use that font. Now, many
650	chinese characters aren't represented in japanese fonts, so when the first
651	non-japanese character comes up, rxvt-unicode will look for a chinese font
652	\&\*(-- unfortunately at this point, it will still use the japanese font for
653	chinese characters that are also in the japanese font.
654	.PP	1112	.PP
655	The workaround is easy: just tag a chinese font at the end of your font	1113	.Vb 3
656	list (see the previous question). The key is to view the font list as	1114	\& printf '\ee]701;%s\e007' ja_JP.SJIS
657	a preference list: If you expect more japanese, list a japanese font	1115	\& xjdic -js
658	first. If you expect more chinese, put a chinese font first.	1116	\& printf '\ee]701;%s\e007' de_DE.UTF-8
		1117	.Ve
659	.PP	1118	.PP
660	In the future it might be possible to switch language preferences at	1119	You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except
661	runtime (the internal data structure has no problem with using different	1120	for some locales where character width differs between program\- and
662	fonts for the same character at the same time, but no interface for this	1121	rxvt\-unicode\-locales.
663	has been designed yet).
664	.PP	1122	.PP
665	Until then, you might get away with switching fonts at runtime (see \*(L"Can I switch the fonts at runtime?\*(R" later in this document).	1123	\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR
666	.Sh "Why does rxvt-unicode sometimes leave pixel droppings?"	1124	.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
667	.IX Subsection "Why does rxvt-unicode sometimes leave pixel droppings?"
668	Most fonts were not designed for terminal use, which means that character
669	size varies a lot. A font that is otherwise fine for terminal use might
670	contain some characters that are simply too wide. Rxvt-unicode will avoid
671	these characters. For characters that are just \*(L"a bit\*(R" too wide a special
672	\&\*(L"careful\*(R" rendering mode is used that redraws adjacent characters.
673	.PP	1125	.PP
674	All of this requires that fonts do not lie about character sizes,	1126	You can specify separate locales for the input method and the rest of the
675	however: Xft fonts often draw glyphs larger than their acclaimed bounding	1127	terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
676	box, and rxvt-unicode has no way of detecting this (the correct way is to
677	ask for the character bounding box, which unfortunately is wrong in these
678	cases).
679	.PP	1128	.PP
680	It's not clear (to me at least), wether this is a bug in Xft, freetype,	1129	.Vb 1
681	or the respective font. If you encounter this problem you might try using	1130	\& URxvt.imlocale: ja_JP.EUC-JP
682	the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you	1131	.Ve
683	might be forced to use a different font.
684	.PP	1132	.PP
685	All of this is not a problem when using X11 core fonts, as their bounding	1133	Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still
686	box data is correct.	1134	use your input method. Please note, however, that you will not be able to
		1135	input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input
		1136	method limits you.
		1137	.PP
		1138	\fIRxvt-unicode crashes when the X Input Method changes or exits.\fR
		1139	.IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits."
		1140	.PP
		1141	Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by
		1142	design. Applications can avoid some crashes at the expense of memory
		1143	leaks, and Input Methods can avoid some crashes by careful ordering at
		1144	exit time. \fBkinput2\fR (and derived input methods) generally succeeds,
		1145	while \fB\s-1SCIM\s0\fR (or similar input methods) fails. In the end, however,
		1146	crashes cannot be completely avoided even if both sides cooperate.
		1147	.PP
		1148	So the only workaround is not to kill your Input Method Servers.
		1149	.Sh "Operating Systems / Package Maintaining"
		1150	.IX Subsection "Operating Systems / Package Maintaining"
		1151	\fII am using Debian GNU/Linux and have a problem...\fR
		1152	.IX Subsection "I am using Debian GNU/Linux and have a problem..."
		1153	.PP
		1154	The Debian GNU/Linux package of rxvt-unicode in sarge contains large
		1155	patches that considerably change the behaviour of rxvt-unicode (but
		1156	unfortunately this notice has been removed). Before reporting a bug to
		1157	the original rxvt-unicode author please download and install the genuine
		1158	version (<http://software.schmorp.de#rxvt\-unicode>) and try to reproduce
		1159	the problem. If you cannot, chances are that the problems are specific to
		1160	Debian GNU/Linux, in which case it should be reported via the Debian Bug
		1161	Tracking System (use \f(CW\*(C`reportbug\*(C'\fR to report the bug).
		1162	.PP
		1163	For other problems that also affect the Debian package, you can and
		1164	probably should use the Debian \s-1BTS\s0, too, because, after all, it's also a
		1165	bug in the Debian version and it serves as a reminder for other users that
		1166	might encounter the same issue.
		1167	.PP
		1168	\fII am maintaining rxvt-unicode for distribution/OS \s-1XXX\s0, any recommendation?\fR
		1169	.IX Subsection "I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?"
		1170	.PP
		1171	You should build one binary with the default options. \fIconfigure\fR
		1172	now enables most useful options, and the trend goes to making them
		1173	runtime\-switchable, too, so there is usually no drawback to enbaling them,
		1174	except higher disk and possibly memory usage. The perl interpreter should
		1175	be enabled, as important functionality (menus, selection, likely more in
		1176	the future) depends on it.
		1177	.PP
		1178	You should not overwrite the \f(CW\*(C`perl\-ext\-common\*(C'\fR snd \f(CW\*(C`perl\-ext\*(C'\fR resources
		1179	system-wide (except maybe with \f(CW\*(C`defaults\*(C'\fR). This will result in useful
		1180	behaviour. If your distribution aims at low memory, add an empty
		1181	\&\f(CW\*(C`perl\-ext\-common\*(C'\fR resource to the app-defaults file. This will keep the
		1182	perl interpreter disabled until the user enables it.
		1183	.PP
		1184	If you can/want build more binaries, I recommend building a minimal
		1185	one with \f(CW\*(C`\-\-disable\-everything\*(C'\fR (very useful) and a maximal one with
		1186	\&\f(CW\*(C`\-\-enable\-everything\*(C'\fR (less useful, it will be very big due to a lot of
		1187	encodings built-in that increase download times and are rarely used).
		1188	.PP
		1189	\fII need to make it setuid/setgid to support utmp/ptys on my \s-1OS\s0, is this safe?\fR
		1190	.IX Subsection "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?"
		1191	.PP
		1192	It should be, starting with release 7.1. You are encouraged to properly
		1193	install urxvt with privileges necessary for your \s-1OS\s0 now.
		1194	.PP
		1195	When rxvt-unicode detects that it runs setuid or setgid, it will fork
		1196	into a helper process for privileged operations (pty handling on some
		1197	systems, utmp/wtmp/lastlog handling on others) and drop privileges
		1198	immediately. This is much safer than most other terminals that keep
		1199	privileges while running (but is more relevant to urxvt, as it contains
		1200	things as perl interpreters, which might be \*(L"helpful\*(R" to attackers).
		1201	.PP
		1202	This forking is done as the very first within \fImain()\fR, which is very early
		1203	and reduces possible bugs to initialisation code run before \fImain()\fR, or
		1204	things like the dynamic loader of your system, which should result in very
		1205	little risk.
		1206	.PP
687	.Sh "On Solaris 9, many line-drawing characters are too wide."	1207	\fIOn Solaris 9, many line-drawing characters are too wide.\fR
688	.IX Subsection "On Solaris 9, many line-drawing characters are too wide."	1208	.IX Subsection "On Solaris 9, many line-drawing characters are too wide."
		1209	.PP
689	Seems to be a known bug, read	1210	Seems to be a known bug, read
690	<http://nixdoc.net/files/forum/about34198.html>. Some people use the	1211	<http://nixdoc.net/files/forum/about34198.html>. Some people use the
691	following ugly workaround to get non-double-wide-characters working:	1212	following ugly workaround to get non-double-wide-characters working:
692	.PP	1213	.PP
693	.Vb 1	1214	.Vb 1
694	\& #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)	1215	\& #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
695	.Ve	1216	.Ve
696	.Sh "My Compose (Multi_key) key is no longer working."
697	.IX Subsection "My Compose (Multi_key) key is no longer working."
698	The most common causes for this are that either your locale is not set
699	correctly, or you specified a \fBpreeditStyle\fR that is not supported by
700	your input method. For example, if you specified \fBOverTheSpot\fR and
701	your input method (e.g. the default input method handling Compose keys)
702	does not support this (for instance because it is not visual), then
703	rxvt-unicode will continue without an input method.
704	.PP	1217	.PP
705	In this case either do not specify a \fBpreeditStyle\fR or specify more than
706	one pre-edit style, such as \fBOverTheSpot,Root,None\fR.
707	.ie n .Sh "I cannot type ""Ctrl\-Shift\-2"" to get an \s-1ASCII\s0 \s-1NUL\s0 character due to \s-1ISO\s0 14755"
708	.el .Sh "I cannot type \f(CWCtrl\-Shift\-2\fP to get an \s-1ASCII\s0 \s-1NUL\s0 character due to \s-1ISO\s0 14755"
709	.IX Subsection "I cannot type Ctrl-Shift-2 to get an ASCII NUL character due to ISO 14755"
710	Either try \f(CW\*(C`Ctrl\-2\*(C'\fR alone (it often is mapped to \s-1ASCII\s0 \s-1NUL\s0 even on
711	international keyboards) or simply use \s-1ISO\s0 14755 support to your
712	advantage, typing <Ctrl\-Shift\-0> to get a \s-1ASCII\s0 \s-1NUL\s0. This works for other
713	codes, too, such as \f(CW\*(C`Ctrl\-Shift\-1\-d\*(C'\fR to type the default telnet escape
714	character and so on.
715	.Sh "How can I keep rxvt-unicode from using reverse video so much?"
716	.IX Subsection "How can I keep rxvt-unicode from using reverse video so much?"
717	First of all, make sure you are running with the right terminal settings
718	(\f(CW\*(C`TERM=rxvt\-unicode\*(C'\fR), which will get rid of most of these effects. Then
719	make sure you have specified colours for italic and bold, as otherwise
720	rxvt-unicode might use reverse video to simulate the effect:
721	.PP
722	.Vb 2
723	\& URxvt.colorBD: white
724	\& URxvt.colorIT: green
725	.Ve
726	.Sh "Some programs assume totally weird colours (red instead of blue), how can I fix that?"
727	.IX Subsection "Some programs assume totally weird colours (red instead of blue), how can I fix that?"
728	For some unexplainable reason, some rare programs assume a very weird
729	colour palette when confronted with a terminal with more than the standard
730	8 colours (rxvt\-unicode supports 88). The right fix is, of course, to fix
731	these programs not to assume non-ISO colours without very good reasons.
732	.PP
733	In the meantime, you can either edit your \f(CW\*(C`rxvt\-unicode\*(C'\fR terminfo
734	definition to only claim 8 colour support or use \f(CW\*(C`TERM=rxvt\*(C'\fR, which will
735	fix colours but keep you from using other rxvt-unicode features.
736	.Sh "I am on FreeBSD and rxvt-unicode does not seem to work at all."	1218	\fII am on FreeBSD and rxvt-unicode does not seem to work at all.\fR
737	.IX Subsection "I am on FreeBSD and rxvt-unicode does not seem to work at all."	1219	.IX Subsection "I am on FreeBSD and rxvt-unicode does not seem to work at all."
		1220	.PP
738	Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined	1221	Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined
739	in your compile environment, or an implementation that implements it,	1222	in your compile environment, or an implementation that implements it,
740	wether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that	1223	wether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that
741	\&\fBwchar_t\fR is represented as unicode.	1224	\&\fBwchar_t\fR is represented as unicode.
742	.PP	1225	.PP
…		…
762	encodings slightly different than the terminal emulator).	1245	encodings slightly different than the terminal emulator).
763	.PP	1246	.PP
764	The rxvt-unicode author insists that the right way to fix this is in the	1247	The rxvt-unicode author insists that the right way to fix this is in the
765	system libraries once and for all, instead of forcing every app to carry	1248	system libraries once and for all, instead of forcing every app to carry
766	complete replacements for them :)	1249	complete replacements for them :)
		1250	.PP
767	.Sh "I use Solaris 9 and it doesn't compile/work/etc."	1251	\fII use Solaris 9 and it doesn't compile/work/etc.\fR
768	.IX Subsection "I use Solaris 9 and it doesn't compile/work/etc."	1252	.IX Subsection "I use Solaris 9 and it doesn't compile/work/etc."
		1253	.PP
769	Try the diff in \fIdoc/solaris9.patch\fR as a base. It fixes the worst	1254	Try the diff in \fIdoc/solaris9.patch\fR as a base. It fixes the worst
770	problems with \f(CW\*(C`wcwidth\*(C'\fR and a compile problem.	1255	problems with \f(CW\*(C`wcwidth\*(C'\fR and a compile problem.
		1256	.PP
771	.Sh "How can I use rxvt-unicode under cygwin?"	1257	\fIHow can I use rxvt-unicode under cygwin?\fR
772	.IX Subsection "How can I use rxvt-unicode under cygwin?"	1258	.IX Subsection "How can I use rxvt-unicode under cygwin?"
		1259	.PP
773	rxvt-unicode should compile and run out of the box on cygwin, using	1260	rxvt-unicode should compile and run out of the box on cygwin, using
774	the X11 libraries that come with cygwin. libW11 emulation is no	1261	the X11 libraries that come with cygwin. libW11 emulation is no
775	longer supported (and makes no sense, either, as it only supported a	1262	longer supported (and makes no sense, either, as it only supported a
776	single font). I recommend starting the X\-server in \f(CW\*(C`\-multiwindow\*(C'\fR or	1263	single font). I recommend starting the X\-server in \f(CW\*(C`\-multiwindow\*(C'\fR or
777	\&\f(CW\*(C`\-rootless\*(C'\fR mode instead, which will result in similar look&feel as the	1264	\&\f(CW\*(C`\-rootless\*(C'\fR mode instead, which will result in similar look&feel as the
778	old libW11 emulation.	1265	old libW11 emulation.
779	.PP	1266	.PP
780	At the time of this writing, cygwin didn't seem to support any multi-byte	1267	At the time of this writing, cygwin didn't seem to support any multi-byte
781	encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited	1268	encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited
782	to 8\-bit encodings.	1269	to 8\-bit encodings.
783	.Sh "How does rxvt-unicode determine the encoding to use?"
784	.IX Subsection "How does rxvt-unicode determine the encoding to use?"
785	See next entry.
786	.Sh "Is there an option to switch encodings?"
787	.IX Subsection "Is there an option to switch encodings?"
788	Unlike some other terminals, rxvt-unicode has no encoding switch, and no
789	specific \*(L"utf\-8\*(R" mode, such as xterm. In fact, it doesn't even know about
790	\&\s-1UTF\-8\s0 or any other encodings with respect to terminal I/O.
791	.PP
792	The reasons is that there exists a perfectly fine mechanism for selecting
793	the encoding, doing I/O and (most important) communicating this to all
794	applications so everybody agrees on character properties such as width
795	and code number. This mechanism is the \fIlocale\fR. Applications not using
796	that info will have problems (for example, \f(CW\*(C`xterm\*(C'\fR gets the width of
797	characters wrong as it uses it's own, locale-independent table under all
798	locales).
799	.PP
800	Rxvt-unicode uses the \f(CW\*(C`LC_CTYPE\*(C'\fR locale category to select encoding. All
801	programs doing the same (that is, most) will automatically agree in the
802	interpretation of characters.
803	.PP
804	Unfortunately, there is no system-independent way to select locales, nor
805	is there a standard on how locale specifiers will look like.
806	.PP
807	On most systems, the content of the \f(CW\*(C`LC_CTYPE\*(C'\fR environment variable
808	contains an arbitrary string which corresponds to an already-installed
809	locale. Common names for locales are \f(CW\*(C`en_US.UTF\-8\*(C'\fR, \f(CW\*(C`de_DE.ISO\-8859\-15\*(C'\fR,
810	\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR, i.e. \f(CW\*(C`language_country.encoding\*(C'\fR, but other forms
811	(i.e. \f(CW\*(C`de\*(C'\fR or \f(CW\*(C`german\*(C'\fR) are also common.
812	.PP
813	Rxvt-unicode ignores all other locale categories, and except for
814	the encoding, ignores country or language-specific settings,
815	i.e. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR and \f(CW\*(C`ja_JP.UTF\-8\*(C'\fR are the normally same to
816	rxvt\-unicode.
817	.PP
818	If you want to use a specific encoding you have to make sure you start
819	rxvt-unicode with the correct \f(CW\*(C`LC_CTYPE\*(C'\fR category.
820	.Sh "Can I switch locales at runtime?"
821	.IX Subsection "Can I switch locales at runtime?"
822	Yes, using an escape sequence. Try something like this, which sets
823	rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR.
824	.PP
825	.Vb 1
826	\& printf '\ee]701;%s\e007' ja_JP.SJIS
827	.Ve
828	.PP
829	See also the previous answer.
830	.PP
831	Sometimes this capability is rather handy when you want to work in
832	one locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support it
833	(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which
834	first switches to a locale supported by xjdic and back later:
835	.PP
836	.Vb 3
837	\& printf '\ee]701;%s\e007' ja_JP.SJIS
838	\& xjdic -js
839	\& printf '\ee]701;%s\e007' de_DE.UTF-8
840	.Ve
841	.PP
842	You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except
843	for some locales where character width differs between program\- and
844	rxvt\-unicode\-locales.
845	.Sh "Can I switch the fonts at runtime?"
846	.IX Subsection "Can I switch the fonts at runtime?"
847	Yes, using an escape sequence. Try something like this, which has the same
848	effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately:
849	.PP
850	.Vb 1
851	\& printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic"
852	.Ve
853	.PP
854	This is useful if you e.g. work primarily with japanese (and prefer a
855	japanese font), but you have to switch to chinese temporarily, where
856	japanese fonts would only be in your way.
857	.PP
858	You can think of this as a kind of manual \s-1ISO\-2022\s0 switching.
859	.Sh "Why do italic characters look as if clipped?"
860	.IX Subsection "Why do italic characters look as if clipped?"
861	Many fonts have difficulties with italic characters and hinting. For
862	example, the otherwise very nicely hinted font \f(CW\*(C`xft:Bitstream Vera Sans
863	Mono\*(C'\fR completely fails in it's italic face. A workaround might be to
864	enable freetype autohinting, i.e. like this:
865	.PP
866	.Vb 2
867	\& URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
868	\& URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
869	.Ve
870	.Sh "My input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?"
871	.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
872	You can specify separate locales for the input method and the rest of the
873	terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
874	.PP
875	.Vb 1
876	\& URxvt.imlocale: ja_JP.EUC-JP
877	.Ve
878	.PP
879	Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still
880	use your input method. Please note, however, that you will not be able to
881	input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input
882	method limits you.
883	.Sh "Rxvt-unicode crashes when the X Input Method changes or exits."
884	.IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits."
885	Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by
886	design. Applications can avoid some crashes at the expense of memory
887	leaks, and Input Methods can avoid some crashes by careful ordering at
888	exit time. \fBkinput2\fR (and derived input methods) generally succeeds,
889	while \fB\s-1SCIM\s0\fR (or similar input methods) fails. In the end, however,
890	crashes cannot be completely avoided even if both sides cooperate.
891	.PP
892	So the only workaround is not to kill your Input Method Servers.
893	.Sh "Rxvt-unicode uses gobs of memory, how can I reduce that?"
894	.IX Subsection "Rxvt-unicode uses gobs of memory, how can I reduce that?"
895	Rxvt-unicode tries to obey the rule of not charging you for something you
896	don't use. One thing you should try is to configure out all settings that
897	you don't need, for example, Xft support is a resource hog by design,
898	when used. Compiling it out ensures that no Xft font will be loaded
899	accidentally when rxvt-unicode tries to find a font for your characters.
900	.PP
901	Also, many people (me included) like large windows and even larger
902	scrollback buffers: Without \f(CW\*(C`\-\-enable\-unicode3\*(C'\fR, rxvt-unicode will use
903	6 bytes per screen cell. For a 160x?? window this amounts to almost a
904	kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
905	use 10 Megabytes of memory. With \f(CW\*(C`\-\-enable\-unicode3\*(C'\fR it gets worse, as
906	rxvt-unicode then uses 8 bytes per screen cell.
907	.Sh "Can I speed up Xft rendering somehow?"
908	.IX Subsection "Can I speed up Xft rendering somehow?"
909	Yes, the most obvious way to speed it up is to avoid Xft entirely, as
910	it is simply slow. If you still want Xft fonts you might try to disable
911	antialiasing (by appending \f(CW\*(C`:antialias=false\*(C'\fR), which saves lots of
912	memory and also speeds up rendering considerably.
913	.Sh "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?"
914	.IX Subsection "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?"
915	Rxvt-unicode will use whatever you specify as a font. If it needs to
916	fall back to it's default font search list it will prefer X11 core
917	fonts, because they are small and fast, and then use Xft fonts. It has
918	antialiasing disabled for most of them, because the author thinks they
919	look best that way.
920	.PP
921	If you want antialiasing, you have to specify the fonts manually.
922	.Sh "Mouse cut/paste suddenly no longer works."
923	.IX Subsection "Mouse cut/paste suddenly no longer works."
924	Make sure that mouse reporting is actually turned off since killing
925	some editors prematurely may leave the mouse in mouse report mode. I've
926	heard that tcsh may use mouse reporting unless it otherwise specified. A
927	quick check is to see if cut/paste works when the Alt or Shift keys are
928	depressed.
929	.Sh "What's with this bold/blink stuff?"
930	.IX Subsection "What's with this bold/blink stuff?"
931	If no bold colour is set via \f(CW\*(C`colorBD:\*(C'\fR, bold will invert text using the
932	standard foreground colour.
933	.PP
934	For the standard background colour, blinking will actually make the
935	text blink when compiled with \f(CW\*(C`\-\-enable\-blinking\*(C'\fR. with standard
936	colours. Without \f(CW\*(C`\-\-enable\-blinking\*(C'\fR, the blink attribute will be
937	ignored.
938	.PP
939	On \s-1ANSI\s0 colours, bold/blink attributes are used to set high-intensity
940	foreground/background colors.
941	.PP
942	color0\-7 are the low-intensity colors.
943	.PP
944	color8\-15 are the corresponding high-intensity colors.
945	.Sh "I don't like the screen colors. How do I change them?"
946	.IX Subsection "I don't like the screen colors. How do I change them?"
947	You can change the screen colors at run-time using \fI~/.Xdefaults\fR
948	resources (or as long\-options).
949	.PP
950	Here are values that are supposed to resemble a \s-1VGA\s0 screen,
951	including the murky brown that passes for low-intensity yellow:
952	.PP
953	.Vb 8
954	\& URxvt.color0: #000000
955	\& URxvt.color1: #A80000
956	\& URxvt.color2: #00A800
957	\& URxvt.color3: #A8A800
958	\& URxvt.color4: #0000A8
959	\& URxvt.color5: #A800A8
960	\& URxvt.color6: #00A8A8
961	\& URxvt.color7: #A8A8A8
962	.Ve
963	.PP
964	.Vb 8
965	\& URxvt.color8: #000054
966	\& URxvt.color9: #FF0054
967	\& URxvt.color10: #00FF54
968	\& URxvt.color11: #FFFF54
969	\& URxvt.color12: #0000FF
970	\& URxvt.color13: #FF00FF
971	\& URxvt.color14: #00FFFF
972	\& URxvt.color15: #FFFFFF
973	.Ve
974	.PP
975	And here is a more complete set of non-standard colors described (not by
976	me) as \*(L"pretty girly\*(R".
977	.PP
978	.Vb 18
979	\& URxvt.cursorColor: #dc74d1
980	\& URxvt.pointerColor: #dc74d1
981	\& URxvt.background: #0e0e0e
982	\& URxvt.foreground: #4ad5e1
983	\& URxvt.color0: #000000
984	\& URxvt.color8: #8b8f93
985	\& URxvt.color1: #dc74d1
986	\& URxvt.color9: #dc74d1
987	\& URxvt.color2: #0eb8c7
988	\& URxvt.color10: #0eb8c7
989	\& URxvt.color3: #dfe37e
990	\& URxvt.color11: #dfe37e
991	\& URxvt.color5: #9e88f0
992	\& URxvt.color13: #9e88f0
993	\& URxvt.color6: #73f7ff
994	\& URxvt.color14: #73f7ff
995	\& URxvt.color7: #e1dddd
996	\& URxvt.color15: #e1dddd
997	.Ve
998	.Sh "How can I start @@RXVT_NAME@@d in a race-free way?"
999	.IX Subsection "How can I start @@RXVT_NAME@@d in a race-free way?"
1000	Try \f(CW\*(C`@@RXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@RXVT_NAME@@d to open the
1001	display, create the listening socket and then fork.
1002	.Sh "What's with the strange Backspace/Delete key behaviour?"
1003	.IX Subsection "What's with the strange Backspace/Delete key behaviour?"
1004	Assuming that the physical Backspace key corresponds to the
1005	BackSpace keysym (not likely for Linux ... see the following
1006	question) there are two standard values that can be used for
1007	Backspace: \f(CW\*(C`^H\*(C'\fR and \f(CW\*(C`^?\*(C'\fR.
1008	.PP
1009	Historically, either value is correct, but rxvt-unicode adopts the debian
1010	policy of using \f(CW\*(C`^?\*(C'\fR when unsure, because it's the one only only correct
1011	choice :).
1012	.PP
1013	Rxvt-unicode tries to inherit the current stty settings and uses the value
1014	of `erase' to guess the value for backspace. If rxvt-unicode wasn't
1015	started from a terminal (say, from a menu or by remote shell), then the
1016	system value of `erase', which corresponds to \s-1CERASE\s0 in <termios.h>, will
1017	be used (which may not be the same as your stty setting).
1018	.PP
1019	For starting a new rxvt\-unicode:
1020	.PP
1021	.Vb 3
1022	\& # use Backspace = ^H
1023	\& $ stty erase ^H
1024	\& $ @@RXVT_NAME@@
1025	.Ve
1026	.PP
1027	.Vb 3
1028	\& # use Backspace = ^?
1029	\& $ stty erase ^?
1030	\& $ @@RXVT_NAME@@
1031	.Ve
1032	.PP
1033	Toggle with \f(CW\*(C`ESC [ 36 h\*(C'\fR / \f(CW\*(C`ESC [ 36 l\*(C'\fR.
1034	.PP
1035	For an existing rxvt\-unicode:
1036	.PP
1037	.Vb 3
1038	\& # use Backspace = ^H
1039	\& $ stty erase ^H
1040	\& $ echo -n "^[[36h"
1041	.Ve
1042	.PP
1043	.Vb 3
1044	\& # use Backspace = ^?
1045	\& $ stty erase ^?
1046	\& $ echo -n "^[[36l"
1047	.Ve
1048	.PP
1049	This helps satisfy some of the Backspace discrepancies that occur, but
1050	if you use Backspace = \f(CW\*(C`^H\*(C'\fR, make sure that the termcap/terminfo value
1051	properly reflects that.
1052	.PP
1053	The Delete key is a another casualty of the ill-defined Backspace problem.
1054	To avoid confusion between the Backspace and Delete keys, the Delete
1055	key has been assigned an escape sequence to match the vt100 for Execute
1056	(\f(CW\*(C`ESC [ 3 ~\*(C'\fR) and is in the supplied termcap/terminfo.
1057	.PP
1058	Some other Backspace problems:
1059	.PP
1060	some editors use termcap/terminfo,
1061	some editors (vim I'm told) expect Backspace = ^H,
1062	\&\s-1GNU\s0 Emacs (and Emacs-like editors) use ^H for help.
1063	.PP
1064	Perhaps someday this will all be resolved in a consistent manner.
1065	.Sh "I don't like the key\-bindings. How do I change them?"
1066	.IX Subsection "I don't like the key-bindings. How do I change them?"
1067	There are some compile-time selections available via configure. Unless
1068	you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can
1069	use the `keysym' resource to alter the keystrings associated with keysyms.
1070	.PP
1071	Here's an example for a URxvt session started using \f(CW\*(C`@@RXVT_NAME@@ \-name URxvt\*(C'\fR
1072	.PP
1073	.Vb 20
1074	\& URxvt.keysym.Home: \e033[1~
1075	\& URxvt.keysym.End: \e033[4~
1076	\& URxvt.keysym.C-apostrophe: \e033<C-'>
1077	\& URxvt.keysym.C-slash: \e033<C-/>
1078	\& URxvt.keysym.C-semicolon: \e033<C-;>
1079	\& URxvt.keysym.C-grave: \e033<C-`>
1080	\& URxvt.keysym.C-comma: \e033<C-,>
1081	\& URxvt.keysym.C-period: \e033<C-.>
1082	\& URxvt.keysym.C-0x60: \e033<C-`>
1083	\& URxvt.keysym.C-Tab: \e033<C-Tab>
1084	\& URxvt.keysym.C-Return: \e033<C-Return>
1085	\& URxvt.keysym.S-Return: \e033<S-Return>
1086	\& URxvt.keysym.S-space: \e033<S-Space>
1087	\& URxvt.keysym.M-Up: \e033<M-Up>
1088	\& URxvt.keysym.M-Down: \e033<M-Down>
1089	\& URxvt.keysym.M-Left: \e033<M-Left>
1090	\& URxvt.keysym.M-Right: \e033<M-Right>
1091	\& URxvt.keysym.M-C-0: list \e033<M-C- 0123456789 >
1092	\& URxvt.keysym.M-C-a: list \e033<M-C- abcdefghijklmnopqrstuvwxyz >
1093	\& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007
1094	.Ve
1095	.PP
1096	See some more examples in the documentation for the \fBkeysym\fR resource.
1097	.Sh "I'm using keyboard model \s-1XXX\s0 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."
1098	.IX Subsection "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."
1099	.Vb 6
1100	\& KP_Insert == Insert
1101	\& F22 == Print
1102	\& F27 == Home
1103	\& F29 == Prior
1104	\& F33 == End
1105	\& F35 == Next
1106	.Ve
1107	.PP
1108	Rather than have rxvt-unicode try to accommodate all the various possible
1109	keyboard mappings, it is better to use `xmodmap' to remap the keys as
1110	required for your particular machine.
1111	.Sh "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc."
1112	.IX Subsection "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc."
1113	rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", so you can
1114	check and see if that is set. Note that several programs, \s-1JED\s0, slrn,
1115	Midnight Commander automatically check this variable to decide whether or
1116	not to use color.
1117	.Sh "How do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?"
1118	.IX Subsection "How do I set the correct, full IP address for the DISPLAY variable?"
1119	If you've compiled rxvt-unicode with \s-1DISPLAY_IS_IP\s0 and have enabled
1120	insecure mode then it is possible to use the following shell script
1121	snippets to correctly set the display. If your version of rxvt-unicode
1122	wasn't also compiled with \s-1ESCZ_ANSWER\s0 (as assumed in these snippets) then
1123	the \s-1COLORTERM\s0 variable can be used to distinguish rxvt-unicode from a
1124	regular xterm.
1125	.PP
1126	Courtesy of Chuck Blake <cblake@BBN.COM> with the following shell script
1127	snippets:
1128	.PP
1129	.Vb 12
1130	\& # Bourne/Korn/POSIX family of shells:
1131	\& [ ${TERM:-foo} = foo ] && TERM=xterm # assume an xterm if we don't know
1132	\& if [ ${TERM:-foo} = xterm ]; then
1133	\& stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
1134	\& echo -n '^[Z'
1135	\& read term_id
1136	\& stty icanon echo
1137	\& if [ ""${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
1138	\& echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
1139	\& read DISPLAY # set it in our local shell
1140	\& fi
1141	\& fi
1142	.Ve
1143	.Sh "How do I compile the manual pages for myself?"
1144	.IX Subsection "How do I compile the manual pages for myself?"
1145	You need to have a recent version of perl installed as \fI/usr/bin/perl\fR,
1146	one that comes with \fIpod2man\fR, \fIpod2text\fR and \fIpod2html\fR. Then go to
1147	the doc subdirectory and enter \f(CW\*(C`make alldoc\*(C'\fR.
1148	.Sh "My question isn't answered here, can I ask a human?"
1149	.IX Subsection "My question isn't answered here, can I ask a human?"
1150	Before sending me mail, you could go to \s-1IRC:\s0 \f(CW\*(C`irc.freenode.net\*(C'\fR,
1151	channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be
1152	interested in learning about new and exciting problems (but not FAQs :).
1153	.SH "RXVT TECHNICAL REFERENCE"	1270	.SH "RXVT-UNICODE TECHNICAL REFERENCE"
1154	.IX Header "RXVT TECHNICAL REFERENCE"	1271	.IX Header "RXVT-UNICODE TECHNICAL REFERENCE"
1155	.SH "DESCRIPTION"
1156	.IX Header "DESCRIPTION"
1157	The rest of this document describes various technical aspects of	1272	The rest of this document describes various technical aspects of
1158	\&\fBrxvt-unicode\fR. First the description of supported command sequences,	1273	\&\fBrxvt-unicode\fR. First the description of supported command sequences,
1159	followed by pixmap support and last by a description of all features	1274	followed by pixmap support and last by a description of all features
1160	selectable at \f(CW\*(C`configure\*(C'\fR time.	1275	selectable at \f(CW\*(C`configure\*(C'\fR time.
1161	.SH "Definitions"	1276	.Sh "Definitions"
1162	.IX Header "Definitions"	1277	.IX Subsection "Definitions"
1163	.ie n .IP "\fB\fB""c""\fB\fR" 4	1278	.ie n .IP "\fB\fB""c""\fB\fR" 4
1164	.el .IP "\fB\f(CBc\fB\fR" 4	1279	.el .IP "\fB\f(CBc\fB\fR" 4
1165	.IX Item "c"	1280	.IX Item "c"
1166	The literal character c.	1281	The literal character c.
1167	.ie n .IP "\fB\fB""C""\fB\fR" 4	1282	.ie n .IP "\fB\fB""C""\fB\fR" 4
…		…
1180	parameters, separated by \f(CW\*(C`;\*(C'\fR character(s).	1295	parameters, separated by \f(CW\*(C`;\*(C'\fR character(s).
1181	.ie n .IP "\fB\fB""Pt""\fB\fR" 4	1296	.ie n .IP "\fB\fB""Pt""\fB\fR" 4
1182	.el .IP "\fB\f(CBPt\fB\fR" 4	1297	.el .IP "\fB\f(CBPt\fB\fR" 4
1183	.IX Item "Pt"	1298	.IX Item "Pt"
1184	A text parameter composed of printable characters.	1299	A text parameter composed of printable characters.
1185	.SH "Values"	1300	.Sh "Values"
1186	.IX Header "Values"	1301	.IX Subsection "Values"
1187	.ie n .IP "\fB\fB""ENQ""\fB\fR" 4	1302	.ie n .IP "\fB\fB""ENQ""\fB\fR" 4
1188	.el .IP "\fB\f(CBENQ\fB\fR" 4	1303	.el .IP "\fB\f(CBENQ\fB\fR" 4
1189	.IX Item "ENQ"	1304	.IX Item "ENQ"
1190	Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0)	1305	Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0)
1191	request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR.	1306	request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR.
…		…
1229	Switch to Standard Character Set	1344	Switch to Standard Character Set
1230	.ie n .IP "\fB\fB""SPC""\fB\fR" 4	1345	.ie n .IP "\fB\fB""SPC""\fB\fR" 4
1231	.el .IP "\fB\f(CBSPC\fB\fR" 4	1346	.el .IP "\fB\f(CBSPC\fB\fR" 4
1232	.IX Item "SPC"	1347	.IX Item "SPC"
1233	Space Character	1348	Space Character
1234	.SH "Escape Sequences"	1349	.Sh "Escape Sequences"
1235	.IX Header "Escape Sequences"	1350	.IX Subsection "Escape Sequences"
1236	.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4	1351	.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4
1237	.el .IP "\fB\f(CBESC # 8\fB\fR" 4	1352	.el .IP "\fB\f(CBESC # 8\fB\fR" 4
1238	.IX Item "ESC # 8"	1353	.IX Item "ESC # 8"
1239	\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)	1354	\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)
1240	.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4	1355	.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4
…		…
1333	.TE	1448	.TE
1334		1449
1335	.PP	1450	.PP
1336		1451
1337	.IX Xref "CSI"	1452	.IX Xref "CSI"
1338	.SH "CSI (Command Sequence Introducer) Sequences"	1453	.Sh "\s-1CSI\s0 (Command Sequence Introducer) Sequences"
1339	.IX Header "CSI (Command Sequence Introducer) Sequences"	1454	.IX Subsection "CSI (Command Sequence Introducer) Sequences"
1340	.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4	1455	.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4
1341	.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4	1456	.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4
1342	.IX Item "ESC [ Ps @"	1457	.IX Item "ESC [ Ps @"
1343	Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)	1458	Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)
1344	.IX Xref "ESCOBPsA"	1459	.IX Xref "ESCOBPsA"
…		…
1607	.IX Item "ESC [ Ps x"	1722	.IX Item "ESC [ Ps x"
1608	Request Terminal Parameters (\s-1DECREQTPARM\s0)	1723	Request Terminal Parameters (\s-1DECREQTPARM\s0)
1609	.PP	1724	.PP
1610		1725
1611	.IX Xref "PrivateModes"	1726	.IX Xref "PrivateModes"
1612	.SH "DEC Private Modes"	1727	.Sh "\s-1DEC\s0 Private Modes"
1613	.IX Header "DEC Private Modes"	1728	.IX Subsection "DEC Private Modes"
1614	.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4	1729	.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4
1615	.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4	1730	.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4
1616	.IX Item "ESC [ ? Pm h"	1731	.IX Item "ESC [ ? Pm h"
1617	\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)	1732	\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)
1618	.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4	1733	.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4
…		…
1885	.RE	2000	.RE
1886	.PD	2001	.PD
1887	.PP	2002	.PP
1888		2003
1889	.IX Xref "XTerm"	2004	.IX Xref "XTerm"
1890	.SH "XTerm Operating System Commands"	2005	.Sh "XTerm Operating System Commands"
1891	.IX Header "XTerm Operating System Commands"	2006	.IX Subsection "XTerm Operating System Commands"
1892	.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4	2007	.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4
1893	.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4	2008	.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4
1894	.IX Item "ESC ] Ps;Pt ST"	2009	.IX Item "ESC ] Ps;Pt ST"
1895	Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,	2010	Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,
1896	0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any	2011	0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any
…		…
1928	Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).	2043	Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1929	Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).	2044	Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1930	Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).	2045	Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
1931	.TE	2046	.TE
1932		2047
1933	.PP
1934
1935	.IX Xref "XPM"
1936	.SH "XPM"	2048	.SH "XPM"
1937	.IX Header "XPM"	2049	.IX Header "XPM"
1938	For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value	2050	For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value
1939	of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a	2051	of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a
1940	sequence of scaling/positioning commands separated by semi\-colons. The	2052	sequence of scaling/positioning commands separated by semi\-colons. The
…		…
2010	.TS	2122	.TS
2011	l l .	2123	l l .
2012	4 Shift	2124	4 Shift
2013	8 Meta	2125	8 Meta
2014	16 Control	2126	16 Control
2015	32 Double Click (Rxvt extension)	2127	32 Double Click (rxvt extension)
2016	.TE	2128	.TE
2017		2129
2018	Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR	2130	Col = \fB\f(CB\*(C`<x> \- SPACE\*(C'\fB\fR
2019	.Sp	2131	.Sp
2020	Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR	2132	Row = \fB\f(CB\*(C`<y> \- SPACE\*(C'\fB\fR

Diff Legend

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