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.11 by root, Fri Feb 11 18:06:44 2005 UTC vs.
Revision 1.25 by root, Tue Nov 8 17:35:28 2005 UTC

… …
83</dd> 83</dd>
84<p></p> 84<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 /> 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 />
86</dt> 86</dt>
87<dd> 87<dd>
88The Debian GNU/Linux package of rxvt-unicode contains large patches that 88The Debian GNU/Linux package of rxvt-unicode in sarge contains large
89considerably change the behaviour of rxvt-unicode. Before reporting a 89patches that considerably change the behaviour of rxvt-unicode. Before
90bug to the original rxvt-unicode author please download and install the 90reporting 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 91install 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 92and 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 93problems are specific to Debian GNU/Linux, in which case it should be
94Debian Bug Tracking System (use <code>reportbug</code> to report the bug). 94reported via the Debian Bug Tracking System (use <code>reportbug</code> to report
95the bug).
95</dd> 96</dd>
96<dd> 97<dd>
97<p>For other problems that also affect the Debian package, you can and 98<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 99probably 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 100bug in the Debian version and it serves as a reminder for other users that
… …
137<dd> 138<dd>
138<p>If you don't plan to use <strong>rxvt</strong> (quite common...) you could also replace 139<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> 140the rxvt terminfo file with the rxvt-unicode one.</p>
140</dd> 141</dd>
141<p></p> 142<p></p>
143<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 />
144</dt>
145<dd>
146Most likely it's the empty definition for <code>enacs=</code>. Just replace it by
147<code>enacs=\E[0@</code> and try again.
148</dd>
149<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 /> 150<dt><strong><a name="item_bash_27s_readline_does_not_work_correctly_under_ur"><code>bash</code>'s readline does not work correctly under urxvt.</a></strong><br />
143</dt> 151</dt>
144<dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br /> 152<dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br />
145</dt> 153</dt>
146<dd> 154<dd>
147One reason you might want this is that some distributions or operating 155One reason you might want this is that some distributions or operating
148systems still compile some programs using the long-obsoleted termcap 156systems still compile some programs using the long-obsoleted termcap
149(Fedora Core's bash is one example) and rely on a termcap entry for 157library (Fedora Core's bash is one example) and rely on a termcap entry
150<code>rxvt-unicode</code>. 158for <code>rxvt-unicode</code>.
151</dd> 159</dd>
152<dd> 160<dd>
153<p>You could use rxvt's termcap entry with resonable results in many cases. 161<p>You could use rxvt's termcap entry with resonable results in many cases.
154You can also create a termcap entry by using terminfo's infocmp program 162You can also create a termcap entry by using terminfo's infocmp program
155like this:</p> 163like this:</p>
… …
163</dd> 171</dd>
164<dd> 172<dd>
165<pre> 173<pre>
166 rxvt-unicode|rxvt-unicode terminal (X Window System):\ 174 rxvt-unicode|rxvt-unicode terminal (X Window System):\
167 :am:bw:eo:km:mi:ms:xn:xo:\ 175 :am:bw:eo:km:mi:ms:xn:xo:\
168 :co#80:it#8:li#24:\ 176 :co#80:it#8:li#24:lm#0:\
169 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ 177 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
170 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ 178 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
171 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=^O:al=\E[L:\ 179 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
172 :as=^N:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:cm=\E[%i%d;%dH:\ 180 :as=\E(0:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:\
173 :cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:dl=\E[M:do=^J:\ 181 :cm=\E[%i%d;%dH:cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:\
174 :ec=\E[%dX:ei=\E[4l:ho=\E[H:i1=\E[?47l\E=\E[?1l:ic=\E[@:\ 182 :dl=\E[M:do=^J:ec=\E[%dX:ei=\E[4l:ho=\E[H:\
183 :i1=\E[?47l\E=\E[?1l:ic=\E[@:im=\E[4h:\
175 :im=\E[4h:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\ 184 :is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
176 :k0=\E[21~:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:\ 185 :k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:k5=\E[15~:\
177 :k5=\E[15~:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:\ 186 :k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:kD=\E[3~:\
178 :kD=\E[3~:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:\ 187 :kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:ke=\E[?1l\E&gt;:\
179 :ke=\E[?1l\E&gt;:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:\ 188 :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
180 :ku=\EOA:le=^H:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:\ 189 :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
181 :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\ 190 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
182 :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\ 191 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
183 :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ 192 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
184 :vs=\E[?25h:</pre> 193 :vs=\E[?25h:</pre>
185</dd> 194</dd>
186<p></p> 195<p></p>
187<dt><strong><a name="item_why_does_ls_no_longer_have_coloured_output_3f">Why does <code>ls</code> no longer have coloured output?</a></strong><br /> 196<dt><strong><a name="item_why_does_ls_no_longer_have_coloured_output_3f">Why does <code>ls</code> no longer have coloured output?</a></strong><br />
188</dt> 197</dt>
… …
300<p>In that case, select a font of your taste and add it to the font list, 309<p>In that case, select a font of your taste and add it to the font list,
301e.g.:</p> 310e.g.:</p>
302</dd> 311</dd>
303<dd> 312<dd>
304<pre> 313<pre>
305 rxvt -fn basefont,font2,font3...</pre> 314 urxvt -fn basefont,font2,font3...</pre>
306</dd> 315</dd>
307<dd> 316<dd>
308<p>When rxvt-unicode sees a character, it will first look at the base 317<p>When rxvt-unicode sees a character, it will first look at the base
309font. If the base font does not contain the character, it will go to the 318font. If the base font does not contain the character, it will go to the
310next font, and so on. Specifying your own fonts will also speed up this 319next font, and so on. Specifying your own fonts will also speed up this
… …
370<dd> 379<dd>
371<p>All of this is not a problem when using X11 core fonts, as their bounding 380<p>All of this is not a problem when using X11 core fonts, as their bounding
372box data is correct.</p> 381box data is correct.</p>
373</dd> 382</dd>
374<p></p> 383<p></p>
384<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 />
385</dt>
386<dd>
387Seems to be a known bug, read
388<a href="http://nixdoc.net/files/forum/about34198.html">http://nixdoc.net/files/forum/about34198.html</a>. Some people use the
389following ugly workaround to get non-double-wide-characters working:
390</dd>
391<dd>
392<pre>
393 #define wcwidth(x) wcwidth(x) &gt; 1 ? 1 : wcwidth(x)</pre>
394</dd>
395<p></p>
375<dt><strong><a name="item_compose">My Compose (Multi_key) key is no longer working.</a></strong><br /> 396<dt><strong><a name="item_compose">My Compose (Multi_key) key is no longer working.</a></strong><br />
376</dt> 397</dt>
377<dd> 398<dd>
378The most common causes for this are that either your locale is not set 399The most common causes for this are that either your locale is not set
379correctly, or you specified a <strong>preeditStyle</strong> that is not supported by 400correctly, or you specified a <strong>preeditStyle</strong> that is not supported by
… …
437<p>As you might have guessed, FreeBSD does neither define this symobl nor 458<p>As you might have guessed, FreeBSD does neither define this symobl nor
438does it support it. Instead, it uses it's own internal representation of 459does it support it. Instead, it uses it's own internal representation of
439<strong>wchar_t</strong>. This is, of course, completely fine with respect to standards.</p> 460<strong>wchar_t</strong>. This is, of course, completely fine with respect to standards.</p>
440</dd> 461</dd>
441<dd> 462<dd>
463<p>However, that means rxvt-unicode only works in <code>POSIX</code>, <code>ISO-8859-1</code> and
464<code>UTF-8</code> locales under FreeBSD (which all use Unicode as <strong>wchar_t</strong>.</p>
465</dd>
466<dd>
442<p>However, <code>__STDC_ISO_10646__</code> is the only sane way to support 467<p><code>__STDC_ISO_10646__</code> is the only sane way to support multi-language
443multi-language apps in an OS, as using a locale-dependent (and 468apps in an OS, as using a locale-dependent (and non-standardized)
444non-standardized) representation of <strong>wchar_t</strong> makes it impossible to 469representation of <strong>wchar_t</strong> makes it impossible to convert between
445convert between <strong>wchar_t</strong> (as used by X11 and your applications) and any 470<strong>wchar_t</strong> (as used by X11 and your applications) and any other encoding
446other encoding without implementing OS-specific-wrappers for each and 471without implementing OS-specific-wrappers for each and every locale. There
447every locale. There simply are no APIs to convert <strong>wchar_t</strong> into anything 472simply are no APIs to convert <strong>wchar_t</strong> into anything except the current
448except the current locale encoding.</p> 473locale encoding.</p>
449</dd> 474</dd>
450<dd> 475<dd>
451<p>Some applications (such as the formidable <strong>mlterm</strong>) work around this 476<p>Some applications (such as the formidable <strong>mlterm</strong>) work around this
452by carrying their own replacement functions for character set handling 477by carrying their own replacement functions for character set handling
453with them, and either implementing OS-dependent hacks or doing multiple 478with them, and either implementing OS-dependent hacks or doing multiple
… …
456</dd> 481</dd>
457<dd> 482<dd>
458<p>The rxvt-unicode author insists that the right way to fix this is in the 483<p>The rxvt-unicode author insists that the right way to fix this is in the
459system libraries once and for all, instead of forcing every app to carry 484system libraries once and for all, instead of forcing every app to carry
460complete replacements for them :)</p> 485complete replacements for them :)</p>
486</dd>
487<p></p>
488<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 />
489</dt>
490<dd>
491Try the diff in <em>doc/solaris9.patch</em> as a base. It fixes the worst
492problems with <code>wcwidth</code> and a compile problem.
493</dd>
494<p></p>
495<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 />
496</dt>
497<dd>
498rxvt-unicode should compile and run out of the box on cygwin, using
499the X11 libraries that come with cygwin. libW11 emulation is no
500longer supported (and makes no sense, either, as it only supported a
501single font). I recommend starting the X-server in <code>-multiwindow</code> or
502<code>-rootless</code> mode instead, which will result in similar look&amp;feel as the
503old libW11 emulation.
504</dd>
505<dd>
506<p>At the time of this writing, cygwin didn't seem to support any multi-byte
507encodings (you might try <code>LC_CTYPE=C-UTF-8</code>), so you are likely limited
508to 8-bit encodings.</p>
461</dd> 509</dd>
462<p></p> 510<p></p>
463<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 /> 511<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 />
464</dt> 512</dt>
465<dt><strong><a name="item_is_there_an_option_to_switch_encodings_3f">Is there an option to switch encodings?</a></strong><br /> 513<dt><strong><a name="item_is_there_an_option_to_switch_encodings_3f">Is there an option to switch encodings?</a></strong><br />
… …
584use your input method. Please note, however, that you will not be able to 632use your input method. Please note, however, that you will not be able to
585input characters outside <code>EUC-JP</code> in a normal way then, as your input 633input characters outside <code>EUC-JP</code> in a normal way then, as your input
586method limits you.</p> 634method limits you.</p>
587</dd> 635</dd>
588<p></p> 636<p></p>
637<dt><strong><a name="item_rxvt_2dunicode_crashes_when_the_x_input_method_cha">Rxvt-unicode crashes when the X Input Method changes or exits.</a></strong><br />
638</dt>
639<dd>
640Unfortunately, this is unavoidable, as the XIM protocol is racy by
641design. Applications can avoid some crashes at the expense of memory
642leaks, and Input Methods can avoid some crashes by careful ordering at
643exit time. <strong>kinput2</strong> (and derived input methods) generally succeeds,
644while <strong>SCIM</strong> (or similar input methods) fails. In the end, however,
645crashes cannot be completely avoided even if both sides cooperate.
646</dd>
647<dd>
648<p>So the only workaround is not to kill your Input Method Servers.</p>
649</dd>
650<p></p>
589<dt><strong><a name="item_rxvt_2dunicode_uses_gobs_of_memory_2c_how_can_i_re">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></strong><br /> 651<dt><strong><a name="item_rxvt_2dunicode_uses_gobs_of_memory_2c_how_can_i_re">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></strong><br />
590</dt> 652</dt>
591<dd> 653<dd>
592Rxvt-unicode tries to obey the rule of not charging you for something you 654Rxvt-unicode tries to obey the rule of not charging you for something you
593don't use. One thing you should try is to configure out all settings that 655don't use. One thing you should try is to configure out all settings that
… …
595when used. Compiling it out ensures that no Xft font will be loaded 657when used. Compiling it out ensures that no Xft font will be loaded
596accidentally when rxvt-unicode tries to find a font for your characters. 658accidentally when rxvt-unicode tries to find a font for your characters.
597</dd> 659</dd>
598<dd> 660<dd>
599<p>Also, many people (me included) like large windows and even larger 661<p>Also, many people (me included) like large windows and even larger
600scrollback buffers: Without <a href="#item__2d_2denable_2dunicode3"><code>--enable-unicode3</code></a>, rxvt-unicode will use 662scrollback buffers: Without <code>--enable-unicode3</code>, rxvt-unicode will use
6016 bytes per screen cell. For a 160x?? window this amounts to almost a 6636 bytes per screen cell. For a 160x?? window this amounts to almost a
602kilobyte per line. A scrollback buffer of 10000 lines will then (if full) 664kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
603use 10 Megabytes of memory. With <a href="#item__2d_2denable_2dunicode3"><code>--enable-unicode3</code></a> it gets worse, as 665use 10 Megabytes of memory. With <code>--enable-unicode3</code> it gets worse, as
604rxvt-unicode then uses 8 bytes per screen cell.</p> 666rxvt-unicode then uses 8 bytes per screen cell.</p>
605</dd> 667</dd>
606<p></p> 668<p></p>
607<dt><strong><a name="item_can_i_speed_up_xft_rendering_somehow_3f">Can I speed up Xft rendering somehow?</a></strong><br /> 669<dt><strong><a name="item_can_i_speed_up_xft_rendering_somehow_3f">Can I speed up Xft rendering somehow?</a></strong><br />
608</dt> 670</dt>
609<dd> 671<dd>
610Yes, the most obvious way to speed it up is to avoid Xft entirely, as 672Yes, the most obvious way to speed it up is to avoid Xft entirely, as
611it is simply slow. If you still want Xft fonts you might try to disable 673it is simply slow. If you still want Xft fonts you might try to disable
612antialiasing (by appending <code>:antialiasing=false</code>), which saves lots of 674antialiasing (by appending <code>:antialias=false</code>), which saves lots of
613memory and also speeds up rendering considerably. 675memory and also speeds up rendering considerably.
614</dd> 676</dd>
615<p></p> 677<p></p>
616<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 /> 678<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 />
617</dt> 679</dt>
… …
631<dd> 693<dd>
632Make sure that mouse reporting is actually turned off since killing 694Make sure that mouse reporting is actually turned off since killing
633some editors prematurely may leave the mouse in mouse report mode. I've 695some editors prematurely may leave the mouse in mouse report mode. I've
634heard that tcsh may use mouse reporting unless it otherwise specified. A 696heard that tcsh may use mouse reporting unless it otherwise specified. A
635quick check is to see if cut/paste works when the Alt or Shift keys are 697quick check is to see if cut/paste works when the Alt or Shift keys are
636depressed. See <code>rxvt(7)</code> 698depressed. See <code>urxvt(7)</code>
637</dd> 699</dd>
638<p></p> 700<p></p>
639<dt><strong><a name="item_what_27s_with_this_bold_2fblink_stuff_3f">What's with this bold/blink stuff?</a></strong><br /> 701<dt><strong><a name="item_what_27s_with_this_bold_2fblink_stuff_3f">What's with this bold/blink stuff?</a></strong><br />
640</dt> 702</dt>
641<dd> 703<dd>
… …
715 URxvt.color14: #73f7ff 777 URxvt.color14: #73f7ff
716 URxvt.color7: #e1dddd 778 URxvt.color7: #e1dddd
717 URxvt.color15: #e1dddd</pre> 779 URxvt.color15: #e1dddd</pre>
718</dd> 780</dd>
719<p></p> 781<p></p>
720<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 /> 782<dt><strong><a name="item_how_can_i_start_urxvtd_in_a_race_2dfree_way_3f">How can I start urxvtd in a race-free way?</a></strong><br />
721</dt> 783</dt>
722<dd>
723Despite it's name, rxvtd is not a real daemon, but more like a
724server that answers rxvtc's requests, so it doesn't background
725itself.
726</dd> 784<dd>
727<dd> 785Try <code>urxvtd -f -o</code>, which tells urxvtd to open the
728<p>To ensure rxvtd is listening on it's socket, you can use the 786display, create the listening socket and then fork.
729following method to wait for the startup message before continuing:</p>
730</dd>
731<dd>
732<pre>
733 { rxvtd &amp; } | read</pre>
734</dd> 787</dd>
735<p></p> 788<p></p>
736<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 /> 789<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 />
737</dt> 790</dt>
738<dd> 791<dd>
… …
758</dd> 811</dd>
759<dd> 812<dd>
760<pre> 813<pre>
761 # use Backspace = ^H 814 # use Backspace = ^H
762 $ stty erase ^H 815 $ stty erase ^H
763 $ rxvt</pre> 816 $ urxvt</pre>
764</dd> 817</dd>
765<dd> 818<dd>
766<pre> 819<pre>
767 # use Backspace = ^? 820 # use Backspace = ^?
768 $ stty erase ^? 821 $ stty erase ^?
769 $ rxvt</pre> 822 $ urxvt</pre>
770</dd>
771<dd> 823</dd>
824<dd>
772<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code> as documented in rxvt(7).</p> 825<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code> as documented in urxvt(7).</p>
773</dd> 826</dd>
774<dd> 827<dd>
775<p>For an existing rxvt-unicode:</p> 828<p>For an existing rxvt-unicode:</p>
776</dd> 829</dd>
777<dd> 830<dd>
… …
815There are some compile-time selections available via configure. Unless 868There are some compile-time selections available via configure. Unless
816you have run ``configure'' with the <a href="#item__2d_2ddisable_2dresources"><code>--disable-resources</code></a> option you can 869you have run ``configure'' with the <a href="#item__2d_2ddisable_2dresources"><code>--disable-resources</code></a> option you can
817use the `keysym' resource to alter the keystrings associated with keysyms. 870use the `keysym' resource to alter the keystrings associated with keysyms.
818</dd> 871</dd>
819<dd> 872<dd>
820<p>Here's an example for a URxvt session started using <code>rxvt -name URxvt</code></p> 873<p>Here's an example for a URxvt session started using <code>urxvt -name URxvt</code></p>
821</dd> 874</dd>
822<dd> 875<dd>
823<pre> 876<pre>
824 URxvt.keysym.Home: \033[1~ 877 URxvt.keysym.Home: \033[1~
825 URxvt.keysym.End: \033[4~ 878 URxvt.keysym.End: \033[4~
… …
1695<tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr> 1748<tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr>
1696<tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr> 1749<tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr>
1697<tr><td>Ps = 18</td><td>Change colour of bold characters to Pt</td></tr> 1750<tr><td>Ps = 18</td><td>Change colour of bold characters to Pt</td></tr>
1698<tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt</td></tr> 1751<tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt</td></tr>
1699<tr><td>Ps = 20</td><td>Change default background to Pt</td></tr> 1752<tr><td>Ps = 20</td><td>Change default background to Pt</td></tr>
1700<tr><td>Ps = 39</td><td>Change default foreground colour to Pt rxvt compile-time option</td></tr> 1753<tr><td>Ps = 39</td><td>Change default foreground colour to Pt.</td></tr>
1701<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr> 1754<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr>
1702<tr><td>Ps = 49</td><td>Change default background colour to Pt rxvt compile-time option</td></tr> 1755<tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr>
1703<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> 1756<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>
1704<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr> 1757<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr>
1705<tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (rxvt extension)</td></tr> 1758<tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).</td></tr>
1706<tr><td>Ps = 703</td><td>Menubar command Pt rxvt compile-time option (rxvt-unicode extension)</td></tr> 1759<tr><td>Ps = 703</td><td>Menubar command Pt (Compile menubar).</td></tr>
1707<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr> 1760<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr>
1708<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt</td></tr> 1761<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr>
1709<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr> 1762<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr>
1710<tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50.</td></tr> 1763<tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1711<tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50.</td></tr> 1764<tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1712<tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50.</td></tr> 1765<tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1766<tr><td>Ps = 720</td><td>Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>
1767<tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>
1713</table><p></p></dl> 1768</table><p></p></dl>
1714<p></p> 1769<p></p>
1715<p> 1770<p>
1716</p> 1771</p>
1717<hr /> 1772<hr />
… …
1763<dt><strong><a name="item__5btitle_3a_2bstring_5d"><strong>[title:+<em>string</em>] </strong>&gt;</a></strong><br /> 1818<dt><strong><a name="item__5btitle_3a_2bstring_5d"><strong>[title:+<em>string</em>] </strong>&gt;</a></strong><br />
1764</dt> 1819</dt>
1765<dd> 1820<dd>
1766set the current menuBar's title to <em>string</em>, which may contain the 1821set the current menuBar's title to <em>string</em>, which may contain the
1767following format specifiers: 1822following format specifiers:
1768<strong>%%</strong> : literal <strong>%</strong> character 1823</dd>
1769<strong>%n</strong> : rxvt name (as per the <strong>-name</strong> command-line option) 1824<dd>
1770<strong>%v</strong> : rxvt version 1825<pre>
1826 B&lt;%n&gt; rxvt name (as per the B&lt;-name&gt; command-line option)
1827 B&lt;%v&gt; rxvt version
1828 B&lt;%%&gt; literal B&lt;%&gt; character</pre>
1771</dd> 1829</dd>
1772<p></p> 1830<p></p>
1773<dt><strong><a name="item__5bdone_5d"><strong>[done]</strong></a></strong><br /> 1831<dt><strong><a name="item__5bdone_5d"><strong>[done]</strong></a></strong><br />
1774</dt> 1832</dt>
1775<dd> 1833<dd>
… …
2476</table><p> 2534</table><p>
2477</p> 2535</p>
2478<hr /> 2536<hr />
2479<h1><a name="configure_options">CONFIGURE OPTIONS</a></h1> 2537<h1><a name="configure_options">CONFIGURE OPTIONS</a></h1>
2480<p>General hint: if you get compile errors, then likely your configuration 2538<p>General hint: if you get compile errors, then likely your configuration
2481hasn't been tested well. Either try with --enable-everything or use the 2539hasn't been tested well. Either try with <a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> or use
2482./reconf script as a base for experiments. ./reconf is used by myself, 2540the <em>./reconf</em> script as a base for experiments. <em>./reconf</em> is used by
2483so it should generally be a working config. Of course, you should always 2541myself, so it should generally be a working config. Of course, you should
2484report when a combination doesn't work, so it can be fixed. Marc Lehmann 2542always report when a combination doesn't work, so it can be fixed. Marc
2485&lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt;.</p> 2543Lehmann &lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt;.</p>
2544<p>All</p>
2486<dl> 2545<dl>
2487<dt><strong><a name="item__2d_2denable_2deverything">--enable-everything</a></strong><br /> 2546<dt><strong><a name="item__2d_2denable_2deverything">--enable-everything</a></strong><br />
2488</dt> 2547</dt>
2489<dd> 2548<dd>
2490Add support for all non-multichoice options listed in ``./configure 2549Add (or remove) support for all non-multichoice options listed in ``./configure
2491--help''. Note that unlike other enable options this is order dependant. 2550--help''.
2492You can specify this and then disable options which this enables by 2551</dd>
2493<em>following</em> this with the appropriate commands.
2494</dd> 2552<dd>
2553<p>You can specify this and then disable options you do not like by
2554<em>following</em> this with the appropriate <code>--disable-...</code> arguments,
2555or you can start with a minimal configuration by specifying
2556<code>--disable-everything</code> and than adding just the <code>--enable-...</code> arguments
2557you want.</p>
2558</dd>
2495<p></p> 2559<p></p>
2496<dt><strong><a name="item__2d_2denable_2dxft">--enable-xft</a></strong><br /> 2560<dt><strong><a name="item_xft">--enable-xft (default: enabled)</a></strong><br />
2497</dt> 2561</dt>
2498<dd> 2562<dd>
2499Add support for Xft (anti-aliases, among others) fonts. Xft fonts are 2563Add support for Xft (anti-aliases, among others) fonts. Xft fonts are
2500slower and require lots of memory, but as long as you don't use them, you 2564slower and require lots of memory, but as long as you don't use them, you
2501don't pay for them. 2565don't pay for them.
2502</dd> 2566</dd>
2503<p></p> 2567<p></p>
2504<dt><strong><a name="item__2d_2denable_2dfont_2dstyles">--enable-font-styles</a></strong><br /> 2568<dt><strong><a name="item_styles">--enable-font-styles (default: on)</a></strong><br />
2505</dt> 2569</dt>
2506<dd> 2570<dd>
2507Add support for <strong>bold</strong>, <em>italic</em> and <strong><em>bold italic</em> </strong>&gt; font 2571Add support for <strong>bold</strong>, <em>italic</em> and <strong><em>bold italic</em> </strong>&gt; font
2508styles. The fonts can be set manually or automatically. 2572styles. The fonts can be set manually or automatically.
2509</dd> 2573</dd>
2510<p></p> 2574<p></p>
2511<dt><strong><a name="item__2d_2dwith_2dcodesets_3dname_2c_2e_2e_2e">--with-codesets=NAME,...</a></strong><br /> 2575<dt><strong><a name="item__2d_2dwith_2dcodesets_3dname_2c_2e_2e_2e__28defaul">--with-codesets=NAME,... (default: all)</a></strong><br />
2512</dt> 2576</dt>
2513<dd> 2577<dd>
2514Compile in support for additional codeset (encoding) groups (eu, vn are 2578Compile in support for additional codeset (encoding) groups (<code>eu</code>, <code>vn</code>
2515always compiled in, which includes most 8-bit character sets). These 2579are always compiled in, which includes most 8-bit character sets). These
2516codeset tables are currently only used for driving X11 core fonts, they 2580codeset tables are used for driving X11 core fonts, they are not required
2517are not required for Xft fonts. Compiling them in will make your binary 2581for Xft fonts, although having them compiled in lets rxvt-unicode choose
2518bigger (together about 700kB), but it doesn't increase memory usage unless 2582replacement fonts more intelligently. Compiling them in will make your
2583binary bigger (all of together cost about 700kB), but it doesn't increase
2519you use an X11 font requiring one of these encodings. 2584memory usage unless you use a font requiring one of these encodings.
2520</dd> 2585</dd>
2521<table> 2586<table>
2522<tr><td>all</td><td>all available codeset groups</td></tr> 2587<tr><td>all</td><td>all available codeset groups</td></tr>
2523<tr><td>zh</td><td>common chinese encodings</td></tr> 2588<tr><td>zh</td><td>common chinese encodings</td></tr>
2524<tr><td>zh_ext</td><td>rarely used but very big chinese encodigs</td></tr> 2589<tr><td>zh_ext</td><td>rarely used but very big chinese encodigs</td></tr>
2525<tr><td>jp</td><td>common japanese encodings</td></tr> 2590<tr><td>jp</td><td>common japanese encodings</td></tr>
2526<tr><td>jp_ext</td><td>rarely used but big japanese encodings</td></tr> 2591<tr><td>jp_ext</td><td>rarely used but big japanese encodings</td></tr>
2527<tr><td>kr</td><td>korean encodings</td></tr> 2592<tr><td>kr</td><td>korean encodings</td></tr>
2528</table><p></p> 2593</table><p></p>
2529<dt><strong><a name="item__2d_2denable_2dxim">--enable-xim</a></strong><br /> 2594<dt><strong><a name="item_xim">--enable-xim (default: on)</a></strong><br />
2530</dt> 2595</dt>
2531<dd> 2596<dd>
2532Add support for XIM (X Input Method) protocol. This allows using 2597Add support for XIM (X Input Method) protocol. This allows using
2533alternative input methods (e.g. kinput2) and will also correctly 2598alternative input methods (e.g. kinput2) and will also correctly
2534set up the input for people using dead keys or compose keys. 2599set up the input for people using dead keys or compose keys.
2535</dd> 2600</dd>
2536<p></p> 2601<p></p>
2537<dt><strong><a name="item__2d_2denable_2dunicode3">--enable-unicode3</a></strong><br /> 2602<dt><strong><a name="item_unicode3">--enable-unicode3 (default: off)</a></strong><br />
2538</dt> 2603</dt>
2539<dd> 2604<dd>
2540Enable direct support for displaying unicode codepoints above 2605Enable direct support for displaying unicode codepoints above
254165535 (the basic multilingual page). This increases storage 260665535 (the basic multilingual page). This increases storage
2542requirements per character from 2 to 4 bytes. X11 fonts do not yet 2607requirements per character from 2 to 4 bytes. X11 fonts do not yet
… …
2548limited to a view thousand (shared with combining characters, 2613limited to a view thousand (shared with combining characters,
2549see next switch), and right now rxvt-unicode cannot display them 2614see next switch), and right now rxvt-unicode cannot display them
2550(input/output and cut&amp;paste still work, though).</p> 2615(input/output and cut&amp;paste still work, though).</p>
2551</dd> 2616</dd>
2552<p></p> 2617<p></p>
2553<dt><strong><a name="item__2d_2denable_2dcombining">--enable-combining</a></strong><br /> 2618<dt><strong><a name="item_combining">--enable-combining (default: on)</a></strong><br />
2554</dt> 2619</dt>
2555<dd> 2620<dd>
2556Enable automatic composition of combining characters into 2621Enable automatic composition of combining characters into
2557composite characters. This is required for proper viewing of text 2622composite characters. This is required for proper viewing of text
2558where accents are encoded as seperate unicode characters. This is 2623where accents are encoded as seperate unicode characters. This is
2559done by using precomposited characters when available or creating 2624done by using precomposited characters when available or creating
2560new pseudo-characters when no precomposed form exists. 2625new pseudo-characters when no precomposed form exists.
2561</dd> 2626</dd>
2562<dd> 2627<dd>
2563<p>Without --enable-unicode3, the number of additional precomposed 2628<p>Without --enable-unicode3, the number of additional precomposed characters
2564characters is rather limited (2048, if this is full, rxvt will use the 2629is rather limited (2048, if this is full, rxvt-unicode will use the
2565private use area, extending the number of combinations to 8448). With 2630private use area, extending the number of combinations to 8448). With
2566--enable-unicode3, no practical limit exists. This will also enable 2631--enable-unicode3, no practical limit exists.</p>
2567storage of characters &gt;65535.</p> 2632</dd>
2633<dd>
2634<p>This option will also enable storage (but not display) of characters
2635beyond plane 0 (&gt;65535) when --enable-unicode3 was not specified.</p>
2568</dd> 2636</dd>
2569<dd> 2637<dd>
2570<p>The combining table also contains entries for arabic presentation forms, 2638<p>The combining table also contains entries for arabic presentation forms,
2571but these are not currently used. Bug me if you want these to be used.</p> 2639but these are not currently used. Bug me if you want these to be used (and
2640tell me how these are to be used...).</p>
2572</dd> 2641</dd>
2573<p></p> 2642<p></p>
2574<dt><strong><a name="item_fallback">--enable-fallback(=CLASS)</a></strong><br /> 2643<dt><strong><a name="item_fallback">--enable-fallback(=CLASS) (default: Rxvt)</a></strong><br />
2575</dt> 2644</dt>
2576<dd>
2577When reading resource settings, also read settings for class CLASS
2578(default: Rxvt). To disable resource fallback use --disable-fallback.
2579</dd> 2645<dd>
2580<p></p> 2646When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback.
2581<dt><strong><a name="item__2d_2dwith_2dres_2dname_3dname">--with-res-name=NAME</a></strong><br />
2582</dt>
2583<dd> 2647</dd>
2648<p></p>
2649<dt><strong><a name="item_name">--with-res-name=NAME (default: urxvt)</a></strong><br />
2650</dt>
2651<dd>
2584Use the given name (default: urxvt) as default application name when 2652Use the given name as default application name when
2585reading resources. Specify --with-res-name=rxvt to replace rxvt. 2653reading resources. Specify --with-res-name=rxvt to replace rxvt.
2586</dd> 2654</dd>
2587<p></p> 2655<p></p>
2588<dt><strong><a name="item__2d_2dwith_2dres_2dclass_3dclass">--with-res-class=CLASS</a></strong><br /> 2656<dt><strong><a name="item__2d_2dwith_2dres_2dclass_3dclass__2fdefault_3a_urx">--with-res-class=CLASS /default: URxvt)</a></strong><br />
2589</dt> 2657</dt>
2590<dd> 2658<dd>
2591Use the given class (default: URxvt) as default application class 2659Use the given class as default application class
2592when reading resources. Specify --with-res-class=Rxvt to replace 2660when reading resources. Specify --with-res-class=Rxvt to replace
2593rxvt. 2661rxvt.
2594</dd> 2662</dd>
2595<p></p> 2663<p></p>
2596<dt><strong><a name="item__2d_2denable_2dutmp">--enable-utmp</a></strong><br /> 2664<dt><strong><a name="item_utmp">--enable-utmp (default: on)</a></strong><br />
2597</dt> 2665</dt>
2598<dd> 2666<dd>
2599Write user and tty to utmp file (used by programs like <em>w</em>) at 2667Write user and tty to utmp file (used by programs like <em>w</em>) at
2600start of rxvt execution and delete information when rxvt exits. 2668start of rxvt execution and delete information when rxvt exits.
2601</dd> 2669</dd>
2602<p></p> 2670<p></p>
2603<dt><strong><a name="item__2d_2denable_2dwtmp">--enable-wtmp</a></strong><br /> 2671<dt><strong><a name="item_wtmp">--enable-wtmp (default: on)</a></strong><br />
2604</dt> 2672</dt>
2605<dd> 2673<dd>
2606Write user and tty to wtmp file (used by programs like <em>last</em>) at 2674Write user and tty to wtmp file (used by programs like <em>last</em>) at
2607start of rxvt execution and write logout when rxvt exits. This 2675start of rxvt execution and write logout when rxvt exits. This
2608option requires --enable-utmp to also be specified. 2676option requires --enable-utmp to also be specified.
2609</dd> 2677</dd>
2610<p></p> 2678<p></p>
2611<dt><strong><a name="item__2d_2denable_2dlastlog">--enable-lastlog</a></strong><br /> 2679<dt><strong><a name="item_lastlog">--enable-lastlog (default: on)</a></strong><br />
2612</dt> 2680</dt>
2613<dd> 2681<dd>
2614Write user and tty to lastlog file (used by programs like 2682Write user and tty to lastlog file (used by programs like
2615<em>lastlogin</em>) at start of rxvt execution. This option requires 2683<em>lastlogin</em>) at start of rxvt execution. This option requires
2616--enable-utmp to also be specified. 2684--enable-utmp to also be specified.
2617</dd> 2685</dd>
2618<p></p> 2686<p></p>
2619<dt><strong><a name="item__2d_2denable_2dxpm_2dbackground">--enable-xpm-background</a></strong><br /> 2687<dt><strong><a name="item_background">--enable-xpm-background (default: off)</a></strong><br />
2620</dt> 2688</dt>
2621<dd> 2689<dd>
2622Add support for XPM background pixmaps. 2690Add support for XPM background pixmaps.
2623</dd> 2691</dd>
2624<p></p> 2692<p></p>
2625<dt><strong><a name="item__2d_2denable_2dtransparency">--enable-transparency</a></strong><br /> 2693<dt><strong><a name="item_transparency">--enable-transparency (default: off)</a></strong><br />
2626</dt> 2694</dt>
2627<dd> 2695<dd>
2628Add support for inheriting parent backgrounds thus giving a fake 2696Add support for inheriting parent backgrounds thus giving a fake
2629transparency to the term. 2697transparency to the term.
2630</dd> 2698</dd>
2631<p></p> 2699<p></p>
2632<dt><strong><a name="item__2d_2denable_2dfading">--enable-fading</a></strong><br /> 2700<dt><strong><a name="item_fading">--enable-fading (default: on)</a></strong><br />
2633</dt> 2701</dt>
2634<dd>
2635Add support for fading the text when focus is lost.
2636</dd> 2702<dd>
2637<p></p> 2703Add support for fading the text when focus is lost (requires <code>--enable-transparency</code>).
2638<dt><strong><a name="item__2d_2denable_2dtinting">--enable-tinting</a></strong><br />
2639</dt>
2640<dd> 2704</dd>
2641Add support for tinting of transparent backgrounds. 2705<p></p>
2706<dt><strong><a name="item_tinting">--enable-tinting (default: on)</a></strong><br />
2707</dt>
2642</dd> 2708<dd>
2709Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>).
2710</dd>
2643<p></p> 2711<p></p>
2644<dt><strong><a name="item__2d_2denable_2dmenubar">--enable-menubar</a></strong><br /> 2712<dt><strong><a name="item_menubar">--enable-menubar (default: off)</a></strong><br />
2645</dt> 2713</dt>
2646<dd> 2714<dd>
2647Add support for our menu bar system (this interacts badly with 2715Add support for our menu bar system (this interacts badly with
2648dynamic locale switching currently). 2716dynamic locale switching currently).
2649</dd> 2717</dd>
2650<p></p> 2718<p></p>
2651<dt><strong><a name="item__2d_2denable_2drxvt_2dscroll">--enable-rxvt-scroll</a></strong><br /> 2719<dt><strong><a name="item_scroll">--enable-rxvt-scroll (default: on)</a></strong><br />
2652</dt> 2720</dt>
2653<dd> 2721<dd>
2654Add support for the original rxvt scrollbar. 2722Add support for the original rxvt scrollbar.
2655</dd> 2723</dd>
2656<p></p> 2724<p></p>
2657<dt><strong><a name="item__2d_2denable_2dnext_2dscroll">--enable-next-scroll</a></strong><br /> 2725<dt><strong>--enable-next-scroll (default: on)</strong><br />
2658</dt> 2726</dt>
2659<dd> 2727<dd>
2660Add support for a NeXT-like scrollbar. 2728Add support for a NeXT-like scrollbar.
2661</dd> 2729</dd>
2662<p></p> 2730<p></p>
2663<dt><strong><a name="item__2d_2denable_2dxterm_2dscroll">--enable-xterm-scroll</a></strong><br /> 2731<dt><strong>--enable-xterm-scroll (default: on)</strong><br />
2664</dt> 2732</dt>
2665<dd> 2733<dd>
2666Add support for an Xterm-like scrollbar. 2734Add support for an Xterm-like scrollbar.
2667</dd> 2735</dd>
2668<p></p> 2736<p></p>
2669<dt><strong><a name="item__2d_2denable_2dplain_2dscroll">--enable-plain-scroll</a></strong><br /> 2737<dt><strong>--enable-plain-scroll (default: on)</strong><br />
2670</dt> 2738</dt>
2671<dd> 2739<dd>
2672Add support for a very unobtrusive, plain-looking scrollbar that 2740Add support for a very unobtrusive, plain-looking scrollbar that
2673is the favourite of the rxvt-unicode author, having used it for 2741is the favourite of the rxvt-unicode author, having used it for
2674many years. 2742many years.
2675</dd> 2743</dd>
2676<p></p> 2744<p></p>
2677<dt><strong><a name="item__2d_2denable_2dhalf_2dshadow">--enable-half-shadow</a></strong><br /> 2745<dt><strong><a name="item_shadow">--enable-half-shadow (default: off)</a></strong><br />
2678</dt> 2746</dt>
2679<dd> 2747<dd>
2680Make shadows on the scrollbar only half the normal width &amp; height. 2748Make shadows on the scrollbar only half the normal width &amp; height.
2681only applicable to rxvt scrollbars. 2749only applicable to rxvt scrollbars.
2682</dd> 2750</dd>
2683<p></p> 2751<p></p>
2684<dt><strong><a name="item__2d_2denable_2dttygid">--enable-ttygid</a></strong><br /> 2752<dt><strong><a name="item_ttygid">--enable-ttygid (default: off)</a></strong><br />
2685</dt> 2753</dt>
2686<dd> 2754<dd>
2687Change tty device setting to group ``tty'' - only use this if 2755Change tty device setting to group ``tty'' - only use this if
2688your system uses this type of security. 2756your system uses this type of security.
2689</dd> 2757</dd>
2690<p></p> 2758<p></p>
2691<dt><strong><a name="item__2d_2ddisable_2dbackspace_2dkey">--disable-backspace-key</a></strong><br /> 2759<dt><strong><a name="item__2d_2ddisable_2dbackspace_2dkey">--disable-backspace-key</a></strong><br />
2692</dt> 2760</dt>
2693<dd> 2761<dd>
2694Disable any handling of the backspace key by us - let the X server 2762Removes any handling of the backspace key by us - let the X server do it.
2763</dd>
2764<p></p>
2765<dt><strong><a name="item__2d_2ddisable_2ddelete_2dkey">--disable-delete-key</a></strong><br />
2766</dt>
2767<dd>
2768Removes any handling of the delete key by us - let the X server
2695do it. 2769do it.
2696</dd> 2770</dd>
2697<p></p> 2771<p></p>
2698<dt><strong><a name="item__2d_2ddisable_2ddelete_2dkey">--disable-delete-key</a></strong><br />
2699</dt>
2700<dd>
2701Disable any handling of the delete key by us - let the X server
2702do it.
2703</dd>
2704<p></p>
2705<dt><strong><a name="item__2d_2ddisable_2dresources">--disable-resources</a></strong><br /> 2772<dt><strong><a name="item__2d_2ddisable_2dresources">--disable-resources</a></strong><br />
2706</dt> 2773</dt>
2707<dd> 2774<dd>
2708Remove all resources checking. 2775Removes any support for resource checking.
2709</dd> 2776</dd>
2710<p></p> 2777<p></p>
2711<dt><strong><a name="item__2d_2denable_2dxgetdefault">--enable-xgetdefault</a></strong><br /> 2778<dt><strong><a name="item__2d_2denable_2dxgetdefault">--enable-xgetdefault</a></strong><br />
2712</dt> 2779</dt>
2713<dd> 2780<dd>
… …
2719<p>Please note that nowadays, things like XIM will automatically pull in and 2786<p>Please note that nowadays, things like XIM will automatically pull in and
2720use the full X resource manager, so the overhead of using it might be very 2787use the full X resource manager, so the overhead of using it might be very
2721small, if nonexistant.</p> 2788small, if nonexistant.</p>
2722</dd> 2789</dd>
2723<p></p> 2790<p></p>
2724<dt><strong><a name="item__2d_2denable_2dstrings">--enable-strings</a></strong><br /> 2791<dt><strong><a name="item_strings">--enable-strings (default: off)</a></strong><br />
2725</dt> 2792</dt>
2726<dd> 2793<dd>
2727Add support for our possibly faster <code>memset()</code> function and other 2794Add support for our possibly faster <code>memset()</code> function and other
2728various routines, overriding your system's versions which may 2795various routines, overriding your system's versions which may
2729have been hand-crafted in assembly or may require extra libraries 2796have been hand-crafted in assembly or may require extra libraries
… …
2732</dd> 2799</dd>
2733<p></p> 2800<p></p>
2734<dt><strong><a name="item__2d_2ddisable_2dswapscreen">--disable-swapscreen</a></strong><br /> 2801<dt><strong><a name="item__2d_2ddisable_2dswapscreen">--disable-swapscreen</a></strong><br />
2735</dt> 2802</dt>
2736<dd> 2803<dd>
2737Remove support for swap screen. 2804Remove support for secondary/swap screen.
2738</dd> 2805</dd>
2739<p></p> 2806<p></p>
2740<dt><strong><a name="item__2d_2denable_2dfrills">--enable-frills</a></strong><br /> 2807<dt><strong><a name="item_frills">--enable-frills (default: on)</a></strong><br />
2741</dt> 2808</dt>
2742<dd> 2809<dd>
2743Add support for many small features that are not essential but nice to 2810Add support for many small features that are not essential but nice to
2744have. Normally you want this, but for very small binaries you may want to 2811have. Normally you want this, but for very small binaries you may want to
2745disable this. 2812disable this.
2746</dd> 2813</dd>
2747<dd> 2814<dd>
2748<p>A non-exhaustive list of features enabled by <a href="#item__2d_2denable_2dfrills"><code>--enable-frills</code></a> (possibly 2815<p>A non-exhaustive list of features enabled by <code>--enable-frills</code> (possibly
2749in combination with other switches) is:</p> 2816in combination with other switches) is:</p>
2750</dd> 2817</dd>
2751<dd> 2818<dd>
2752<pre> 2819<pre>
2753 MWM-hints 2820 MWM-hints
2821 EWMH-hints (pid, utf8 names) and protocols (ping)
2754 seperate underline colour 2822 seperate underline colour
2755 settable border widths and borderless switch 2823 settable border widths and borderless switch
2756 settable extra linespacing 2824 settable extra linespacing
2757 extra window properties (e.g. UTF-8 window names and PID)
2758 iso-14755-2 and -3, and visual feedback 2825 iso-14755-2 and -3, and visual feedback
2759 backindex and forwardindex escape sequence 2826 backindex and forwardindex escape sequence
2760 window op and locale change escape sequences 2827 window op and some xterm/OSC escape sequences
2761 tripleclickwords 2828 tripleclickwords
2762 settable insecure mode 2829 settable insecure mode
2763 keysym remapping support</pre> 2830 keysym remapping support
2764</dd> 2831 cursor blinking and underline cursor
2765<p></p> 2832 -embed and -pty-fd options</pre>
2766<dt><strong><a name="item__2d_2denable_2diso14755">--enable-iso14755</a></strong><br />
2767</dt>
2768<dd> 2833</dd>
2834<p></p>
2835<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br />
2836</dt>
2837<dd>
2769Enable extended ISO 14755 support (see rxvt(1), or 2838Enable extended ISO 14755 support (see urxvt(1), or
2770<em>doc/rxvt.1.txt</em>). Basic support (section 5.1) is enabled by 2839<em>doc/rxvt.1.txt</em>). Basic support (section 5.1) is enabled by
2771<a href="#item__2d_2denable_2dfrills"><code>--enable-frills</code></a>, while support for 5.2, 5.3 and 5.4 is enabled with 2840<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with
2772this switch. 2841this switch.
2773</dd> 2842</dd>
2774<p></p> 2843<p></p>
2775<dt><strong><a name="item__2d_2denable_2dkeepscrolling">--enable-keepscrolling</a></strong><br /> 2844<dt><strong><a name="item_keepscrolling">--enable-keepscrolling (default: on)</a></strong><br />
2776</dt> 2845</dt>
2777<dd> 2846<dd>
2778Add support for continual scrolling of the display when you hold 2847Add support for continual scrolling of the display when you hold
2779the mouse button down on a scrollbar arrow. 2848the mouse button down on a scrollbar arrow.
2780</dd> 2849</dd>
2781<p></p> 2850<p></p>
2782<dt><strong><a name="item__2d_2denable_2dmousewheel">--enable-mousewheel</a></strong><br /> 2851<dt><strong><a name="item_mousewheel">--enable-mousewheel (default: on)</a></strong><br />
2783</dt> 2852</dt>
2784<dd> 2853<dd>
2785Add support for scrolling via mouse wheel or buttons 4 &amp; 5. 2854Add support for scrolling via mouse wheel or buttons 4 &amp; 5.
2786</dd> 2855</dd>
2787<p></p> 2856<p></p>
2788<dt><strong><a name="item__2d_2denable_2dslipwheeling">--enable-slipwheeling</a></strong><br /> 2857<dt><strong><a name="item_slipwheeling">--enable-slipwheeling (default: on)</a></strong><br />
2789</dt> 2858</dt>
2790<dd> 2859<dd>
2791Add support for continual scrolling (using the mouse wheel as an 2860Add support for continual scrolling (using the mouse wheel as an
2792accelerator) while the control key is held down. This option 2861accelerator) while the control key is held down. This option
2793requires --enable-mousewheel to also be specified. 2862requires --enable-mousewheel to also be specified.
… …
2797</dt> 2866</dt>
2798<dd> 2867<dd>
2799Remove support for mouse selection style like that of xterm. 2868Remove support for mouse selection style like that of xterm.
2800</dd> 2869</dd>
2801<p></p> 2870<p></p>
2802<dt><strong><a name="item__2d_2denable_2ddmalloc">--enable-dmalloc</a></strong><br /> 2871<dt><strong><a name="item_dmalloc">--enable-dmalloc (default: off)</a></strong><br />
2803</dt> 2872</dt>
2804<dd> 2873<dd>
2805Use Gray Watson's malloc - which is good for debugging See 2874Use Gray Watson's malloc - which is good for debugging See
2806<a href="http://www.letters.com/dmalloc/">http://www.letters.com/dmalloc/</a> for details If you use either this or the 2875<a href="http://www.letters.com/dmalloc/">http://www.letters.com/dmalloc/</a> for details If you use either this or the
2807next option, you may need to edit src/Makefile after compiling to point 2876next option, you may need to edit src/Makefile after compiling to point
… …
2810<dd> 2879<dd>
2811<p>You can only use either this option and the following (should 2880<p>You can only use either this option and the following (should
2812you use either) .</p> 2881you use either) .</p>
2813</dd> 2882</dd>
2814<p></p> 2883<p></p>
2815<dt><strong><a name="item__2d_2denable_2ddlmalloc">--enable-dlmalloc</a></strong><br /> 2884<dt><strong><a name="item_dlmalloc">--enable-dlmalloc (default: off)</a></strong><br />
2816</dt> 2885</dt>
2817<dd> 2886<dd>
2818Use Doug Lea's malloc - which is good for a production version 2887Use Doug Lea's malloc - which is good for a production version
2819See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details. 2888See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details.
2820</dd> 2889</dd>
2821<p></p> 2890<p></p>
2822<dt><strong><a name="item__2d_2denable_2dsmart_2dresize">--enable-smart-resize</a></strong><br /> 2891<dt><strong><a name="item_resize">--enable-smart-resize (default: on)</a></strong><br />
2823</dt> 2892</dt>
2824<dd> 2893<dd>
2825Add smart growth/shrink behaviour when changing font size via from hot 2894Add smart growth/shrink behaviour when changing font size via hot
2826keys. This should keep in a fixed position the rxvt corner which is 2895keys. This should keep in a fixed position the urxvt corner which is
2827closest to a corner of the screen. 2896closest to a corner of the screen.
2828</dd> 2897</dd>
2829<p></p> 2898<p></p>
2830<dt><strong><a name="item__2d_2denable_2dcursor_2dblink">--enable-cursor-blink</a></strong><br />
2831</dt>
2832<dd>
2833Add support for a blinking cursor.
2834</dd>
2835<p></p>
2836<dt><strong><a name="item__2d_2denable_2dpointer_2dblank">--enable-pointer-blank</a></strong><br /> 2899<dt><strong><a name="item_blank">--enable-pointer-blank (default: on)</a></strong><br />
2837</dt> 2900</dt>
2838<dd> 2901<dd>
2839Add support to have the pointer disappear when typing or inactive. 2902Add support to have the pointer disappear when typing or inactive.
2840</dd> 2903</dd>
2841<p></p> 2904<p></p>
2842<dt><strong><a name="item__2d_2dwith_2dname_3dname">--with-name=NAME</a></strong><br /> 2905<dt><strong>--with-name=NAME (default: urxvt)</strong><br />
2843</dt> 2906</dt>
2844<dd> 2907<dd>
2845Set the basename for the installed binaries (default: <code>urxvt</code>, resulting 2908Set the basename for the installed binaries, resulting
2846in <code>urxvt</code>, <code>urxvtd</code> etc.). Specify <code>--with-name=rxvt</code> to replace with 2909in <code>urxvt</code>, <code>urxvtd</code> etc.). Specify <code>--with-name=rxvt</code> to replace with
2847<code>rxvt</code>. 2910<code>rxvt</code>.
2848</dd> 2911</dd>
2849<p></p> 2912<p></p>
2850<dt><strong><a name="item__2d_2dwith_2dterm_3dname">--with-term=NAME</a></strong><br /> 2913<dt><strong>--with-term=NAME (default: rxvt-unicode)</strong><br />
2851</dt> 2914</dt>
2852<dd> 2915<dd>
2853Change the environmental variable for the terminal to NAME (default 2916Change the environmental variable for the terminal to NAME.
2854<code>rxvt-unicode</code>)
2855</dd> 2917</dd>
2856<p></p> 2918<p></p>
2857<dt><strong><a name="item__2d_2dwith_2dterminfo_3dpath">--with-terminfo=PATH</a></strong><br /> 2919<dt><strong><a name="item__2d_2dwith_2dterminfo_3dpath">--with-terminfo=PATH</a></strong><br />
2858</dt> 2920</dt>
2859<dd> 2921<dd>

Diff Legend

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