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.59 by root, Tue Jan 31 00:57:35 2006 UTC vs.
Revision 1.72 by root, Thu Feb 2 18:04:45 2006 UTC

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

Diff Legend

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