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.5 by root, Thu Feb 3 10:24:10 2005 UTC vs.
Revision 1.47 by root, Mon Jan 16 15:07:27 2006 UTC

…		…
36	. ds PI pi	36	. ds PI pi
37	. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch	37	. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38	. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch	38	. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
39	. ds L" ""	39	. ds L" ""
40	. ds R" ""	40	. ds R" ""
41	. ds C`	41	. ds C` ""
42	. ds C'	42	. ds C' ""
43	'br\}	43	'br\}
44	.el\{\	44	.el\{\
45	. ds -- \|\(em\|	45	. ds -- \|\(em\|
46	. ds PI \(*p	46	. ds PI \(*p
47	. ds L" ``	47	. ds L" ``
…		…
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 "2005-02-03" "4.9" "RXVT-UNICODE"	132	.TH rxvt 7 "2006-01-16" "7.0" "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"
		136	.IX Header "SYNOPSIS"
		137	.Vb 2
		138	\& # set a new font set
		139	\& printf '\e33]50;%s\e007' 9x15,xft:Kochi" Mincho"
		140	.Ve
		141	.PP
		142	.Vb 2
		143	\& # change the locale and tell rxvt-unicode about it
		144	\& export LC_CTYPE=ja_JP.EUC-JP; printf "\e33]701;$LC_CTYPE\e007"
		145	.Ve
		146	.PP
		147	.Vb 2
		148	\& # set window title
		149	\& printf '\e33]2;%s\e007' "new window title"
		150	.Ve
		151	.SH "DESCRIPTION"
		152	.IX Header "DESCRIPTION"
		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.
		155	.PP
		156	The newest version of this document is
		157	also available on the World Wide Web at
		158	<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>.
135	.SH "FREQUENTLY ASKED QUESTIONS"	159	.SH "FREQUENTLY ASKED QUESTIONS"
136	.IX Header "FREQUENTLY ASKED QUESTIONS"	160	.IX Header "FREQUENTLY ASKED QUESTIONS"
		161	.IP "The new selection selects pieces that are too big, how can I select single words?" 4
		162	.IX Item "The new selection selects pieces that are too big, how can I select single words?"
		163	Yes. For example, if you want to select alphanumeric words, you can use
		164	the following resource:
		165	.Sp
		166	.Vb 1
		167	\& URxvt.selection.pattern-0: ([[:word:]]+)
		168	.Ve
		169	.Sp
		170	If you click more than twice, the selection will be extended
		171	more and more.
		172	.Sp
		173	To get a selection that is very similar to the old code, try this pattern:
		174	.Sp
		175	.Vb 1
		176	\& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+)
		177	.Ve
		178	.Sp
		179	Please also note that the \fILeftClick Shift-LeftClik\fR combination also
		180	selects words like the old code.
		181	.IP "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?" 4
		182	.IX Item "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?"
		183	You can disable the perl extension completely by setting the
		184	\&\fBperl-ext-common\fR resource to the empty string, which also keeps
		185	rxvt-unicode from initialising perl, saving memory.
		186	.Sp
		187	If you only want to disable specific features, you first have to
		188	identify which perl extension is responsible. For this, read the section
		189	\&\fB\s-1PREPACKAGED\s0 \s-1EXTENSIONS\s0\fR in the @@RXVT_NAME@@\fIperl\fR\|(3) manpage. For
		190	example, to disable the \fBselection-popup\fR and \fBoption-popup\fR, specify
		191	this \fBperl-ext-common\fR resource:
		192	.Sp
		193	.Vb 1
		194	\& URxvt.perl-ext-common: default,-selection-popup,-option-popup
		195	.Ve
		196	.Sp
		197	This will keep the default extensions, but disable the two popup
		198	extensions. Some extensions can also be configured, for example,
		199	scrollback search mode is triggered by \fBM\-s\fR. You can move it to any
		200	other combination either by setting the \fBsearchable-scrollback\fR resource:
		201	.Sp
		202	.Vb 1
		203	\& URxvt.searchable-scrollback: CM-s
		204	.Ve
		205	.IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4
		206	.IX Item "Isn't rxvt supposed to be small? Don't all those features bloat?"
		207	I often get asked about this, and I think, no, they didn't cause extra
		208	bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
		209	that the urxvt binary is larger (due to some encoding tables always being
		210	compiled in), but it actually uses less memory (\s-1RSS\s0) after startup. Even
		211	with \f(CW\*(C`\-\-disable\-everything\*(C'\fR, this comparison is a bit unfair, as many
		212	features unique to urxvt (locale, encoding conversion, iso14755 etc.) are
		213	already in use in this mode.
		214	.Sp
		215	.Vb 3
		216	\& text data bss drs rss filename
		217	\& 98398 1664 24 15695 1824 rxvt --disable-everything
		218	\& 188985 9048 66616 18222 1788 urxvt --disable-everything
		219	.Ve
		220	.Sp
		221	When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which _is_ unfair, as this involves xft
		222	and full locale/XIM support which are quite bloaty inside libX11 and my
		223	libc), the two diverge, but not unreasnobaly so.
		224	.Sp
		225	.Vb 3
		226	\& text data bss drs rss filename
		227	\& 163431 2152 24 20123 2060 rxvt --enable-everything
		228	\& 1035683 49680 66648 29096 3680 urxvt --enable-everything
		229	.Ve
		230	.Sp
		231	The very large size of the text section is explained by the east-asian
		232	encoding tables, which, if unused, take up disk space but nothing else
		233	and can be compiled out unless you rely on X11 core fonts that use those
		234	encodings. The \s-1BSS\s0 size comes from the 64k emergency buffer that my c++
		235	compiler allocates (but of course doesn't use unless you are out of
		236	memory). Also, using an xft font instead of a core font immediately adds a
		237	few megabytes of \s-1RSS\s0. Xft indeed is responsible for a lot of \s-1RSS\s0 even when
		238	not used.
		239	.Sp
		240	Of course, due to every character using two or four bytes instead of one,
		241	a large scrollback buffer will ultimately make rxvt-unicode use more
		242	memory.
		243	.Sp
		244	Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this
		245	still fares rather well. And compared to some monsters like gnome-terminal
		246	(21152k + extra 4204k in separate processes) or konsole (22200k + extra
		247	43180k in daemons that stay around after exit, plus half a minute of
		248	startup time, including the hundreds of warnings it spits out), it fares
		249	extremely well *g*.
		250	.IP "Why \*(C+, isn't that unportable/bloated/uncool?" 4
		251	.IX Item "Why , isn't that unportable/bloated/uncool?"
		252	Is this a question? :) It comes up very often. The simple answer is: I had
		253	to write it, and \*(C+ allowed me to write and maintain it in a fraction
		254	of the time and effort (which is a scarce resource for me). Put even
		255	shorter: It simply wouldn't exist without \*(C+.
		256	.Sp
		257	My personal stance on this is that \*(C+ is less portable than C, but in
		258	the case of rxvt-unicode this hardly matters, as its portability limits
		259	are defined by things like X11, pseudo terminals, locale support and unix
		260	domain sockets, which are all less portable than \*(C+ itself.
		261	.Sp
		262	Regarding the bloat, see the above question: It's easy to write programs
		263	in C that use gobs of memory, an certainly possible to write programs in
		264	\&\*(C+ that don't. \*(C+ also often comes with large libraries, but this is
		265	not necessarily the case with \s-1GCC\s0. Here is what rxvt links against on my
		266	system with a minimal config:
		267	.Sp
		268	.Vb 4
		269	\& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
		270	\& libc.so.6 => /lib/libc.so.6 (0x00002aaaaadde000)
		271	\& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab01d000)
		272	\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
		273	.Ve
		274	.Sp
		275	And here is rxvt\-unicode:
		276	.Sp
		277	.Vb 5
		278	\& libX11.so.6 => /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
		279	\& libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
		280	\& libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)
		281	\& libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)
		282	\& /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
		283	.Ve
		284	.Sp
		285	No large bloated libraries (of course, none were linked in statically),
		286	except maybe libX11 :)
		287	.IP "Does it support tabs, can I have a tabbed rxvt\-unicode?" 4
		288	.IX Item "Does it support tabs, can I have a tabbed rxvt-unicode?"
		289	rxvt-unicode does not directly support tabs. It will work fine with
		290	tabbing functionality of many window managers or similar tabbing programs,
		291	and its embedding-features allow it to be embedded into other programs,
		292	as witnessed by \fIdoc/rxvt\-tabbed\fR or the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl
		293	module, which features a tabbed urxvt (murxvt) terminal as an example
		294	embedding application.
137	.IP "How do I know which rxvt-unicode version I'm using?" 4	295	.IP "How do I know which rxvt-unicode version I'm using?" 4
138	.IX Item "How do I know which rxvt-unicode version I'm using?"	296	.IX Item "How do I know which rxvt-unicode version I'm using?"
139	The version number is displayed with the usage (\-h). Also the escape	297	The version number is displayed with the usage (\-h). Also the escape
140	sequence \f(CW\*(C`ESC[8n\*(C'\fR sets the window title to the version number.	298	sequence \f(CW\*(C`ESC [ 8 n\*(C'\fR sets the window title to the version number. When
		299	using the @@RXVT_NAME@@c client, the version displayed is that of the
		300	daemon.
		301	.IP "I am using Debian GNU/Linux and have a problem..." 4
		302	.IX Item "I am using Debian GNU/Linux and have a problem..."
		303	The Debian GNU/Linux package of rxvt-unicode in sarge contains large
		304	patches that considerably change the behaviour of rxvt\-unicode. Before
		305	reporting a bug to the original rxvt-unicode author please download and
		306	install the genuine version (<http://software.schmorp.de#rxvt\-unicode>)
		307	and try to reproduce the problem. If you cannot, chances are that the
		308	problems are specific to Debian GNU/Linux, in which case it should be
		309	reported via the Debian Bug Tracking System (use \f(CW\*(C`reportbug\*(C'\fR to report
		310	the bug).
		311	.Sp
		312	For other problems that also affect the Debian package, you can and
		313	probably should use the Debian \s-1BTS\s0, too, because, after all, it's also a
		314	bug in the Debian version and it serves as a reminder for other users that
		315	might encounter the same issue.
		316	.IP "I am maintaining rxvt-unicode for distribution/OS \s-1XXX\s0, any recommendation?" 4
		317	.IX Item "I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?"
		318	You should build one binary with the default options. \fIconfigure\fR
		319	now enables most useful options, and the trend goes to making them
		320	runtime\-switchable, too, so there is usually no drawback to enbaling them,
		321	except higher disk and possibly memory usage. The perl interpreter should
		322	be enabled, as important functionality (menus, selection, likely more in
		323	the future) depends on it.
		324	.Sp
		325	You should not overwrite the \f(CW\*(C`perl\-ext\-common\*(C'\fR snd \f(CW\*(C`perl\-ext\*(C'\fR resources
		326	system-wide (except maybe with \f(CW\*(C`defaults\*(C'\fR). This will result in useful
		327	behaviour. If your distribution aims at low memory, add an empty
		328	\&\f(CW\*(C`perl\-ext\-common\*(C'\fR resource to the app-defaults file. This will keep the
		329	perl interpreter disabled until the user enables it.
		330	.Sp
		331	If you can/want build more binaries, I recommend building a minimal
		332	one with \f(CW\*(C`\-\-disable\-everything\*(C'\fR (very useful) and a maximal one with
		333	\&\f(CW\*(C`\-\-enable\-everything\*(C'\fR (less useful, it will be very big due to a lot of
		334	encodings built-in that increase download times and are rarely used).
		335	.IP "I need to make it setuid/setgid to support utmp/ptys on my \s-1OS\s0, is this safe?" 4
		336	.IX Item "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?"
		337	Likely not. While I honestly try to make it secure, and am probably not
		338	bad at it, I think it is simply unreasonable to expect all of freetype
		339	+ fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be
		340	secure. Also, rxvt-unicode disables some options when it detects that it
		341	runs setuid or setgid, which is not nice. Besides, with the embedded perl
		342	interpreter the possibility for security problems easily multiplies.
		343	.Sp
		344	Elevated privileges are only required for utmp and pty operations on some
		345	systems (for example, GNU/Linux doesn't need any extra privileges for
		346	ptys, but some need it for utmp support). It is planned to mvoe this into
		347	a forked handler process, but this is not yet done.
		348	.Sp
		349	So, while setuid/setgid operation is supported and not a problem on your
		350	typical single-user-no-other-logins unix desktop, always remember that
		351	its an awful lot of code, most of which isn't checked for security issues
		352	regularly.
141	.IP "When I log-in to another system it tells me about missing terminfo data?" 4	353	.IP "When I log-in to another system it tells me about missing terminfo data?" 4
142	.IX Item "When I log-in to another system it tells me about missing terminfo data?"	354	.IX Item "When I log-in to another system it tells me about missing terminfo data?"
143	The terminal description used by rxvt-unicode is not as widely available	355	The terminal description used by rxvt-unicode is not as widely available
144	as that for xterm, or even rxvt (for which the same problem often arises).	356	as that for xterm, or even rxvt (for which the same problem often arises).
145	.Sp	357	.Sp
…		…
157	\&\f(CW\*(C`TERM=rxvt\*(C'\fR or even \f(CW\*(C`TERM=xterm\*(C'\fR, and live with the small number of	369	\&\f(CW\*(C`TERM=rxvt\*(C'\fR or even \f(CW\*(C`TERM=xterm\*(C'\fR, and live with the small number of
158	problems arising, which includes wrong keymapping, less and different	370	problems arising, which includes wrong keymapping, less and different
159	colours and some refresh errors in fullscreen applications. It's a nice	371	colours and some refresh errors in fullscreen applications. It's a nice
160	quick-and-dirty workaround for rare cases, though.	372	quick-and-dirty workaround for rare cases, though.
161	.Sp	373	.Sp
162	If you always want to do this you can either recompile rxvt-unicode with	374	If you always want to do this (and are fine with the consequences) you
163	the desired \s-1TERM\s0 value or use a resource to set it:	375	can either recompile rxvt-unicode with the desired \s-1TERM\s0 value or use a
		376	resource to set it:
164	.Sp	377	.Sp
165	.Vb 1	378	.Vb 1
166	\& URxvt.termName: rxvt	379	\& URxvt.termName: rxvt
167	.Ve	380	.Ve
168	.Sp	381	.Sp
169	If you don't plan to use \fBrxvt\fR (quite common...) you could also replace	382	If you don't plan to use \fBrxvt\fR (quite common...) you could also replace
170	the rxvt terminfo file with the rxvt-unicode one.	383	the rxvt terminfo file with the rxvt-unicode one.
		384	.ie n .IP """tic"" outputs some error when compiling the terminfo entry." 4
		385	.el .IP "\f(CWtic\fR outputs some error when compiling the terminfo entry." 4
		386	.IX Item "tic outputs some error when compiling the terminfo entry."
		387	Most likely it's the empty definition for \f(CW\*(C`enacs=\*(C'\fR. Just replace it by
		388	\&\f(CW\*(C`enacs=\eE[0@\*(C'\fR and try again.
		389	.ie n .IP """bash""'s readline does not work correctly under @@RXVT_NAME@@." 4
		390	.el .IP "\f(CWbash\fR's readline does not work correctly under @@RXVT_NAME@@." 4
		391	.IX Item "bash's readline does not work correctly under @@RXVT_NAME@@."
		392	.PD 0
171	.IP "I need a termcap file entry." 4	393	.IP "I need a termcap file entry." 4
172	.IX Item "I need a termcap file entry."	394	.IX Item "I need a termcap file entry."
		395	.PD
		396	One reason you might want this is that some distributions or operating
		397	systems still compile some programs using the long-obsoleted termcap
		398	library (Fedora Core's bash is one example) and rely on a termcap entry
		399	for \f(CW\*(C`rxvt\-unicode\*(C'\fR.
		400	.Sp
173	You could use rxvt's termcap entry with resonable results in many cases.	401	You could use rxvt's termcap entry with resonable results in many cases.
174	You can also create a termcap entry by using terminfo's infocmp program	402	You can also create a termcap entry by using terminfo's infocmp program
175	like this:	403	like this:
176	.Sp	404	.Sp
177	.Vb 1	405	.Vb 1
178	\& infocmp -C rxvt-unicode	406	\& infocmp -C rxvt-unicode
179	.Ve	407	.Ve
180	.Sp	408	.Sp
181	\&\s-1OR\s0 you could this termcap entry:	409	Or you could use this termcap entry, generated by the command above:
182	.Sp	410	.Sp
183	.Vb 19	411	.Vb 20
184	\& rxvt-unicode|rxvt-unicode terminal (X Window System):\e	412	\& rxvt-unicode|rxvt-unicode terminal (X Window System):\e
185	\& :am:bw:eo:km:mi:ms:xn:xo:\e	413	\& :am:bw:eo:km:mi:ms:xn:xo:\e
186	\& :co#80:it#8:li#24:\e	414	\& :co#80:it#8:li#24:lm#0:\e
187	\& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e	415	\& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e
188	\& :K1=\eEOw:K2=\eEOu:K3=\eEOy:K4=\eEOq:K5=\eEOs:LE=\eE[%dD:\e	416	\& :K1=\eEOw:K2=\eEOu:K3=\eEOy:K4=\eEOq:K5=\eEOs:LE=\eE[%dD:\e
189	\& :RI=\eE[%dC:SF=\eE[%dS:SR=\eE[%dT:UP=\eE[%dA:ae=^O:al=\eE[L:\e	417	\& :RI=\eE[%dC:SF=\eE[%dS:SR=\eE[%dT:UP=\eE[%dA:ae=\eE(B:al=\eE[L:\e
190	\& :as=^N:bl=^G:cd=\eE[J:ce=\eE[K:cl=\eE[H\eE[2J:cm=\eE[%i%d;%dH:\e	418	\& :as=\eE(0:bl=^G:cd=\eE[J:ce=\eE[K:cl=\eE[H\eE[2J:\e
191	\& :cr=^M:cs=\eE[%i%d;%dr:ct=\eE[3g:dc=\eE[P:dl=\eE[M:do=^J:\e	419	\& :cm=\eE[%i%d;%dH:cr=^M:cs=\eE[%i%d;%dr:ct=\eE[3g:dc=\eE[P:\e
192	\& :ec=\eE[%dX:ei=\eE[4l:ho=\eE[H:i1=\eE[?47l\eE=\eE[?1l:ic=\eE[@:\e	420	\& :dl=\eE[M:do=^J:ec=\eE[%dX:ei=\eE[4l:ho=\eE[H:\e
		421	\& :i1=\eE[?47l\eE=\eE[?1l:ic=\eE[@:im=\eE[4h:\e
193	\& :im=\eE[4h:is=\eE[r\eE[m\eE[2J\eE[H\eE[?7h\eE[?1;3;4;6l\eE[4l:\e	422	\& :is=\eE[r\eE[m\eE[2J\eE[H\eE[?7h\eE[?1;3;4;6l\eE[4l:\e
194	\& :k0=\eE[21~:k1=\eE[11~:k2=\eE[12~:k3=\eE[13~:k4=\eE[14~:\e	423	\& :k1=\eE[11~:k2=\eE[12~:k3=\eE[13~:k4=\eE[14~:k5=\eE[15~:\e
195	\& :k5=\eE[15~:k6=\eE[17~:k7=\eE[18~:k8=\eE[19~:k9=\eE[20~:\e	424	\& :k6=\eE[17~:k7=\eE[18~:k8=\eE[19~:k9=\eE[20~:kD=\eE[3~:\e
196	\& :kD=\eE[3~:kI=\eE[2~:kN=\eE[6~:kP=\eE[5~:kb=\e177:kd=\eEOB:\e	425	\& :kI=\eE[2~:kN=\eE[6~:kP=\eE[5~:kb=\e177:kd=\eEOB:ke=\eE[?1l\eE>:\e
197	\& :ke=\eE[?1l\eE>:kh=\eE[7~:kl=\eEOD:kr=\eEOC:ks=\eE[?1h\eE=:\e	426	\& :kh=\eE[7~:kl=\eEOD:kr=\eEOC:ks=\eE[?1h\eE=:ku=\eEOA:le=^H:\e
198	\& :ku=\eEOA:le=^H:mb=\eE[5m:md=\eE[1m:me=\eE[m\e017:mr=\eE[7m:\e	427	\& :mb=\eE[5m:md=\eE[1m:me=\eE[m\e017:mr=\eE[7m:nd=\eE[C:rc=\eE8:\e
199	\& :nd=\eE[C:rc=\eE8:sc=\eE7:se=\eE[27m:sf=^J:so=\eE[7m:sr=\eEM:\e	428	\& :sc=\eE7:se=\eE[27m:sf=^J:so=\eE[7m:sr=\eEM:st=\eEH:ta=^I:\e
200	\& :st=\eEH:ta=^I:te=\eE[r\eE[?1049l:ti=\eE[?1049h:ue=\eE[24m:\e	429	\& :te=\eE[r\eE[?1049l:ti=\eE[?1049h:ue=\eE[24m:up=\eE[A:\e
201	\& :up=\eE[A:us=\eE[4m:vb=\eE[?5h\eE[?5l:ve=\eE[?25h:vi=\eE[?25l:\e	430	\& :us=\eE[4m:vb=\eE[?5h\eE[?5l:ve=\eE[?25h:vi=\eE[?25l:\e
202	\& :vs=\eE[?25h:	431	\& :vs=\eE[?25h:
203	.Ve	432	.Ve
204	.ie n .IP "Why does \*(C`ls\*(C' no longer have coloured output?" 4	433	.ie n .IP "Why does ""ls"" no longer have coloured output?" 4
205	.el .IP "Why does \f(CW\*(C`ls\*(C'\fR no longer have coloured output?" 4	434	.el .IP "Why does \f(CWls\fR no longer have coloured output?" 4
206	.IX Item "Why does ls no longer have coloured output?"	435	.IX Item "Why does ls no longer have coloured output?"
207	The \f(CW\*(C`ls\*(C'\fR in the \s-1GNU\s0 coreutils unfortunately doesn't use terminfo to	436	The \f(CW\*(C`ls\*(C'\fR in the \s-1GNU\s0 coreutils unfortunately doesn't use terminfo to
208	decide wether a terminal has colour, but uses it's own configuration	437	decide wether a terminal has colour, but uses it's own configuration
209	file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in it's default file (among	438	file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in it's default file (among
210	with most other terminals supporting colour). Either add:	439	with most other terminals supporting colour). Either add:
…		…
234	features. Unfortunately, some of these (most notably, again, Debian	463	features. Unfortunately, some of these (most notably, again, Debian
235	GNU/Linux) furthermore fail to even install the \f(CW\*(C`rxvt\-unicode\*(C'\fR terminfo	464	GNU/Linux) furthermore fail to even install the \f(CW\*(C`rxvt\-unicode\*(C'\fR terminfo
236	file, so you will need to install it on your own (See the question \fBWhen	465	file, so you will need to install it on your own (See the question \fBWhen
237	I log-in to another system it tells me about missing terminfo data?\fR on	466	I log-in to another system it tells me about missing terminfo data?\fR on
238	how to do this).	467	how to do this).
		468	.IP "My numerical keypad acts weird and generates differing output?" 4
		469	.IX Item "My numerical keypad acts weird and generates differing output?"
		470	Some Debian GNUL/Linux users seem to have this problem, although no
		471	specific details were reported so far. It is possible that this is caused
		472	by the wrong \f(CW\*(C`TERM\*(C'\fR setting, although the details of wether and how
		473	this can happen are unknown, as \f(CW\*(C`TERM=rxvt\*(C'\fR should offer a compatible
		474	keymap. See the answer to the previous question, and please report if that
		475	helped.
239	.IP "Rxvt-unicode does not seem to understand the selected encoding?" 4	476	.IP "Rxvt-unicode does not seem to understand the selected encoding?" 4
240	.IX Item "Rxvt-unicode does not seem to understand the selected encoding?"	477	.IX Item "Rxvt-unicode does not seem to understand the selected encoding?"
241	.PD 0	478	.PD 0
242	.IP "Unicode does not seem to work?" 4	479	.IP "Unicode does not seem to work?" 4
243	.IX Item "Unicode does not seem to work?"	480	.IX Item "Unicode does not seem to work?"
…		…
247	subtly garbled, then you should check your locale settings.	484	subtly garbled, then you should check your locale settings.
248	.Sp	485	.Sp
249	Rxvt-unicode must be started with the same \f(CW\*(C`LC_CTYPE\*(C'\fR setting as the	486	Rxvt-unicode must be started with the same \f(CW\*(C`LC_CTYPE\*(C'\fR setting as the
250	programs. Often rxvt-unicode is started in the \f(CW\*(C`C\*(C'\fR locale, while the	487	programs. Often rxvt-unicode is started in the \f(CW\*(C`C\*(C'\fR locale, while the
251	login script running within the rxvt-unicode window changes the locale to	488	login script running within the rxvt-unicode window changes the locale to
252	sth. else, e.h. \f(CW\*(C`en_GB.UTF\-8\*(C'\fR. Needless to say, this is not going to work.	489	something else, e.g. \f(CW\*(C`en_GB.UTF\-8\*(C'\fR. Needless to say, this is not going to work.
253	.Sp	490	.Sp
254	The best thing is to fix your startup environment, as you will likely run	491	The best thing is to fix your startup environment, as you will likely run
255	into other problems. If nothing works you can try this in your .profile.	492	into other problems. If nothing works you can try this in your .profile.
256	.Sp	493	.Sp
257	.Vb 1	494	.Vb 1
258	\& printf '\ee]701;%s\e007' "$LC_CTYPE"	495	\& printf '\ee]701;%s\e007' "$LC_CTYPE"
259	.Ve	496	.Ve
260	.Sp	497	.Sp
261	If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not	498	If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not
262	supported on your systems. Some systems have a \f(CW\*(C`locale\*(C'\fR command which	499	supported on your systems. Some systems have a \f(CW\*(C`locale\*(C'\fR command which
263	displays this. If it displays sth. like:	500	displays this (also, \f(CW\*(C`perl \-e0\*(C'\fR can be used to check locale settings, as
		501	it will complain loudly if it cannot set the locale). If it displays something
		502	like:
264	.Sp	503	.Sp
265	.Vb 1	504	.Vb 1
266	\& locale: Cannot set LC_CTYPE to default locale: ...	505	\& locale: Cannot set LC_CTYPE to default locale: ...
267	.Ve	506	.Ve
268	.Sp	507	.Sp
…		…
282	your system/os) have specified does not cover all the characters you want	521	your system/os) have specified does not cover all the characters you want
283	to display.	522	to display.
284	.Sp	523	.Sp
285	\&\fBrxvt-unicode\fR makes a best-effort try at finding a replacement	524	\&\fBrxvt-unicode\fR makes a best-effort try at finding a replacement
286	font. Often the result is fine, but sometimes the chosen font looks	525	font. Often the result is fine, but sometimes the chosen font looks
287	bad. Many fonts have totally strange characters that don't resemble the	526	bad/ugly/wrong. Some fonts have totally strange characters that don't
288	correct glyph at all, and rxvt-unicode lacks the artificial intelligence	527	resemble the correct glyph at all, and rxvt-unicode lacks the artificial
289	to detect that a specific glyph is wrong: it has to believe the font that	528	intelligence to detect that a specific glyph is wrong: it has to believe
290	the characters it contains indeed look correct.	529	the font that the characters it claims to contain indeed look correct.
291	.Sp	530	.Sp
292	In that case, select a font of your taste and add it to the font list,	531	In that case, select a font of your taste and add it to the font list,
293	e.g.:	532	e.g.:
294	.Sp	533	.Sp
295	.Vb 1	534	.Vb 1
…		…
299	When rxvt-unicode sees a character, it will first look at the base	538	When rxvt-unicode sees a character, it will first look at the base
300	font. If the base font does not contain the character, it will go to the	539	font. If the base font does not contain the character, it will go to the
301	next font, and so on. Specifying your own fonts will also speed up this	540	next font, and so on. Specifying your own fonts will also speed up this
302	search and use less resources within rxvt-unicode and the X\-server.	541	search and use less resources within rxvt-unicode and the X\-server.
303	.Sp	542	.Sp
304	The only limitation is that all the fonts must not be larger than the base	543	The only limitation is that none of the fonts may be larger than the base
305	font, as the base font defines the principal cell size, which must be the	544	font, as the base font defines the terminal character cell size, which
306	same due to the way terminals work.	545	must be the same due to the way terminals work.
307	.IP "Why do some chinese characters look so different than others?" 4	546	.IP "Why do some chinese characters look so different than others?" 4
308	.IX Item "Why do some chinese characters look so different than others?"	547	.IX Item "Why do some chinese characters look so different than others?"
309	This is because there is a difference between script and language \*(--	548	This is because there is a difference between script and language \*(--
310	rxvt-unicode does not know which language the text that is output	549	rxvt-unicode does not know which language the text that is output is,
311	is, as it only knows the unicode character codes. If rxvt-unicode	550	as it only knows the unicode character codes. If rxvt-unicode first
312	first sees a japanese character, it might choose a japanese font for	551	sees a japanese/chinese character, it might choose a japanese font for
313	it. Subsequent japanese characters will take that font. Now, many chinese	552	display. Subsequent japanese characters will use that font. Now, many
314	characters aren't represented in japanese fonts, so when the first	553	chinese characters aren't represented in japanese fonts, so when the first
315	non-japanese character comes up, rxvt-unicode will look for a chinese font	554	non-japanese character comes up, rxvt-unicode will look for a chinese font
316	\&\*(-- unfortunately at this point, it will still use the japanese font for	555	\&\*(-- unfortunately at this point, it will still use the japanese font for
317	japanese characters that are also chinese.	556	chinese characters that are also in the japanese font.
318	.Sp	557	.Sp
319	The workaround is easy: just tag a chinese font at the end of your font	558	The workaround is easy: just tag a chinese font at the end of your font
320	list (see the previous question). The key is to view the font list as	559	list (see the previous question). The key is to view the font list as
321	a preference list: If you expect more japanese, list a japanese font	560	a preference list: If you expect more japanese, list a japanese font
322	first. If you expect more chinese, put a chinese font first.	561	first. If you expect more chinese, put a chinese font first.
323	.Sp	562	.Sp
324	In the future it might be possible to switch preferences at runtime (the	563	In the future it might be possible to switch language preferences at
325	internal data structure has no problem with using different fonts for	564	runtime (the internal data structure has no problem with using different
326	the same character at the same time, but no interface for this has been	565	fonts for the same character at the same time, but no interface for this
327	designed yet).	566	has been designed yet).
		567	.Sp
		568	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).
328	.IP "Why does rxvt-unicode sometimes leave pixel droppings?" 4	569	.IP "Why does rxvt-unicode sometimes leave pixel droppings?" 4
329	.IX Item "Why does rxvt-unicode sometimes leave pixel droppings?"	570	.IX Item "Why does rxvt-unicode sometimes leave pixel droppings?"
330	Most fonts were not designed for terminal use, which means that character	571	Most fonts were not designed for terminal use, which means that character
331	size varies a lot. A font that is otherwise fine for terminal use might	572	size varies a lot. A font that is otherwise fine for terminal use might
332	contain some characters that are simply too wide. Rxvt-unicode will avoid	573	contain some characters that are simply too wide. Rxvt-unicode will avoid
…		…
344	the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you	585	the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you
345	might be forced to use a different font.	586	might be forced to use a different font.
346	.Sp	587	.Sp
347	All of this is not a problem when using X11 core fonts, as their bounding	588	All of this is not a problem when using X11 core fonts, as their bounding
348	box data is correct.	589	box data is correct.
		590	.IP "On Solaris 9, many line-drawing characters are too wide." 4
		591	.IX Item "On Solaris 9, many line-drawing characters are too wide."
		592	Seems to be a known bug, read
		593	<http://nixdoc.net/files/forum/about34198.html>. Some people use the
		594	following ugly workaround to get non-double-wide-characters working:
		595	.Sp
		596	.Vb 1
		597	\& #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
		598	.Ve
349	.IP "My Compose (Multi_key) key is no longer working." 4	599	.IP "My Compose (Multi_key) key is no longer working." 4
350	.IX Item "My Compose (Multi_key) key is no longer working."	600	.IX Item "My Compose (Multi_key) key is no longer working."
351	The most common causes for this are that either your locale is not set	601	The most common causes for this are that either your locale is not set
352	correctly, or you specified a \fBpreeditStyle\fR that is not supported by	602	correctly, or you specified a \fBpreeditStyle\fR that is not supported by
353	your input method. For example, if you specified \fBOverTheSpot\fR and	603	your input method. For example, if you specified \fBOverTheSpot\fR and
…		…
355	does not support this (for instance because it is not visual), then	605	does not support this (for instance because it is not visual), then
356	rxvt-unicode will continue without an input method.	606	rxvt-unicode will continue without an input method.
357	.Sp	607	.Sp
358	In this case either do not specify a \fBpreeditStyle\fR or specify more than	608	In this case either do not specify a \fBpreeditStyle\fR or specify more than
359	one pre-edit style, such as \fBOverTheSpot,Root,None\fR.	609	one pre-edit style, such as \fBOverTheSpot,Root,None\fR.
360	.ie n .IP "I cannot type \*(C`Ctrl\-Shift\-2\*(C' to get an \s-1ASCII\s0 \s-1NUL\s0 character due to \s-1ISO\s0 14755" 4	610	.ie n .IP "I cannot type ""Ctrl\-Shift\-2"" to get an \s-1ASCII\s0 \s-1NUL\s0 character due to \s-1ISO\s0 14755" 4
361	.el .IP "I cannot type \f(CW\*(C`Ctrl\-Shift\-2\*(C'\fR to get an \s-1ASCII\s0 \s-1NUL\s0 character due to \s-1ISO\s0 14755" 4	611	.el .IP "I cannot type \f(CWCtrl\-Shift\-2\fR to get an \s-1ASCII\s0 \s-1NUL\s0 character due to \s-1ISO\s0 14755" 4
362	.IX Item "I cannot type Ctrl-Shift-2 to get an ASCII NUL character due to ISO 14755"	612	.IX Item "I cannot type Ctrl-Shift-2 to get an ASCII NUL character due to ISO 14755"
363	Either try \f(CW\*(C`Ctrl\-2\*(C'\fR alone (it often is mapped to \s-1ASCII\s0 \s-1NUL\s0 even on	613	Either try \f(CW\*(C`Ctrl\-2\*(C'\fR alone (it often is mapped to \s-1ASCII\s0 \s-1NUL\s0 even on
364	international keyboards) or simply use \s-1ISO\s0 14755 support to your	614	international keyboards) or simply use \s-1ISO\s0 14755 support to your
365	advantage, typing <Ctrl\-Shift\-0> to get a \s-1ASCII\s0 \s-1NUL\s0. This works for other	615	advantage, typing <Ctrl\-Shift\-0> to get a \s-1ASCII\s0 \s-1NUL\s0. This works for other
366	codes, too, such as \f(CW\*(C`Ctrl\-Shift\-1\-d\*(C'\fR to type the default telnet escape	616	codes, too, such as \f(CW\*(C`Ctrl\-Shift\-1\-d\*(C'\fR to type the default telnet escape
367	character and so on.	617	character and so on.
368	.IP "How can I keep rxvt-unicode from using reverse video so much?" 4	618	.IP "How can I keep rxvt-unicode from using reverse video so much?" 4
369	.IX Item "How can I keep rxvt-unicode from using reverse video so much?"	619	.IX Item "How can I keep rxvt-unicode from using reverse video so much?"
370	First of all, make sure you are running with the right terminfo	620	First of all, make sure you are running with the right terminal settings
371	(\f(CW\*(C`urxvt\*(C'\fR), which will get rid of most of these effects. Then make sure	621	(\f(CW\*(C`TERM=rxvt\-unicode\*(C'\fR), which will get rid of most of these effects. Then
372	you have specified colours for italic and bold, as otherwise rxvt-unicode	622	make sure you have specified colours for italic and bold, as otherwise
373	might use reverse video to simulate the effect:	623	rxvt-unicode might use reverse video to simulate the effect:
374	.Sp	624	.Sp
375	.Vb 2	625	.Vb 2
376	\& URxvt*colorBD: white	626	\& URxvt.colorBD: white
377	\& URxvt*colorIT: green	627	\& URxvt.colorIT: green
378	.Ve	628	.Ve
379	.IP "Some programs assume totally weird colours (red instead of blue), how can I fix that?" 4	629	.IP "Some programs assume totally weird colours (red instead of blue), how can I fix that?" 4
380	.IX Item "Some programs assume totally weird colours (red instead of blue), how can I fix that?"	630	.IX Item "Some programs assume totally weird colours (red instead of blue), how can I fix that?"
381	For some unexplainable reason, some programs (i.e. irssi) assume a very	631	For some unexplainable reason, some rare programs assume a very weird
382	weird colour palette when confronted with a terminal with more than the	632	colour palette when confronted with a terminal with more than the standard
383	standard 8 colours (rxvt\-unicode supports 88). The right fix is, of	633	8 colours (rxvt\-unicode supports 88). The right fix is, of course, to fix
384	course, to fix these programs not to assume non-ISO colours without very	634	these programs not to assume non-ISO colours without very good reasons.
385	good reasons.
386	.Sp	635	.Sp
387	In the meantime, you can either edit your \f(CW\*(C`urxvt\*(C'\fR terminfo definition to	636	In the meantime, you can either edit your \f(CW\*(C`rxvt\-unicode\*(C'\fR terminfo
388	only claim 8 colour support or use \f(CW\*(C`TERM=rxvt\*(C'\fR, which will fix colours	637	definition to only claim 8 colour support or use \f(CW\*(C`TERM=rxvt\*(C'\fR, which will
389	but keep you from using other rxvt-unicode features.	638	fix colours but keep you from using other rxvt-unicode features.
390	.IP "I am on FreeBSD and rxvt-unicode does not seem to work at all." 4	639	.IP "I am on FreeBSD and rxvt-unicode does not seem to work at all." 4
391	.IX Item "I am on FreeBSD and rxvt-unicode does not seem to work at all."	640	.IX Item "I am on FreeBSD and rxvt-unicode does not seem to work at all."
392	Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined	641	Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined
393	in your compile environment, or an implementation that implements it,	642	in your compile environment, or an implementation that implements it,
394	wether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that	643	wether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that
395	\&\fBwchar_t\fR is represented as unicode.	644	\&\fBwchar_t\fR is represented as unicode.
396	.Sp	645	.Sp
397	As you might have guessed, FreeBSD does neither define this symobl nor	646	As you might have guessed, FreeBSD does neither define this symobl nor
398	does it support it. Instead, it uses it's own internal representation of	647	does it support it. Instead, it uses it's own internal representation of
399	\&\fBwchar_t\fR. This is, of course, completely legal.	648	\&\fBwchar_t\fR. This is, of course, completely fine with respect to standards.
400	.Sp	649	.Sp
		650	However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and
		651	\&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR.
		652	.Sp
401	However, \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support	653	\&\f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support multi-language
402	multi-language apps in an \s-1OS\s0, as using a locale-dependent (and	654	apps in an \s-1OS\s0, as using a locale-dependent (and non\-standardized)
403	non\-standardized) representation of \fBwchar_t\fR makes it impossible to	655	representation of \fBwchar_t\fR makes it impossible to convert between
404	convert between \fBwchar_t\fR (as used by X11 and your applications) and any	656	\&\fBwchar_t\fR (as used by X11 and your applications) and any other encoding
405	other encoding without implementing OS-specific-wrappers for each and	657	without implementing OS-specific-wrappers for each and every locale. There
406	every locale. There simply are no APIs to convert \fBwchar_t\fR into anything	658	simply are no APIs to convert \fBwchar_t\fR into anything except the current
407	except the current locale encoding.	659	locale encoding.
408	.Sp	660	.Sp
409	Some applications (such as the formidable \fBmlterm\fR) work around this	661	Some applications (such as the formidable \fBmlterm\fR) work around this
410	by carrying their own replacement functions for character set handling	662	by carrying their own replacement functions for character set handling
411	with them, and either implementing OS-dependent hacks or doing multiple	663	with them, and either implementing OS-dependent hacks or doing multiple
412	conversions (which is slow and unreliable in case the \s-1OS\s0 implements	664	conversions (which is slow and unreliable in case the \s-1OS\s0 implements
413	encodings slightly different than the terminal emulator).	665	encodings slightly different than the terminal emulator).
414	.Sp	666	.Sp
415	The rxvt-unicode author insists that the right way to fix this is in the	667	The rxvt-unicode author insists that the right way to fix this is in the
416	system libraries once and for all, instead of forcing every app to carry	668	system libraries once and for all, instead of forcing every app to carry
417	complete replacements.	669	complete replacements for them :)
		670	.IP "I use Solaris 9 and it doesn't compile/work/etc." 4
		671	.IX Item "I use Solaris 9 and it doesn't compile/work/etc."
		672	Try the diff in \fIdoc/solaris9.patch\fR as a base. It fixes the worst
		673	problems with \f(CW\*(C`wcwidth\*(C'\fR and a compile problem.
		674	.IP "How can I use rxvt-unicode under cygwin?" 4
		675	.IX Item "How can I use rxvt-unicode under cygwin?"
		676	rxvt-unicode should compile and run out of the box on cygwin, using
		677	the X11 libraries that come with cygwin. libW11 emulation is no
		678	longer supported (and makes no sense, either, as it only supported a
		679	single font). I recommend starting the X\-server in \f(CW\*(C`\-multiwindow\*(C'\fR or
		680	\&\f(CW\*(C`\-rootless\*(C'\fR mode instead, which will result in similar look&feel as the
		681	old libW11 emulation.
		682	.Sp
		683	At the time of this writing, cygwin didn't seem to support any multi-byte
		684	encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited
		685	to 8\-bit encodings.
418	.IP "How does rxvt-unicode determine the encoding to use?" 4	686	.IP "How does rxvt-unicode determine the encoding to use?" 4
419	.IX Item "How does rxvt-unicode determine the encoding to use?"	687	.IX Item "How does rxvt-unicode determine the encoding to use?"
420	.PD 0	688	.PD 0
421	.IP "Is there an option to switch encodings?" 4	689	.IP "Is there an option to switch encodings?" 4
422	.IX Item "Is there an option to switch encodings?"	690	.IX Item "Is there an option to switch encodings?"
…		…
425	specific \*(L"utf\-8\*(R" mode, such as xterm. In fact, it doesn't even know about	693	specific \*(L"utf\-8\*(R" mode, such as xterm. In fact, it doesn't even know about
426	\&\s-1UTF\-8\s0 or any other encodings with respect to terminal I/O.	694	\&\s-1UTF\-8\s0 or any other encodings with respect to terminal I/O.
427	.Sp	695	.Sp
428	The reasons is that there exists a perfectly fine mechanism for selecting	696	The reasons is that there exists a perfectly fine mechanism for selecting
429	the encoding, doing I/O and (most important) communicating this to all	697	the encoding, doing I/O and (most important) communicating this to all
430	applications so everybody agrees on character properties such as width and	698	applications so everybody agrees on character properties such as width
431	code number. This mechanism is the \fIlocale\fR.	699	and code number. This mechanism is the \fIlocale\fR. Applications not using
		700	that info will have problems (for example, \f(CW\*(C`xterm\*(C'\fR gets the width of
		701	characters wrong as it uses it's own, locale-independent table under all
		702	locales).
432	.Sp	703	.Sp
433	Rxvt-unicode uses the \f(CW\*(C`LC_CTYPE\*(C'\fR locale category to select encoding. All	704	Rxvt-unicode uses the \f(CW\*(C`LC_CTYPE\*(C'\fR locale category to select encoding. All
434	programs doing the same (that is, most) will automatically agree in the	705	programs doing the same (that is, most) will automatically agree in the
435	interpretation of characters.	706	interpretation of characters.
436	.Sp	707	.Sp
…		…
443	\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR, i.e. \f(CW\*(C`language_country.encoding\*(C'\fR, but other forms	714	\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR, i.e. \f(CW\*(C`language_country.encoding\*(C'\fR, but other forms
444	(i.e. \f(CW\*(C`de\*(C'\fR or \f(CW\*(C`german\*(C'\fR) are also common.	715	(i.e. \f(CW\*(C`de\*(C'\fR or \f(CW\*(C`german\*(C'\fR) are also common.
445	.Sp	716	.Sp
446	Rxvt-unicode ignores all other locale categories, and except for	717	Rxvt-unicode ignores all other locale categories, and except for
447	the encoding, ignores country or language-specific settings,	718	the encoding, ignores country or language-specific settings,
448	i.e. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR and \f(CW\*(C`ja_JP.UTF\-8\*(C'\fR are the same for rxvt\-unicode.	719	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
		720	rxvt\-unicode.
449	.Sp	721	.Sp
450	If you want to use a specific encoding you have to make sure you start	722	If you want to use a specific encoding you have to make sure you start
451	rxvt-unicode with the correct \f(CW\*(C`LC_CTYPE\*(C'\fR category.	723	rxvt-unicode with the correct \f(CW\*(C`LC_CTYPE\*(C'\fR category.
452	.IP "Can I switch locales at runtime?" 4	724	.IP "Can I switch locales at runtime?" 4
453	.IX Item "Can I switch locales at runtime?"	725	.IX Item "Can I switch locales at runtime?"
454	Yes, using an escape sequence. Try sth. like this, which sets	726	Yes, using an escape sequence. Try something like this, which sets
455	rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR.	727	rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR.
456	.Sp	728	.Sp
457	.Vb 1	729	.Vb 1
458	\& printf '\ee]701;%s\e007' ja_JP.SJIS	730	\& printf '\ee]701;%s\e007' ja_JP.SJIS
459	.Ve	731	.Ve
460	.Sp	732	.Sp
461	See also the previous question.	733	See also the previous answer.
462	.Sp	734	.Sp
463	Sometimes this capability is rather handy when you want to work in one	735	Sometimes this capability is rather handy when you want to work in
464	locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support \s-1UTF\-8\s0. For	736	one locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support it
465	example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which first switches to a	737	(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which
466	locale supported by xjdic and back later:	738	first switches to a locale supported by xjdic and back later:
467	.Sp	739	.Sp
468	.Vb 3	740	.Vb 3
469	\& printf '\ee]701;%s\e007' ja_JP.SJIS	741	\& printf '\ee]701;%s\e007' ja_JP.SJIS
470	\& xjdic -js	742	\& xjdic -js
471	\& printf '\ee]701;%s\e007' de_DE.UTF-8	743	\& printf '\ee]701;%s\e007' de_DE.UTF-8
472	.Ve	744	.Ve
		745	.Sp
		746	You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except
		747	for some locales where character width differs between program\- and
		748	rxvt\-unicode\-locales.
473	.IP "Can I switch the fonts at runtime?" 4	749	.IP "Can I switch the fonts at runtime?" 4
474	.IX Item "Can I switch the fonts at runtime?"	750	.IX Item "Can I switch the fonts at runtime?"
475	Yes, using an escape sequence. Try sth. like this, which has the same	751	Yes, using an escape sequence. Try something like this, which has the same
476	effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately:	752	effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately:
477	.Sp	753	.Sp
478	.Vb 1	754	.Vb 1
479	\& printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic"	755	\& printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic"
480	.Ve	756	.Ve
…		…
486	You can think of this as a kind of manual \s-1ISO\-2022\s0 switching.	762	You can think of this as a kind of manual \s-1ISO\-2022\s0 switching.
487	.IP "Why do italic characters look as if clipped?" 4	763	.IP "Why do italic characters look as if clipped?" 4
488	.IX Item "Why do italic characters look as if clipped?"	764	.IX Item "Why do italic characters look as if clipped?"
489	Many fonts have difficulties with italic characters and hinting. For	765	Many fonts have difficulties with italic characters and hinting. For
490	example, the otherwise very nicely hinted font \f(CW\*(C`xft:Bitstream Vera Sans	766	example, the otherwise very nicely hinted font \f(CW\*(C`xft:Bitstream Vera Sans
491	Mono\*(C'\fR completely fails in it's italic face. A workaround is to enable	767	Mono\*(C'\fR completely fails in it's italic face. A workaround might be to
492	freetype autohinting, i.e. like this:	768	enable freetype autohinting, i.e. like this:
493	.Sp	769	.Sp
494	.Vb 2	770	.Vb 2
495	\& URxvt*italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true	771	\& URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
496	\& URxvt*boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true	772	\& URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
497	.Ve	773	.Ve
498	.IP "My input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?" 4	774	.IP "My input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?" 4
499	.IX Item "My input method wants <some encoding> but I want UTF-8, what can I do?"	775	.IX Item "My input method wants <some encoding> but I want UTF-8, what can I do?"
500	You can specify separate locales for the input method and the rest of the	776	You can specify separate locales for the input method and the rest of the
501	terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:	777	terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
502	.Sp	778	.Sp
503	.Vb 1	779	.Vb 1
504	\& URxvt*imlocale: ja_JP.EUC-JP	780	\& URxvt.imlocale: ja_JP.EUC-JP
505	.Ve	781	.Ve
506	.Sp	782	.Sp
507	Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still	783	Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still
508	use your input method. Please note, however, that you will not be able to	784	use your input method. Please note, however, that you will not be able to
509	input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input	785	input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input
510	method limits you.	786	method limits you.
		787	.IP "Rxvt-unicode crashes when the X Input Method changes or exits." 4
		788	.IX Item "Rxvt-unicode crashes when the X Input Method changes or exits."
		789	Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by
		790	design. Applications can avoid some crashes at the expense of memory
		791	leaks, and Input Methods can avoid some crashes by careful ordering at
		792	exit time. \fBkinput2\fR (and derived input methods) generally succeeds,
		793	while \fB\s-1SCIM\s0\fR (or similar input methods) fails. In the end, however,
		794	crashes cannot be completely avoided even if both sides cooperate.
		795	.Sp
		796	So the only workaround is not to kill your Input Method Servers.
511	.IP "Rxvt-unicode uses gobs of memory, how can I reduce that?" 4	797	.IP "Rxvt-unicode uses gobs of memory, how can I reduce that?" 4
512	.IX Item "Rxvt-unicode uses gobs of memory, how can I reduce that?"	798	.IX Item "Rxvt-unicode uses gobs of memory, how can I reduce that?"
513	Rxvt-unicode tries to obey the rule of not charging you for sth. you	799	Rxvt-unicode tries to obey the rule of not charging you for something you
514	don't use. One thing you should try is to configure out all settings that	800	don't use. One thing you should try is to configure out all settings that
515	you don't need, for example, Xft support is a resource hog by design,	801	you don't need, for example, Xft support is a resource hog by design,
516	when used. Compiling it out ensures that no Xft font will be loaded	802	when used. Compiling it out ensures that no Xft font will be loaded
517	accidentally when rxvt-unicode tries to find a font for your characters.	803	accidentally when rxvt-unicode tries to find a font for your characters.
518	.Sp	804	.Sp
…		…
524	rxvt-unicode then uses 8 bytes per screen cell.	810	rxvt-unicode then uses 8 bytes per screen cell.
525	.IP "Can I speed up Xft rendering somehow?" 4	811	.IP "Can I speed up Xft rendering somehow?" 4
526	.IX Item "Can I speed up Xft rendering somehow?"	812	.IX Item "Can I speed up Xft rendering somehow?"
527	Yes, the most obvious way to speed it up is to avoid Xft entirely, as	813	Yes, the most obvious way to speed it up is to avoid Xft entirely, as
528	it is simply slow. If you still want Xft fonts you might try to disable	814	it is simply slow. If you still want Xft fonts you might try to disable
529	antialiasing (by appending \f(CW\*(C`:antialiasing=false\*(C'\fR), which saves lots of	815	antialiasing (by appending \f(CW\*(C`:antialias=false\*(C'\fR), which saves lots of
530	memory and also speeds up rendering considerably.	816	memory and also speeds up rendering considerably.
531	.IP "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?" 4	817	.IP "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?" 4
532	.IX Item "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?"	818	.IX Item "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?"
533	Rxvt-unicode will use whatever you specify as a font. If it needs to	819	Rxvt-unicode will use whatever you specify as a font. If it needs to
534	fall back to it's default font search list it will prefer X11 core	820	fall back to it's default font search list it will prefer X11 core
…		…
541	.IX Item "Mouse cut/paste suddenly no longer works."	827	.IX Item "Mouse cut/paste suddenly no longer works."
542	Make sure that mouse reporting is actually turned off since killing	828	Make sure that mouse reporting is actually turned off since killing
543	some editors prematurely may leave the mouse in mouse report mode. I've	829	some editors prematurely may leave the mouse in mouse report mode. I've
544	heard that tcsh may use mouse reporting unless it otherwise specified. A	830	heard that tcsh may use mouse reporting unless it otherwise specified. A
545	quick check is to see if cut/paste works when the Alt or Shift keys are	831	quick check is to see if cut/paste works when the Alt or Shift keys are
546	depressed. See @@RXVT_NAME@@(7)	832	depressed.
547	.IP "What's with this bold/blink stuff?" 4	833	.IP "What's with this bold/blink stuff?" 4
548	.IX Item "What's with this bold/blink stuff?"	834	.IX Item "What's with this bold/blink stuff?"
549	If no bold colour is set via \f(CW\*(C`colorBD:\*(C'\fR, bold will invert text using the	835	If no bold colour is set via \f(CW\*(C`colorBD:\*(C'\fR, bold will invert text using the
550	standard foreground colour.	836	standard foreground colour.
551	.Sp	837	.Sp
…		…
567	.Sp	853	.Sp
568	Here are values that are supposed to resemble a \s-1VGA\s0 screen,	854	Here are values that are supposed to resemble a \s-1VGA\s0 screen,
569	including the murky brown that passes for low-intensity yellow:	855	including the murky brown that passes for low-intensity yellow:
570	.Sp	856	.Sp
571	.Vb 8	857	.Vb 8
572	\& URxvt*color0: #000000	858	\& URxvt.color0: #000000
573	\& URxvt*color1: #A80000	859	\& URxvt.color1: #A80000
574	\& URxvt*color2: #00A800	860	\& URxvt.color2: #00A800
575	\& URxvt*color3: #A8A800	861	\& URxvt.color3: #A8A800
576	\& URxvt*color4: #0000A8	862	\& URxvt.color4: #0000A8
577	\& URxvt*color5: #A800A8	863	\& URxvt.color5: #A800A8
578	\& URxvt*color6: #00A8A8	864	\& URxvt.color6: #00A8A8
579	\& URxvt*color7: #A8A8A8	865	\& URxvt.color7: #A8A8A8
580	.Ve	866	.Ve
581	.Sp	867	.Sp
582	.Vb 8	868	.Vb 8
583	\& URxvt*color8: #000054	869	\& URxvt.color8: #000054
584	\& URxvt*color9: #FF0054	870	\& URxvt.color9: #FF0054
585	\& URxvt*color10: #00FF54	871	\& URxvt.color10: #00FF54
586	\& URxvt*color11: #FFFF54	872	\& URxvt.color11: #FFFF54
587	\& URxvt*color12: #0000FF	873	\& URxvt.color12: #0000FF
588	\& URxvt*color13: #FF00FF	874	\& URxvt.color13: #FF00FF
589	\& URxvt*color14: #00FFFF	875	\& URxvt.color14: #00FFFF
590	\& URxvt*color15: #FFFFFF	876	\& URxvt.color15: #FFFFFF
591	.Ve	877	.Ve
592	.Sp	878	.Sp
593	And here is a more complete set of non-standard colors described as	879	And here is a more complete set of non-standard colors described (not by
594	\&\*(L"pretty girly\*(R":	880	me) as \*(L"pretty girly\*(R".
595	.Sp	881	.Sp
596	.Vb 18	882	.Vb 18
597	\& URxvt.cursorColor: #dc74d1	883	\& URxvt.cursorColor: #dc74d1
598	\& URxvt.pointerColor: #dc74d1	884	\& URxvt.pointerColor: #dc74d1
599	\& URxvt.background: #0e0e0e	885	\& URxvt.background: #0e0e0e
…		…
611	\& URxvt.color6: #73f7ff	897	\& URxvt.color6: #73f7ff
612	\& URxvt.color14: #73f7ff	898	\& URxvt.color14: #73f7ff
613	\& URxvt.color7: #e1dddd	899	\& URxvt.color7: #e1dddd
614	\& URxvt.color15: #e1dddd	900	\& URxvt.color15: #e1dddd
615	.Ve	901	.Ve
		902	.IP "How can I start @@RXVT_NAME@@d in a race-free way?" 4
		903	.IX Item "How can I start @@RXVT_NAME@@d in a race-free way?"
		904	Try \f(CW\*(C`@@RXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@RXVT_NAME@@d to open the
		905	display, create the listening socket and then fork.
616	.IP "What's with the strange Backspace/Delete key behaviour?" 4	906	.IP "What's with the strange Backspace/Delete key behaviour?" 4
617	.IX Item "What's with the strange Backspace/Delete key behaviour?"	907	.IX Item "What's with the strange Backspace/Delete key behaviour?"
618	Assuming that the physical Backspace key corresponds to the	908	Assuming that the physical Backspace key corresponds to the
619	BackSpace keysym (not likely for Linux ... see the following	909	BackSpace keysym (not likely for Linux ... see the following
620	question) there are two standard values that can be used for	910	question) there are two standard values that can be used for
…		…
642	\& # use Backspace = ^?	932	\& # use Backspace = ^?
643	\& $ stty erase ^?	933	\& $ stty erase ^?
644	\& $ @@RXVT_NAME@@	934	\& $ @@RXVT_NAME@@
645	.Ve	935	.Ve
646	.Sp	936	.Sp
647	Toggle with \*(L"ESC[36h\*(R" / \*(L"ESC[36l\*(R" as documented in @@RXVT_NAME@@(7).	937	Toggle with \f(CW\*(C`ESC [ 36 h\*(C'\fR / \f(CW\*(C`ESC [ 36 l\*(C'\fR.
648	.Sp	938	.Sp
649	For an existing rxvt\-unicode:	939	For an existing rxvt\-unicode:
650	.Sp	940	.Sp
651	.Vb 3	941	.Vb 3
652	\& # use Backspace = ^H	942	\& # use Backspace = ^H
…		…
665	properly reflects that.	955	properly reflects that.
666	.Sp	956	.Sp
667	The Delete key is a another casualty of the ill-defined Backspace problem.	957	The Delete key is a another casualty of the ill-defined Backspace problem.
668	To avoid confusion between the Backspace and Delete keys, the Delete	958	To avoid confusion between the Backspace and Delete keys, the Delete
669	key has been assigned an escape sequence to match the vt100 for Execute	959	key has been assigned an escape sequence to match the vt100 for Execute
670	(ESC[3~) and is in the supplied termcap/terminfo.	960	(\f(CW\*(C`ESC [ 3 ~\*(C'\fR) and is in the supplied termcap/terminfo.
671	.Sp	961	.Sp
672	Some other Backspace problems:	962	Some other Backspace problems:
673	.Sp	963	.Sp
674	some editors use termcap/terminfo,	964	some editors use termcap/terminfo,
675	some editors (vim I'm told) expect Backspace = ^H,	965	some editors (vim I'm told) expect Backspace = ^H,
…		…
680	.IX Item "I don't like the key-bindings. How do I change them?"	970	.IX Item "I don't like the key-bindings. How do I change them?"
681	There are some compile-time selections available via configure. Unless	971	There are some compile-time selections available via configure. Unless
682	you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can	972	you have run \*(L"configure\*(R" with the \f(CW\*(C`\-\-disable\-resources\*(C'\fR option you can
683	use the `keysym' resource to alter the keystrings associated with keysyms.	973	use the `keysym' resource to alter the keystrings associated with keysyms.
684	.Sp	974	.Sp
685	Here's an example for a URxvt session started using `@@RXVT_NAME@@ \-name URxvt'	975	Here's an example for a URxvt session started using \f(CW\*(C`@@RXVT_NAME@@ \-name URxvt\*(C'\fR
686	.Sp	976	.Sp
687	.Vb 20	977	.Vb 20
688	\& URxvt.keysym.Home: \ee[1~	978	\& URxvt.keysym.Home: \e033[1~
689	\& URxvt.keysym.End: \ee[4~	979	\& URxvt.keysym.End: \e033[4~
690	\& URxvt.keysym.C-apostrophe: \ee<C-'>	980	\& URxvt.keysym.C-apostrophe: \e033<C-'>
691	\& URxvt.keysym.C-slash: \ee<C-/>	981	\& URxvt.keysym.C-slash: \e033<C-/>
692	\& URxvt.keysym.C-semicolon: \ee<C-;>	982	\& URxvt.keysym.C-semicolon: \e033<C-;>
693	\& URxvt.keysym.C-grave: \ee<C-`>	983	\& URxvt.keysym.C-grave: \e033<C-`>
694	\& URxvt.keysym.C-comma: \ee<C-,>	984	\& URxvt.keysym.C-comma: \e033<C-,>
695	\& URxvt.keysym.C-period: \ee<C-.>	985	\& URxvt.keysym.C-period: \e033<C-.>
696	\& URxvt.keysym.C-0x60: \ee<C-`>	986	\& URxvt.keysym.C-0x60: \e033<C-`>
697	\& URxvt.keysym.C-Tab: \ee<C-Tab>	987	\& URxvt.keysym.C-Tab: \e033<C-Tab>
698	\& URxvt.keysym.C-Return: \ee<C-Return>	988	\& URxvt.keysym.C-Return: \e033<C-Return>
699	\& URxvt.keysym.S-Return: \ee<S-Return>	989	\& URxvt.keysym.S-Return: \e033<S-Return>
700	\& URxvt.keysym.S-space: \ee<S-Space>	990	\& URxvt.keysym.S-space: \e033<S-Space>
701	\& URxvt.keysym.M-Up: \ee<M-Up>	991	\& URxvt.keysym.M-Up: \e033<M-Up>
702	\& URxvt.keysym.M-Down: \ee<M-Down>	992	\& URxvt.keysym.M-Down: \e033<M-Down>
703	\& URxvt.keysym.M-Left: \ee<M-Left>	993	\& URxvt.keysym.M-Left: \e033<M-Left>
704	\& URxvt.keysym.M-Right: \ee<M-Right>	994	\& URxvt.keysym.M-Right: \e033<M-Right>
705	\& URxvt.keysym.M-C-0: list \ee<M-C- 0123456789 >	995	\& URxvt.keysym.M-C-0: list \e033<M-C- 0123456789 >
706	\& URxvt.keysym.M-C-a: list \e033<M-C- abcdefghijklmnopqrstuvwxyz >	996	\& URxvt.keysym.M-C-a: list \e033<M-C- abcdefghijklmnopqrstuvwxyz >
707	\& URxvt.keysym.F12: proto:\e033]701;zh_CN.GBK\e007	997	\& URxvt.keysym.F12: command:\e033]701;zh_CN.GBK\e007
708	.Ve	998	.Ve
709	.Sp	999	.Sp
710	See some more examples in the documentation for the \fBkeysym\fR resource.	1000	See some more examples in the documentation for the \fBkeysym\fR resource.
711	.IP "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." 4	1001	.IP "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." 4
712	.IX Item "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."	1002	.IX Item "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."
…		…
720	.Ve	1010	.Ve
721	.Sp	1011	.Sp
722	Rather than have rxvt-unicode try to accommodate all the various possible	1012	Rather than have rxvt-unicode try to accommodate all the various possible
723	keyboard mappings, it is better to use `xmodmap' to remap the keys as	1013	keyboard mappings, it is better to use `xmodmap' to remap the keys as
724	required for your particular machine.	1014	required for your particular machine.
725	.IP "How do I distinguish if I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc." 4	1015	.IP "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc." 4
726	.IX Item "How do I distinguish if I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc."	1016	.IX Item "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc."
727	rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", so you can	1017	rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", so you can
728	check and see if that is set. Note that several programs, \s-1JED\s0, slrn,	1018	check and see if that is set. Note that several programs, \s-1JED\s0, slrn,
729	Midnight Commander automatically check this variable to decide whether or	1019	Midnight Commander automatically check this variable to decide whether or
730	not to use color.	1020	not to use color.
731	.IP "How do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?" 4	1021	.IP "How do I set the correct, full \s-1IP\s0 address for the \s-1DISPLAY\s0 variable?" 4
…		…
762	.IP "My question isn't answered here, can I ask a human?" 4	1052	.IP "My question isn't answered here, can I ask a human?" 4
763	.IX Item "My question isn't answered here, can I ask a human?"	1053	.IX Item "My question isn't answered here, can I ask a human?"
764	Before sending me mail, you could go to \s-1IRC:\s0 \f(CW\*(C`irc.freenode.net\*(C'\fR,	1054	Before sending me mail, you could go to \s-1IRC:\s0 \f(CW\*(C`irc.freenode.net\*(C'\fR,
765	channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be	1055	channel \f(CW\*(C`#rxvt\-unicode\*(C'\fR has some rxvt-unicode enthusiasts that might be
766	interested in learning about new and exciting problems (but not FAQs :).	1056	interested in learning about new and exciting problems (but not FAQs :).
767	.SH "SYNOPSIS"	1057	.SH "RXVT TECHNICAL REFERENCE"
768	.IX Header "SYNOPSIS"	1058	.IX Header "RXVT TECHNICAL REFERENCE"
769	.Vb 2
770	\& # set a new font set
771	\& printf '\e33]50;%s\e007' 9x15,xft:Kochi" Mincho"
772	.Ve
773	.PP
774	.Vb 2
775	\& # change the locale and tell rxvt-unicode about it
776	\& export LC_CTYPE=ja_JP.EUC-JP; printf "\e33]701;$LC_CTYPE\e007"
777	.Ve
778	.PP
779	.Vb 2
780	\& # set window title
781	\& printf '\e33]2;%s\e007' "new window title"
782	.Ve
783	.SH "DESCRIPTION"	1059	.SH "DESCRIPTION"
784	.IX Header "DESCRIPTION"	1060	.IX Header "DESCRIPTION"
785	The rest of this document describes various technical aspects of	1061	The rest of this document describes various technical aspects of
786	\&\fBrxvt-unicode\fR. First the description of supported command sequences,	1062	\&\fBrxvt-unicode\fR. First the description of supported command sequences,
787	followed by menu and pixmap support and last by a description of all	1063	followed by menu and pixmap support and last by a description of all
788	features selectable at \f(CW\*(C`configure\*(C'\fR time.	1064	features selectable at \f(CW\*(C`configure\*(C'\fR time.
789	.SH "RXVT TECHNICAL REFERENCE"
790	.IX Header "RXVT TECHNICAL REFERENCE"
791	.SH "Definitions"	1065	.SH "Definitions"
792	.IX Header "Definitions"	1066	.IX Header "Definitions"
793	.ie n .IP "\fB\fB\*(C`c\*(C'\fB\fR" 4	1067	.ie n .IP "\fB\fB""c""\fB\fR" 4
794	.el .IP "\fB\f(CB\*(C`c\*(C'\fB\fR" 4	1068	.el .IP "\fB\f(CBc\fB\fR" 4
795	.IX Item "c"	1069	.IX Item "c"
796	The literal character c.	1070	The literal character c.
797	.ie n .IP "\fB\fB\*(C`C\*(C'\fB\fR" 4	1071	.ie n .IP "\fB\fB""C""\fB\fR" 4
798	.el .IP "\fB\f(CB\*(C`C\*(C'\fB\fR" 4	1072	.el .IP "\fB\f(CBC\fB\fR" 4
799	.IX Item "C"	1073	.IX Item "C"
800	A single (required) character.	1074	A single (required) character.
801	.ie n .IP "\fB\fB\*(C`Ps\*(C'\fB\fR" 4	1075	.ie n .IP "\fB\fB""Ps""\fB\fR" 4
802	.el .IP "\fB\f(CB\*(C`Ps\*(C'\fB\fR" 4	1076	.el .IP "\fB\f(CBPs\fB\fR" 4
803	.IX Item "Ps"	1077	.IX Item "Ps"
804	A single (usually optional) numeric parameter, composed of one or more	1078	A single (usually optional) numeric parameter, composed of one or more
805	digits.	1079	digits.
806	.ie n .IP "\fB\fB\*(C`Pm\*(C'\fB\fR" 4	1080	.ie n .IP "\fB\fB""Pm""\fB\fR" 4
807	.el .IP "\fB\f(CB\*(C`Pm\*(C'\fB\fR" 4	1081	.el .IP "\fB\f(CBPm\fB\fR" 4
808	.IX Item "Pm"	1082	.IX Item "Pm"
809	A multiple numeric parameter composed of any number of single numeric	1083	A multiple numeric parameter composed of any number of single numeric
810	parameters, separated by \f(CW\*(C`;\*(C'\fR character(s).	1084	parameters, separated by \f(CW\*(C`;\*(C'\fR character(s).
811	.ie n .IP "\fB\fB\*(C`Pt\*(C'\fB\fR" 4	1085	.ie n .IP "\fB\fB""Pt""\fB\fR" 4
812	.el .IP "\fB\f(CB\*(C`Pt\*(C'\fB\fR" 4	1086	.el .IP "\fB\f(CBPt\fB\fR" 4
813	.IX Item "Pt"	1087	.IX Item "Pt"
814	A text parameter composed of printable characters.	1088	A text parameter composed of printable characters.
815	.SH "Values"	1089	.SH "Values"
816	.IX Header "Values"	1090	.IX Header "Values"
817	.ie n .IP "\fB\fB\*(C`ENQ\*(C'\fB\fR" 4	1091	.ie n .IP "\fB\fB""ENQ""\fB\fR" 4
818	.el .IP "\fB\f(CB\*(C`ENQ\*(C'\fB\fR" 4	1092	.el .IP "\fB\f(CBENQ\fB\fR" 4
819	.IX Item "ENQ"	1093	.IX Item "ENQ"
820	Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0)	1094	Enquiry (Ctrl\-E) = Send Device Attributes (\s-1DA\s0)
821	request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR.	1095	request attributes from terminal. See \fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR.
822	.ie n .IP "\fB\fB\*(C`BEL\*(C'\fB\fR" 4	1096	.ie n .IP "\fB\fB""BEL""\fB\fR" 4
823	.el .IP "\fB\f(CB\*(C`BEL\*(C'\fB\fR" 4	1097	.el .IP "\fB\f(CBBEL\fB\fR" 4
824	.IX Item "BEL"	1098	.IX Item "BEL"
825	Bell (Ctrl\-G)	1099	Bell (Ctrl\-G)
826	.ie n .IP "\fB\fB\*(C`BS\*(C'\fB\fR" 4	1100	.ie n .IP "\fB\fB""BS""\fB\fR" 4
827	.el .IP "\fB\f(CB\*(C`BS\*(C'\fB\fR" 4	1101	.el .IP "\fB\f(CBBS\fB\fR" 4
828	.IX Item "BS"	1102	.IX Item "BS"
829	Backspace (Ctrl\-H)	1103	Backspace (Ctrl\-H)
830	.ie n .IP "\fB\fB\*(C`TAB\*(C'\fB\fR" 4	1104	.ie n .IP "\fB\fB""TAB""\fB\fR" 4
831	.el .IP "\fB\f(CB\*(C`TAB\*(C'\fB\fR" 4	1105	.el .IP "\fB\f(CBTAB\fB\fR" 4
832	.IX Item "TAB"	1106	.IX Item "TAB"
833	Horizontal Tab (\s-1HT\s0) (Ctrl\-I)	1107	Horizontal Tab (\s-1HT\s0) (Ctrl\-I)
834	.ie n .IP "\fB\fB\*(C`LF\*(C'\fB\fR" 4	1108	.ie n .IP "\fB\fB""LF""\fB\fR" 4
835	.el .IP "\fB\f(CB\*(C`LF\*(C'\fB\fR" 4	1109	.el .IP "\fB\f(CBLF\fB\fR" 4
836	.IX Item "LF"	1110	.IX Item "LF"
837	Line Feed or New Line (\s-1NL\s0) (Ctrl\-J)	1111	Line Feed or New Line (\s-1NL\s0) (Ctrl\-J)
838	.ie n .IP "\fB\fB\*(C`VT\*(C'\fB\fR" 4	1112	.ie n .IP "\fB\fB""VT""\fB\fR" 4
839	.el .IP "\fB\f(CB\*(C`VT\*(C'\fB\fR" 4	1113	.el .IP "\fB\f(CBVT\fB\fR" 4
840	.IX Item "VT"	1114	.IX Item "VT"
841	Vertical Tab (Ctrl\-K) same as \fB\f(CB\*(C`LF\*(C'\fB\fR	1115	Vertical Tab (Ctrl\-K) same as \fB\f(CB\*(C`LF\*(C'\fB\fR
842	.ie n .IP "\fB\fB\*(C`FF\*(C'\fB\fR" 4	1116	.ie n .IP "\fB\fB""FF""\fB\fR" 4
843	.el .IP "\fB\f(CB\*(C`FF\*(C'\fB\fR" 4	1117	.el .IP "\fB\f(CBFF\fB\fR" 4
844	.IX Item "FF"	1118	.IX Item "FF"
845	Form Feed or New Page (\s-1NP\s0) (Ctrl\-L) same as \fB\f(CB\*(C`LF\*(C'\fB\fR	1119	Form Feed or New Page (\s-1NP\s0) (Ctrl\-L) same as \fB\f(CB\*(C`LF\*(C'\fB\fR
846	.ie n .IP "\fB\fB\*(C`CR\*(C'\fB\fR" 4	1120	.ie n .IP "\fB\fB""CR""\fB\fR" 4
847	.el .IP "\fB\f(CB\*(C`CR\*(C'\fB\fR" 4	1121	.el .IP "\fB\f(CBCR\fB\fR" 4
848	.IX Item "CR"	1122	.IX Item "CR"
849	Carriage Return (Ctrl\-M)	1123	Carriage Return (Ctrl\-M)
850	.ie n .IP "\fB\fB\*(C`SO\*(C'\fB\fR" 4	1124	.ie n .IP "\fB\fB""SO""\fB\fR" 4
851	.el .IP "\fB\f(CB\*(C`SO\*(C'\fB\fR" 4	1125	.el .IP "\fB\f(CBSO\fB\fR" 4
852	.IX Item "SO"	1126	.IX Item "SO"
853	Shift Out (Ctrl\-N), invokes the G1 character set.	1127	Shift Out (Ctrl\-N), invokes the G1 character set.
854	Switch to Alternate Character Set	1128	Switch to Alternate Character Set
855	.ie n .IP "\fB\fB\*(C`SI\*(C'\fB\fR" 4	1129	.ie n .IP "\fB\fB""SI""\fB\fR" 4
856	.el .IP "\fB\f(CB\*(C`SI\*(C'\fB\fR" 4	1130	.el .IP "\fB\f(CBSI\fB\fR" 4
857	.IX Item "SI"	1131	.IX Item "SI"
858	Shift In (Ctrl\-O), invokes the G0 character set (the default).	1132	Shift In (Ctrl\-O), invokes the G0 character set (the default).
859	Switch to Standard Character Set	1133	Switch to Standard Character Set
860	.ie n .IP "\fB\fB\*(C`SPC\*(C'\fB\fR" 4	1134	.ie n .IP "\fB\fB""SPC""\fB\fR" 4
861	.el .IP "\fB\f(CB\*(C`SPC\*(C'\fB\fR" 4	1135	.el .IP "\fB\f(CBSPC\fB\fR" 4
862	.IX Item "SPC"	1136	.IX Item "SPC"
863	Space Character	1137	Space Character
864	.SH "Escape Sequences"	1138	.SH "Escape Sequences"
865	.IX Header "Escape Sequences"	1139	.IX Header "Escape Sequences"
866	.ie n .IP "\fB\fB\*(C`ESC # 8\*(C'\fB\fR" 4	1140	.ie n .IP "\fB\fB""ESC # 8""\fB\fR" 4
867	.el .IP "\fB\f(CB\*(C`ESC # 8\*(C'\fB\fR" 4	1141	.el .IP "\fB\f(CBESC # 8\fB\fR" 4
868	.IX Item "ESC # 8"	1142	.IX Item "ESC # 8"
869	\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)	1143	\&\s-1DEC\s0 Screen Alignment Test (\s-1DECALN\s0)
870	.ie n .IP "\fB\fB\*(C`ESC 7\*(C'\fB\fR" 4	1144	.ie n .IP "\fB\fB""ESC 7""\fB\fR" 4
871	.el .IP "\fB\f(CB\*(C`ESC 7\*(C'\fB\fR" 4	1145	.el .IP "\fB\f(CBESC 7\fB\fR" 4
872	.IX Item "ESC 7"	1146	.IX Item "ESC 7"
873	Save Cursor (\s-1SC\s0)	1147	Save Cursor (\s-1SC\s0)
874	.ie n .IP "\fB\fB\*(C`ESC 8\*(C'\fB\fR" 4	1148	.ie n .IP "\fB\fB""ESC 8""\fB\fR" 4
875	.el .IP "\fB\f(CB\*(C`ESC 8\*(C'\fB\fR" 4	1149	.el .IP "\fB\f(CBESC 8\fB\fR" 4
876	.IX Item "ESC 8"	1150	.IX Item "ESC 8"
877	Restore Cursor	1151	Restore Cursor
878	.ie n .IP "\fB\fB\*(C`ESC =\*(C'\fB\fR" 4	1152	.ie n .IP "\fB\fB""ESC =""\fB\fR" 4
879	.el .IP "\fB\f(CB\*(C`ESC =\*(C'\fB\fR" 4	1153	.el .IP "\fB\f(CBESC =\fB\fR" 4
880	.IX Item "ESC ="	1154	.IX Item "ESC ="
881	Application Keypad (\s-1SMKX\s0). See also next sequence.	1155	Application Keypad (\s-1SMKX\s0). See also next sequence.
882	.ie n .IP "\fB\fB\*(C`ESC\*(C'\fB\fR" 4	1156	.ie n .IP "\fB\fB""ESC""\fB\fR" 4
883	.el .IP "\fB\f(CB\*(C`ESC\*(C'\fB\fR" 4	1157	.el .IP "\fB\f(CBESC\fB\fR" 4
884	.IX Item "ESC"	1158	.IX Item "ESC"
885	Normal Keypad (\s-1RMKX\s0)	1159	Normal Keypad (\s-1RMKX\s0)
886	.Sp	1160	.Sp
887	\&\fBNote:\fR If the numeric keypad is activated, eg, \fBNum_Lock\fR has been	1161	\&\fBNote:\fR If the numeric keypad is activated, eg, \fBNum_Lock\fR has been
888	pressed, numbers or control functions are generated by the numeric keypad	1162	pressed, numbers or control functions are generated by the numeric keypad
889	(see Key Codes).	1163	(see Key Codes).
890	.ie n .IP "\fB\fB\*(C`ESC D\*(C'\fB\fR" 4	1164	.ie n .IP "\fB\fB""ESC D""\fB\fR" 4
891	.el .IP "\fB\f(CB\*(C`ESC D\*(C'\fB\fR" 4	1165	.el .IP "\fB\f(CBESC D\fB\fR" 4
892	.IX Item "ESC D"	1166	.IX Item "ESC D"
893	Index (\s-1IND\s0)	1167	Index (\s-1IND\s0)
894	.ie n .IP "\fB\fB\*(C`ESC E\*(C'\fB\fR" 4	1168	.ie n .IP "\fB\fB""ESC E""\fB\fR" 4
895	.el .IP "\fB\f(CB\*(C`ESC E\*(C'\fB\fR" 4	1169	.el .IP "\fB\f(CBESC E\fB\fR" 4
896	.IX Item "ESC E"	1170	.IX Item "ESC E"
897	Next Line (\s-1NEL\s0)	1171	Next Line (\s-1NEL\s0)
898	.ie n .IP "\fB\fB\*(C`ESC H\*(C'\fB\fR" 4	1172	.ie n .IP "\fB\fB""ESC H""\fB\fR" 4
899	.el .IP "\fB\f(CB\*(C`ESC H\*(C'\fB\fR" 4	1173	.el .IP "\fB\f(CBESC H\fB\fR" 4
900	.IX Item "ESC H"	1174	.IX Item "ESC H"
901	Tab Set (\s-1HTS\s0)	1175	Tab Set (\s-1HTS\s0)
902	.ie n .IP "\fB\fB\*(C`ESC M\*(C'\fB\fR" 4	1176	.ie n .IP "\fB\fB""ESC M""\fB\fR" 4
903	.el .IP "\fB\f(CB\*(C`ESC M\*(C'\fB\fR" 4	1177	.el .IP "\fB\f(CBESC M\fB\fR" 4
904	.IX Item "ESC M"	1178	.IX Item "ESC M"
905	Reverse Index (\s-1RI\s0)	1179	Reverse Index (\s-1RI\s0)
906	.ie n .IP "\fB\fB\*(C`ESC N\*(C'\fB\fR" 4	1180	.ie n .IP "\fB\fB""ESC N""\fB\fR" 4
907	.el .IP "\fB\f(CB\*(C`ESC N\*(C'\fB\fR" 4	1181	.el .IP "\fB\f(CBESC N\fB\fR" 4
908	.IX Item "ESC N"	1182	.IX Item "ESC N"
909	Single Shift Select of G2 Character Set (\s-1SS2\s0): affects next character	1183	Single Shift Select of G2 Character Set (\s-1SS2\s0): affects next character
910	only \fIunimplemented\fR	1184	only \fIunimplemented\fR
911	.ie n .IP "\fB\fB\*(C`ESC O\*(C'\fB\fR" 4	1185	.ie n .IP "\fB\fB""ESC O""\fB\fR" 4
912	.el .IP "\fB\f(CB\*(C`ESC O\*(C'\fB\fR" 4	1186	.el .IP "\fB\f(CBESC O\fB\fR" 4
913	.IX Item "ESC O"	1187	.IX Item "ESC O"
914	Single Shift Select of G3 Character Set (\s-1SS3\s0): affects next character	1188	Single Shift Select of G3 Character Set (\s-1SS3\s0): affects next character
915	only \fIunimplemented\fR	1189	only \fIunimplemented\fR
916	.ie n .IP "\fB\fB\*(C`ESC Z\*(C'\fB\fR" 4	1190	.ie n .IP "\fB\fB""ESC Z""\fB\fR" 4
917	.el .IP "\fB\f(CB\*(C`ESC Z\*(C'\fB\fR" 4	1191	.el .IP "\fB\f(CBESC Z\fB\fR" 4
918	.IX Item "ESC Z"	1192	.IX Item "ESC Z"
919	Obsolete form of returns: \fB\f(CB\*(C`ESC[?1;2C\*(C'\fB\fR \fIrxvt-unicode compile-time option\fR	1193	Obsolete form of returns: \fB\f(CB\*(C`ESC [ ? 1 ; 2 C\*(C'\fB\fR \fIrxvt-unicode compile-time option\fR
920	.ie n .IP "\fB\fB\*(C`ESC c\*(C'\fB\fR" 4	1194	.ie n .IP "\fB\fB""ESC c""\fB\fR" 4
921	.el .IP "\fB\f(CB\*(C`ESC c\*(C'\fB\fR" 4	1195	.el .IP "\fB\f(CBESC c\fB\fR" 4
922	.IX Item "ESC c"	1196	.IX Item "ESC c"
923	Full reset (\s-1RIS\s0)	1197	Full reset (\s-1RIS\s0)
924	.ie n .IP "\fB\fB\*(C`ESC n\*(C'\fB\fR" 4	1198	.ie n .IP "\fB\fB""ESC n""\fB\fR" 4
925	.el .IP "\fB\f(CB\*(C`ESC n\*(C'\fB\fR" 4	1199	.el .IP "\fB\f(CBESC n\fB\fR" 4
926	.IX Item "ESC n"	1200	.IX Item "ESC n"
927	Invoke the G2 Character Set (\s-1LS2\s0)	1201	Invoke the G2 Character Set (\s-1LS2\s0)
928	.ie n .IP "\fB\fB\*(C`ESC o\*(C'\fB\fR" 4	1202	.ie n .IP "\fB\fB""ESC o""\fB\fR" 4
929	.el .IP "\fB\f(CB\*(C`ESC o\*(C'\fB\fR" 4	1203	.el .IP "\fB\f(CBESC o\fB\fR" 4
930	.IX Item "ESC o"	1204	.IX Item "ESC o"
931	Invoke the G3 Character Set (\s-1LS3\s0)	1205	Invoke the G3 Character Set (\s-1LS3\s0)
932	.ie n .IP "\fB\fB\*(C`ESC\*(C'\fB ( C>\fR" 4	1206	.ie n .IP "\fB\fB""ESC ( C""\fB\fR" 4
933	.el .IP "\fB\f(CB\*(C`ESC\*(C'\fB ( C>\fR" 4	1207	.el .IP "\fB\f(CBESC ( C\fB\fR" 4
934	.IX Item "ESC ( C>"	1208	.IX Item "ESC ( C"
935	Designate G0 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.	1209	Designate G0 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.
936	.ie n .IP "\fB\fB\*(C`ESC\*(C'\fB ) C>\fR" 4	1210	.ie n .IP "\fB\fB""ESC ) C""\fB\fR" 4
937	.el .IP "\fB\f(CB\*(C`ESC\*(C'\fB ) C>\fR" 4	1211	.el .IP "\fB\f(CBESC ) C\fB\fR" 4
938	.IX Item "ESC ) C>"	1212	.IX Item "ESC ) C"
939	Designate G1 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.	1213	Designate G1 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.
940	.ie n .IP "\fB\fB\*(C`ESC * C\*(C'\fB\fR" 4	1214	.ie n .IP "\fB\fB""ESC * C""\fB\fR" 4
941	.el .IP "\fB\f(CB\*(C`ESC * C\*(C'\fB\fR" 4	1215	.el .IP "\fB\f(CBESC * C\fB\fR" 4
942	.IX Item "ESC * C"	1216	.IX Item "ESC * C"
943	Designate G2 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.	1217	Designate G2 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.
944	.ie n .IP "\fB\fB\*(C`ESC + C\*(C'\fB\fR" 4	1218	.ie n .IP "\fB\fB""ESC + C""\fB\fR" 4
945	.el .IP "\fB\f(CB\*(C`ESC + C\*(C'\fB\fR" 4	1219	.el .IP "\fB\f(CBESC + C\fB\fR" 4
946	.IX Item "ESC + C"	1220	.IX Item "ESC + C"
947	Designate G3 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.	1221	Designate G3 Character Set (\s-1ISO\s0 2022), see below for values of \f(CW\*(C`C\*(C'\fR.
948	.ie n .IP "\fB\fB\*(C`ESC $ C\*(C'\fB\fR" 4	1222	.ie n .IP "\fB\fB""ESC $ C""\fB\fR" 4
949	.el .IP "\fB\f(CB\*(C`ESC $ C\*(C'\fB\fR" 4	1223	.el .IP "\fB\f(CBESC $ C\fB\fR" 4
950	.IX Item "ESC $ C"	1224	.IX Item "ESC $ C"
951	Designate Kanji Character Set	1225	Designate Kanji Character Set
952	.Sp	1226	.Sp
953	Where \fB\f(CB\*(C`C\*(C'\fB\fR is one of:	1227	Where \fB\f(CB\*(C`C\*(C'\fB\fR is one of:
954	.TS	1228	.TS
…		…
965	.PP	1239	.PP
966		1240
967	.IX Xref "CSI"	1241	.IX Xref "CSI"
968	.SH "CSI (Command Sequence Introducer) Sequences"	1242	.SH "CSI (Command Sequence Introducer) Sequences"
969	.IX Header "CSI (Command Sequence Introducer) Sequences"	1243	.IX Header "CSI (Command Sequence Introducer) Sequences"
970	.ie n .IP "\fB\fB\*(C`ESC [ Ps @\*(C'\fB\fR" 4	1244	.ie n .IP "\fB\fB""ESC [ Ps @""\fB\fR" 4
971	.el .IP "\fB\f(CB\*(C`ESC [ Ps @\*(C'\fB\fR" 4	1245	.el .IP "\fB\f(CBESC [ Ps @\fB\fR" 4
972	.IX Item "ESC [ Ps @"	1246	.IX Item "ESC [ Ps @"
973	Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)	1247	Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR (Blank) Character(s) [default: 1] (\s-1ICH\s0)
974	.IX Xref "ESCOBPsA"	1248	.IX Xref "ESCOBPsA"
975	.ie n .IP "\fB\fB\*(C`ESC [ Ps A\*(C'\fB\fR" 4	1249	.ie n .IP "\fB\fB""ESC [ Ps A""\fB\fR" 4
976	.el .IP "\fB\f(CB\*(C`ESC [ Ps A\*(C'\fB\fR" 4	1250	.el .IP "\fB\f(CBESC [ Ps A\fB\fR" 4
977	.IX Item "ESC [ Ps A"	1251	.IX Item "ESC [ Ps A"
978	Cursor Up \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUU\s0)	1252	Cursor Up \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUU\s0)
979	.ie n .IP "\fB\fB\*(C`ESC [ Ps B\*(C'\fB\fR" 4	1253	.ie n .IP "\fB\fB""ESC [ Ps B""\fB\fR" 4
980	.el .IP "\fB\f(CB\*(C`ESC [ Ps B\*(C'\fB\fR" 4	1254	.el .IP "\fB\f(CBESC [ Ps B\fB\fR" 4
981	.IX Item "ESC [ Ps B"	1255	.IX Item "ESC [ Ps B"
982	Cursor Down \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUD\s0)	1256	Cursor Down \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUD\s0)
983	.IX Xref "ESCOBPsC"	1257	.IX Xref "ESCOBPsC"
984	.ie n .IP "\fB\fB\*(C`ESC [ Ps C\*(C'\fB\fR" 4	1258	.ie n .IP "\fB\fB""ESC [ Ps C""\fB\fR" 4
985	.el .IP "\fB\f(CB\*(C`ESC [ Ps C\*(C'\fB\fR" 4	1259	.el .IP "\fB\f(CBESC [ Ps C\fB\fR" 4
986	.IX Item "ESC [ Ps C"	1260	.IX Item "ESC [ Ps C"
987	Cursor Forward \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUF\s0)	1261	Cursor Forward \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUF\s0)
988	.ie n .IP "\fB\fB\*(C`ESC [ Ps D\*(C'\fB\fR" 4	1262	.ie n .IP "\fB\fB""ESC [ Ps D""\fB\fR" 4
989	.el .IP "\fB\f(CB\*(C`ESC [ Ps D\*(C'\fB\fR" 4	1263	.el .IP "\fB\f(CBESC [ Ps D\fB\fR" 4
990	.IX Item "ESC [ Ps D"	1264	.IX Item "ESC [ Ps D"
991	Cursor Backward \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUB\s0)	1265	Cursor Backward \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] (\s-1CUB\s0)
992	.ie n .IP "\fB\fB\*(C`ESC [ Ps E\*(C'\fB\fR" 4	1266	.ie n .IP "\fB\fB""ESC [ Ps E""\fB\fR" 4
993	.el .IP "\fB\f(CB\*(C`ESC [ Ps E\*(C'\fB\fR" 4	1267	.el .IP "\fB\f(CBESC [ Ps E\fB\fR" 4
994	.IX Item "ESC [ Ps E"	1268	.IX Item "ESC [ Ps E"
995	Cursor Down \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] and to first column	1269	Cursor Down \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] and to first column
996	.ie n .IP "\fB\fB\*(C`ESC [ Ps F\*(C'\fB\fR" 4	1270	.ie n .IP "\fB\fB""ESC [ Ps F""\fB\fR" 4
997	.el .IP "\fB\f(CB\*(C`ESC [ Ps F\*(C'\fB\fR" 4	1271	.el .IP "\fB\f(CBESC [ Ps F\fB\fR" 4
998	.IX Item "ESC [ Ps F"	1272	.IX Item "ESC [ Ps F"
999	Cursor Up \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] and to first column	1273	Cursor Up \fB\f(CB\*(C`Ps\*(C'\fB\fR Times [default: 1] and to first column
1000	.IX Xref "ESCOBPsG"	1274	.IX Xref "ESCOBPsG"
1001	.ie n .IP "\fB\fB\*(C`ESC [ Ps G\*(C'\fB\fR" 4	1275	.ie n .IP "\fB\fB""ESC [ Ps G""\fB\fR" 4
1002	.el .IP "\fB\f(CB\*(C`ESC [ Ps G\*(C'\fB\fR" 4	1276	.el .IP "\fB\f(CBESC [ Ps G\fB\fR" 4
1003	.IX Item "ESC [ Ps G"	1277	.IX Item "ESC [ Ps G"
1004	Cursor to Column \fB\f(CB\*(C`Ps\*(C'\fB\fR (\s-1HPA\s0)	1278	Cursor to Column \fB\f(CB\*(C`Ps\*(C'\fB\fR (\s-1HPA\s0)
1005	.ie n .IP "\fB\fB\*(C`ESC [ Ps;Ps H\*(C'\fB\fR" 4	1279	.ie n .IP "\fB\fB""ESC [ Ps;Ps H""\fB\fR" 4
1006	.el .IP "\fB\f(CB\*(C`ESC [ Ps;Ps H\*(C'\fB\fR" 4	1280	.el .IP "\fB\f(CBESC [ Ps;Ps H\fB\fR" 4
1007	.IX Item "ESC [ Ps;Ps H"	1281	.IX Item "ESC [ Ps;Ps H"
1008	Cursor Position [row;column] [default: 1;1] (\s-1CUP\s0)	1282	Cursor Position [row;column] [default: 1;1] (\s-1CUP\s0)
1009	.ie n .IP "\fB\fB\*(C`ESC [ Ps I\*(C'\fB\fR" 4	1283	.ie n .IP "\fB\fB""ESC [ Ps I""\fB\fR" 4
1010	.el .IP "\fB\f(CB\*(C`ESC [ Ps I\*(C'\fB\fR" 4	1284	.el .IP "\fB\f(CBESC [ Ps I\fB\fR" 4
1011	.IX Item "ESC [ Ps I"	1285	.IX Item "ESC [ Ps I"
1012	Move forward \fB\f(CB\*(C`Ps\*(C'\fB\fR tab stops [default: 1]	1286	Move forward \fB\f(CB\*(C`Ps\*(C'\fB\fR tab stops [default: 1]
1013	.ie n .IP "\fB\fB\*(C`ESC [ Ps J\*(C'\fB\fR" 4	1287	.ie n .IP "\fB\fB""ESC [ Ps J""\fB\fR" 4
1014	.el .IP "\fB\f(CB\*(C`ESC [ Ps J\*(C'\fB\fR" 4	1288	.el .IP "\fB\f(CBESC [ Ps J\fB\fR" 4
1015	.IX Item "ESC [ Ps J"	1289	.IX Item "ESC [ Ps J"
1016	Erase in Display (\s-1ED\s0)	1290	Erase in Display (\s-1ED\s0)
1017	.TS	1291	.TS
1018	l l .	1292	l l .
1019	Ps = 0 Clear Below (default)	1293	Ps = 0 Clear Below (default)
1020	Ps = 1 Clear Above	1294	Ps = 1 Clear Above
1021	Ps = 2 Clear All	1295	Ps = 2 Clear All
1022	.TE	1296	.TE
1023		1297
1024	.ie n .IP "\fB\fB\*(C`ESC [ Ps K\*(C'\fB\fR" 4	1298	.ie n .IP "\fB\fB""ESC [ Ps K""\fB\fR" 4
1025	.el .IP "\fB\f(CB\*(C`ESC [ Ps K\*(C'\fB\fR" 4	1299	.el .IP "\fB\f(CBESC [ Ps K\fB\fR" 4
1026	.IX Item "ESC [ Ps K"	1300	.IX Item "ESC [ Ps K"
1027	Erase in Line (\s-1EL\s0)	1301	Erase in Line (\s-1EL\s0)
1028	.TS	1302	.TS
1029	l l .	1303	l l .
1030	Ps = 0 Clear to Right (default)	1304	Ps = 0 Clear to Right (default)
1031	Ps = 1 Clear to Left	1305	Ps = 1 Clear to Left
1032	Ps = 2 Clear All	1306	Ps = 2 Clear All
1033	.TE	1307	.TE
1034		1308
1035	.ie n .IP "\fB\fB\*(C`ESC [ Ps L\*(C'\fB\fR" 4	1309	.ie n .IP "\fB\fB""ESC [ Ps L""\fB\fR" 4
1036	.el .IP "\fB\f(CB\*(C`ESC [ Ps L\*(C'\fB\fR" 4	1310	.el .IP "\fB\f(CBESC [ Ps L\fB\fR" 4
1037	.IX Item "ESC [ Ps L"	1311	.IX Item "ESC [ Ps L"
1038	Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR Line(s) [default: 1] (\s-1IL\s0)	1312	Insert \fB\f(CB\*(C`Ps\*(C'\fB\fR Line(s) [default: 1] (\s-1IL\s0)
1039	.ie n .IP "\fB\fB\*(C`ESC [ Ps M\*(C'\fB\fR" 4	1313	.ie n .IP "\fB\fB""ESC [ Ps M""\fB\fR" 4
1040	.el .IP "\fB\f(CB\*(C`ESC [ Ps M\*(C'\fB\fR" 4	1314	.el .IP "\fB\f(CBESC [ Ps M\fB\fR" 4
1041	.IX Item "ESC [ Ps M"	1315	.IX Item "ESC [ Ps M"
1042	Delete \fB\f(CB\*(C`Ps\*(C'\fB\fR Line(s) [default: 1] (\s-1DL\s0)	1316	Delete \fB\f(CB\*(C`Ps\*(C'\fB\fR Line(s) [default: 1] (\s-1DL\s0)
1043	.ie n .IP "\fB\fB\*(C`ESC [ Ps P\*(C'\fB\fR" 4	1317	.ie n .IP "\fB\fB""ESC [ Ps P""\fB\fR" 4
1044	.el .IP "\fB\f(CB\*(C`ESC [ Ps P\*(C'\fB\fR" 4	1318	.el .IP "\fB\f(CBESC [ Ps P\fB\fR" 4
1045	.IX Item "ESC [ Ps P"	1319	.IX Item "ESC [ Ps P"
1046	Delete \fB\f(CB\*(C`Ps\*(C'\fB\fR Character(s) [default: 1] (\s-1DCH\s0)	1320	Delete \fB\f(CB\*(C`Ps\*(C'\fB\fR Character(s) [default: 1] (\s-1DCH\s0)
1047	.ie n .IP "\fB\fB\*(C`ESC [ Ps;Ps;Ps;Ps;Ps T\*(C'\fB\fR" 4	1321	.ie n .IP "\fB\fB""ESC [ Ps;Ps;Ps;Ps;Ps T""\fB\fR" 4
1048	.el .IP "\fB\f(CB\*(C`ESC [ Ps;Ps;Ps;Ps;Ps T\*(C'\fB\fR" 4	1322	.el .IP "\fB\f(CBESC [ Ps;Ps;Ps;Ps;Ps T\fB\fR" 4
1049	.IX Item "ESC [ Ps;Ps;Ps;Ps;Ps T"	1323	.IX Item "ESC [ Ps;Ps;Ps;Ps;Ps T"
1050	Initiate . \fIunimplemented\fR Parameters are	1324	Initiate . \fIunimplemented\fR Parameters are
1051	[func;startx;starty;firstrow;lastrow].	1325	[func;startx;starty;firstrow;lastrow].
1052	.ie n .IP "\fB\fB\*(C`ESC [ Ps W\*(C'\fB\fR" 4	1326	.ie n .IP "\fB\fB""ESC [ Ps W""\fB\fR" 4
1053	.el .IP "\fB\f(CB\*(C`ESC [ Ps W\*(C'\fB\fR" 4	1327	.el .IP "\fB\f(CBESC [ Ps W\fB\fR" 4
1054	.IX Item "ESC [ Ps W"	1328	.IX Item "ESC [ Ps W"
1055	Tabulator functions	1329	Tabulator functions
1056	.TS	1330	.TS
1057	l l .	1331	l l .
1058	Ps = 0 Tab Set (HTS)	1332	Ps = 0 Tab Set (HTS)
1059	Ps = 2 Tab Clear (TBC), Clear Current Column (default)	1333	Ps = 2 Tab Clear (TBC), Clear Current Column (default)
1060	Ps = 5 Tab Clear (TBC), Clear All	1334	Ps = 5 Tab Clear (TBC), Clear All
1061	.TE	1335	.TE
1062		1336
1063	.ie n .IP "\fB\fB\*(C`ESC [ Ps X\*(C'\fB\fR" 4	1337	.ie n .IP "\fB\fB""ESC [ Ps X""\fB\fR" 4
1064	.el .IP "\fB\f(CB\*(C`ESC [ Ps X\*(C'\fB\fR" 4	1338	.el .IP "\fB\f(CBESC [ Ps X\fB\fR" 4
1065	.IX Item "ESC [ Ps X"	1339	.IX Item "ESC [ Ps X"
1066	Erase \fB\f(CB\*(C`Ps\*(C'\fB\fR Character(s) [default: 1] (\s-1ECH\s0)	1340	Erase \fB\f(CB\*(C`Ps\*(C'\fB\fR Character(s) [default: 1] (\s-1ECH\s0)
1067	.ie n .IP "\fB\fB\*(C`ESC [ Ps Z\*(C'\fB\fR" 4	1341	.ie n .IP "\fB\fB""ESC [ Ps Z""\fB\fR" 4
1068	.el .IP "\fB\f(CB\*(C`ESC [ Ps Z\*(C'\fB\fR" 4	1342	.el .IP "\fB\f(CBESC [ Ps Z\fB\fR" 4
1069	.IX Item "ESC [ Ps Z"	1343	.IX Item "ESC [ Ps Z"
1070	Move backward \fB\f(CB\*(C`Ps\*(C'\fB\fR [default: 1] tab stops	1344	Move backward \fB\f(CB\*(C`Ps\*(C'\fB\fR [default: 1] tab stops
1071	.ie n .IP "\fB\fB\*(C`ESC [ Ps '\*(C'\fB\fR" 4	1345	.ie n .IP "\fB\fB""ESC [ Ps '""\fB\fR" 4
1072	.el .IP "\fB\f(CB\*(C`ESC [ Ps '\*(C'\fB\fR" 4	1346	.el .IP "\fB\f(CBESC [ Ps '\fB\fR" 4
1073	.IX Item "ESC [ Ps '"	1347	.IX Item "ESC [ Ps '"
1074	See \fB\f(CB\*(C`ESC [ Ps G\*(C'\fB\fR	1348	See \fB\f(CB\*(C`ESC [ Ps G\*(C'\fB\fR
1075	.ie n .IP "\fB\fB\*(C`ESC [ Ps a\*(C'\fB\fR" 4	1349	.ie n .IP "\fB\fB""ESC [ Ps a""\fB\fR" 4
1076	.el .IP "\fB\f(CB\*(C`ESC [ Ps a\*(C'\fB\fR" 4	1350	.el .IP "\fB\f(CBESC [ Ps a\fB\fR" 4
1077	.IX Item "ESC [ Ps a"	1351	.IX Item "ESC [ Ps a"
1078	See \fB\f(CB\*(C`ESC [ Ps C\*(C'\fB\fR	1352	See \fB\f(CB\*(C`ESC [ Ps C\*(C'\fB\fR
1079	.ie n .IP "\fB\fB\*(C`ESC [ Ps c\*(C'\fB\fR" 4	1353	.ie n .IP "\fB\fB""ESC [ Ps c""\fB\fR" 4
1080	.el .IP "\fB\f(CB\*(C`ESC [ Ps c\*(C'\fB\fR" 4	1354	.el .IP "\fB\f(CBESC [ Ps c\fB\fR" 4
1081	.IX Item "ESC [ Ps c"	1355	.IX Item "ESC [ Ps c"
1082	Send Device Attributes (\s-1DA\s0)	1356	Send Device Attributes (\s-1DA\s0)
1083	\&\fB\f(CB\*(C`Ps = 0\*(C'\fB\fR (or omitted): request attributes from terminal	1357	\&\fB\f(CB\*(C`Ps = 0\*(C'\fB\fR (or omitted): request attributes from terminal
1084	returns: \fB\f(CB\*(C`ESC[?1;2c\*(C'\fB\fR (``I am a \s-1VT100\s0 with Advanced Video	1358	returns: \fB\f(CB\*(C`ESC [ ? 1 ; 2 c\*(C'\fB\fR (``I am a \s-1VT100\s0 with Advanced Video
1085	Option'')	1359	Option'')
1086	.ie n .IP "\fB\fB\*(C`ESC [ Ps d\*(C'\fB\fR" 4	1360	.ie n .IP "\fB\fB""ESC [ Ps d""\fB\fR" 4
1087	.el .IP "\fB\f(CB\*(C`ESC [ Ps d\*(C'\fB\fR" 4	1361	.el .IP "\fB\f(CBESC [ Ps d\fB\fR" 4
1088	.IX Item "ESC [ Ps d"	1362	.IX Item "ESC [ Ps d"
1089	Cursor to Line \fB\f(CB\*(C`Ps\*(C'\fB\fR (\s-1VPA\s0)	1363	Cursor to Line \fB\f(CB\*(C`Ps\*(C'\fB\fR (\s-1VPA\s0)
1090	.ie n .IP "\fB\fB\*(C`ESC [ Ps e\*(C'\fB\fR" 4	1364	.ie n .IP "\fB\fB""ESC [ Ps e""\fB\fR" 4
1091	.el .IP "\fB\f(CB\*(C`ESC [ Ps e\*(C'\fB\fR" 4	1365	.el .IP "\fB\f(CBESC [ Ps e\fB\fR" 4
1092	.IX Item "ESC [ Ps e"	1366	.IX Item "ESC [ Ps e"
1093	See \fB\f(CB\*(C`ESC [ Ps A\*(C'\fB\fR	1367	See \fB\f(CB\*(C`ESC [ Ps A\*(C'\fB\fR
1094	.ie n .IP "\fB\fB\*(C`ESC [ Ps;Ps f\*(C'\fB\fR" 4	1368	.ie n .IP "\fB\fB""ESC [ Ps;Ps f""\fB\fR" 4
1095	.el .IP "\fB\f(CB\*(C`ESC [ Ps;Ps f\*(C'\fB\fR" 4	1369	.el .IP "\fB\f(CBESC [ Ps;Ps f\fB\fR" 4
1096	.IX Item "ESC [ Ps;Ps f"	1370	.IX Item "ESC [ Ps;Ps f"
1097	Horizontal and Vertical Position [row;column] (\s-1HVP\s0) [default: 1;1]	1371	Horizontal and Vertical Position [row;column] (\s-1HVP\s0) [default: 1;1]
1098	.ie n .IP "\fB\fB\*(C`ESC [ Ps g\*(C'\fB\fR" 4	1372	.ie n .IP "\fB\fB""ESC [ Ps g""\fB\fR" 4
1099	.el .IP "\fB\f(CB\*(C`ESC [ Ps g\*(C'\fB\fR" 4	1373	.el .IP "\fB\f(CBESC [ Ps g\fB\fR" 4
1100	.IX Item "ESC [ Ps g"	1374	.IX Item "ESC [ Ps g"
1101	Tab Clear (\s-1TBC\s0)	1375	Tab Clear (\s-1TBC\s0)
1102	.TS	1376	.TS
1103	l l .	1377	l l .
1104	Ps = 0 Clear Current Column (default)	1378	Ps = 0 Clear Current Column (default)
1105	Ps = 3 Clear All (TBC)	1379	Ps = 3 Clear All (TBC)
1106	.TE	1380	.TE
1107		1381
1108	.ie n .IP "\fB\fB\*(C`ESC [ Pm h\*(C'\fB\fR" 4	1382	.ie n .IP "\fB\fB""ESC [ Pm h""\fB\fR" 4
1109	.el .IP "\fB\f(CB\*(C`ESC [ Pm h\*(C'\fB\fR" 4	1383	.el .IP "\fB\f(CBESC [ Pm h\fB\fR" 4
1110	.IX Item "ESC [ Pm h"	1384	.IX Item "ESC [ Pm h"
1111	Set Mode (\s-1SM\s0). See \fB\f(CB\*(C`ESC [ Pm l\*(C'\fB\fR sequence for description of \f(CW\*(C`Pm\*(C'\fR.	1385	Set Mode (\s-1SM\s0). See \fB\f(CB\*(C`ESC [ Pm l\*(C'\fB\fR sequence for description of \f(CW\*(C`Pm\*(C'\fR.
1112	.ie n .IP "\fB\fB\*(C`ESC [ Ps i\*(C'\fB\fR" 4	1386	.ie n .IP "\fB\fB""ESC [ Ps i""\fB\fR" 4
1113	.el .IP "\fB\f(CB\*(C`ESC [ Ps i\*(C'\fB\fR" 4	1387	.el .IP "\fB\f(CBESC [ Ps i\fB\fR" 4
1114	.IX Item "ESC [ Ps i"	1388	.IX Item "ESC [ Ps i"
1115	Printing. See also the \f(CW\*(C`print\-pipe\*(C'\fR resource.	1389	Printing. See also the \f(CW\*(C`print\-pipe\*(C'\fR resource.
1116	.TS	1390	.TS
1117	l l .	1391	l l .
1118	Ps = 0 print screen (MC0)	1392	Ps = 0 print screen (MC0)
1119	Ps = 4 disable transparent print mode (MC4)	1393	Ps = 4 disable transparent print mode (MC4)
1120	Ps = 5 enable transparent print mode (MC5)	1394	Ps = 5 enable transparent print mode (MC5)
1121	.TE	1395	.TE
1122		1396
1123	.ie n .IP "\fB\fB\*(C`ESC [ Pm l\*(C'\fB\fR" 4	1397	.ie n .IP "\fB\fB""ESC [ Pm l""\fB\fR" 4
1124	.el .IP "\fB\f(CB\*(C`ESC [ Pm l\*(C'\fB\fR" 4	1398	.el .IP "\fB\f(CBESC [ Pm l\fB\fR" 4
1125	.IX Item "ESC [ Pm l"	1399	.IX Item "ESC [ Pm l"
1126	Reset Mode (\s-1RM\s0)	1400	Reset Mode (\s-1RM\s0)
1127	.RS 4	1401	.RS 4
1128	.ie n .IP "\fB\fB\*(C`Ps = 4\*(C'\fB\fR" 4	1402	.ie n .IP "\fB\fB""Ps = 4""\fB\fR" 4
1129	.el .IP "\fB\f(CB\*(C`Ps = 4\*(C'\fB\fR" 4	1403	.el .IP "\fB\f(CBPs = 4\fB\fR" 4
1130	.IX Item "Ps = 4"	1404	.IX Item "Ps = 4"
1131	.TS	1405	.TS
1132	l l .	1406	l l .
1133	h Insert Mode (SMIR)	1407	h Insert Mode (SMIR)
1134	l Replace Mode (RMIR)	1408	l Replace Mode (RMIR)
1135	.TE	1409	.TE
1136		1410
1137	.PD 0	1411	.PD 0
1138	.ie n .IP "\fB\fB\*(C`Ps = 20\*(C'\fB\fR (partially implemented)" 4	1412	.ie n .IP "\fB\fB""Ps = 20""\fB\fR (partially implemented)" 4
1139	.el .IP "\fB\f(CB\*(C`Ps = 20\*(C'\fB\fR (partially implemented)" 4	1413	.el .IP "\fB\f(CBPs = 20\fB\fR (partially implemented)" 4
1140	.IX Item "Ps = 20 (partially implemented)"	1414	.IX Item "Ps = 20 (partially implemented)"
1141	.TS	1415	.TS
1142	l l .	1416	l l .
1143	h Automatic Newline (LNM)	1417	h Automatic Newline (LNM)
1144	l Normal Linefeed (LNM)	1418	l Normal Linefeed (LNM)
1145	.TE	1419	.TE
1146		1420
1147	.RE	1421	.RE
1148	.RS 4	1422	.RS 4
1149	.RE	1423	.RE
1150	.ie n .IP "\fB\fB\*(C`ESC [ Pm m\*(C'\fB\fR" 4	1424	.ie n .IP "\fB\fB""ESC [ Pm m""\fB\fR" 4
1151	.el .IP "\fB\f(CB\*(C`ESC [ Pm m\*(C'\fB\fR" 4	1425	.el .IP "\fB\f(CBESC [ Pm m\fB\fR" 4
1152	.IX Item "ESC [ Pm m"	1426	.IX Item "ESC [ Pm m"
1153	.PD	1427	.PD
1154	Character Attributes (\s-1SGR\s0)	1428	Character Attributes (\s-1SGR\s0)
1155	.TS	1429	.TS
1156	l l .	1430	l l .
…		…
1181	Ps = 96 / 106 fg/bg Bright Cyan	1455	Ps = 96 / 106 fg/bg Bright Cyan
1182	Ps = 97 / 107 fg/bg Bright White	1456	Ps = 97 / 107 fg/bg Bright White
1183	Ps = 99 / 109 fg/bg Bright Default	1457	Ps = 99 / 109 fg/bg Bright Default
1184	.TE	1458	.TE
1185		1459
1186	.ie n .IP "\fB\fB\*(C`ESC [ Ps n\*(C'\fB\fR" 4	1460	.ie n .IP "\fB\fB""ESC [ Ps n""\fB\fR" 4
1187	.el .IP "\fB\f(CB\*(C`ESC [ Ps n\*(C'\fB\fR" 4	1461	.el .IP "\fB\f(CBESC [ Ps n\fB\fR" 4
1188	.IX Item "ESC [ Ps n"	1462	.IX Item "ESC [ Ps n"
1189	Device Status Report (\s-1DSR\s0)	1463	Device Status Report (\s-1DSR\s0)
1190	.TS	1464	.TS
1191	l l .	1465	l l .
1192	Ps = 5 Status Report ESC [ 0 n (``OK'')	1466	Ps = 5 Status Report ESC [ 0 n (``OK'')
1193	Ps = 6 Report Cursor Position (CPR) [row;column] as ESC [ r ; c R	1467	Ps = 6 Report Cursor Position (CPR) [row;column] as ESC [ r ; c R
1194	Ps = 7 Request Display Name	1468	Ps = 7 Request Display Name
1195	Ps = 8 Request Version Number (place in window title)	1469	Ps = 8 Request Version Number (place in window title)
1196	.TE	1470	.TE
1197		1471
1198	.ie n .IP "\fB\fB\*(C`ESC [ Ps;Ps r\*(C'\fB\fR" 4	1472	.ie n .IP "\fB\fB""ESC [ Ps;Ps r""\fB\fR" 4
1199	.el .IP "\fB\f(CB\*(C`ESC [ Ps;Ps r\*(C'\fB\fR" 4	1473	.el .IP "\fB\f(CBESC [ Ps;Ps r\fB\fR" 4
1200	.IX Item "ESC [ Ps;Ps r"	1474	.IX Item "ESC [ Ps;Ps r"
1201	Set Scrolling Region [top;bottom]	1475	Set Scrolling Region [top;bottom]
1202	[default: full size of window] (\s-1CSR\s0)	1476	[default: full size of window] (\s-1CSR\s0)
1203	.ie n .IP "\fB\fB\*(C`ESC [ s\*(C'\fB\fR" 4	1477	.ie n .IP "\fB\fB""ESC [ s""\fB\fR" 4
1204	.el .IP "\fB\f(CB\*(C`ESC [ s\*(C'\fB\fR" 4	1478	.el .IP "\fB\f(CBESC [ s\fB\fR" 4
1205	.IX Item "ESC [ s"	1479	.IX Item "ESC [ s"
1206	Save Cursor (\s-1SC\s0)	1480	Save Cursor (\s-1SC\s0)
1207	.ie n .IP "\fB\fB\*(C`ESC [ Ps;Pt t\*(C'\fB\fR" 4	1481	.ie n .IP "\fB\fB""ESC [ Ps;Pt t""\fB\fR" 4
1208	.el .IP "\fB\f(CB\*(C`ESC [ Ps;Pt t\*(C'\fB\fR" 4	1482	.el .IP "\fB\f(CBESC [ Ps;Pt t\fB\fR" 4
1209	.IX Item "ESC [ Ps;Pt t"	1483	.IX Item "ESC [ Ps;Pt t"
1210	Window Operations	1484	Window Operations
1211	.TS	1485	.TS
1212	l l .	1486	l l .
1213	Ps = 1 Deiconify (map) window	1487	Ps = 1 Deiconify (map) window
1214	Ps = 2 Iconify window	1488	Ps = 2 Iconify window
1215	Ps = 3 ESC [ 3 ; X ; Y t Move window to (X|Y)	1489	Ps = 3 ESC [ 3 ; X ; Y t Move window to (X|Y)
1216	Ps = 4 ESC [ 4 ; W ; H t Resize to WxH pixels	1490	Ps = 4 ESC [ 4 ; H ; W t Resize to WxH pixels
1217	Ps = 5 Raise window	1491	Ps = 5 Raise window
1218	Ps = 6 Lower window	1492	Ps = 6 Lower window
1219	Ps = 7 Refresh screen once	1493	Ps = 7 Refresh screen once
1220	Ps = 8 ESC [ 4 ; C ; R t Resize to C columns and R rows	1494	Ps = 8 ESC [ 8 ; R ; C t Resize to R rows and C columns
1221	Ps = 11 Report window state (responds with Ps = 1 or Ps = 2	1495	Ps = 11 Report window state (responds with Ps = 1 or Ps = 2)
1222	Ps = 13 Report window position (responds with Ps = 3)	1496	Ps = 13 Report window position (responds with Ps = 3)
1223	Ps = 14 Report window pixel size (responds with Ps = 4)	1497	Ps = 14 Report window pixel size (responds with Ps = 4)
1224	Ps = 18 Report window text size (responds with Ps = 7)	1498	Ps = 18 Report window text size (responds with Ps = 7)
1225	Ps = 19 Currently the same as Ps = 18, but responds with Ps = 9	1499	Ps = 19 Currently the same as Ps = 18, but responds with Ps = 9
1226	Ps = 20 Reports icon label (ESC ] L NAME \234)	1500	Ps = 20 Reports icon label (ESC ] L NAME \234)
1227	Ps = 21 Reports window title (ESC ] l NAME \234)	1501	Ps = 21 Reports window title (ESC ] l NAME \234)
1228	Ps = 24.. Set window height to Ps rows	1502	Ps = 24.. Set window height to Ps rows
1229	.TE	1503	.TE
1230		1504
1231	.ie n .IP "\fB\fB\*(C`ESC [ u\*(C'\fB\fR" 4	1505	.ie n .IP "\fB\fB""ESC [ u""\fB\fR" 4
1232	.el .IP "\fB\f(CB\*(C`ESC [ u\*(C'\fB\fR" 4	1506	.el .IP "\fB\f(CBESC [ u\fB\fR" 4
1233	.IX Item "ESC [ u"	1507	.IX Item "ESC [ u"
1234	Restore Cursor	1508	Restore Cursor
1235	.ie n .IP "\fB\fB\*(C`ESC [ Ps x\*(C'\fB\fR" 4	1509	.ie n .IP "\fB\fB""ESC [ Ps x""\fB\fR" 4
1236	.el .IP "\fB\f(CB\*(C`ESC [ Ps x\*(C'\fB\fR" 4	1510	.el .IP "\fB\f(CBESC [ Ps x\fB\fR" 4
1237	.IX Item "ESC [ Ps x"	1511	.IX Item "ESC [ Ps x"
1238	Request Terminal Parameters (\s-1DECREQTPARM\s0)	1512	Request Terminal Parameters (\s-1DECREQTPARM\s0)
1239	.PP	1513	.PP
1240		1514
1241	.IX Xref "PrivateModes"	1515	.IX Xref "PrivateModes"
1242	.SH "DEC Private Modes"	1516	.SH "DEC Private Modes"
1243	.IX Header "DEC Private Modes"	1517	.IX Header "DEC Private Modes"
1244	.ie n .IP "\fB\fB\*(C`ESC [ ? Pm h\*(C'\fB\fR" 4	1518	.ie n .IP "\fB\fB""ESC [ ? Pm h""\fB\fR" 4
1245	.el .IP "\fB\f(CB\*(C`ESC [ ? Pm h\*(C'\fB\fR" 4	1519	.el .IP "\fB\f(CBESC [ ? Pm h\fB\fR" 4
1246	.IX Item "ESC [ ? Pm h"	1520	.IX Item "ESC [ ? Pm h"
1247	\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)	1521	\&\s-1DEC\s0 Private Mode Set (\s-1DECSET\s0)
1248	.ie n .IP "\fB\fB\*(C`ESC [ ? Pm l\*(C'\fB\fR" 4	1522	.ie n .IP "\fB\fB""ESC [ ? Pm l""\fB\fR" 4
1249	.el .IP "\fB\f(CB\*(C`ESC [ ? Pm l\*(C'\fB\fR" 4	1523	.el .IP "\fB\f(CBESC [ ? Pm l\fB\fR" 4
1250	.IX Item "ESC [ ? Pm l"	1524	.IX Item "ESC [ ? Pm l"
1251	\&\s-1DEC\s0 Private Mode Reset (\s-1DECRST\s0)	1525	\&\s-1DEC\s0 Private Mode Reset (\s-1DECRST\s0)
1252	.ie n .IP "\fB\fB\*(C`ESC [ ? Pm r\*(C'\fB\fR" 4	1526	.ie n .IP "\fB\fB""ESC [ ? Pm r""\fB\fR" 4
1253	.el .IP "\fB\f(CB\*(C`ESC [ ? Pm r\*(C'\fB\fR" 4	1527	.el .IP "\fB\f(CBESC [ ? Pm r\fB\fR" 4
1254	.IX Item "ESC [ ? Pm r"	1528	.IX Item "ESC [ ? Pm r"
1255	Restore previously saved \s-1DEC\s0 Private Mode Values.	1529	Restore previously saved \s-1DEC\s0 Private Mode Values.
1256	.ie n .IP "\fB\fB\*(C`ESC [ ? Pm s\*(C'\fB\fR" 4	1530	.ie n .IP "\fB\fB""ESC [ ? Pm s""\fB\fR" 4
1257	.el .IP "\fB\f(CB\*(C`ESC [ ? Pm s\*(C'\fB\fR" 4	1531	.el .IP "\fB\f(CBESC [ ? Pm s\fB\fR" 4
1258	.IX Item "ESC [ ? Pm s"	1532	.IX Item "ESC [ ? Pm s"
1259	Save \s-1DEC\s0 Private Mode Values.	1533	Save \s-1DEC\s0 Private Mode Values.
1260	.ie n .IP "\fB\fB\*(C`ESC [ ? Pm t\*(C'\fB\fR" 4	1534	.ie n .IP "\fB\fB""ESC [ ? Pm t""\fB\fR" 4
1261	.el .IP "\fB\f(CB\*(C`ESC [ ? Pm t\*(C'\fB\fR" 4	1535	.el .IP "\fB\f(CBESC [ ? Pm t\fB\fR" 4
1262	.IX Item "ESC [ ? Pm t"	1536	.IX Item "ESC [ ? Pm t"
1263	Toggle \s-1DEC\s0 Private Mode Values (rxvt extension). \fIwhere\fR	1537	Toggle \s-1DEC\s0 Private Mode Values (rxvt extension). \fIwhere\fR
1264	.RS 4	1538	.RS 4
1265	.ie n .IP "\fB\fB\*(C`Ps = 1\*(C'\fB\fR (\s-1DECCKM\s0)" 4	1539	.ie n .IP "\fB\fB""Ps = 1""\fB\fR (\s-1DECCKM\s0)" 4
1266	.el .IP "\fB\f(CB\*(C`Ps = 1\*(C'\fB\fR (\s-1DECCKM\s0)" 4	1540	.el .IP "\fB\f(CBPs = 1\fB\fR (\s-1DECCKM\s0)" 4
1267	.IX Item "Ps = 1 (DECCKM)"	1541	.IX Item "Ps = 1 (DECCKM)"
1268	.TS	1542	.TS
1269	l l .	1543	l l .
1270	h Application Cursor Keys	1544	h Application Cursor Keys
1271	l Normal Cursor Keys	1545	l Normal Cursor Keys
1272	.TE	1546	.TE
1273		1547
1274	.PD 0	1548	.PD 0
1275	.ie n .IP "\fB\fB\*(C`Ps = 2\*(C'\fB\fR (\s-1ANSI/VT52\s0 mode)" 4	1549	.ie n .IP "\fB\fB""Ps = 2""\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
1276	.el .IP "\fB\f(CB\*(C`Ps = 2\*(C'\fB\fR (\s-1ANSI/VT52\s0 mode)" 4	1550	.el .IP "\fB\f(CBPs = 2\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
1277	.IX Item "Ps = 2 (ANSI/VT52 mode)"	1551	.IX Item "Ps = 2 (ANSI/VT52 mode)"
1278	.TS	1552	.TS
1279	l l .	1553	l l .
1280	h Enter VT52 mode	1554	h Enter VT52 mode
1281	l Enter VT52 mode	1555	l Enter VT52 mode
1282	.TE	1556	.TE
1283		1557
1284	.ie n .IP "\fB\fB\*(C`Ps = 3\*(C'\fB\fR" 4	1558	.ie n .IP "\fB\fB""Ps = 3""\fB\fR" 4
1285	.el .IP "\fB\f(CB\*(C`Ps = 3\*(C'\fB\fR" 4	1559	.el .IP "\fB\f(CBPs = 3\fB\fR" 4
1286	.IX Item "Ps = 3"	1560	.IX Item "Ps = 3"
1287	.TS	1561	.TS
1288	l l .	1562	l l .
1289	h 132 Column Mode (DECCOLM)	1563	h 132 Column Mode (DECCOLM)
1290	l 80 Column Mode (DECCOLM)	1564	l 80 Column Mode (DECCOLM)
1291	.TE	1565	.TE
1292		1566
1293	.ie n .IP "\fB\fB\*(C`Ps = 4\*(C'\fB\fR" 4	1567	.ie n .IP "\fB\fB""Ps = 4""\fB\fR" 4
1294	.el .IP "\fB\f(CB\*(C`Ps = 4\*(C'\fB\fR" 4	1568	.el .IP "\fB\f(CBPs = 4\fB\fR" 4
1295	.IX Item "Ps = 4"	1569	.IX Item "Ps = 4"
1296	.TS	1570	.TS
1297	l l .	1571	l l .
1298	h Smooth (Slow) Scroll (DECSCLM)	1572	h Smooth (Slow) Scroll (DECSCLM)
1299	l Jump (Fast) Scroll (DECSCLM)	1573	l Jump (Fast) Scroll (DECSCLM)
1300	.TE	1574	.TE
1301		1575
1302	.ie n .IP "\fB\fB\*(C`Ps = 5\*(C'\fB\fR" 4	1576	.ie n .IP "\fB\fB""Ps = 5""\fB\fR" 4
1303	.el .IP "\fB\f(CB\*(C`Ps = 5\*(C'\fB\fR" 4	1577	.el .IP "\fB\f(CBPs = 5\fB\fR" 4
1304	.IX Item "Ps = 5"	1578	.IX Item "Ps = 5"
1305	.TS	1579	.TS
1306	l l .	1580	l l .
1307	h Reverse Video (DECSCNM)	1581	h Reverse Video (DECSCNM)
1308	l Normal Video (DECSCNM)	1582	l Normal Video (DECSCNM)
1309	.TE	1583	.TE
1310		1584
1311	.ie n .IP "\fB\fB\*(C`Ps = 6\*(C'\fB\fR" 4	1585	.ie n .IP "\fB\fB""Ps = 6""\fB\fR" 4
1312	.el .IP "\fB\f(CB\*(C`Ps = 6\*(C'\fB\fR" 4	1586	.el .IP "\fB\f(CBPs = 6\fB\fR" 4
1313	.IX Item "Ps = 6"	1587	.IX Item "Ps = 6"
1314	.TS	1588	.TS
1315	l l .	1589	l l .
1316	h Origin Mode (DECOM)	1590	h Origin Mode (DECOM)
1317	l Normal Cursor Mode (DECOM)	1591	l Normal Cursor Mode (DECOM)
1318	.TE	1592	.TE
1319		1593
1320	.ie n .IP "\fB\fB\*(C`Ps = 7\*(C'\fB\fR" 4	1594	.ie n .IP "\fB\fB""Ps = 7""\fB\fR" 4
1321	.el .IP "\fB\f(CB\*(C`Ps = 7\*(C'\fB\fR" 4	1595	.el .IP "\fB\f(CBPs = 7\fB\fR" 4
1322	.IX Item "Ps = 7"	1596	.IX Item "Ps = 7"
1323	.TS	1597	.TS
1324	l l .	1598	l l .
1325	h Wraparound Mode (DECAWM)	1599	h Wraparound Mode (DECAWM)
1326	l No Wraparound Mode (DECAWM)	1600	l No Wraparound Mode (DECAWM)
1327	.TE	1601	.TE
1328		1602
1329	.ie n .IP "\fB\fB\*(C`Ps = 8\*(C'\fB\fR \fIunimplemented\fR" 4	1603	.ie n .IP "\fB\fB""Ps = 8""\fB\fR \fIunimplemented\fR" 4
1330	.el .IP "\fB\f(CB\*(C`Ps = 8\*(C'\fB\fR \fIunimplemented\fR" 4	1604	.el .IP "\fB\f(CBPs = 8\fB\fR \fIunimplemented\fR" 4
1331	.IX Item "Ps = 8 unimplemented"	1605	.IX Item "Ps = 8 unimplemented"
1332	.TS	1606	.TS
1333	l l .	1607	l l .
1334	h Auto-repeat Keys (DECARM)	1608	h Auto-repeat Keys (DECARM)
1335	l No Auto-repeat Keys (DECARM)	1609	l No Auto-repeat Keys (DECARM)
1336	.TE	1610	.TE
1337		1611
1338	.ie n .IP "\fB\fB\*(C`Ps = 9\*(C'\fB\fR X10 XTerm" 4	1612	.ie n .IP "\fB\fB""Ps = 9""\fB\fR X10 XTerm" 4
1339	.el .IP "\fB\f(CB\*(C`Ps = 9\*(C'\fB\fR X10 XTerm" 4	1613	.el .IP "\fB\f(CBPs = 9\fB\fR X10 XTerm" 4
1340	.IX Item "Ps = 9 X10 XTerm"	1614	.IX Item "Ps = 9 X10 XTerm"
1341	.TS	1615	.TS
1342	l l .	1616	l l .
1343	h Send Mouse X & Y on button press.	1617	h Send Mouse X & Y on button press.
1344	l No mouse reporting.	1618	l No mouse reporting.
1345	.TE	1619	.TE
1346		1620
1347	.ie n .IP "\fB\fB\*(C`Ps = 10\*(C'\fB\fR (\fBrxvt\fR)" 4
1348	.el .IP "\fB\f(CB\*(C`Ps = 10\*(C'\fB\fR (\fBrxvt\fR)" 4
1349	.IX Item "Ps = 10 (rxvt)"
1350	.TS
1351	l l .
1352	h menuBar visible
1353	l menuBar invisible
1354	.TE
1355
1356	.ie n .IP "\fB\fB\*(C`Ps = 25\*(C'\fB\fR" 4	1621	.ie n .IP "\fB\fB""Ps = 25""\fB\fR" 4
1357	.el .IP "\fB\f(CB\*(C`Ps = 25\*(C'\fB\fR" 4	1622	.el .IP "\fB\f(CBPs = 25\fB\fR" 4
1358	.IX Item "Ps = 25"	1623	.IX Item "Ps = 25"
1359	.TS	1624	.TS
1360	l l .	1625	l l .
1361	h Visible cursor {cnorm/cvvis}	1626	h Visible cursor {cnorm/cvvis}
1362	l Invisible cursor {civis}	1627	l Invisible cursor {civis}
1363	.TE	1628	.TE
1364		1629
1365	.ie n .IP "\fB\fB\*(C`Ps = 30\*(C'\fB\fR" 4	1630	.ie n .IP "\fB\fB""Ps = 30""\fB\fR" 4
1366	.el .IP "\fB\f(CB\*(C`Ps = 30\*(C'\fB\fR" 4	1631	.el .IP "\fB\f(CBPs = 30\fB\fR" 4
1367	.IX Item "Ps = 30"	1632	.IX Item "Ps = 30"
1368	.TS	1633	.TS
1369	l l .	1634	l l .
1370	h scrollBar visisble	1635	h scrollBar visisble
1371	l scrollBar invisisble	1636	l scrollBar invisisble
1372	.TE	1637	.TE
1373		1638
1374	.ie n .IP "\fB\fB\*(C`Ps = 35\*(C'\fB\fR (\fBrxvt\fR)" 4	1639	.ie n .IP "\fB\fB""Ps = 35""\fB\fR (\fBrxvt\fR)" 4
1375	.el .IP "\fB\f(CB\*(C`Ps = 35\*(C'\fB\fR (\fBrxvt\fR)" 4	1640	.el .IP "\fB\f(CBPs = 35\fB\fR (\fBrxvt\fR)" 4
1376	.IX Item "Ps = 35 (rxvt)"	1641	.IX Item "Ps = 35 (rxvt)"
1377	.TS	1642	.TS
1378	l l .	1643	l l .
1379	h Allow XTerm Shift+key sequences	1644	h Allow XTerm Shift+key sequences
1380	l Disallow XTerm Shift+key sequences	1645	l Disallow XTerm Shift+key sequences
1381	.TE	1646	.TE
1382		1647
1383	.ie n .IP "\fB\fB\*(C`Ps = 38\*(C'\fB\fR \fIunimplemented\fR" 4	1648	.ie n .IP "\fB\fB""Ps = 38""\fB\fR \fIunimplemented\fR" 4
1384	.el .IP "\fB\f(CB\*(C`Ps = 38\*(C'\fB\fR \fIunimplemented\fR" 4	1649	.el .IP "\fB\f(CBPs = 38\fB\fR \fIunimplemented\fR" 4
1385	.IX Item "Ps = 38 unimplemented"	1650	.IX Item "Ps = 38 unimplemented"
1386	.PD	1651	.PD
1387	Enter Tektronix Mode (\s-1DECTEK\s0)	1652	Enter Tektronix Mode (\s-1DECTEK\s0)
1388	.ie n .IP "\fB\fB\*(C`Ps = 40\*(C'\fB\fR" 4	1653	.ie n .IP "\fB\fB""Ps = 40""\fB\fR" 4
1389	.el .IP "\fB\f(CB\*(C`Ps = 40\*(C'\fB\fR" 4	1654	.el .IP "\fB\f(CBPs = 40\fB\fR" 4
1390	.IX Item "Ps = 40"	1655	.IX Item "Ps = 40"
1391	.TS	1656	.TS
1392	l l .	1657	l l .
1393	h Allow 80/132 Mode	1658	h Allow 80/132 Mode
1394	l Disallow 80/132 Mode	1659	l Disallow 80/132 Mode
1395	.TE	1660	.TE
1396		1661
1397	.PD 0	1662	.PD 0
1398	.ie n .IP "\fB\fB\*(C`Ps = 44\*(C'\fB\fR \fIunimplemented\fR" 4	1663	.ie n .IP "\fB\fB""Ps = 44""\fB\fR \fIunimplemented\fR" 4
1399	.el .IP "\fB\f(CB\*(C`Ps = 44\*(C'\fB\fR \fIunimplemented\fR" 4	1664	.el .IP "\fB\f(CBPs = 44\fB\fR \fIunimplemented\fR" 4
1400	.IX Item "Ps = 44 unimplemented"	1665	.IX Item "Ps = 44 unimplemented"
1401	.TS	1666	.TS
1402	l l .	1667	l l .
1403	h Turn On Margin Bell	1668	h Turn On Margin Bell
1404	l Turn Off Margin Bell	1669	l Turn Off Margin Bell
1405	.TE	1670	.TE
1406		1671
1407	.ie n .IP "\fB\fB\*(C`Ps = 45\*(C'\fB\fR \fIunimplemented\fR" 4	1672	.ie n .IP "\fB\fB""Ps = 45""\fB\fR \fIunimplemented\fR" 4
1408	.el .IP "\fB\f(CB\*(C`Ps = 45\*(C'\fB\fR \fIunimplemented\fR" 4	1673	.el .IP "\fB\f(CBPs = 45\fB\fR \fIunimplemented\fR" 4
1409	.IX Item "Ps = 45 unimplemented"	1674	.IX Item "Ps = 45 unimplemented"
1410	.TS	1675	.TS
1411	l l .	1676	l l .
1412	h Reverse-wraparound Mode	1677	h Reverse-wraparound Mode
1413	l No Reverse-wraparound Mode	1678	l No Reverse-wraparound Mode
1414	.TE	1679	.TE
1415		1680
1416	.ie n .IP "\fB\fB\*(C`Ps = 46\*(C'\fB\fR \fIunimplemented\fR" 4	1681	.ie n .IP "\fB\fB""Ps = 46""\fB\fR \fIunimplemented\fR" 4
1417	.el .IP "\fB\f(CB\*(C`Ps = 46\*(C'\fB\fR \fIunimplemented\fR" 4	1682	.el .IP "\fB\f(CBPs = 46\fB\fR \fIunimplemented\fR" 4
1418	.IX Item "Ps = 46 unimplemented"	1683	.IX Item "Ps = 46 unimplemented"
1419	.ie n .IP "\fB\fB\*(C`Ps = 47\*(C'\fB\fR" 4	1684	.ie n .IP "\fB\fB""Ps = 47""\fB\fR" 4
1420	.el .IP "\fB\f(CB\*(C`Ps = 47\*(C'\fB\fR" 4	1685	.el .IP "\fB\f(CBPs = 47\fB\fR" 4
1421	.IX Item "Ps = 47"	1686	.IX Item "Ps = 47"
1422	.TS	1687	.TS
1423	l l .	1688	l l .
1424	h Use Alternate Screen Buffer	1689	h Use Alternate Screen Buffer
1425	l Use Normal Screen Buffer	1690	l Use Normal Screen Buffer
1426	.TE	1691	.TE
1427		1692
1428	.PD	1693	.PD
1429		1694
1430	.IX Xref "Priv66"	1695	.IX Xref "Priv66"
1431	.ie n .IP "\fB\fB\*(C`Ps = 66\*(C'\fB\fR" 4	1696	.ie n .IP "\fB\fB""Ps = 66""\fB\fR" 4
1432	.el .IP "\fB\f(CB\*(C`Ps = 66\*(C'\fB\fR" 4	1697	.el .IP "\fB\f(CBPs = 66\fB\fR" 4
1433	.IX Item "Ps = 66"	1698	.IX Item "Ps = 66"
1434	.TS	1699	.TS
1435	l l .	1700	l l .
1436	h Application Keypad (DECPAM) == ESC =	1701	h Application Keypad (DECPAM) == ESC =
1437	l Normal Keypad (DECPNM) == ESC >	1702	l Normal Keypad (DECPNM) == ESC >
1438	.TE	1703	.TE
1439		1704
1440	.PD 0	1705	.PD 0
1441	.ie n .IP "\fB\fB\*(C`Ps = 67\*(C'\fB\fR" 4	1706	.ie n .IP "\fB\fB""Ps = 67""\fB\fR" 4
1442	.el .IP "\fB\f(CB\*(C`Ps = 67\*(C'\fB\fR" 4	1707	.el .IP "\fB\f(CBPs = 67\fB\fR" 4
1443	.IX Item "Ps = 67"	1708	.IX Item "Ps = 67"
1444	.TS	1709	.TS
1445	l l .	1710	l l .
1446	h Backspace key sends BS (DECBKM)	1711	h Backspace key sends BS (DECBKM)
1447	l Backspace key sends DEL	1712	l Backspace key sends DEL
1448	.TE	1713	.TE
1449		1714
1450	.ie n .IP "\fB\fB\*(C`Ps = 1000\*(C'\fB\fR (X11 XTerm)" 4	1715	.ie n .IP "\fB\fB""Ps = 1000""\fB\fR (X11 XTerm)" 4
1451	.el .IP "\fB\f(CB\*(C`Ps = 1000\*(C'\fB\fR (X11 XTerm)" 4	1716	.el .IP "\fB\f(CBPs = 1000\fB\fR (X11 XTerm)" 4
1452	.IX Item "Ps = 1000 (X11 XTerm)"	1717	.IX Item "Ps = 1000 (X11 XTerm)"
1453	.TS	1718	.TS
1454	l l .	1719	l l .
1455	h Send Mouse X & Y on button press and release.	1720	h Send Mouse X & Y on button press and release.
1456	l No mouse reporting.	1721	l No mouse reporting.
1457	.TE	1722	.TE
1458		1723
1459	.ie n .IP "\fB\fB\*(C`Ps = 1001\*(C'\fB\fR (X11 XTerm) \fIunimplemented\fR" 4	1724	.ie n .IP "\fB\fB""Ps = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
1460	.el .IP "\fB\f(CB\*(C`Ps = 1001\*(C'\fB\fR (X11 XTerm) \fIunimplemented\fR" 4	1725	.el .IP "\fB\f(CBPs = 1001\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
1461	.IX Item "Ps = 1001 (X11 XTerm) unimplemented"	1726	.IX Item "Ps = 1001 (X11 XTerm) unimplemented"
1462	.TS	1727	.TS
1463	l l .	1728	l l .
1464	h Use Hilite Mouse Tracking.	1729	h Use Hilite Mouse Tracking.
1465	l No mouse reporting.	1730	l No mouse reporting.
1466	.TE	1731	.TE
1467		1732
1468	.ie n .IP "\fB\fB\*(C`Ps = 1010\*(C'\fB\fR (\fBrxvt\fR)" 4	1733	.ie n .IP "\fB\fB""Ps = 1010""\fB\fR (\fBrxvt\fR)" 4
1469	.el .IP "\fB\f(CB\*(C`Ps = 1010\*(C'\fB\fR (\fBrxvt\fR)" 4	1734	.el .IP "\fB\f(CBPs = 1010\fB\fR (\fBrxvt\fR)" 4
1470	.IX Item "Ps = 1010 (rxvt)"	1735	.IX Item "Ps = 1010 (rxvt)"
1471	.TS	1736	.TS
1472	l l .	1737	l l .
1473	h Don't scroll to bottom on TTY output	1738	h Don't scroll to bottom on TTY output
1474	l Scroll to bottom on TTY output	1739	l Scroll to bottom on TTY output
1475	.TE	1740	.TE
1476		1741
1477	.ie n .IP "\fB\fB\*(C`Ps = 1011\*(C'\fB\fR (\fBrxvt\fR)" 4	1742	.ie n .IP "\fB\fB""Ps = 1011""\fB\fR (\fBrxvt\fR)" 4
1478	.el .IP "\fB\f(CB\*(C`Ps = 1011\*(C'\fB\fR (\fBrxvt\fR)" 4	1743	.el .IP "\fB\f(CBPs = 1011\fB\fR (\fBrxvt\fR)" 4
1479	.IX Item "Ps = 1011 (rxvt)"	1744	.IX Item "Ps = 1011 (rxvt)"
1480	.TS	1745	.TS
1481	l l .	1746	l l .
1482	h Scroll to bottom when a key is pressed	1747	h Scroll to bottom when a key is pressed
1483	l Don't scroll to bottom when a key is pressed	1748	l Don't scroll to bottom when a key is pressed
1484	.TE	1749	.TE
1485		1750
		1751	.ie n .IP "\fB\fB""Ps = 1021""\fB\fR (\fBrxvt\fR)" 4
		1752	.el .IP "\fB\f(CBPs = 1021\fB\fR (\fBrxvt\fR)" 4
		1753	.IX Item "Ps = 1021 (rxvt)"
		1754	.TS
		1755	l l .
		1756	h Bold/italic implies high intensity (see option -is)
		1757	l Font styles have no effect on intensity (Compile styles)
		1758	.TE
		1759
1486	.ie n .IP "\fB\fB\*(C`Ps = 1047\*(C'\fB\fR" 4	1760	.ie n .IP "\fB\fB""Ps = 1047""\fB\fR" 4
1487	.el .IP "\fB\f(CB\*(C`Ps = 1047\*(C'\fB\fR" 4	1761	.el .IP "\fB\f(CBPs = 1047\fB\fR" 4
1488	.IX Item "Ps = 1047"	1762	.IX Item "Ps = 1047"
1489	.TS	1763	.TS
1490	l l .	1764	l l .
1491	h Use Alternate Screen Buffer	1765	h Use Alternate Screen Buffer
1492	l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it	1766	l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
1493	.TE	1767	.TE
1494		1768
1495	.ie n .IP "\fB\fB\*(C`Ps = 1048\*(C'\fB\fR" 4	1769	.ie n .IP "\fB\fB""Ps = 1048""\fB\fR" 4
1496	.el .IP "\fB\f(CB\*(C`Ps = 1048\*(C'\fB\fR" 4	1770	.el .IP "\fB\f(CBPs = 1048\fB\fR" 4
1497	.IX Item "Ps = 1048"	1771	.IX Item "Ps = 1048"
1498	.TS	1772	.TS
1499	l l .	1773	l l .
1500	h Save cursor position	1774	h Save cursor position
1501	l Restore cursor position	1775	l Restore cursor position
1502	.TE	1776	.TE
1503		1777
1504	.ie n .IP "\fB\fB\*(C`Ps = 1049\*(C'\fB\fR" 4	1778	.ie n .IP "\fB\fB""Ps = 1049""\fB\fR" 4
1505	.el .IP "\fB\f(CB\*(C`Ps = 1049\*(C'\fB\fR" 4	1779	.el .IP "\fB\f(CBPs = 1049\fB\fR" 4
1506	.IX Item "Ps = 1049"	1780	.IX Item "Ps = 1049"
1507	.TS	1781	.TS
1508	l l .	1782	l l .
1509	h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it	1783	h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
1510	l Use Normal Screen Buffer	1784	l Use Normal Screen Buffer
…		…
1517	.PP	1791	.PP
1518		1792
1519	.IX Xref "XTerm"	1793	.IX Xref "XTerm"
1520	.SH "XTerm Operating System Commands"	1794	.SH "XTerm Operating System Commands"
1521	.IX Header "XTerm Operating System Commands"	1795	.IX Header "XTerm Operating System Commands"
1522	.ie n .IP "\fB\fB\*(C`ESC ] Ps;Pt ST\*(C'\fB\fR" 4	1796	.ie n .IP "\fB\fB""ESC ] Ps;Pt ST""\fB\fR" 4
1523	.el .IP "\fB\f(CB\*(C`ESC ] Ps;Pt ST\*(C'\fB\fR" 4	1797	.el .IP "\fB\f(CBESC ] Ps;Pt ST\fB\fR" 4
1524	.IX Item "ESC ] Ps;Pt ST"	1798	.IX Item "ESC ] Ps;Pt ST"
1525	Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,	1799	Set XTerm Parameters. 8\-bit \s-1ST:\s0 0x9c, 7\-bit \s-1ST\s0 sequence: \s-1ESC\s0 \e (0x1b,
1526	0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any	1800	0x5c), backwards compatible terminator \s-1BEL\s0 (0x07) is also accepted. any
1527	\&\fBoctet\fR can be escaped by prefixing it with \s-1SYN\s0 (0x16, ^V).	1801	\&\fBoctet\fR can be escaped by prefixing it with \s-1SYN\s0 (0x16, ^V).
1528	.TS	1802	.TS
…		…
1535	Ps = 10 Change colour of text foreground to Pt (NB: may change in future)	1809	Ps = 10 Change colour of text foreground to Pt (NB: may change in future)
1536	Ps = 11 Change colour of text background to Pt (NB: may change in future)	1810	Ps = 11 Change colour of text background to Pt (NB: may change in future)
1537	Ps = 12 Change colour of text cursor foreground to Pt	1811	Ps = 12 Change colour of text cursor foreground to Pt
1538	Ps = 13 Change colour of mouse foreground to Pt	1812	Ps = 13 Change colour of mouse foreground to Pt
1539	Ps = 17 Change colour of highlight characters to Pt	1813	Ps = 17 Change colour of highlight characters to Pt
1540	Ps = 18 Change colour of bold characters to Pt	1814	Ps = 18 Change colour of bold characters to Pt [deprecated, see 706]
1541	Ps = 19 Change colour of underlined characters to Pt	1815	Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707]
1542	Ps = 20 Change default background to Pt	1816	Ps = 20 Change default background to Pt
1543	Ps = 39 Change default foreground colour to Pt rxvt compile-time option	1817	Ps = 39 Change default foreground colour to Pt.
1544	Ps = 46 Change Log File to Pt unimplemented	1818	Ps = 46 Change Log File to Pt unimplemented
1545	Ps = 49 Change default background colour to Pt rxvt compile-time option	1819	Ps = 49 Change default background colour to Pt.
1546	Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n	1820	Ps = 50 Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n
1547	Ps = 55 Log all scrollback buffer and all of screen to Pt	1821	Ps = 55 Log all scrollback buffer and all of screen to Pt
1548	Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (@@RXVT_NAME@@ extension)	1822	Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
1549	Ps = 703 Menubar command Pt rxvt compile-time option (rxvt-unicode extension)
1550	Ps = 704 Change colour of italic characters to Pt	1823	Ps = 704 Change colour of italic characters to Pt
1551	Ps = 705 Change background pixmap tint colour to Pt	1824	Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
		1825	Ps = 706 Change colour of bold characters to Pt
		1826	Ps = 707 Change colour of underlined characters to Pt
1552	Ps = 710 Set normal fontset to Pt. Same as Ps = 50.	1827	Ps = 710 Set normal fontset to Pt. Same as Ps = 50.
1553	Ps = 711 Set bold fontset to Pt. Similar to Ps = 50.	1828	Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
1554	Ps = 712 Set italic fontset to Pt. Similar to Ps = 50.	1829	Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1555	Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50.	1830	Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
		1831	Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
		1832	Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
		1833	Ps = 777 Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).
1556	.TE	1834	.TE
1557		1835
1558	.PP	1836	.PP
1559		1837
1560	.IX Xref "menuBar"	1838	.IX Xref "XPM"
1561	.SH "menuBar"
1562	.IX Header "menuBar"
1563	\&\fBThe exact syntax used is \f(BIalmost\fB solidified.\fR
1564	In the menus, \fB\s-1DON\s0'T\fR try to use menuBar commands that add or remove a
1565	menuBar.
1566	.PP
1567	Note that in all of the commands, the \fB\f(BI/path/\fB\fR \fIcannot\fR be
1568	omitted: use \fB./\fR to specify a menu relative to the current menu.
1569	.Sh "Overview of menuBar operation"
1570	.IX Subsection "Overview of menuBar operation"
1571	For the menuBar XTerm escape sequence \f(CW\*(C`ESC ] 703 ; Pt ST\*(C'\fR, the syntax
1572	of \f(CW\*(C`Pt\*(C'\fR can be used for a variety of tasks:
1573	.PP
1574	At the top level is the current menuBar which is a member of a circular
1575	linked-list of other such menuBars.
1576	.PP
1577	The menuBar acts as a parent for the various drop-down menus, which in
1578	turn, may have labels, separator lines, menuItems and subMenus.
1579	.PP
1580	The menuItems are the useful bits: you can use them to mimic keyboard
1581	input or even to send text or escape sequences back to rxvt.
1582	.PP
1583	The menuBar syntax is intended to provide a simple yet robust method of
1584	constructing and manipulating menus and navigating through the
1585	menuBars.
1586	.PP
1587	The first step is to use the tag \fB[menu:\f(BIname\fB]\fR which creates
1588	the menuBar called \fIname\fR and allows access. You may now or menus,
1589	subMenus, and menuItems. Finally, use the tag \fB[done]\fR to set the
1590	menuBar access as \fBreadonly\fR to prevent accidental corruption of the
1591	menus. To re-access the current menuBar for alterations, use the tag
1592	\&\fB[menu]\fR, make the alterations and then use \fB[done]\fR
1593	.PP
1594
1595	.IX Xref "menuBarCommands"
1596	.Sh "Commands"
1597	.IX Subsection "Commands"
1598	.IP "\fB[menu:+\f(BIname\fB]\fR" 4
1599	.IX Item "[menu:+name]"
1600	access the named menuBar for creation or alteration. If a new menuBar
1601	is created, it is called \fIname\fR (max of 15 chars) and the current
1602	menuBar is pushed onto the stack
1603	.IP "\fB[menu]\fR" 4
1604	.IX Item "[menu]"
1605	access the current menuBar for alteration
1606	.IP "\fB[title:+\f(BIstring\fB]\fR" 4
1607	.IX Item "[title:+string]"
1608	set the current menuBar's title to \fIstring\fR, which may contain the
1609	following format specifiers:
1610	\&\fB%%\fR : literal \fB%\fR character
1611	\&\fB%n\fR : rxvt name (as per the \fB\-name\fR command-line option)
1612	\&\fB%v\fR : rxvt version
1613	.IP "\fB[done]\fR" 4
1614	.IX Item "[done]"
1615	set menuBar access as \fBreadonly\fR.
1616	End-of-file tag for \fB[read:+\f(BIfile\fB]\fR operations.
1617	.IP "\fB[read:+\f(BIfile\fB]\fR" 4
1618	.IX Item "[read:+file]"
1619	read menu commands directly from \fIfile\fR (extension \*(L".menu\*(R" will be
1620	appended if required.) Start reading at a line with \fB[menu]\fR or \fB[menu:+\f(BIname\fB\fR and continuing until \fB[done]\fR is encountered.
1621	.Sp
1622	Blank and comment lines (starting with \fB#\fR) are ignored. Actually,
1623	since any invalid menu commands are also ignored, almost anything could
1624	be construed as a comment line, but this may be tightened up in the
1625	future ... so don't count on it!.
1626	.IP "\fB[read:+\f(BIfile\fB;+\f(BIname\fB]\fR" 4
1627	.IX Item "[read:+file;+name]"
1628	The same as \fB[read:+\f(BIfile\fB]\fR, but start reading at a line with
1629	\&\fB[menu:+\f(BIname\fB]\fR and continuing until \fB[done:+\f(BIname\fB]\fR or
1630	\&\fB[done]\fR is encountered.
1631	.IP "\fB[dump]\fR" 4
1632	.IX Item "[dump]"
1633	dump all menuBars to the file \fB/tmp/rxvt\-PID\fR in a format suitable for
1634	later rereading.
1635	.IP "\fB[rm:name]\fR" 4
1636	.IX Item "[rm:name]"
1637	remove the named menuBar
1638	.IP "\fB[rm] [rm:]\fR" 4
1639	.IX Item "[rm] [rm:]"
1640	remove the current menuBar
1641	.IP "\fB[rm*] [rm:*]\fR" 4
1642	.IX Item "[rm*] [rm:*]"
1643	remove all menuBars
1644	.IP "\fB[swap]\fR" 4
1645	.IX Item "[swap]"
1646	swap the top two menuBars
1647	.IP "\fB[prev]\fR" 4
1648	.IX Item "[prev]"
1649	access the previous menuBar
1650	.IP "\fB[next]\fR" 4
1651	.IX Item "[next]"
1652	access the next menuBar
1653	.IP "\fB[show]\fR" 4
1654	.IX Item "[show]"
1655	Enable display of the menuBar
1656	.IP "\fB[hide]\fR" 4
1657	.IX Item "[hide]"
1658	Disable display of the menuBar
1659	.IP "\fB[pixmap:+\f(BIname\fB]\fR" 4
1660	.IX Item "[pixmap:+name]"
1661	.PD 0
1662	.IP "\fB[pixmap:+\f(BIname\fB;\f(BIscaling\fB]\fR" 4
1663	.IX Item "[pixmap:+name;scaling]"
1664	.PD
1665	(set the background pixmap globally
1666	.Sp
1667	\&\fBA Future implementation \f(BImay\fB make this local to the menubar\fR)
1668	.IP "\fB[:+\f(BIcommand\fB:]\fR" 4
1669	.IX Item "[:+command:]"
1670	ignore the menu readonly status and issue a \fIcommand\fR to or a menu or
1671	menuitem or change the ; a useful shortcut for setting the quick arrows
1672	from a menuBar.
1673	.PP
1674
1675	.IX Xref "menuBarAdd"
1676	.Sh "Adding and accessing menus"
1677	.IX Subsection "Adding and accessing menus"
1678	The following commands may also be \fB+\fR prefixed.
1679	.IP "\fB/+\fR" 4
1680	.IX Item "/+"
1681	access menuBar top level
1682	.IP "\fB./+\fR" 4
1683	.IX Item "./+"
1684	access current menu level
1685	.IP "\fB../+\fR" 4
1686	.IX Item "../+"
1687	access parent menu (1 level up)
1688	.IP "\fB../../\fR" 4
1689	.IX Item "../../"
1690	access parent menu (multiple levels up)
1691	.IP "\fB\f(BI/path/\fBmenu\fR" 4
1692	.IX Item "/path/menu"
1693	add/access menu
1694	.IP "\fB\f(BI/path/\fBmenu/*\fR" 4
1695	.IX Item "/path/menu/*"
1696	add/access menu and clear it if it exists
1697	.IP "\fB\f(BI/path/\fB{\-}\fR" 4
1698	.IX Item "/path/{-}"
1699	add separator
1700	.IP "\fB\f(BI/path/\fB{item}\fR" 4
1701	.IX Item "/path/{item}"
1702	add \fBitem\fR as a label
1703	.IP "\fB\f(BI/path/\fB{item} action\fR" 4
1704	.IX Item "/path/{item} action"
1705	add/alter \fImenuitem\fR with an associated \fIaction\fR
1706	.IP "\fB\f(BI/path/\fB{item}{right\-text}\fR" 4
1707	.IX Item "/path/{item}{right-text}"
1708	add/alter \fImenuitem\fR with \fBright-text\fR as the right-justified text
1709	and as the associated \fIaction\fR
1710	.IP "\fB\f(BI/path/\fB{item}{rtext} action\fR" 4
1711	.IX Item "/path/{item}{rtext} action"
1712	add/alter \fImenuitem\fR with an associated \fIaction\fR and with \fBrtext\fR as
1713	the right-justified text.
1714	.IP "Special characters in \fIaction\fR must be backslash\-escaped:" 4
1715	.IX Item "Special characters in action must be backslash-escaped:"
1716	\&\fB\ea \eb \eE \ee \en \er \et \eoctal\fR
1717	.IP "or in control-character notation:" 4
1718	.IX Item "or in control-character notation:"
1719	\&\fB^@, ^A .. ^Z .. ^_, ^?\fR
1720	.PP
1721	To send a string starting with a \fB\s-1NUL\s0\fR (\fB^@\fR) character to the
1722	program, start \fIaction\fR with a pair of \fB\s-1NUL\s0\fR characters (\fB^@^@\fR),
1723	the first of which will be stripped off and the balance directed to the
1724	program. Otherwise if \fIaction\fR begins with \fB\s-1NUL\s0\fR followed by
1725	non\-+\fB\s-1NUL\s0\fR characters, the leading \fB\s-1NUL\s0\fR is stripped off and the
1726	balance is sent back to rxvt.
1727	.PP
1728	As a convenience for the many Emacs-type editors, \fIaction\fR may start
1729	with \fBM\-\fR (eg, \fBM\-$\fR is equivalent to \fB\eE$\fR) and a \fB\s-1CR\s0\fR will be
1730	appended if missed from \fBM\-x\fR commands.
1731	.PP
1732	As a convenience for issuing XTerm \fB\s-1ESC\s0]\fR sequences from a menubar (or
1733	quick arrow), a \fB\s-1BEL\s0\fR (\fB^G\fR) will be appended if needed.
1734	.IP "For example," 4
1735	.IX Item "For example,"
1736	\&\fBM\-xapropos\fR is equivalent to \fB\eExapropos\er\fR
1737	.IP "and" 4
1738	.IX Item "and"
1739	\&\fB\eE]703;mona;100\fR is equivalent to \fB\eE]703;mona;100\ea\fR
1740	.PP
1741	The option \fB{\f(BIright-rtext\fB}\fR will be right\-justified. In the
1742	absence of a specified action, this text will be used as the \fIaction\fR
1743	as well.
1744	.IP "For example," 4
1745	.IX Item "For example,"
1746	\&\fB/File/{Open}{^X^F}\fR is equivalent to \fB/File/{Open}{^X^F} ^X^F\fR
1747	.PP
1748	The left label \fIis\fR necessary, since it's used for matching, but
1749	implicitly hiding the left label (by using same name for both left and
1750	right labels), or explicitly hiding the left label (by preceeding it
1751	with a dot), makes it possible to have right-justified text only.
1752	.IP "For example," 4
1753	.IX Item "For example,"
1754	\&\fB/File/{Open}{Open} Open-File-Action\fR
1755	.IP "or hiding it" 4
1756	.IX Item "or hiding it"
1757	\&\fB/File/{.anylabel}{Open} Open-File-Action\fR
1758	.PP
1759
1760	.IX Xref "menuBarRemove"
1761	.Sh "Removing menus"
1762	.IX Subsection "Removing menus"
1763	.IP "\fB\-/*+\fR" 4
1764	.IX Item "-/*+"
1765	remove all menus from the menuBar, the same as \fB[clear]\fR
1766	.IP "\fB\-+\f(BI/path\fBmenu+\fR" 4
1767	.IX Item "-+/pathmenu+"
1768	remove menu
1769	.IP "\fB\-+\f(BI/path\fB{item}+\fR" 4
1770	.IX Item "-+/path{item}+"
1771	remove item
1772	.IP "\fB\-+\f(BI/path\fB{\-}\fR" 4
1773	.IX Item "-+/path{-}"
1774	remove separator)
1775	.IP "\fB\-/path/menu/*\fR" 4
1776	.IX Item "-/path/menu/*"
1777	remove all items, separators and submenus from menu
1778	.PP
1779
1780	.IX Xref "menuBarArrows"
1781	.Sh "Quick Arrows"
1782	.IX Subsection "Quick Arrows"
1783	The menus also provide a hook for \fIquick arrows\fR to provide easier
1784	user access. If nothing has been explicitly set, the default is to
1785	emulate the curror keys. The syntax permits each arrow to be altered
1786	individually or all four at once without re-entering their common
1787	beginning/end text. For example, to explicitly associate cursor actions
1788	with the arrows, any of the following forms could be used:
1789	.IP "\fB<r>+\f(BIRight\fB\fR" 4
1790	.IX Item "<r>+Right"
1791	.PD 0
1792	.IP "\fB<l>+\f(BILeft\fB\fR" 4
1793	.IX Item "<l>+Left"
1794	.IP "\fB<u>+\f(BIUp\fB\fR" 4
1795	.IX Item "<u>+Up"
1796	.IP "\fB<d>+\f(BIDown\fB\fR" 4
1797	.IX Item "<d>+Down"
1798	.PD
1799	Define actions for the respective arrow buttons
1800	.IP "\fB<b>+\f(BIBegin\fB\fR" 4
1801	.IX Item "<b>+Begin"
1802	.PD 0
1803	.IP "\fB<e>+\f(BIEnd\fB\fR" 4
1804	.IX Item "<e>+End"
1805	.PD
1806	Define common beginning/end parts for \fIquick arrows\fR which used in
1807	conjunction with the above <r> <l> <u> <d> constructs
1808	.IP "For example, define arrows individually," 4
1809	.IX Item "For example, define arrows individually,"
1810	.Vb 1
1811	\& <u>\eE[A
1812	.Ve
1813	.Sp
1814	.Vb 1
1815	\& <d>\eE[B
1816	.Ve
1817	.Sp
1818	.Vb 1
1819	\& <r>\eE[C
1820	.Ve
1821	.Sp
1822	.Vb 1
1823	\& <l>\eE[D
1824	.Ve
1825	.IP "or all at once" 4
1826	.IX Item "or all at once"
1827	.Vb 1
1828	\& <u>\eE[AZ<><d>\eE[BZ<><r>\eE[CZ<><l>\eE[D
1829	.Ve
1830	.IP "or more compactly (factoring out common parts)" 4
1831	.IX Item "or more compactly (factoring out common parts)"
1832	.Vb 1
1833	\& <b>\eE[<u>AZ<><d>BZ<><r>CZ<><l>D
1834	.Ve
1835	.PP
1836
1837	.IX Xref "menuBarSummary"
1838	.Sh "Command Summary"
1839	.IX Subsection "Command Summary"
1840	A short summary of the most \fIcommon\fR commands:
1841	.IP "[menu:name]" 4
1842	.IX Item "[menu:name]"
1843	use an existing named menuBar or start a new one
1844	.IP "[menu]" 4
1845	.IX Item "[menu]"
1846	use the current menuBar
1847	.IP "[title:string]" 4
1848	.IX Item "[title:string]"
1849	set menuBar title
1850	.IP "[done]" 4
1851	.IX Item "[done]"
1852	set menu access to readonly and, if reading from a file, signal \s-1EOF\s0
1853	.IP "[done:name]" 4
1854	.IX Item "[done:name]"
1855	if reading from a file using [read:file;name] signal \s-1EOF\s0
1856	.IP "[rm:name]" 4
1857	.IX Item "[rm:name]"
1858	remove named menuBar(s)
1859	.IP "[rm] [rm:]" 4
1860	.IX Item "[rm] [rm:]"
1861	remove current menuBar
1862	.IP "[rm*] [rm:*]" 4
1863	.IX Item "[rm*] [rm:*]"
1864	remove all menuBar(s)
1865	.IP "[swap]" 4
1866	.IX Item "[swap]"
1867	swap top two menuBars
1868	.IP "[prev]" 4
1869	.IX Item "[prev]"
1870	access the previous menuBar
1871	.IP "[next]" 4
1872	.IX Item "[next]"
1873	access the next menuBar
1874	.IP "[show]" 4
1875	.IX Item "[show]"
1876	map menuBar
1877	.IP "[hide]" 4
1878	.IX Item "[hide]"
1879	unmap menuBar
1880	.IP "[pixmap;file]" 4
1881	.IX Item "[pixmap;file]"
1882	.PD 0
1883	.IP "[pixmap;file;scaling]" 4
1884	.IX Item "[pixmap;file;scaling]"
1885	.PD
1886	set a background pixmap
1887	.IP "[read:file]" 4
1888	.IX Item "[read:file]"
1889	.PD 0
1890	.IP "[read:file;name]" 4
1891	.IX Item "[read:file;name]"
1892	.PD
1893	read in a menu from a file
1894	.IP "[dump]" 4
1895	.IX Item "[dump]"
1896	dump out all menuBars to /tmp/rxvt\-PID
1897	.IP "/" 4
1898	access menuBar top level
1899	.IP "./" 4
1900	.PD 0
1901	.IP "../" 4
1902	.IP "../../" 4
1903	.PD
1904	access current or parent menu level
1905	.IP "/path/menu" 4
1906	.IX Item "/path/menu"
1907	add/access menu
1908	.IP "/path/{\-}" 4
1909	.IX Item "/path/{-}"
1910	add separator
1911	.IP "/path/{item}{rtext} action" 4
1912	.IX Item "/path/{item}{rtext} action"
1913	add/alter menu item
1914	.IP "\-/*" 4
1915	remove all menus from the menuBar
1916	.IP "\-/path/menu" 4
1917	.IX Item "-/path/menu"
1918	remove menu items, separators and submenus from menu
1919	.IP "\-/path/menu" 4
1920	.IX Item "-/path/menu"
1921	remove menu
1922	.IP "\-/path/{item}" 4
1923	.IX Item "-/path/{item}"
1924	remove item
1925	.IP "\-/path/{\-}" 4
1926	.IX Item "-/path/{-}"
1927	remove separator
1928	.IP "<b>Begin<r>Right<l>Left<u>Up<d>Down<e>End" 4
1929	.IX Item "<b>Begin<r>Right<l>Left<u>Up<d>Down<e>End"
1930	menu quick arrows
1931	.SH "XPM"	1839	.SH "XPM"
1932	.IX Header "XPM"	1840	.IX Header "XPM"
1933	For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value	1841	For the \s-1XPM\s0 XTerm escape sequence \fB\f(CB\*(C`ESC ] 20 ; Pt ST\*(C'\fB\fR then value
1934	of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a	1842	of \fB\f(CB\*(C`Pt\*(C'\fB\fR can be the name of the background pixmap followed by a
1935	sequence of scaling/positioning commands separated by semi\-colons. The	1843	sequence of scaling/positioning commands separated by semi\-colons. The
…		…
1977	.IX Item "E]20;;200;?a"	1885	.IX Item "E]20;;200;?a"
1978	rescale the current pixmap to 200% and display the image geometry in	1886	rescale the current pixmap to 200% and display the image geometry in
1979	the title	1887	the title
1980	.SH "Mouse Reporting"	1888	.SH "Mouse Reporting"
1981	.IX Header "Mouse Reporting"	1889	.IX Header "Mouse Reporting"
1982	.ie n .IP "\fB\fB\*(C`ESC [ M <b> <x> <y>\*(C'\fB\fR" 4	1890	.ie n .IP "\fB\fB""ESC [ M <b> <x> <y>""\fB\fR" 4
1983	.el .IP "\fB\f(CB\*(C`ESC [ M <b> <x> <y>\*(C'\fB\fR" 4	1891	.el .IP "\fB\f(CBESC [ M <b> <x> <y>\fB\fR" 4
1984	.IX Item "ESC [ M <b> <x> <y>"	1892	.IX Item "ESC [ M <b> <x> <y>"
1985	report mouse position	1893	report mouse position
1986	.PP	1894	.PP
1987	The lower 2 bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the button:	1895	The lower 2 bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the button:
1988	.ie n .IP "Button = \fB\fB\*(C`(<b> \- SPACE) & 3\*(C'\fB\fR" 4	1896	.ie n .IP "Button = \fB\fB""(<b> \- SPACE) & 3""\fB\fR" 4
1989	.el .IP "Button = \fB\f(CB\*(C`(<b> \- SPACE) & 3\*(C'\fB\fR" 4	1897	.el .IP "Button = \fB\f(CB(<b> \- SPACE) & 3\fB\fR" 4
1990	.IX Item "Button = (<b> - SPACE) & 3"	1898	.IX Item "Button = (<b> - SPACE) & 3"
1991	.TS	1899	.TS
1992	l l .	1900	l l .
1993	0 Button1 pressed	1901	0 Button1 pressed
1994	1 Button2 pressed	1902	1 Button2 pressed
…		…
1997	.TE	1905	.TE
1998		1906
1999	.PP	1907	.PP
2000	The upper bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the modifiers when the	1908	The upper bits of \fB\f(CB\*(C`<b>\*(C'\fB\fR indicate the modifiers when the
2001	button was pressed and are added together (X11 mouse report only):	1909	button was pressed and are added together (X11 mouse report only):
2002	.ie n .IP "State = \fB\fB\*(C`(<b> \- SPACE) & 60\*(C'\fB\fR" 4	1910	.ie n .IP "State = \fB\fB""(<b> \- SPACE) & 60""\fB\fR" 4
2003	.el .IP "State = \fB\f(CB\*(C`(<b> \- SPACE) & 60\*(C'\fB\fR" 4	1911	.el .IP "State = \fB\f(CB(<b> \- SPACE) & 60\fB\fR" 4
2004	.IX Item "State = (<b> - SPACE) & 60"	1912	.IX Item "State = (<b> - SPACE) & 60"
2005	.TS	1913	.TS
2006	l l .	1914	l l .
2007	4 Shift	1915	4 Shift
2008	8 Meta	1916	8 Meta
…		…
2085	.TE	1993	.TE
2086		1994
2087	.SH "CONFIGURE OPTIONS"	1995	.SH "CONFIGURE OPTIONS"
2088	.IX Header "CONFIGURE OPTIONS"	1996	.IX Header "CONFIGURE OPTIONS"
2089	General hint: if you get compile errors, then likely your configuration	1997	General hint: if you get compile errors, then likely your configuration
2090	hasn't been tested well. Either try with \-\-enable\-everything or use the	1998	hasn't been tested well. Either try with \f(CW\*(C`\-\-enable\-everything\*(C'\fR or use
2091	\&./reconf script as a base for experiments. ./reconf is used by myself,	1999	the \fI./reconf\fR script as a base for experiments. \fI./reconf\fR is used by
2092	so it should generally be a working config. Of course, you should always	2000	myself, so it should generally be a working config. Of course, you should
2093	report when a combination doesn't work, so it can be fixed. Marc Lehmann	2001	always report when a combination doesn't work, so it can be fixed. Marc
2094	<rxvt@schmorp.de>.	2002	Lehmann <rxvt@schmorp.de>.
		2003	.PP
		2004	All
2095	.IP "\-\-enable\-everything" 4	2005	.IP "\-\-enable\-everything" 4
2096	.IX Item "--enable-everything"	2006	.IX Item "--enable-everything"
2097	Add support for all non-multichoice options listed in \*(L"./configure	2007	Add (or remove) support for all non-multichoice options listed in \*(L"./configure
2098	\&\-\-help\*(R". Note that unlike other enable options this is order dependant.	2008	\&\-\-help\*(R".
		2009	.Sp
2099	You can specify this and then disable options which this enables by	2010	You can specify this and then disable options you do not like by
2100	\&\fIfollowing\fR this with the appropriate commands.	2011	\&\fIfollowing\fR this with the appropriate \f(CW\*(C`\-\-disable\-...\*(C'\fR arguments,
2101	.IP "\-\-enable\-xft" 4	2012	or you can start with a minimal configuration by specifying
2102	.IX Item "--enable-xft"	2013	\&\f(CW\*(C`\-\-disable\-everything\*(C'\fR and than adding just the \f(CW\*(C`\-\-enable\-...\*(C'\fR arguments
		2014	you want.
		2015	.IP "\-\-enable\-xft (default: enabled)" 4
		2016	.IX Item "--enable-xft (default: enabled)"
2103	Add support for Xft (anti\-aliases, among others) fonts. Xft fonts are	2017	Add support for Xft (anti\-aliases, among others) fonts. Xft fonts are
2104	slower and require lots of memory, but as long as you don't use them, you	2018	slower and require lots of memory, but as long as you don't use them, you
2105	don't pay for them.	2019	don't pay for them.
2106	.IP "\-\-enable\-font\-styles" 4	2020	.IP "\-\-enable\-font\-styles (default: on)" 4
2107	.IX Item "--enable-font-styles"	2021	.IX Item "--enable-font-styles (default: on)"
2108	Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font	2022	Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font
2109	styles. The fonts can be set manually or automatically.	2023	styles. The fonts can be set manually or automatically.
2110	.IP "\-\-with\-codesets=NAME,..." 4	2024	.IP "\-\-with\-codesets=NAME,... (default: all)" 4
2111	.IX Item "--with-codesets=NAME,..."	2025	.IX Item "--with-codesets=NAME,... (default: all)"
2112	Compile in support for additional codeset (encoding) groups (eu, vn are	2026	Compile in support for additional codeset (encoding) groups (\f(CW\*(C`eu\*(C'\fR, \f(CW\*(C`vn\*(C'\fR
2113	always compiled in, which includes most 8\-bit character sets). These	2027	are always compiled in, which includes most 8\-bit character sets). These
2114	codeset tables are currently only used for driving X11 core fonts, they	2028	codeset tables are used for driving X11 core fonts, they are not required
2115	are not required for Xft fonts. Compiling them in will make your binary	2029	for Xft fonts, although having them compiled in lets rxvt-unicode choose
2116	bigger (together about 700kB), but it doesn't increase memory usage unless	2030	replacement fonts more intelligently. Compiling them in will make your
		2031	binary bigger (all of together cost about 700kB), but it doesn't increase
2117	you use an X11 font requiring one of these encodings.	2032	memory usage unless you use a font requiring one of these encodings.
2118	.TS	2033	.TS
2119	l l .	2034	l l .
2120	all all available codeset groups	2035	all all available codeset groups
2121	zh common chinese encodings	2036	zh common chinese encodings
2122	zh_ext rarely used but very big chinese encodigs	2037	zh_ext rarely used but very big chinese encodigs
2123	jp common japanese encodings	2038	jp common japanese encodings
2124	jp_ext rarely used but big japanese encodings	2039	jp_ext rarely used but big japanese encodings
2125	kr korean encodings	2040	kr korean encodings
2126	.TE	2041	.TE
2127		2042
2128	.IP "\-\-enable\-xim" 4	2043	.IP "\-\-enable\-xim (default: on)" 4
2129	.IX Item "--enable-xim"	2044	.IX Item "--enable-xim (default: on)"
2130	Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using	2045	Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using
2131	alternative input methods (e.g. kinput2) and will also correctly	2046	alternative input methods (e.g. kinput2) and will also correctly
2132	set up the input for people using dead keys or compose keys.	2047	set up the input for people using dead keys or compose keys.
2133	.IP "\-\-enable\-unicode3" 4	2048	.IP "\-\-enable\-unicode3 (default: off)" 4
2134	.IX Item "--enable-unicode3"	2049	.IX Item "--enable-unicode3 (default: off)"
2135	Enable direct support for displaying unicode codepoints above	2050	Enable direct support for displaying unicode codepoints above
2136	65535 (the basic multilingual page). This increases storage	2051	65535 (the basic multilingual page). This increases storage
2137	requirements per character from 2 to 4 bytes. X11 fonts do not yet	2052	requirements per character from 2 to 4 bytes. X11 fonts do not yet
2138	support these extra characters, but Xft does.	2053	support these extra characters, but Xft does.
2139	.Sp	2054	.Sp
2140	Please note that rxvt-unicode can store unicode code points >65535	2055	Please note that rxvt-unicode can store unicode code points >65535
2141	even without this flag, but the number of such characters is	2056	even without this flag, but the number of such characters is
2142	limited to a view thousand (shared with combining characters,	2057	limited to a view thousand (shared with combining characters,
2143	see next switch), and right now rxvt-unicode cannot display them	2058	see next switch), and right now rxvt-unicode cannot display them
2144	(input/output and cut&paste still work, though).	2059	(input/output and cut&paste still work, though).
2145	.IP "\-\-enable\-combining" 4	2060	.IP "\-\-enable\-combining (default: on)" 4
2146	.IX Item "--enable-combining"	2061	.IX Item "--enable-combining (default: on)"
2147	Enable automatic composition of combining characters into	2062	Enable automatic composition of combining characters into
2148	composite characters. This is required for proper viewing of text	2063	composite characters. This is required for proper viewing of text
2149	where accents are encoded as seperate unicode characters. This is	2064	where accents are encoded as seperate unicode characters. This is
2150	done by using precomposited characters when available or creating	2065	done by using precomposited characters when available or creating
2151	new pseudo-characters when no precomposed form exists.	2066	new pseudo-characters when no precomposed form exists.
2152	.Sp	2067	.Sp
2153	Without \-\-enable\-unicode3, the number of additional precomposed	2068	Without \-\-enable\-unicode3, the number of additional precomposed characters
2154	characters is rather limited (2048, if this is full, rxvt will use the	2069	is rather limited (2048, if this is full, rxvt-unicode will use the
2155	private use area, extending the number of combinations to 8448). With	2070	private use area, extending the number of combinations to 8448). With
2156	\&\-\-enable\-unicode3, no practical limit exists. This will also enable	2071	\&\-\-enable\-unicode3, no practical limit exists.
2157	storage of characters >65535.	2072	.Sp
		2073	This option will also enable storage (but not display) of characters
		2074	beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified.
2158	.Sp	2075	.Sp
2159	The combining table also contains entries for arabic presentation forms,	2076	The combining table also contains entries for arabic presentation forms,
2160	but these are not currently used. Bug me if you want these to be used.	2077	but these are not currently used. Bug me if you want these to be used (and
		2078	tell me how these are to be used...).
2161	.IP "\-\-enable\-fallback(=CLASS)" 4	2079	.IP "\-\-enable\-fallback(=CLASS) (default: Rxvt)" 4
2162	.IX Item "--enable-fallback(=CLASS)"	2080	.IX Item "--enable-fallback(=CLASS) (default: Rxvt)"
2163	When reading resource settings, also read settings for class \s-1CLASS\s0	2081	When reading resource settings, also read settings for class \s-1CLASS\s0. To disable resource fallback use \-\-disable\-fallback.
2164	(default: Rxvt). To disable resource fallback use \-\-disable\-fallback.
2165	.IP "\-\-with\-res\-name=NAME" 4	2082	.IP "\-\-with\-res\-name=NAME (default: urxvt)" 4
2166	.IX Item "--with-res-name=NAME"	2083	.IX Item "--with-res-name=NAME (default: urxvt)"
2167	Use the given name (default: urxvt) as default application name when	2084	Use the given name as default application name when
2168	reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt.	2085	reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt.
2169	.IP "\-\-with\-res\-class=CLASS" 4	2086	.IP "\-\-with\-res\-class=CLASS /default: URxvt)" 4
2170	.IX Item "--with-res-class=CLASS"	2087	.IX Item "--with-res-class=CLASS /default: URxvt)"
2171	Use the given class (default: URxvt) as default application class	2088	Use the given class as default application class
2172	when reading resources. Specify \-\-with\-res\-class=Rxvt to replace	2089	when reading resources. Specify \-\-with\-res\-class=Rxvt to replace
2173	rxvt.	2090	rxvt.
2174	.IP "\-\-enable\-utmp" 4	2091	.IP "\-\-enable\-utmp (default: on)" 4
2175	.IX Item "--enable-utmp"	2092	.IX Item "--enable-utmp (default: on)"
2176	Write user and tty to utmp file (used by programs like \fIw\fR) at	2093	Write user and tty to utmp file (used by programs like \fIw\fR) at
2177	start of rxvt execution and delete information when rxvt exits.	2094	start of rxvt execution and delete information when rxvt exits.
2178	.IP "\-\-enable\-wtmp" 4	2095	.IP "\-\-enable\-wtmp (default: on)" 4
2179	.IX Item "--enable-wtmp"	2096	.IX Item "--enable-wtmp (default: on)"
2180	Write user and tty to wtmp file (used by programs like \fIlast\fR) at	2097	Write user and tty to wtmp file (used by programs like \fIlast\fR) at
2181	start of rxvt execution and write logout when rxvt exits. This	2098	start of rxvt execution and write logout when rxvt exits. This
2182	option requires \-\-enable\-utmp to also be specified.	2099	option requires \-\-enable\-utmp to also be specified.
2183	.IP "\-\-enable\-lastlog" 4	2100	.IP "\-\-enable\-lastlog (default: on)" 4
2184	.IX Item "--enable-lastlog"	2101	.IX Item "--enable-lastlog (default: on)"
2185	Write user and tty to lastlog file (used by programs like	2102	Write user and tty to lastlog file (used by programs like
2186	\&\fIlastlogin\fR) at start of rxvt execution. This option requires	2103	\&\fIlastlogin\fR) at start of rxvt execution. This option requires
2187	\&\-\-enable\-utmp to also be specified.	2104	\&\-\-enable\-utmp to also be specified.
2188	.IP "\-\-enable\-xpm\-background" 4	2105	.IP "\-\-enable\-xpm\-background (default: on)" 4
2189	.IX Item "--enable-xpm-background"	2106	.IX Item "--enable-xpm-background (default: on)"
2190	Add support for \s-1XPM\s0 background pixmaps.	2107	Add support for \s-1XPM\s0 background pixmaps.
2191	.IP "\-\-enable\-transparency" 4	2108	.IP "\-\-enable\-transparency (default: on)" 4
2192	.IX Item "--enable-transparency"	2109	.IX Item "--enable-transparency (default: on)"
2193	Add support for inheriting parent backgrounds thus giving a fake	2110	Add support for inheriting parent backgrounds thus giving a fake
2194	transparency to the term.	2111	transparency to the term.
2195	.IP "\-\-enable\-fading" 4	2112	.IP "\-\-enable\-fading (default: on)" 4
2196	.IX Item "--enable-fading"	2113	.IX Item "--enable-fading (default: on)"
2197	Add support for fading the text when focus is lost.	2114	Add support for fading the text when focus is lost (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR).
2198	.IP "\-\-enable\-tinting" 4	2115	.IP "\-\-enable\-tinting (default: on)" 4
2199	.IX Item "--enable-tinting"	2116	.IX Item "--enable-tinting (default: on)"
2200	Add support for tinting of transparent backgrounds.	2117	Add support for tinting of transparent backgrounds (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR).
2201	.IP "\-\-enable\-menubar" 4
2202	.IX Item "--enable-menubar"
2203	Add support for our menu bar system (this interacts badly with
2204	dynamic locale switching currently).
2205	.IP "\-\-enable\-rxvt\-scroll" 4	2118	.IP "\-\-enable\-rxvt\-scroll (default: on)" 4
2206	.IX Item "--enable-rxvt-scroll"	2119	.IX Item "--enable-rxvt-scroll (default: on)"
2207	Add support for the original rxvt scrollbar.	2120	Add support for the original rxvt scrollbar.
2208	.IP "\-\-enable\-next\-scroll" 4	2121	.IP "\-\-enable\-next\-scroll (default: on)" 4
2209	.IX Item "--enable-next-scroll"	2122	.IX Item "--enable-next-scroll (default: on)"
2210	Add support for a NeXT-like scrollbar.	2123	Add support for a NeXT-like scrollbar.
2211	.IP "\-\-enable\-xterm\-scroll" 4	2124	.IP "\-\-enable\-xterm\-scroll (default: on)" 4
2212	.IX Item "--enable-xterm-scroll"	2125	.IX Item "--enable-xterm-scroll (default: on)"
2213	Add support for an Xterm-like scrollbar.	2126	Add support for an Xterm-like scrollbar.
2214	.IP "\-\-enable\-plain\-scroll" 4	2127	.IP "\-\-enable\-plain\-scroll (default: on)" 4
2215	.IX Item "--enable-plain-scroll"	2128	.IX Item "--enable-plain-scroll (default: on)"
2216	Add support for a very unobtrusive, plain-looking scrollbar that	2129	Add support for a very unobtrusive, plain-looking scrollbar that
2217	is the favourite of the rxvt-unicode author, having used it for	2130	is the favourite of the rxvt-unicode author, having used it for
2218	many years.	2131	many years.
2219	.IP "\-\-enable\-half\-shadow" 4	2132	.IP "\-\-enable\-half\-shadow (default: off)" 4
2220	.IX Item "--enable-half-shadow"	2133	.IX Item "--enable-half-shadow (default: off)"
2221	Make shadows on the scrollbar only half the normal width & height.	2134	Make shadows on the scrollbar only half the normal width & height.
2222	only applicable to rxvt scrollbars.	2135	only applicable to rxvt scrollbars.
2223	.IP "\-\-enable\-ttygid" 4	2136	.IP "\-\-enable\-ttygid (default: off)" 4
2224	.IX Item "--enable-ttygid"	2137	.IX Item "--enable-ttygid (default: off)"
2225	Change tty device setting to group \*(L"tty\*(R" \- only use this if	2138	Change tty device setting to group \*(L"tty\*(R" \- only use this if
2226	your system uses this type of security.	2139	your system uses this type of security.
2227	.IP "\-\-disable\-backspace\-key" 4	2140	.IP "\-\-disable\-backspace\-key" 4
2228	.IX Item "--disable-backspace-key"	2141	.IX Item "--disable-backspace-key"
2229	Disable any handling of the backspace key by us \- let the X server	2142	Removes any handling of the backspace key by us \- let the X server do it.
2230	do it.
2231	.IP "\-\-disable\-delete\-key" 4	2143	.IP "\-\-disable\-delete\-key" 4
2232	.IX Item "--disable-delete-key"	2144	.IX Item "--disable-delete-key"
2233	Disable any handling of the delete key by us \- let the X server	2145	Removes any handling of the delete key by us \- let the X server
2234	do it.	2146	do it.
2235	.IP "\-\-disable\-resources" 4	2147	.IP "\-\-disable\-resources" 4
2236	.IX Item "--disable-resources"	2148	.IX Item "--disable-resources"
2237	Remove all resources checking.	2149	Removes any support for resource checking.
2238	.IP "\-\-enable\-xgetdefault" 4
2239	.IX Item "--enable-xgetdefault"
2240	Make resources checking via \fIXGetDefault()\fR instead of our small
2241	version which only checks ~/.Xdefaults, or if that doesn't exist
2242	then ~/.Xresources.
2243	.IP "\-\-enable\-strings" 4
2244	.IX Item "--enable-strings"
2245	Add support for our possibly faster \fImemset()\fR function and other
2246	various routines, overriding your system's versions which may
2247	have been hand-crafted in assembly or may require extra libraries
2248	to link in. (this breaks ANSI-C rules and has problems on many
2249	GNU/Linux systems).
2250	.IP "\-\-disable\-swapscreen" 4	2150	.IP "\-\-disable\-swapscreen" 4
2251	.IX Item "--disable-swapscreen"	2151	.IX Item "--disable-swapscreen"
2252	Remove support for swap screen.	2152	Remove support for secondary/swap screen.
2253	.IP "\-\-enable\-frills" 4	2153	.IP "\-\-enable\-frills (default: on)" 4
2254	.IX Item "--enable-frills"	2154	.IX Item "--enable-frills (default: on)"
2255	Add support for many small features that are not essential but nice to	2155	Add support for many small features that are not essential but nice to
2256	have. Normally you want this, but for very small binaries you may want to	2156	have. Normally you want this, but for very small binaries you may want to
2257	disable this.	2157	disable this.
2258	.Sp	2158	.Sp
2259	A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly	2159	A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2260	in combination with other switches) is:	2160	in combination with other switches) is:
2261	.Sp	2161	.Sp
2262	.Vb 10	2162	.Vb 17
2263	\& MWM-hints	2163	\& MWM-hints
		2164	\& EWMH-hints (pid, utf8 names) and protocols (ping)
2264	\& seperate underline colour	2165	\& seperate underline colour (-underlineColor)
2265	\& settable border widths and borderless switch	2166	\& settable border widths and borderless switch (-w, -b, -bl)
2266	\& settable extra linespacing	2167	\& settable extra linespacing /-lsp)
2267	\& extra window properties (e.g. UTF-8 window names and PID)
2268	\& iso-14755-2 and -3, and visual feedback	2168	\& iso-14755-2 and -3, and visual feedback
2269	\& backindex and forwardindex escape sequence	2169	\& backindex and forwardindex escape sequence
2270	\& window op and locale change escape sequences	2170	\& window op and some xterm/OSC escape sequences
2271	\& tripleclickwords	2171	\& tripleclickwords (-tcw)
2272	\& settable insecure mode	2172	\& settable insecure mode (-insecure)
		2173	\& keysym remapping support
		2174	\& cursor blinking and underline cursor (-cb, -uc)
		2175	\& XEmbed support (-embed)
		2176	\& user-pty (-pty-fd)
		2177	\& hold on exit (-hold)
		2178	\& skip builtin block graphics (-sbg)
		2179	\& sgr modes 90..97 and 100..107
2273	.Ve	2180	.Ve
2274	.IP "\-\-enable\-iso14755" 4	2181	.IP "\-\-enable\-iso14755 (default: on)" 4
2275	.IX Item "--enable-iso14755"	2182	.IX Item "--enable-iso14755 (default: on)"
2276	Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or	2183	Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or
2277	\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by	2184	\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by
2278	\&\f(CW\*(C`\-\-enable\-frills\*(C'\fR, while support for 5.2, 5.3 and 5.4 is enabled with	2185	\&\f(CW\*(C`\-\-enable\-frills\*(C'\fR, while support for 5.2, 5.3 and 5.4 is enabled with
2279	this switch.	2186	this switch.
2280	.IP "\-\-enable\-keepscrolling" 4	2187	.IP "\-\-enable\-keepscrolling (default: on)" 4
2281	.IX Item "--enable-keepscrolling"	2188	.IX Item "--enable-keepscrolling (default: on)"
2282	Add support for continual scrolling of the display when you hold	2189	Add support for continual scrolling of the display when you hold
2283	the mouse button down on a scrollbar arrow.	2190	the mouse button down on a scrollbar arrow.
2284	.IP "\-\-enable\-mousewheel" 4	2191	.IP "\-\-enable\-mousewheel (default: on)" 4
2285	.IX Item "--enable-mousewheel"	2192	.IX Item "--enable-mousewheel (default: on)"
2286	Add support for scrolling via mouse wheel or buttons 4 & 5.	2193	Add support for scrolling via mouse wheel or buttons 4 & 5.
2287	.IP "\-\-enable\-slipwheeling" 4	2194	.IP "\-\-enable\-slipwheeling (default: on)" 4
2288	.IX Item "--enable-slipwheeling"	2195	.IX Item "--enable-slipwheeling (default: on)"
2289	Add support for continual scrolling (using the mouse wheel as an	2196	Add support for continual scrolling (using the mouse wheel as an
2290	accelerator) while the control key is held down. This option	2197	accelerator) while the control key is held down. This option
2291	requires \-\-enable\-mousewheel to also be specified.	2198	requires \-\-enable\-mousewheel to also be specified.
2292	.IP "\-\-disable\-new\-selection" 4	2199	.IP "\-\-disable\-new\-selection" 4
2293	.IX Item "--disable-new-selection"	2200	.IX Item "--disable-new-selection"
2294	Remove support for mouse selection style like that of xterm.	2201	Remove support for mouse selection style like that of xterm.
2295	.IP "\-\-enable\-dmalloc" 4	2202	.IP "\-\-enable\-dmalloc (default: off)" 4
2296	.IX Item "--enable-dmalloc"	2203	.IX Item "--enable-dmalloc (default: off)"
2297	Use Gray Watson's malloc \- which is good for debugging See	2204	Use Gray Watson's malloc \- which is good for debugging See
2298	http://www.letters.com/dmalloc/ for details If you use either this or the	2205	http://www.letters.com/dmalloc/ for details If you use either this or the
2299	next option, you may need to edit src/Makefile after compiling to point	2206	next option, you may need to edit src/Makefile after compiling to point
2300	\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.	2207	\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.
2301	.Sp	2208	.Sp
2302	You can only use either this option and the following (should	2209	You can only use either this option and the following (should
2303	you use either) .	2210	you use either) .
2304	.IP "\-\-enable\-dlmalloc" 4	2211	.IP "\-\-enable\-dlmalloc (default: off)" 4
2305	.IX Item "--enable-dlmalloc"	2212	.IX Item "--enable-dlmalloc (default: off)"
2306	Use Doug Lea's malloc \- which is good for a production version	2213	Use Doug Lea's malloc \- which is good for a production version
2307	See <http://g.oswego.edu/dl/html/malloc.html> for details.	2214	See <http://g.oswego.edu/dl/html/malloc.html> for details.
2308	.IP "\-\-enable\-smart\-resize" 4	2215	.IP "\-\-enable\-smart\-resize (default: on)" 4
2309	.IX Item "--enable-smart-resize"	2216	.IX Item "--enable-smart-resize (default: on)"
2310	Add smart growth/shrink behaviour when changing font size via from hot	2217	Add smart growth/shrink behaviour when changing font size via hot
2311	keys. This should keep in a fixed position the rxvt corner which is	2218	keys. This should keep the window corner which is closest to a corner of
2312	closest to a corner of the screen.	2219	the screen in a fixed position.
2313	.IP "\-\-enable\-cursor\-blink" 4
2314	.IX Item "--enable-cursor-blink"
2315	Add support for a blinking cursor.
2316	.IP "\-\-enable\-pointer\-blank" 4	2220	.IP "\-\-enable\-pointer\-blank (default: on)" 4
2317	.IX Item "--enable-pointer-blank"	2221	.IX Item "--enable-pointer-blank (default: on)"
2318	Add support to have the pointer disappear when typing or inactive.	2222	Add support to have the pointer disappear when typing or inactive.
		2223	.IP "\-\-enable\-perl (default: off)" 4
		2224	.IX Item "--enable-perl (default: off)"
		2225	Enable an embedded perl interpreter. See the \fB@@RXVT_NAME@@\f(BIperl\fB\|(3)\fR
		2226	manpage (\fIdoc/rxvtperl.txt\fR) for more info on this feature, or the files
		2227	in \fIsrc/perl\-ext/\fR for the extensions that are installed by default. The
		2228	perl interpreter that is used can be specified via the \f(CW\*(C`PERL\*(C'\fR environment
		2229	variable when running configure.
2319	.IP "\-\-with\-name=NAME" 4	2230	.IP "\-\-with\-name=NAME (default: urxvt)" 4
2320	.IX Item "--with-name=NAME"	2231	.IX Item "--with-name=NAME (default: urxvt)"
2321	Set the basename for the installed binaries (default: \f(CW\*(C`urxvt\*(C'\fR, resulting	2232	Set the basename for the installed binaries, resulting
2322	in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with	2233	in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with
2323	\&\f(CW\*(C`rxvt\*(C'\fR.	2234	\&\f(CW\*(C`rxvt\*(C'\fR.
2324	.IP "\-\-with\-term=NAME" 4	2235	.IP "\-\-with\-term=NAME (default: rxvt\-unicode)" 4
2325	.IX Item "--with-term=NAME"	2236	.IX Item "--with-term=NAME (default: rxvt-unicode)"
2326	Change the environmental variable for the terminal to \s-1NAME\s0 (default	2237	Change the environmental variable for the terminal to \s-1NAME\s0.
2327	\&\f(CW\*(C`rxvt\-unicode\*(C'\fR)
2328	.IP "\-\-with\-terminfo=PATH" 4	2238	.IP "\-\-with\-terminfo=PATH" 4
2329	.IX Item "--with-terminfo=PATH"	2239	.IX Item "--with-terminfo=PATH"
2330	Change the environmental variable for the path to the terminfo tree to	2240	Change the environmental variable for the path to the terminfo tree to
2331	\&\s-1PATH\s0.	2241	\&\s-1PATH\s0.
2332	.IP "\-\-with\-x" 4	2242	.IP "\-\-with\-x" 4

Diff Legend

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