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.18 by root, Mon Feb 21 19:26:06 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
… …
301<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,
302e.g.:</p> 310e.g.:</p>
303</dd> 311</dd>
304<dd> 312<dd>
305<pre> 313<pre>
306 rxvt -fn basefont,font2,font3...</pre> 314 urxvt -fn basefont,font2,font3...</pre>
307</dd> 315</dd>
308<dd> 316<dd>
309<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
310font. 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
311next 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
… …
371<dd> 379<dd>
372<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
373box data is correct.</p> 381box data is correct.</p>
374</dd> 382</dd>
375<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>
376<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 />
377</dt> 397</dt>
378<dd> 398<dd>
379The 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
380correctly, 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
… …
438<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
439does 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
440<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>
441</dd> 461</dd>
442<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>
443<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
444multi-language apps in an OS, as using a locale-dependent (and 468apps in an OS, as using a locale-dependent (and non-standardized)
445non-standardized) representation of <strong>wchar_t</strong> makes it impossible to 469representation 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 470<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 471without 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 472simply are no APIs to convert <strong>wchar_t</strong> into anything except the current
449except the current locale encoding.</p> 473locale encoding.</p>
450</dd> 474</dd>
451<dd> 475<dd>
452<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
453by carrying their own replacement functions for character set handling 477by carrying their own replacement functions for character set handling
454with them, and either implementing OS-dependent hacks or doing multiple 478with them, and either implementing OS-dependent hacks or doing multiple
… …
457</dd> 481</dd>
458<dd> 482<dd>
459<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
460system 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
461complete 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>
462</dd> 509</dd>
463<p></p> 510<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 /> 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 />
465</dt> 512</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 /> 513<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 657when used. Compiling it out ensures that no Xft font will be loaded
611accidentally when rxvt-unicode tries to find a font for your characters. 658accidentally when rxvt-unicode tries to find a font for your characters.
612</dd> 659</dd>
613<dd> 660<dd>
614<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
615scrollback 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
6166 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
617kilobyte 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)
618use 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
619rxvt-unicode then uses 8 bytes per screen cell.</p> 666rxvt-unicode then uses 8 bytes per screen cell.</p>
620</dd> 667</dd>
621<p></p> 668<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 /> 669<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> 670</dt>
624<dd> 671<dd>
625Yes, 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
626it 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
627antialiasing (by appending <code>:antialiasing=false</code>), which saves lots of 674antialiasing (by appending <code>:antialias=false</code>), which saves lots of
628memory and also speeds up rendering considerably. 675memory and also speeds up rendering considerably.
629</dd> 676</dd>
630<p></p> 677<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 /> 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 />
632</dt> 679</dt>
… …
646<dd> 693<dd>
647Make sure that mouse reporting is actually turned off since killing 694Make sure that mouse reporting is actually turned off since killing
648some 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
649heard that tcsh may use mouse reporting unless it otherwise specified. A 696heard that tcsh may use mouse reporting unless it otherwise specified. A
650quick 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
651depressed. See <code>rxvt(7)</code> 698depressed. See <code>urxvt(7)</code>
652</dd> 699</dd>
653<p></p> 700<p></p>
654<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 />
655</dt> 702</dt>
656<dd> 703<dd>
… …
730 URxvt.color14: #73f7ff 777 URxvt.color14: #73f7ff
731 URxvt.color7: #e1dddd 778 URxvt.color7: #e1dddd
732 URxvt.color15: #e1dddd</pre> 779 URxvt.color15: #e1dddd</pre>
733</dd> 780</dd>
734<p></p> 781<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 /> 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 />
736</dt> 783</dt>
737<dd>
738Despite it's name, rxvtd is not a real daemon, but more like a
739server that answers rxvtc's requests, so it doesn't background
740itself.
741</dd> 784<dd>
742<dd> 785Try <code>urxvtd -f -o</code>, which tells urxvtd to open the
743<p>To ensure rxvtd is listening on it's socket, you can use the 786display, create the listening socket and then fork.
744following method to wait for the startup message before continuing:</p>
745</dd>
746<dd>
747<pre>
748 { rxvtd &amp; } | read</pre>
749</dd> 787</dd>
750<p></p> 788<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 /> 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 />
752</dt> 790</dt>
753<dd> 791<dd>
… …
773</dd> 811</dd>
774<dd> 812<dd>
775<pre> 813<pre>
776 # use Backspace = ^H 814 # use Backspace = ^H
777 $ stty erase ^H 815 $ stty erase ^H
778 $ rxvt</pre> 816 $ urxvt</pre>
779</dd> 817</dd>
780<dd> 818<dd>
781<pre> 819<pre>
782 # use Backspace = ^? 820 # use Backspace = ^?
783 $ stty erase ^? 821 $ stty erase ^?
784 $ rxvt</pre> 822 $ urxvt</pre>
785</dd>
786<dd> 823</dd>
824<dd>
787<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>
788</dd> 826</dd>
789<dd> 827<dd>
790<p>For an existing rxvt-unicode:</p> 828<p>For an existing rxvt-unicode:</p>
791</dd> 829</dd>
792<dd> 830<dd>
… …
830There are some compile-time selections available via configure. Unless 868There are some compile-time selections available via configure. Unless
831you 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
832use the `keysym' resource to alter the keystrings associated with keysyms. 870use the `keysym' resource to alter the keystrings associated with keysyms.
833</dd> 871</dd>
834<dd> 872<dd>
835<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>
836</dd> 874</dd>
837<dd> 875<dd>
838<pre> 876<pre>
839 URxvt.keysym.Home: \033[1~ 877 URxvt.keysym.Home: \033[1~
840 URxvt.keysym.End: \033[4~ 878 URxvt.keysym.End: \033[4~
… …
2496</table><p> 2534</table><p>
2497</p> 2535</p>
2498<hr /> 2536<hr />
2499<h1><a name="configure_options">CONFIGURE OPTIONS</a></h1> 2537<h1><a name="configure_options">CONFIGURE OPTIONS</a></h1>
2500<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
2501hasn'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
2502./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
2503so 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
2504report 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
2505&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>
2506<dl> 2545<dl>
2507<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 />
2508</dt> 2547</dt>
2509<dd> 2548<dd>
2510Add support for all non-multichoice options listed in ``./configure 2549Add (or remove) support for all non-multichoice options listed in ``./configure
2511--help''. Note that unlike other enable options this is order dependant. 2550--help''.
2512You can specify this and then disable options which this enables by 2551</dd>
2513<em>following</em> this with the appropriate commands.
2514</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>
2515<p></p> 2559<p></p>
2516<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 />
2517</dt> 2561</dt>
2518<dd> 2562<dd>
2519Add support for Xft (anti-aliases, among others) fonts. Xft fonts are 2563Add support for Xft (anti-aliases, among others) fonts. Xft fonts are
2520slower 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
2521don't pay for them. 2565don't pay for them.
2522</dd> 2566</dd>
2523<p></p> 2567<p></p>
2524<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 />
2525</dt> 2569</dt>
2526<dd> 2570<dd>
2527Add 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
2528styles. The fonts can be set manually or automatically. 2572styles. The fonts can be set manually or automatically.
2529</dd> 2573</dd>
2530<p></p> 2574<p></p>
2531<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 />
2532</dt> 2576</dt>
2533<dd> 2577<dd>
2534Compile in support for additional codeset (encoding) groups (eu, vn are 2578Compile in support for additional codeset (encoding) groups (<code>eu</code>, <code>vn</code>
2535always compiled in, which includes most 8-bit character sets). These 2579are always compiled in, which includes most 8-bit character sets). These
2536codeset tables are currently only used for driving X11 core fonts, they 2580codeset tables are used for driving X11 core fonts, they are not required
2537are not required for Xft fonts. Compiling them in will make your binary 2581for Xft fonts, although having them compiled in lets rxvt-unicode choose
2538bigger (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
2539you use an X11 font requiring one of these encodings. 2584memory usage unless you use a font requiring one of these encodings.
2540</dd> 2585</dd>
2541<table> 2586<table>
2542<tr><td>all</td><td>all available codeset groups</td></tr> 2587<tr><td>all</td><td>all available codeset groups</td></tr>
2543<tr><td>zh</td><td>common chinese encodings</td></tr> 2588<tr><td>zh</td><td>common chinese encodings</td></tr>
2544<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>
2545<tr><td>jp</td><td>common japanese encodings</td></tr> 2590<tr><td>jp</td><td>common japanese encodings</td></tr>
2546<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>
2547<tr><td>kr</td><td>korean encodings</td></tr> 2592<tr><td>kr</td><td>korean encodings</td></tr>
2548</table><p></p> 2593</table><p></p>
2549<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 />
2550</dt> 2595</dt>
2551<dd> 2596<dd>
2552Add support for XIM (X Input Method) protocol. This allows using 2597Add support for XIM (X Input Method) protocol. This allows using
2553alternative input methods (e.g. kinput2) and will also correctly 2598alternative input methods (e.g. kinput2) and will also correctly
2554set up the input for people using dead keys or compose keys. 2599set up the input for people using dead keys or compose keys.
2555</dd> 2600</dd>
2556<p></p> 2601<p></p>
2557<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 />
2558</dt> 2603</dt>
2559<dd> 2604<dd>
2560Enable direct support for displaying unicode codepoints above 2605Enable direct support for displaying unicode codepoints above
256165535 (the basic multilingual page). This increases storage 260665535 (the basic multilingual page). This increases storage
2562requirements 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
… …
2568limited to a view thousand (shared with combining characters, 2613limited to a view thousand (shared with combining characters,
2569see next switch), and right now rxvt-unicode cannot display them 2614see next switch), and right now rxvt-unicode cannot display them
2570(input/output and cut&amp;paste still work, though).</p> 2615(input/output and cut&amp;paste still work, though).</p>
2571</dd> 2616</dd>
2572<p></p> 2617<p></p>
2573<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 />
2574</dt> 2619</dt>
2575<dd> 2620<dd>
2576Enable automatic composition of combining characters into 2621Enable automatic composition of combining characters into
2577composite characters. This is required for proper viewing of text 2622composite characters. This is required for proper viewing of text
2578where accents are encoded as seperate unicode characters. This is 2623where accents are encoded as seperate unicode characters. This is
… …
2593<p>The combining table also contains entries for arabic presentation forms, 2638<p>The combining table also contains entries for arabic presentation forms,
2594but these are not currently used. Bug me if you want these to be used (and 2639but these are not currently used. Bug me if you want these to be used (and
2595tell me how these are to be used...).</p> 2640tell me how these are to be used...).</p>
2596</dd> 2641</dd>
2597<p></p> 2642<p></p>
2598<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 />
2599</dt> 2644</dt>
2600<dd>
2601When reading resource settings, also read settings for class CLASS
2602(default: Rxvt). To disable resource fallback use --disable-fallback.
2603</dd> 2645<dd>
2604<p></p> 2646When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback.
2605<dt><strong><a name="item__2d_2dwith_2dres_2dname_3dname">--with-res-name=NAME</a></strong><br />
2606</dt>
2607<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>
2608Use the given name (default: urxvt) as default application name when 2652Use the given name as default application name when
2609reading resources. Specify --with-res-name=rxvt to replace rxvt. 2653reading resources. Specify --with-res-name=rxvt to replace rxvt.
2610</dd> 2654</dd>
2611<p></p> 2655<p></p>
2612<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 />
2613</dt> 2657</dt>
2614<dd> 2658<dd>
2615Use the given class (default: URxvt) as default application class 2659Use the given class as default application class
2616when reading resources. Specify --with-res-class=Rxvt to replace 2660when reading resources. Specify --with-res-class=Rxvt to replace
2617rxvt. 2661rxvt.
2618</dd> 2662</dd>
2619<p></p> 2663<p></p>
2620<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 />
2621</dt> 2665</dt>
2622<dd> 2666<dd>
2623Write 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
2624start of rxvt execution and delete information when rxvt exits. 2668start of rxvt execution and delete information when rxvt exits.
2625</dd> 2669</dd>
2626<p></p> 2670<p></p>
2627<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 />
2628</dt> 2672</dt>
2629<dd> 2673<dd>
2630Write 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
2631start of rxvt execution and write logout when rxvt exits. This 2675start of rxvt execution and write logout when rxvt exits. This
2632option requires --enable-utmp to also be specified. 2676option requires --enable-utmp to also be specified.
2633</dd> 2677</dd>
2634<p></p> 2678<p></p>
2635<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 />
2636</dt> 2680</dt>
2637<dd> 2681<dd>
2638Write user and tty to lastlog file (used by programs like 2682Write user and tty to lastlog file (used by programs like
2639<em>lastlogin</em>) at start of rxvt execution. This option requires 2683<em>lastlogin</em>) at start of rxvt execution. This option requires
2640--enable-utmp to also be specified. 2684--enable-utmp to also be specified.
2641</dd> 2685</dd>
2642<p></p> 2686<p></p>
2643<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 />
2644</dt> 2688</dt>
2645<dd> 2689<dd>
2646Add support for XPM background pixmaps. 2690Add support for XPM background pixmaps.
2647</dd> 2691</dd>
2648<p></p> 2692<p></p>
2649<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 />
2650</dt> 2694</dt>
2651<dd> 2695<dd>
2652Add support for inheriting parent backgrounds thus giving a fake 2696Add support for inheriting parent backgrounds thus giving a fake
2653transparency to the term. 2697transparency to the term.
2654</dd> 2698</dd>
2655<p></p> 2699<p></p>
2656<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 />
2657</dt> 2701</dt>
2658<dd>
2659Add support for fading the text when focus is lost.
2660</dd> 2702<dd>
2661<p></p> 2703Add support for fading the text when focus is lost (requires <code>--enable-transparency</code>).
2662<dt><strong><a name="item__2d_2denable_2dtinting">--enable-tinting</a></strong><br />
2663</dt>
2664<dd> 2704</dd>
2665Add 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>
2666</dd> 2708<dd>
2709Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>).
2710</dd>
2667<p></p> 2711<p></p>
2668<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 />
2669</dt> 2713</dt>
2670<dd> 2714<dd>
2671Add support for our menu bar system (this interacts badly with 2715Add support for our menu bar system (this interacts badly with
2672dynamic locale switching currently). 2716dynamic locale switching currently).
2673</dd> 2717</dd>
2674<p></p> 2718<p></p>
2675<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 />
2676</dt> 2720</dt>
2677<dd> 2721<dd>
2678Add support for the original rxvt scrollbar. 2722Add support for the original rxvt scrollbar.
2679</dd> 2723</dd>
2680<p></p> 2724<p></p>
2681<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 />
2682</dt> 2726</dt>
2683<dd> 2727<dd>
2684Add support for a NeXT-like scrollbar. 2728Add support for a NeXT-like scrollbar.
2685</dd> 2729</dd>
2686<p></p> 2730<p></p>
2687<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 />
2688</dt> 2732</dt>
2689<dd> 2733<dd>
2690Add support for an Xterm-like scrollbar. 2734Add support for an Xterm-like scrollbar.
2691</dd> 2735</dd>
2692<p></p> 2736<p></p>
2693<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 />
2694</dt> 2738</dt>
2695<dd> 2739<dd>
2696Add support for a very unobtrusive, plain-looking scrollbar that 2740Add support for a very unobtrusive, plain-looking scrollbar that
2697is the favourite of the rxvt-unicode author, having used it for 2741is the favourite of the rxvt-unicode author, having used it for
2698many years. 2742many years.
2699</dd> 2743</dd>
2700<p></p> 2744<p></p>
2701<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 />
2702</dt> 2746</dt>
2703<dd> 2747<dd>
2704Make shadows on the scrollbar only half the normal width &amp; height. 2748Make shadows on the scrollbar only half the normal width &amp; height.
2705only applicable to rxvt scrollbars. 2749only applicable to rxvt scrollbars.
2706</dd> 2750</dd>
2707<p></p> 2751<p></p>
2708<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 />
2709</dt> 2753</dt>
2710<dd> 2754<dd>
2711Change tty device setting to group ``tty'' - only use this if 2755Change tty device setting to group ``tty'' - only use this if
2712your system uses this type of security. 2756your system uses this type of security.
2713</dd> 2757</dd>
2714<p></p> 2758<p></p>
2715<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 />
2716</dt> 2760</dt>
2717<dd> 2761<dd>
2718Disable 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
2719do it. 2769do it.
2720</dd> 2770</dd>
2721<p></p> 2771<p></p>
2722<dt><strong><a name="item__2d_2ddisable_2ddelete_2dkey">--disable-delete-key</a></strong><br />
2723</dt>
2724<dd>
2725Disable any handling of the delete key by us - let the X server
2726do it.
2727</dd>
2728<p></p>
2729<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 />
2730</dt> 2773</dt>
2731<dd> 2774<dd>
2732Remove all resources checking. 2775Removes any support for resource checking.
2733</dd> 2776</dd>
2734<p></p> 2777<p></p>
2735<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 />
2736</dt> 2779</dt>
2737<dd> 2780<dd>
… …
2743<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
2744use 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
2745small, if nonexistant.</p> 2788small, if nonexistant.</p>
2746</dd> 2789</dd>
2747<p></p> 2790<p></p>
2748<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 />
2749</dt> 2792</dt>
2750<dd> 2793<dd>
2751Add support for our possibly faster <code>memset()</code> function and other 2794Add support for our possibly faster <code>memset()</code> function and other
2752various routines, overriding your system's versions which may 2795various routines, overriding your system's versions which may
2753have been hand-crafted in assembly or may require extra libraries 2796have been hand-crafted in assembly or may require extra libraries
… …
2756</dd> 2799</dd>
2757<p></p> 2800<p></p>
2758<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 />
2759</dt> 2802</dt>
2760<dd> 2803<dd>
2761Remove support for swap screen. 2804Remove support for secondary/swap screen.
2762</dd> 2805</dd>
2763<p></p> 2806<p></p>
2764<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 />
2765</dt> 2808</dt>
2766<dd> 2809<dd>
2767Add 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
2768have. 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
2769disable this. 2812disable this.
2770</dd> 2813</dd>
2771<dd> 2814<dd>
2772<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
2773in combination with other switches) is:</p> 2816in combination with other switches) is:</p>
2774</dd> 2817</dd>
2775<dd> 2818<dd>
2776<pre> 2819<pre>
2777 MWM-hints 2820 MWM-hints
… …
2783 backindex and forwardindex escape sequence 2826 backindex and forwardindex escape sequence
2784 window op and some xterm/OSC escape sequences 2827 window op and some xterm/OSC escape sequences
2785 tripleclickwords 2828 tripleclickwords
2786 settable insecure mode 2829 settable insecure mode
2787 keysym remapping support 2830 keysym remapping support
2831 cursor blinking and underline cursor
2788 -embed and -pty-fd options</pre> 2832 -embed and -pty-fd options</pre>
2789</dd> 2833</dd>
2790<p></p> 2834<p></p>
2791<dt><strong><a name="item__2d_2denable_2diso14755">--enable-iso14755</a></strong><br /> 2835<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br />
2792</dt> 2836</dt>
2793<dd> 2837<dd>
2794Enable extended ISO 14755 support (see rxvt(1), or 2838Enable extended ISO 14755 support (see urxvt(1), or
2795<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
2796<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
2797this switch. 2841this switch.
2798</dd> 2842</dd>
2799<p></p> 2843<p></p>
2800<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 />
2801</dt> 2845</dt>
2802<dd> 2846<dd>
2803Add support for continual scrolling of the display when you hold 2847Add support for continual scrolling of the display when you hold
2804the mouse button down on a scrollbar arrow. 2848the mouse button down on a scrollbar arrow.
2805</dd> 2849</dd>
2806<p></p> 2850<p></p>
2807<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 />
2808</dt> 2852</dt>
2809<dd> 2853<dd>
2810Add support for scrolling via mouse wheel or buttons 4 &amp; 5. 2854Add support for scrolling via mouse wheel or buttons 4 &amp; 5.
2811</dd> 2855</dd>
2812<p></p> 2856<p></p>
2813<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 />
2814</dt> 2858</dt>
2815<dd> 2859<dd>
2816Add support for continual scrolling (using the mouse wheel as an 2860Add support for continual scrolling (using the mouse wheel as an
2817accelerator) while the control key is held down. This option 2861accelerator) while the control key is held down. This option
2818requires --enable-mousewheel to also be specified. 2862requires --enable-mousewheel to also be specified.
… …
2822</dt> 2866</dt>
2823<dd> 2867<dd>
2824Remove support for mouse selection style like that of xterm. 2868Remove support for mouse selection style like that of xterm.
2825</dd> 2869</dd>
2826<p></p> 2870<p></p>
2827<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 />
2828</dt> 2872</dt>
2829<dd> 2873<dd>
2830Use Gray Watson's malloc - which is good for debugging See 2874Use Gray Watson's malloc - which is good for debugging See
2831<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
2832next 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
… …
2835<dd> 2879<dd>
2836<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
2837you use either) .</p> 2881you use either) .</p>
2838</dd> 2882</dd>
2839<p></p> 2883<p></p>
2840<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 />
2841</dt> 2885</dt>
2842<dd> 2886<dd>
2843Use Doug Lea's malloc - which is good for a production version 2887Use Doug Lea's malloc - which is good for a production version
2844See <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.
2845</dd> 2889</dd>
2846<p></p> 2890<p></p>
2847<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 />
2848</dt> 2892</dt>
2849<dd> 2893<dd>
2850Add smart growth/shrink behaviour when changing font size via from hot 2894Add smart growth/shrink behaviour when changing font size via hot
2851keys. 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
2852closest to a corner of the screen. 2896closest to a corner of the screen.
2853</dd> 2897</dd>
2854<p></p> 2898<p></p>
2855<dt><strong><a name="item__2d_2denable_2dcursor_2dblink">--enable-cursor-blink</a></strong><br />
2856</dt>
2857<dd>
2858Add support for a blinking cursor.
2859</dd>
2860<p></p>
2861<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 />
2862</dt> 2900</dt>
2863<dd> 2901<dd>
2864Add support to have the pointer disappear when typing or inactive. 2902Add support to have the pointer disappear when typing or inactive.
2865</dd> 2903</dd>
2866<p></p> 2904<p></p>
2867<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 />
2868</dt> 2906</dt>
2869<dd> 2907<dd>
2870Set the basename for the installed binaries (default: <code>urxvt</code>, resulting 2908Set the basename for the installed binaries, resulting
2871in <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
2872<code>rxvt</code>. 2910<code>rxvt</code>.
2873</dd> 2911</dd>
2874<p></p> 2912<p></p>
2875<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 />
2876</dt> 2914</dt>
2877<dd> 2915<dd>
2878Change the environmental variable for the terminal to NAME (default 2916Change the environmental variable for the terminal to NAME.
2879<code>rxvt-unicode</code>)
2880</dd> 2917</dd>
2881<p></p> 2918<p></p>
2882<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 />
2883</dt> 2920</dt>
2884<dd> 2921<dd>

Diff Legend

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