ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.html
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.html (file contents):
Revision 1.17 by root, Sun Feb 20 19:45:30 2005 UTC vs.
Revision 1.39 by root, Wed Jan 11 19:55:34 2006 UTC

… …
73<p> 73<p>
74</p> 74</p>
75<hr /> 75<hr />
76<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> 76<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1>
77<dl> 77<dl>
78<dt><strong><a name="item_isn_27t_rxvt_supposed_to_be_small_3f_don_27t_all_t">Isn't rxvt supposed to be small? Don't all those features bloat?</a></strong><br />
79</dt>
80<dd>
81I often get asked about this, and I think, no, they didn't cause extra
82bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
83that the urxvt binary is larger (due to some encoding tables always being
84compiled in), but it actually uses less memory (RSS) after startup. Even
85with <code>--disable-everything</code>, this comparison is a bit unfair, as many
86features unique to urxvt (locale, encoding conversion, iso14755 etc.) are
87already in use in this mode.
88</dd>
89<dd>
90<pre>
91 text data bss drs rss filename
92 98398 1664 24 15695 1824 rxvt --disable-everything
93 188985 9048 66616 18222 1788 urxvt --disable-everything</pre>
94</dd>
95<dd>
96<p>When you <a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> (which _is_ unfair, as this involves xft
97and full locale/XIM support which are quite bloaty inside libX11 and my
98libc), the two diverge, but not unreasnobaly so.</p>
99</dd>
100<dd>
101<pre>
102 text data bss drs rss filename
103 163431 2152 24 20123 2060 rxvt --enable-everything
104 1035683 49680 66648 29096 3680 urxvt --enable-everything</pre>
105</dd>
106<dd>
107<p>The very large size of the text section is explained by the east-asian
108encoding tables, which, if unused, take up disk space but nothing else
109and can be compiled out unless you rely on X11 core fonts that use those
110encodings. The BSS size comes from the 64k emergency buffer that my c++
111compiler allocates (but of course doesn't use unless you are out of
112memory). Also, using an xft font instead of a core font immediately adds a
113few megabytes of RSS. Xft indeed is responsible for a lot of RSS even when
114not used.</p>
115</dd>
116<dd>
117<p>Of course, due to every character using two or four bytes instead of one,
118a large scrollback buffer will ultimately make rxvt-unicode use more
119memory.</p>
120</dd>
121<dd>
122<p>Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this
123still fares rather well. And compared to some monsters like gnome-terminal
124(21152k + extra 4204k in separate processes) or konsole (22200k + extra
12543180k in daemons that stay around after exit, plus half a minute of
126startup time, including the hundreds of warnings it spits out), it fares
127extremely well *g*.</p>
128</dd>
129<p></p>
130<dt><strong><a name="item_why_c_2b_2b_2c_isn_27t_that_unportable_2fbloated_2">Why C++, isn't that unportable/bloated/uncool?</a></strong><br />
131</dt>
132<dd>
133Is this a question? :) It comes up very often. The simple answer is: I had
134to write it, and C++ allowed me to write and maintain it in a fraction
135of the time and effort (which is a scarce resource for me). Put even
136shorter: It simply wouldn't exist without C++.
137</dd>
138<dd>
139<p>My personal stance on this is that C++ is less portable than C, but in
140the case of rxvt-unicode this hardly matters, as its portability limits
141are defined by things like X11, pseudo terminals, locale support and unix
142domain sockets, which are all less portable than C++ itself.</p>
143</dd>
144<dd>
145<p>Regarding the bloat, see the above question: It's easy to write programs
146in C that use gobs of memory, an certainly possible to write programs in
147C++ that don't. C++ also often comes with large libraries, but this is
148not necessarily the case with GCC. Here is what rxvt links against on my
149system with a minimal config:</p>
150</dd>
151<dd>
152<pre>
153 libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
154 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaadde000)
155 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab01d000)
156 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)</pre>
157</dd>
158<dd>
159<p>And here is rxvt-unicode:</p>
160</dd>
161<dd>
162<pre>
163 libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
164 libgcc_s.so.1 =&gt; /lib/libgcc_s.so.1 (0x00002aaaaada2000)
165 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaaeb0000)
166 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab0ee000)
167 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)</pre>
168</dd>
169<dd>
170<p>No large bloated libraries (of course, none were linked in statically),
171except maybe libX11 :)</p>
172</dd>
173<p></p>
174<dt><strong><a name="item_does_it_support_tabs_2c_can_i_have_a_tabbed_rxvt_2">Does it support tabs, can I have a tabbed rxvt-unicode?</a></strong><br />
175</dt>
176<dd>
177rxvt-unicode does not directly support tabs. It will work fine with
178tabbing functionality of many window managers or similar tabbing programs,
179and its embedding-features allow it to be embedded into other programs,
180as witnessed by <em>doc/rxvt-tabbed</em> or the upcoming <code>Gtk2::URxvt</code> perl
181module, which features a tabbed urxvt (murxvt) terminal as an example
182embedding application.
183</dd>
184<p></p>
78<dt><strong><a name="item_how_do_i_know_which_rxvt_2dunicode_version_i_27m_u">How do I know which rxvt-unicode version I'm using?</a></strong><br /> 185<dt><strong><a name="item_how_do_i_know_which_rxvt_2dunicode_version_i_27m_u">How do I know which rxvt-unicode version I'm using?</a></strong><br />
79</dt> 186</dt>
80<dd> 187<dd>
81The version number is displayed with the usage (-h). Also the escape 188The version number is displayed with the usage (-h). Also the escape
82sequence <code>ESC [ 8 n</code> sets the window title to the version number. 189sequence <code>ESC [ 8 n</code> sets the window title to the version number. When
190using the rxvtc client, the version displayed is that of the
191daemon.
83</dd> 192</dd>
84<p></p> 193<p></p>
85<dt><strong><a name="item_i_am_using_debian_gnu_2flinux_and_have_a_problem_2">I am using Debian GNU/Linux and have a problem...</a></strong><br /> 194<dt><strong><a name="item_i_am_using_debian_gnu_2flinux_and_have_a_problem_2">I am using Debian GNU/Linux and have a problem...</a></strong><br />
86</dt> 195</dt>
87<dd> 196<dd>
88The Debian GNU/Linux package of rxvt-unicode contains large patches that 197The Debian GNU/Linux package of rxvt-unicode in sarge contains large
89considerably change the behaviour of rxvt-unicode. Before reporting a 198patches that considerably change the behaviour of rxvt-unicode. Before
90bug to the original rxvt-unicode author please download and install the 199reporting a bug to the original rxvt-unicode author please download and
91genuine version (<a href="http://software.schmorp.de#rxvt-unicode">http://software.schmorp.de#rxvt-unicode</a>) and try to 200install the genuine version (<a href="http://software.schmorp.de#rxvt-unicode">http://software.schmorp.de#rxvt-unicode</a>)
92reproduce the problem. If you cannot, chances are that the problems are 201and try to reproduce the problem. If you cannot, chances are that the
93specific to Debian GNU/Linux, in which case it should be reported via the 202problems are specific to Debian GNU/Linux, in which case it should be
94Debian Bug Tracking System (use <code>reportbug</code> to report the bug). 203reported via the Debian Bug Tracking System (use <code>reportbug</code> to report
204the bug).
95</dd> 205</dd>
96<dd> 206<dd>
97<p>For other problems that also affect the Debian package, you can and 207<p>For other problems that also affect the Debian package, you can and
98probably should use the Debian BTS, too, because, after all, it's also a 208probably should use the Debian BTS, too, because, after all, it's also a
99bug in the Debian version and it serves as a reminder for other users that 209bug in the Debian version and it serves as a reminder for other users that
100might encounter the same issue.</p> 210might encounter the same issue.</p>
211</dd>
212<p></p>
213<dt><strong><a name="item_i_am_maintaining_rxvt_2dunicode_for_distribution_2">I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?</a></strong><br />
214</dt>
215<dd>
216You should build one binary with the default options. <em>configure</em>
217now enables most useful options, and the trend goes to making them
218runtime-switchable, too, so there is usually no drawback to enbaling them,
219except higher disk and possibly memory usage. The perl interpreter should
220be enabled, as important functionality (menus, selection, likely more in
221the future) depends on it.
222</dd>
223<dd>
224<p>You should not overwrite the <code>perl-ext-common</code> snd <code>perl-ext</code> resources
225system-wide (except maybe with <code>defaults</code>). This will result in useful
226behaviour. If your distribution aims at low memory, add an empty
227<code>perl-ext-common</code> resource to the app-defaults file. This will keep the
228perl interpreter disabled until the user enables it.</p>
229</dd>
230<dd>
231<p>If you can/want build more binaries, I recommend building a minimal
232one with <code>--disable-everything</code> (very useful) and a maximal one with
233<a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> (less useful, it will be very big due to a lot of
234encodings built-in that increase download times and are rarely used).</p>
235</dd>
236<p></p>
237<dt><strong><a name="item_i_need_to_make_it_setuid_2fsetgid_to_support_utmp_">I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?</a></strong><br />
238</dt>
239<dd>
240Likely not. While I honestly try to make it secure, and am probably not
241bad at it, I think it is simply unreasonable to expect all of freetype
242+ fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be
243secure. Also, rxvt-unicode disables some options when it detects that it
244runs setuid or setgid, which is not nice. Besides, with the embedded perl
245interpreter the possibility for security problems easily multiplies.
246</dd>
247<dd>
248<p>Elevated privileges are only required for utmp and pty operations on some
249systems (for example, GNU/Linux doesn't need any extra privileges for
250ptys, but some need it for utmp support). It is planned to mvoe this into
251a forked handler process, but this is not yet done.</p>
252</dd>
253<dd>
254<p>So, while setuid/setgid operation is supported and not a problem on your
255typical single-user-no-other-logins unix desktop, always remember that
256its an awful lot of code, most of which isn't checked for security issues
257regularly.</p>
101</dd> 258</dd>
102<p></p> 259<p></p>
103<dt><strong><a name="item_when_i_log_2din_to_another_system_it_tells_me_abou">When I log-in to another system it tells me about missing terminfo data?</a></strong><br /> 260<dt><strong><a name="item_when_i_log_2din_to_another_system_it_tells_me_abou">When I log-in to another system it tells me about missing terminfo data?</a></strong><br />
104</dt> 261</dt>
105<dd> 262<dd>
… …
135 URxvt.termName: rxvt</pre> 292 URxvt.termName: rxvt</pre>
136</dd> 293</dd>
137<dd> 294<dd>
138<p>If you don't plan to use <strong>rxvt</strong> (quite common...) you could also replace 295<p>If you don't plan to use <strong>rxvt</strong> (quite common...) you could also replace
139the rxvt terminfo file with the rxvt-unicode one.</p> 296the rxvt terminfo file with the rxvt-unicode one.</p>
297</dd>
298<p></p>
299<dt><strong><a name="item_tic_outputs_some_error_when_compiling_the_terminfo"><code>tic</code> outputs some error when compiling the terminfo entry.</a></strong><br />
300</dt>
301<dd>
302Most likely it's the empty definition for <code>enacs=</code>. Just replace it by
303<code>enacs=\E[0@</code> and try again.
140</dd> 304</dd>
141<p></p> 305<p></p>
142<dt><strong><a name="item_bash_27s_readline_does_not_work_correctly_under_rx"><code>bash</code>'s readline does not work correctly under rxvt.</a></strong><br /> 306<dt><strong><a name="item_bash_27s_readline_does_not_work_correctly_under_rx"><code>bash</code>'s readline does not work correctly under rxvt.</a></strong><br />
143</dt> 307</dt>
144<dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br /> 308<dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br />
… …
371<dd> 535<dd>
372<p>All of this is not a problem when using X11 core fonts, as their bounding 536<p>All of this is not a problem when using X11 core fonts, as their bounding
373box data is correct.</p> 537box data is correct.</p>
374</dd> 538</dd>
375<p></p> 539<p></p>
540<dt><strong><a name="item_on_solaris_9_2c_many_line_2ddrawing_characters_are">On Solaris 9, many line-drawing characters are too wide.</a></strong><br />
541</dt>
542<dd>
543Seems to be a known bug, read
544<a href="http://nixdoc.net/files/forum/about34198.html">http://nixdoc.net/files/forum/about34198.html</a>. Some people use the
545following ugly workaround to get non-double-wide-characters working:
546</dd>
547<dd>
548<pre>
549 #define wcwidth(x) wcwidth(x) &gt; 1 ? 1 : wcwidth(x)</pre>
550</dd>
551<p></p>
376<dt><strong><a name="item_compose">My Compose (Multi_key) key is no longer working.</a></strong><br /> 552<dt><strong><a name="item_compose">My Compose (Multi_key) key is no longer working.</a></strong><br />
377</dt> 553</dt>
378<dd> 554<dd>
379The most common causes for this are that either your locale is not set 555The most common causes for this are that either your locale is not set
380correctly, or you specified a <strong>preeditStyle</strong> that is not supported by 556correctly, or you specified a <strong>preeditStyle</strong> that is not supported by
… …
438<p>As you might have guessed, FreeBSD does neither define this symobl nor 614<p>As you might have guessed, FreeBSD does neither define this symobl nor
439does it support it. Instead, it uses it's own internal representation of 615does it support it. Instead, it uses it's own internal representation of
440<strong>wchar_t</strong>. This is, of course, completely fine with respect to standards.</p> 616<strong>wchar_t</strong>. This is, of course, completely fine with respect to standards.</p>
441</dd> 617</dd>
442<dd> 618<dd>
619<p>However, that means rxvt-unicode only works in <code>POSIX</code>, <code>ISO-8859-1</code> and
620<code>UTF-8</code> locales under FreeBSD (which all use Unicode as <strong>wchar_t</strong>.</p>
621</dd>
622<dd>
443<p>However, <code>__STDC_ISO_10646__</code> is the only sane way to support 623<p><code>__STDC_ISO_10646__</code> is the only sane way to support multi-language
444multi-language apps in an OS, as using a locale-dependent (and 624apps in an OS, as using a locale-dependent (and non-standardized)
445non-standardized) representation of <strong>wchar_t</strong> makes it impossible to 625representation of <strong>wchar_t</strong> makes it impossible to convert between
446convert between <strong>wchar_t</strong> (as used by X11 and your applications) and any 626<strong>wchar_t</strong> (as used by X11 and your applications) and any other encoding
447other encoding without implementing OS-specific-wrappers for each and 627without implementing OS-specific-wrappers for each and every locale. There
448every locale. There simply are no APIs to convert <strong>wchar_t</strong> into anything 628simply are no APIs to convert <strong>wchar_t</strong> into anything except the current
449except the current locale encoding.</p> 629locale encoding.</p>
450</dd> 630</dd>
451<dd> 631<dd>
452<p>Some applications (such as the formidable <strong>mlterm</strong>) work around this 632<p>Some applications (such as the formidable <strong>mlterm</strong>) work around this
453by carrying their own replacement functions for character set handling 633by carrying their own replacement functions for character set handling
454with them, and either implementing OS-dependent hacks or doing multiple 634with them, and either implementing OS-dependent hacks or doing multiple
… …
457</dd> 637</dd>
458<dd> 638<dd>
459<p>The rxvt-unicode author insists that the right way to fix this is in the 639<p>The rxvt-unicode author insists that the right way to fix this is in the
460system libraries once and for all, instead of forcing every app to carry 640system libraries once and for all, instead of forcing every app to carry
461complete replacements for them :)</p> 641complete replacements for them :)</p>
642</dd>
643<p></p>
644<dt><strong><a name="item_i_use_solaris_9_and_it_doesn_27t_compile_2fwork_2f">I use Solaris 9 and it doesn't compile/work/etc.</a></strong><br />
645</dt>
646<dd>
647Try the diff in <em>doc/solaris9.patch</em> as a base. It fixes the worst
648problems with <code>wcwidth</code> and a compile problem.
649</dd>
650<p></p>
651<dt><strong><a name="item_how_can_i_use_rxvt_2dunicode_under_cygwin_3f">How can I use rxvt-unicode under cygwin?</a></strong><br />
652</dt>
653<dd>
654rxvt-unicode should compile and run out of the box on cygwin, using
655the X11 libraries that come with cygwin. libW11 emulation is no
656longer supported (and makes no sense, either, as it only supported a
657single font). I recommend starting the X-server in <code>-multiwindow</code> or
658<code>-rootless</code> mode instead, which will result in similar look&amp;feel as the
659old libW11 emulation.
660</dd>
661<dd>
662<p>At the time of this writing, cygwin didn't seem to support any multi-byte
663encodings (you might try <code>LC_CTYPE=C-UTF-8</code>), so you are likely limited
664to 8-bit encodings.</p>
462</dd> 665</dd>
463<p></p> 666<p></p>
464<dt><strong><a name="item_how_does_rxvt_2dunicode_determine_the_encoding_to_">How does rxvt-unicode determine the encoding to use?</a></strong><br /> 667<dt><strong><a name="item_how_does_rxvt_2dunicode_determine_the_encoding_to_">How does rxvt-unicode determine the encoding to use?</a></strong><br />
465</dt> 668</dt>
466<dt><strong><a name="item_is_there_an_option_to_switch_encodings_3f">Is there an option to switch encodings?</a></strong><br /> 669<dt><strong><a name="item_is_there_an_option_to_switch_encodings_3f">Is there an option to switch encodings?</a></strong><br />
… …
610when used. Compiling it out ensures that no Xft font will be loaded 813when used. Compiling it out ensures that no Xft font will be loaded
611accidentally when rxvt-unicode tries to find a font for your characters. 814accidentally when rxvt-unicode tries to find a font for your characters.
612</dd> 815</dd>
613<dd> 816<dd>
614<p>Also, many people (me included) like large windows and even larger 817<p>Also, many people (me included) like large windows and even larger
615scrollback buffers: Without <a href="#item__2d_2denable_2dunicode3"><code>--enable-unicode3</code></a>, rxvt-unicode will use 818scrollback buffers: Without <code>--enable-unicode3</code>, rxvt-unicode will use
6166 bytes per screen cell. For a 160x?? window this amounts to almost a 8196 bytes per screen cell. For a 160x?? window this amounts to almost a
617kilobyte per line. A scrollback buffer of 10000 lines will then (if full) 820kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
618use 10 Megabytes of memory. With <a href="#item__2d_2denable_2dunicode3"><code>--enable-unicode3</code></a> it gets worse, as 821use 10 Megabytes of memory. With <code>--enable-unicode3</code> it gets worse, as
619rxvt-unicode then uses 8 bytes per screen cell.</p> 822rxvt-unicode then uses 8 bytes per screen cell.</p>
620</dd> 823</dd>
621<p></p> 824<p></p>
622<dt><strong><a name="item_can_i_speed_up_xft_rendering_somehow_3f">Can I speed up Xft rendering somehow?</a></strong><br /> 825<dt><strong><a name="item_can_i_speed_up_xft_rendering_somehow_3f">Can I speed up Xft rendering somehow?</a></strong><br />
623</dt> 826</dt>
624<dd> 827<dd>
625Yes, the most obvious way to speed it up is to avoid Xft entirely, as 828Yes, the most obvious way to speed it up is to avoid Xft entirely, as
626it is simply slow. If you still want Xft fonts you might try to disable 829it is simply slow. If you still want Xft fonts you might try to disable
627antialiasing (by appending <code>:antialiasing=false</code>), which saves lots of 830antialiasing (by appending <code>:antialias=false</code>), which saves lots of
628memory and also speeds up rendering considerably. 831memory and also speeds up rendering considerably.
629</dd> 832</dd>
630<p></p> 833<p></p>
631<dt><strong><a name="item_rxvt_2dunicode_doesn_27t_seem_to_anti_2dalias_its_">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></strong><br /> 834<dt><strong><a name="item_rxvt_2dunicode_doesn_27t_seem_to_anti_2dalias_its_">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></strong><br />
632</dt> 835</dt>
… …
733</dd> 936</dd>
734<p></p> 937<p></p>
735<dt><strong><a name="item_how_can_i_start_rxvtd_in_a_race_2dfree_way_3f">How can I start rxvtd in a race-free way?</a></strong><br /> 938<dt><strong><a name="item_how_can_i_start_rxvtd_in_a_race_2dfree_way_3f">How can I start rxvtd in a race-free way?</a></strong><br />
736</dt> 939</dt>
737<dd> 940<dd>
738Despite it's name, rxvtd is not a real daemon, but more like a 941Try <code>rxvtd -f -o</code>, which tells rxvtd to open the
739server that answers rxvtc's requests, so it doesn't background 942display, create the listening socket and then fork.
740itself.
741</dd>
742<dd>
743<p>To ensure rxvtd is listening on it's socket, you can use the
744following method to wait for the startup message before continuing:</p>
745</dd>
746<dd>
747<pre>
748 { rxvtd &amp; } | read</pre>
749</dd> 943</dd>
750<p></p> 944<p></p>
751<dt><strong><a name="item_what_27s_with_the_strange_backspace_2fdelete_key_b">What's with the strange Backspace/Delete key behaviour?</a></strong><br /> 945<dt><strong><a name="item_what_27s_with_the_strange_backspace_2fdelete_key_b">What's with the strange Backspace/Delete key behaviour?</a></strong><br />
752</dt> 946</dt>
753<dd> 947<dd>
… …
1666</table><dt><strong><a name="item_1011"><strong><code>Ps = 1011</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br /> 1860</table><dt><strong><a name="item_1011"><strong><code>Ps = 1011</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1667</dt> 1861</dt>
1668<table> 1862<table>
1669<tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr> 1863<tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr>
1670<tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr> 1864<tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr>
1865</table><dt><strong><a name="item_1021"><strong><code>Ps = 1021</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1866</dt>
1867<table>
1868<tr><td>h</td><td>Bold/italic implies high intensity (see option -is)</td></tr>
1869<tr><td>l</td><td>Font styles have no effect on intensity (Compile styles)</td></tr>
1671</table><dt><strong><a name="item_ps__3d_1047"><strong><code>Ps = 1047</code> </strong>&gt;</a></strong><br /> 1870</table><dt><strong><a name="item_ps__3d_1047"><strong><code>Ps = 1047</code> </strong>&gt;</a></strong><br />
1672</dt> 1871</dt>
1673<table> 1872<table>
1674<tr><td>h</td><td>Use Alternate Screen Buffer</td></tr> 1873<tr><td>h</td><td>Use Alternate Screen Buffer</td></tr>
1675<tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr> 1874<tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr>
… …
1707<tr><td>Ps = 10</td><td>Change colour of text foreground to Pt (NB: may change in future)</td></tr> 1906<tr><td>Ps = 10</td><td>Change colour of text foreground to Pt (NB: may change in future)</td></tr>
1708<tr><td>Ps = 11</td><td>Change colour of text background to Pt (NB: may change in future)</td></tr> 1907<tr><td>Ps = 11</td><td>Change colour of text background to Pt (NB: may change in future)</td></tr>
1709<tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr> 1908<tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr>
1710<tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr> 1909<tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr>
1711<tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr> 1910<tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr>
1712<tr><td>Ps = 18</td><td>Change colour of bold characters to Pt</td></tr> 1911<tr><td>Ps = 18</td><td>Change colour of bold characters to Pt [deprecated, see 706]</td></tr>
1713<tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt</td></tr> 1912<tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt [deprecated, see 707]</td></tr>
1714<tr><td>Ps = 20</td><td>Change default background to Pt</td></tr> 1913<tr><td>Ps = 20</td><td>Change default background to Pt</td></tr>
1715<tr><td>Ps = 39</td><td>Change default foreground colour to Pt rxvt compile-time option</td></tr> 1914<tr><td>Ps = 39</td><td>Change default foreground colour to Pt.</td></tr>
1716<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr> 1915<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr>
1717<tr><td>Ps = 49</td><td>Change default background colour to Pt rxvt compile-time option</td></tr> 1916<tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr>
1718<tr><td>Ps = 50</td><td>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</td></tr> 1917<tr><td>Ps = 50</td><td>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</td></tr>
1719<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr> 1918<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr>
1720<tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (rxvt extension)</td></tr> 1919<tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).</td></tr>
1721<tr><td>Ps = 703</td><td>Menubar command Pt rxvt compile-time option (rxvt-unicode extension)</td></tr> 1920<tr><td>Ps = 703</td><td>Menubar command Pt (Compile menubar).</td></tr>
1722<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr> 1921<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr>
1723<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt</td></tr> 1922<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr>
1923<tr><td>Ps = 706</td><td>Change colour of bold characters to Pt</td></tr>
1924<tr><td>Ps = 707</td><td>Change colour of underlined characters to Pt</td></tr>
1724<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr> 1925<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr>
1725<tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50.</td></tr> 1926<tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1726<tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50.</td></tr> 1927<tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1727<tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50.</td></tr> 1928<tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1929<tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>
1930<tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>
1931<tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr>
1728</table><p></p></dl> 1932</table><p></p></dl>
1729<p></p> 1933<p></p>
1730<p> 1934<p>
1731</p> 1935</p>
1732<hr /> 1936<hr />
… …
2494</table><p> 2698</table><p>
2495</p> 2699</p>
2496<hr /> 2700<hr />
2497<h1><a name="configure_options">CONFIGURE OPTIONS</a></h1> 2701<h1><a name="configure_options">CONFIGURE OPTIONS</a></h1>
2498<p>General hint: if you get compile errors, then likely your configuration 2702<p>General hint: if you get compile errors, then likely your configuration
2499hasn't been tested well. Either try with --enable-everything or use the 2703hasn't been tested well. Either try with <a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> or use
2500./reconf script as a base for experiments. ./reconf is used by myself, 2704the <em>./reconf</em> script as a base for experiments. <em>./reconf</em> is used by
2501so it should generally be a working config. Of course, you should always 2705myself, so it should generally be a working config. Of course, you should
2502report when a combination doesn't work, so it can be fixed. Marc Lehmann 2706always report when a combination doesn't work, so it can be fixed. Marc
2503&lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt;.</p> 2707Lehmann &lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt;.</p>
2708<p>All</p>
2504<dl> 2709<dl>
2505<dt><strong><a name="item__2d_2denable_2deverything">--enable-everything</a></strong><br /> 2710<dt><strong><a name="item__2d_2denable_2deverything">--enable-everything</a></strong><br />
2506</dt> 2711</dt>
2507<dd> 2712<dd>
2508Add support for all non-multichoice options listed in ``./configure 2713Add (or remove) support for all non-multichoice options listed in ``./configure
2509--help''. Note that unlike other enable options this is order dependant. 2714--help''.
2510You can specify this and then disable options which this enables by 2715</dd>
2511<em>following</em> this with the appropriate commands.
2512</dd> 2716<dd>
2717<p>You can specify this and then disable options you do not like by
2718<em>following</em> this with the appropriate <code>--disable-...</code> arguments,
2719or you can start with a minimal configuration by specifying
2720<code>--disable-everything</code> and than adding just the <code>--enable-...</code> arguments
2721you want.</p>
2722</dd>
2513<p></p> 2723<p></p>
2514<dt><strong><a name="item__2d_2denable_2dxft">--enable-xft</a></strong><br /> 2724<dt><strong><a name="item_xft">--enable-xft (default: enabled)</a></strong><br />
2515</dt> 2725</dt>
2516<dd> 2726<dd>
2517Add support for Xft (anti-aliases, among others) fonts. Xft fonts are 2727Add support for Xft (anti-aliases, among others) fonts. Xft fonts are
2518slower and require lots of memory, but as long as you don't use them, you 2728slower and require lots of memory, but as long as you don't use them, you
2519don't pay for them. 2729don't pay for them.
2520</dd> 2730</dd>
2521<p></p> 2731<p></p>
2522<dt><strong><a name="item__2d_2denable_2dfont_2dstyles">--enable-font-styles</a></strong><br /> 2732<dt><strong><a name="item_styles">--enable-font-styles (default: on)</a></strong><br />
2523</dt> 2733</dt>
2524<dd> 2734<dd>
2525Add support for <strong>bold</strong>, <em>italic</em> and <strong><em>bold italic</em> </strong>&gt; font 2735Add support for <strong>bold</strong>, <em>italic</em> and <strong><em>bold italic</em> </strong>&gt; font
2526styles. The fonts can be set manually or automatically. 2736styles. The fonts can be set manually or automatically.
2527</dd> 2737</dd>
2528<p></p> 2738<p></p>
2529<dt><strong><a name="item__2d_2dwith_2dcodesets_3dname_2c_2e_2e_2e">--with-codesets=NAME,...</a></strong><br /> 2739<dt><strong><a name="item__2d_2dwith_2dcodesets_3dname_2c_2e_2e_2e__28defaul">--with-codesets=NAME,... (default: all)</a></strong><br />
2530</dt> 2740</dt>
2531<dd> 2741<dd>
2532Compile in support for additional codeset (encoding) groups (eu, vn are 2742Compile in support for additional codeset (encoding) groups (<code>eu</code>, <code>vn</code>
2533always compiled in, which includes most 8-bit character sets). These 2743are always compiled in, which includes most 8-bit character sets). These
2534codeset tables are currently only used for driving X11 core fonts, they 2744codeset tables are used for driving X11 core fonts, they are not required
2535are not required for Xft fonts. Compiling them in will make your binary 2745for Xft fonts, although having them compiled in lets rxvt-unicode choose
2536bigger (together about 700kB), but it doesn't increase memory usage unless 2746replacement fonts more intelligently. Compiling them in will make your
2747binary bigger (all of together cost about 700kB), but it doesn't increase
2537you use an X11 font requiring one of these encodings. 2748memory usage unless you use a font requiring one of these encodings.
2538</dd> 2749</dd>
2539<table> 2750<table>
2540<tr><td>all</td><td>all available codeset groups</td></tr> 2751<tr><td>all</td><td>all available codeset groups</td></tr>
2541<tr><td>zh</td><td>common chinese encodings</td></tr> 2752<tr><td>zh</td><td>common chinese encodings</td></tr>
2542<tr><td>zh_ext</td><td>rarely used but very big chinese encodigs</td></tr> 2753<tr><td>zh_ext</td><td>rarely used but very big chinese encodigs</td></tr>
2543<tr><td>jp</td><td>common japanese encodings</td></tr> 2754<tr><td>jp</td><td>common japanese encodings</td></tr>
2544<tr><td>jp_ext</td><td>rarely used but big japanese encodings</td></tr> 2755<tr><td>jp_ext</td><td>rarely used but big japanese encodings</td></tr>
2545<tr><td>kr</td><td>korean encodings</td></tr> 2756<tr><td>kr</td><td>korean encodings</td></tr>
2546</table><p></p> 2757</table><p></p>
2547<dt><strong><a name="item__2d_2denable_2dxim">--enable-xim</a></strong><br /> 2758<dt><strong><a name="item_xim">--enable-xim (default: on)</a></strong><br />
2548</dt> 2759</dt>
2549<dd> 2760<dd>
2550Add support for XIM (X Input Method) protocol. This allows using 2761Add support for XIM (X Input Method) protocol. This allows using
2551alternative input methods (e.g. kinput2) and will also correctly 2762alternative input methods (e.g. kinput2) and will also correctly
2552set up the input for people using dead keys or compose keys. 2763set up the input for people using dead keys or compose keys.
2553</dd> 2764</dd>
2554<p></p> 2765<p></p>
2555<dt><strong><a name="item__2d_2denable_2dunicode3">--enable-unicode3</a></strong><br /> 2766<dt><strong><a name="item_unicode3">--enable-unicode3 (default: off)</a></strong><br />
2556</dt> 2767</dt>
2557<dd> 2768<dd>
2558Enable direct support for displaying unicode codepoints above 2769Enable direct support for displaying unicode codepoints above
255965535 (the basic multilingual page). This increases storage 277065535 (the basic multilingual page). This increases storage
2560requirements per character from 2 to 4 bytes. X11 fonts do not yet 2771requirements per character from 2 to 4 bytes. X11 fonts do not yet
… …
2566limited to a view thousand (shared with combining characters, 2777limited to a view thousand (shared with combining characters,
2567see next switch), and right now rxvt-unicode cannot display them 2778see next switch), and right now rxvt-unicode cannot display them
2568(input/output and cut&amp;paste still work, though).</p> 2779(input/output and cut&amp;paste still work, though).</p>
2569</dd> 2780</dd>
2570<p></p> 2781<p></p>
2571<dt><strong><a name="item__2d_2denable_2dcombining">--enable-combining</a></strong><br /> 2782<dt><strong><a name="item_combining">--enable-combining (default: on)</a></strong><br />
2572</dt> 2783</dt>
2573<dd> 2784<dd>
2574Enable automatic composition of combining characters into 2785Enable automatic composition of combining characters into
2575composite characters. This is required for proper viewing of text 2786composite characters. This is required for proper viewing of text
2576where accents are encoded as seperate unicode characters. This is 2787where accents are encoded as seperate unicode characters. This is
… …
2591<p>The combining table also contains entries for arabic presentation forms, 2802<p>The combining table also contains entries for arabic presentation forms,
2592but these are not currently used. Bug me if you want these to be used (and 2803but these are not currently used. Bug me if you want these to be used (and
2593tell me how these are to be used...).</p> 2804tell me how these are to be used...).</p>
2594</dd> 2805</dd>
2595<p></p> 2806<p></p>
2596<dt><strong><a name="item_fallback">--enable-fallback(=CLASS)</a></strong><br /> 2807<dt><strong><a name="item_fallback">--enable-fallback(=CLASS) (default: Rxvt)</a></strong><br />
2597</dt> 2808</dt>
2598<dd>
2599When reading resource settings, also read settings for class CLASS
2600(default: Rxvt). To disable resource fallback use --disable-fallback.
2601</dd> 2809<dd>
2602<p></p> 2810When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback.
2603<dt><strong><a name="item__2d_2dwith_2dres_2dname_3dname">--with-res-name=NAME</a></strong><br />
2604</dt>
2605<dd> 2811</dd>
2812<p></p>
2813<dt><strong><a name="item_name">--with-res-name=NAME (default: urxvt)</a></strong><br />
2814</dt>
2815<dd>
2606Use the given name (default: urxvt) as default application name when 2816Use the given name as default application name when
2607reading resources. Specify --with-res-name=rxvt to replace rxvt. 2817reading resources. Specify --with-res-name=rxvt to replace rxvt.
2608</dd> 2818</dd>
2609<p></p> 2819<p></p>
2610<dt><strong><a name="item__2d_2dwith_2dres_2dclass_3dclass">--with-res-class=CLASS</a></strong><br /> 2820<dt><strong><a name="item__2d_2dwith_2dres_2dclass_3dclass__2fdefault_3a_urx">--with-res-class=CLASS /default: URxvt)</a></strong><br />
2611</dt> 2821</dt>
2612<dd> 2822<dd>
2613Use the given class (default: URxvt) as default application class 2823Use the given class as default application class
2614when reading resources. Specify --with-res-class=Rxvt to replace 2824when reading resources. Specify --with-res-class=Rxvt to replace
2615rxvt. 2825rxvt.
2616</dd> 2826</dd>
2617<p></p> 2827<p></p>
2618<dt><strong><a name="item__2d_2denable_2dutmp">--enable-utmp</a></strong><br /> 2828<dt><strong><a name="item_utmp">--enable-utmp (default: on)</a></strong><br />
2619</dt> 2829</dt>
2620<dd> 2830<dd>
2621Write user and tty to utmp file (used by programs like <em>w</em>) at 2831Write user and tty to utmp file (used by programs like <em>w</em>) at
2622start of rxvt execution and delete information when rxvt exits. 2832start of rxvt execution and delete information when rxvt exits.
2623</dd> 2833</dd>
2624<p></p> 2834<p></p>
2625<dt><strong><a name="item__2d_2denable_2dwtmp">--enable-wtmp</a></strong><br /> 2835<dt><strong><a name="item_wtmp">--enable-wtmp (default: on)</a></strong><br />
2626</dt> 2836</dt>
2627<dd> 2837<dd>
2628Write user and tty to wtmp file (used by programs like <em>last</em>) at 2838Write user and tty to wtmp file (used by programs like <em>last</em>) at
2629start of rxvt execution and write logout when rxvt exits. This 2839start of rxvt execution and write logout when rxvt exits. This
2630option requires --enable-utmp to also be specified. 2840option requires --enable-utmp to also be specified.
2631</dd> 2841</dd>
2632<p></p> 2842<p></p>
2633<dt><strong><a name="item__2d_2denable_2dlastlog">--enable-lastlog</a></strong><br /> 2843<dt><strong><a name="item_lastlog">--enable-lastlog (default: on)</a></strong><br />
2634</dt> 2844</dt>
2635<dd> 2845<dd>
2636Write user and tty to lastlog file (used by programs like 2846Write user and tty to lastlog file (used by programs like
2637<em>lastlogin</em>) at start of rxvt execution. This option requires 2847<em>lastlogin</em>) at start of rxvt execution. This option requires
2638--enable-utmp to also be specified. 2848--enable-utmp to also be specified.
2639</dd> 2849</dd>
2640<p></p> 2850<p></p>
2641<dt><strong><a name="item__2d_2denable_2dxpm_2dbackground">--enable-xpm-background</a></strong><br /> 2851<dt><strong><a name="item_background">--enable-xpm-background (default: on)</a></strong><br />
2642</dt> 2852</dt>
2643<dd> 2853<dd>
2644Add support for XPM background pixmaps. 2854Add support for XPM background pixmaps.
2645</dd> 2855</dd>
2646<p></p> 2856<p></p>
2647<dt><strong><a name="item__2d_2denable_2dtransparency">--enable-transparency</a></strong><br /> 2857<dt><strong><a name="item_transparency">--enable-transparency (default: on)</a></strong><br />
2648</dt> 2858</dt>
2649<dd> 2859<dd>
2650Add support for inheriting parent backgrounds thus giving a fake 2860Add support for inheriting parent backgrounds thus giving a fake
2651transparency to the term. 2861transparency to the term.
2652</dd> 2862</dd>
2653<p></p> 2863<p></p>
2654<dt><strong><a name="item__2d_2denable_2dfading">--enable-fading</a></strong><br /> 2864<dt><strong><a name="item_fading">--enable-fading (default: on)</a></strong><br />
2655</dt> 2865</dt>
2656<dd>
2657Add support for fading the text when focus is lost.
2658</dd> 2866<dd>
2659<p></p> 2867Add support for fading the text when focus is lost (requires <code>--enable-transparency</code>).
2660<dt><strong><a name="item__2d_2denable_2dtinting">--enable-tinting</a></strong><br />
2661</dt>
2662<dd> 2868</dd>
2663Add support for tinting of transparent backgrounds. 2869<p></p>
2870<dt><strong><a name="item_tinting">--enable-tinting (default: on)</a></strong><br />
2871</dt>
2664</dd> 2872<dd>
2665<p></p> 2873Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>).
2666<dt><strong><a name="item__2d_2denable_2dmenubar">--enable-menubar</a></strong><br />
2667</dt>
2668<dd> 2874</dd>
2875<p></p>
2876<dt><strong><a name="item_menubar">--enable-menubar (default: off) [DEPRECATED]</a></strong><br />
2877</dt>
2878<dd>
2669Add support for our menu bar system (this interacts badly with 2879Add support for our menu bar system (this interacts badly with dynamic
2670dynamic locale switching currently). 2880locale switching currently). This option is DEPRECATED and will be removed
2881in the future.
2671</dd> 2882</dd>
2672<p></p> 2883<p></p>
2673<dt><strong><a name="item__2d_2denable_2drxvt_2dscroll">--enable-rxvt-scroll</a></strong><br /> 2884<dt><strong><a name="item_scroll">--enable-rxvt-scroll (default: on)</a></strong><br />
2674</dt> 2885</dt>
2675<dd> 2886<dd>
2676Add support for the original rxvt scrollbar. 2887Add support for the original rxvt scrollbar.
2677</dd> 2888</dd>
2678<p></p> 2889<p></p>
2679<dt><strong><a name="item__2d_2denable_2dnext_2dscroll">--enable-next-scroll</a></strong><br /> 2890<dt><strong>--enable-next-scroll (default: on)</strong><br />
2680</dt> 2891</dt>
2681<dd> 2892<dd>
2682Add support for a NeXT-like scrollbar. 2893Add support for a NeXT-like scrollbar.
2683</dd> 2894</dd>
2684<p></p> 2895<p></p>
2685<dt><strong><a name="item__2d_2denable_2dxterm_2dscroll">--enable-xterm-scroll</a></strong><br /> 2896<dt><strong>--enable-xterm-scroll (default: on)</strong><br />
2686</dt> 2897</dt>
2687<dd> 2898<dd>
2688Add support for an Xterm-like scrollbar. 2899Add support for an Xterm-like scrollbar.
2689</dd> 2900</dd>
2690<p></p> 2901<p></p>
2691<dt><strong><a name="item__2d_2denable_2dplain_2dscroll">--enable-plain-scroll</a></strong><br /> 2902<dt><strong>--enable-plain-scroll (default: on)</strong><br />
2692</dt> 2903</dt>
2693<dd> 2904<dd>
2694Add support for a very unobtrusive, plain-looking scrollbar that 2905Add support for a very unobtrusive, plain-looking scrollbar that
2695is the favourite of the rxvt-unicode author, having used it for 2906is the favourite of the rxvt-unicode author, having used it for
2696many years. 2907many years.
2697</dd> 2908</dd>
2698<p></p> 2909<p></p>
2699<dt><strong><a name="item__2d_2denable_2dhalf_2dshadow">--enable-half-shadow</a></strong><br /> 2910<dt><strong><a name="item_shadow">--enable-half-shadow (default: off)</a></strong><br />
2700</dt> 2911</dt>
2701<dd> 2912<dd>
2702Make shadows on the scrollbar only half the normal width &amp; height. 2913Make shadows on the scrollbar only half the normal width &amp; height.
2703only applicable to rxvt scrollbars. 2914only applicable to rxvt scrollbars.
2704</dd> 2915</dd>
2705<p></p> 2916<p></p>
2706<dt><strong><a name="item__2d_2denable_2dttygid">--enable-ttygid</a></strong><br /> 2917<dt><strong><a name="item_ttygid">--enable-ttygid (default: off)</a></strong><br />
2707</dt> 2918</dt>
2708<dd> 2919<dd>
2709Change tty device setting to group ``tty'' - only use this if 2920Change tty device setting to group ``tty'' - only use this if
2710your system uses this type of security. 2921your system uses this type of security.
2711</dd> 2922</dd>
2712<p></p> 2923<p></p>
2713<dt><strong><a name="item__2d_2ddisable_2dbackspace_2dkey">--disable-backspace-key</a></strong><br /> 2924<dt><strong><a name="item__2d_2ddisable_2dbackspace_2dkey">--disable-backspace-key</a></strong><br />
2714</dt> 2925</dt>
2715<dd> 2926<dd>
2716Disable any handling of the backspace key by us - let the X server 2927Removes any handling of the backspace key by us - let the X server do it.
2928</dd>
2929<p></p>
2930<dt><strong><a name="item__2d_2ddisable_2ddelete_2dkey">--disable-delete-key</a></strong><br />
2931</dt>
2932<dd>
2933Removes any handling of the delete key by us - let the X server
2717do it. 2934do it.
2718</dd> 2935</dd>
2719<p></p> 2936<p></p>
2720<dt><strong><a name="item__2d_2ddisable_2ddelete_2dkey">--disable-delete-key</a></strong><br />
2721</dt>
2722<dd>
2723Disable any handling of the delete key by us - let the X server
2724do it.
2725</dd>
2726<p></p>
2727<dt><strong><a name="item__2d_2ddisable_2dresources">--disable-resources</a></strong><br /> 2937<dt><strong><a name="item__2d_2ddisable_2dresources">--disable-resources</a></strong><br />
2728</dt> 2938</dt>
2729<dd> 2939<dd>
2730Remove all resources checking. 2940Removes any support for resource checking.
2731</dd> 2941</dd>
2732<p></p> 2942<p></p>
2733<dt><strong><a name="item__2d_2denable_2dxgetdefault">--enable-xgetdefault</a></strong><br /> 2943<dt><strong><a name="item__2d_2denable_2dxgetdefault">--enable-xgetdefault</a></strong><br />
2734</dt> 2944</dt>
2735<dd> 2945<dd>
… …
2741<p>Please note that nowadays, things like XIM will automatically pull in and 2951<p>Please note that nowadays, things like XIM will automatically pull in and
2742use the full X resource manager, so the overhead of using it might be very 2952use the full X resource manager, so the overhead of using it might be very
2743small, if nonexistant.</p> 2953small, if nonexistant.</p>
2744</dd> 2954</dd>
2745<p></p> 2955<p></p>
2746<dt><strong><a name="item__2d_2denable_2dstrings">--enable-strings</a></strong><br /> 2956<dt><strong><a name="item_strings">--enable-strings (default: off)</a></strong><br />
2747</dt> 2957</dt>
2748<dd> 2958<dd>
2749Add support for our possibly faster <code>memset()</code> function and other 2959Add support for our possibly faster <code>memset()</code> function and other
2750various routines, overriding your system's versions which may 2960various routines, overriding your system's versions which may
2751have been hand-crafted in assembly or may require extra libraries 2961have been hand-crafted in assembly or may require extra libraries
… …
2754</dd> 2964</dd>
2755<p></p> 2965<p></p>
2756<dt><strong><a name="item__2d_2ddisable_2dswapscreen">--disable-swapscreen</a></strong><br /> 2966<dt><strong><a name="item__2d_2ddisable_2dswapscreen">--disable-swapscreen</a></strong><br />
2757</dt> 2967</dt>
2758<dd> 2968<dd>
2759Remove support for swap screen. 2969Remove support for secondary/swap screen.
2760</dd> 2970</dd>
2761<p></p> 2971<p></p>
2762<dt><strong><a name="item__2d_2denable_2dfrills">--enable-frills</a></strong><br /> 2972<dt><strong><a name="item_frills">--enable-frills (default: on)</a></strong><br />
2763</dt> 2973</dt>
2764<dd> 2974<dd>
2765Add support for many small features that are not essential but nice to 2975Add support for many small features that are not essential but nice to
2766have. Normally you want this, but for very small binaries you may want to 2976have. Normally you want this, but for very small binaries you may want to
2767disable this. 2977disable this.
2768</dd> 2978</dd>
2769<dd> 2979<dd>
2770<p>A non-exhaustive list of features enabled by <a href="#item__2d_2denable_2dfrills"><code>--enable-frills</code></a> (possibly 2980<p>A non-exhaustive list of features enabled by <code>--enable-frills</code> (possibly
2771in combination with other switches) is:</p> 2981in combination with other switches) is:</p>
2772</dd> 2982</dd>
2773<dd> 2983<dd>
2774<pre> 2984<pre>
2775 MWM-hints 2985 MWM-hints
2776 EWMH-hints (pid, utf8 names) and protocols (ping) 2986 EWMH-hints (pid, utf8 names) and protocols (ping)
2777 seperate underline colour 2987 seperate underline colour (-underlineColor)
2778 settable border widths and borderless switch 2988 settable border widths and borderless switch (-w, -b, -bl)
2779 settable extra linespacing 2989 settable extra linespacing /-lsp)
2780 iso-14755-2 and -3, and visual feedback 2990 iso-14755-2 and -3, and visual feedback
2781 backindex and forwardindex escape sequence 2991 backindex and forwardindex escape sequence
2782 window op and locale change escape sequences 2992 window op and some xterm/OSC escape sequences
2783 tripleclickwords 2993 tripleclickwords (-tcw)
2784 settable insecure mode 2994 settable insecure mode (-insecure)
2785 keysym remapping support 2995 keysym remapping support
2786 -embed and -pty-fd options</pre> 2996 cursor blinking and underline cursor (-cb, -uc)
2997 XEmbed support (-embed)
2998 user-pty (-pty-fd)
2999 hold on exit (-hold)
3000 skip builtin block graphics (-sbg)
3001 sgr modes 90..97 and 100..107</pre>
2787</dd> 3002</dd>
2788<p></p> 3003<p></p>
2789<dt><strong><a name="item__2d_2denable_2diso14755">--enable-iso14755</a></strong><br /> 3004<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br />
2790</dt> 3005</dt>
2791<dd> 3006<dd>
2792Enable extended ISO 14755 support (see rxvt(1), or 3007Enable extended ISO 14755 support (see rxvt(1), or
2793<em>doc/rxvt.1.txt</em>). Basic support (section 5.1) is enabled by 3008<em>doc/rxvt.1.txt</em>). Basic support (section 5.1) is enabled by
2794<a href="#item__2d_2denable_2dfrills"><code>--enable-frills</code></a>, while support for 5.2, 5.3 and 5.4 is enabled with 3009<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with
2795this switch. 3010this switch.
2796</dd> 3011</dd>
2797<p></p> 3012<p></p>
2798<dt><strong><a name="item__2d_2denable_2dkeepscrolling">--enable-keepscrolling</a></strong><br /> 3013<dt><strong><a name="item_keepscrolling">--enable-keepscrolling (default: on)</a></strong><br />
2799</dt> 3014</dt>
2800<dd> 3015<dd>
2801Add support for continual scrolling of the display when you hold 3016Add support for continual scrolling of the display when you hold
2802the mouse button down on a scrollbar arrow. 3017the mouse button down on a scrollbar arrow.
2803</dd> 3018</dd>
2804<p></p> 3019<p></p>
2805<dt><strong><a name="item__2d_2denable_2dmousewheel">--enable-mousewheel</a></strong><br /> 3020<dt><strong><a name="item_mousewheel">--enable-mousewheel (default: on)</a></strong><br />
2806</dt> 3021</dt>
2807<dd> 3022<dd>
2808Add support for scrolling via mouse wheel or buttons 4 &amp; 5. 3023Add support for scrolling via mouse wheel or buttons 4 &amp; 5.
2809</dd> 3024</dd>
2810<p></p> 3025<p></p>
2811<dt><strong><a name="item__2d_2denable_2dslipwheeling">--enable-slipwheeling</a></strong><br /> 3026<dt><strong><a name="item_slipwheeling">--enable-slipwheeling (default: on)</a></strong><br />
2812</dt> 3027</dt>
2813<dd> 3028<dd>
2814Add support for continual scrolling (using the mouse wheel as an 3029Add support for continual scrolling (using the mouse wheel as an
2815accelerator) while the control key is held down. This option 3030accelerator) while the control key is held down. This option
2816requires --enable-mousewheel to also be specified. 3031requires --enable-mousewheel to also be specified.
… …
2820</dt> 3035</dt>
2821<dd> 3036<dd>
2822Remove support for mouse selection style like that of xterm. 3037Remove support for mouse selection style like that of xterm.
2823</dd> 3038</dd>
2824<p></p> 3039<p></p>
2825<dt><strong><a name="item__2d_2denable_2ddmalloc">--enable-dmalloc</a></strong><br /> 3040<dt><strong><a name="item_dmalloc">--enable-dmalloc (default: off)</a></strong><br />
2826</dt> 3041</dt>
2827<dd> 3042<dd>
2828Use Gray Watson's malloc - which is good for debugging See 3043Use Gray Watson's malloc - which is good for debugging See
2829<a href="http://www.letters.com/dmalloc/">http://www.letters.com/dmalloc/</a> for details If you use either this or the 3044<a href="http://www.letters.com/dmalloc/">http://www.letters.com/dmalloc/</a> for details If you use either this or the
2830next option, you may need to edit src/Makefile after compiling to point 3045next option, you may need to edit src/Makefile after compiling to point
… …
2833<dd> 3048<dd>
2834<p>You can only use either this option and the following (should 3049<p>You can only use either this option and the following (should
2835you use either) .</p> 3050you use either) .</p>
2836</dd> 3051</dd>
2837<p></p> 3052<p></p>
2838<dt><strong><a name="item__2d_2denable_2ddlmalloc">--enable-dlmalloc</a></strong><br /> 3053<dt><strong><a name="item_dlmalloc">--enable-dlmalloc (default: off)</a></strong><br />
2839</dt> 3054</dt>
2840<dd> 3055<dd>
2841Use Doug Lea's malloc - which is good for a production version 3056Use Doug Lea's malloc - which is good for a production version
2842See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details. 3057See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details.
2843</dd> 3058</dd>
2844<p></p> 3059<p></p>
2845<dt><strong><a name="item__2d_2denable_2dsmart_2dresize">--enable-smart-resize</a></strong><br /> 3060<dt><strong><a name="item_resize">--enable-smart-resize (default: on)</a></strong><br />
2846</dt> 3061</dt>
2847<dd> 3062<dd>
2848Add smart growth/shrink behaviour when changing font size via from hot 3063Add smart growth/shrink behaviour when changing font size via hot
2849keys. This should keep in a fixed position the rxvt corner which is 3064keys. This should keep the window corner which is closest to a corner of
2850closest to a corner of the screen. 3065the screen in a fixed position.
2851</dd>
2852<p></p>
2853<dt><strong><a name="item__2d_2denable_2dcursor_2dblink">--enable-cursor-blink</a></strong><br />
2854</dt>
2855<dd> 3066</dd>
2856Add support for a blinking cursor.
2857</dd>
2858<p></p> 3067<p></p>
2859<dt><strong><a name="item__2d_2denable_2dpointer_2dblank">--enable-pointer-blank</a></strong><br /> 3068<dt><strong><a name="item_blank">--enable-pointer-blank (default: on)</a></strong><br />
2860</dt> 3069</dt>
2861<dd> 3070<dd>
2862Add support to have the pointer disappear when typing or inactive. 3071Add support to have the pointer disappear when typing or inactive.
2863</dd> 3072</dd>
2864<p></p> 3073<p></p>
2865<dt><strong><a name="item__2d_2dwith_2dname_3dname">--with-name=NAME</a></strong><br /> 3074<dt><strong><a name="item_perl">--enable-perl (default: off)</a></strong><br />
2866</dt> 3075</dt>
3076<dd>
3077Enable an embedded perl interpreter. See the <strong>rxvtperl(3)</strong>
3078manpage (<em>doc/rxvtperl.txt</em>) for more info on this feature, or the files
3079in <em>src/perl-ext/</em> for the extensions that are installed by default. The
3080perl interpreter that is used can be specified via the <code>PERL</code> environment
3081variable when running configure.
2867<dd> 3082</dd>
3083<p></p>
3084<dt><strong>--with-name=NAME (default: urxvt)</strong><br />
3085</dt>
3086<dd>
2868Set the basename for the installed binaries (default: <code>urxvt</code>, resulting 3087Set the basename for the installed binaries, resulting
2869in <code>urxvt</code>, <code>urxvtd</code> etc.). Specify <code>--with-name=rxvt</code> to replace with 3088in <code>urxvt</code>, <code>urxvtd</code> etc.). Specify <code>--with-name=rxvt</code> to replace with
2870<code>rxvt</code>. 3089<code>rxvt</code>.
2871</dd> 3090</dd>
2872<p></p> 3091<p></p>
2873<dt><strong><a name="item__2d_2dwith_2dterm_3dname">--with-term=NAME</a></strong><br /> 3092<dt><strong>--with-term=NAME (default: rxvt-unicode)</strong><br />
2874</dt> 3093</dt>
2875<dd> 3094<dd>
2876Change the environmental variable for the terminal to NAME (default 3095Change the environmental variable for the terminal to NAME.
2877<code>rxvt-unicode</code>)
2878</dd> 3096</dd>
2879<p></p> 3097<p></p>
2880<dt><strong><a name="item__2d_2dwith_2dterminfo_3dpath">--with-terminfo=PATH</a></strong><br /> 3098<dt><strong><a name="item__2d_2dwith_2dterminfo_3dpath">--with-terminfo=PATH</a></strong><br />
2881</dt> 3099</dt>
2882<dd> 3100<dd>

Diff Legend

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