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.25 by root, Tue Nov 8 17:35:28 2005 UTC vs.
Revision 1.30 by root, Mon Jan 2 19:36:07 2006 UTC

… …
73<p> 73<p>
74</p> 74</p>
75<hr /> 75<hr />
76<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> 76<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1>
77<dl> 77<dl>
78<dt><strong><a name="item_isn_27t_rxvt_supposed_to_be_small_3f_don_27t_all_t">Isn't rxvt supposed to be small? Don't all those features bloat?</a></strong><br />
79</dt>
80<dd>
81I often get asked about this, and I think, no, they didn't cause extra
82bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
83that the urxvt binary is larger (due to some encoding tables always being
84compiled in), but it actually uses less memory (RSS) after startup. Even
85with <code>--disable-everything</code>, this comparison is a bit unfair, as many
86features unique to urxvt (locale, encoding conversion, iso14755 etc.) are
87already in use in this mode.
88</dd>
89<dd>
90<pre>
91 text data bss drs rss filename
92 98398 1664 24 15695 1824 rxvt --disable-everything
93 188985 9048 66616 18222 1788 urxvt --disable-everything</pre>
94</dd>
95<dd>
96<p>When you <a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> (which _is_ unfair, as this involves xft
97and full locale/XIM support which are quite bloaty inside libX11 and my
98libc), the two diverge, but not unreasnobaly so.</p>
99</dd>
100<dd>
101<pre>
102 text data bss drs rss filename
103 163431 2152 24 20123 2060 rxvt --enable-everything
104 1035683 49680 66648 29096 3680 urxvt --enable-everything</pre>
105</dd>
106<dd>
107<p>The very large size of the text section is explained by the east-asian
108encoding tables, which, if unused, take up disk space but nothing else
109and can be compiled out unless you rely on X11 core fonts that use those
110encodings. The BSS size comes from the 64k emergency buffer that my c++
111compiler allocates (but of course doesn't use unless you are out of
112memory). Also, using an xft font instead of a core font immediately adds a
113few megabytes of RSS. Xft indeed is responsible for a lot of RSS even when
114not used.</p>
115</dd>
116<dd>
117<p>Of course, due to every character using two or four bytes instead of one,
118a large scrollback buffer will ultimately make rxvt-unicode use more
119memory.</p>
120</dd>
121<dd>
122<p>Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this
123still fares rather well. And compared to some monsters like gnome-terminal
124(21152k + extra 4204k in separate processes) or konsole (22200k + extra
12543180k in daemons that stay around after exit, plus half aminute of
126startup time, including the hundreds of warnings it spits out), it fares
127extremely well *g*.</p>
128</dd>
129<p></p>
130<dt><strong><a name="item_why_c_2b_2b_2c_isn_27t_that_unportable_2fbloated_2">Why C++, isn't that unportable/bloated/uncool?</a></strong><br />
131</dt>
132<dd>
133Is this a question? :) It comes up very often. The simple answer is: I had
134to write it, and C++ allowed me to write and maintain it in a fraction
135of the time and effort (which is a scarce resource for me). Put even
136shorter: It simply wouldn't exist without C++.
137</dd>
138<dd>
139<p>My personal stance on this is that C++ is less portable than C, but in
140the case of rxvt-unicode this hardly matters, as its portability limits
141are defined by things like X11, pseudo terminals, locale support and unix
142domain sockets, which are all less portable than C++ itself.</p>
143</dd>
144<dd>
145<p>Regarding the bloat, see the above question: It's easy to write programs
146in C that use gobs of memory, an certainly possible to write programs in
147C++ that don't. C++ also often comes with large libraries, but this is
148not necessarily the case with GCC. Here is what rxvt links against on my
149system with a minimal config:</p>
150</dd>
151<dd>
152<pre>
153 libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
154 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaadde000)
155 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab01d000)
156 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)</pre>
157</dd>
158<dd>
159<p>And here is rxvt-unicode:</p>
160</dd>
161<dd>
162<pre>
163 libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
164 libgcc_s.so.1 =&gt; /lib/libgcc_s.so.1 (0x00002aaaaada2000)
165 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaaeb0000)
166 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab0ee000)
167 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)</pre>
168</dd>
169<dd>
170<p>No large bloated libraries (of course, none were linked in statically),
171except maybe libX11 :)</p>
172</dd>
173<p></p>
174<dt><strong><a name="item_does_it_support_tabs_2c_can_i_have_a_tabbed_rxvt_2">Does it support tabs, can I have a tabbed rxvt-unicode?</a></strong><br />
175</dt>
176<dd>
177rxvt-unicode does not directly support tabs. It will work fine with
178tabbing functionality of many window managers or similar tabbing programs,
179and its embedding-features allow it to be embedded into other programs,
180as witnessed by <em>doc/rxvt-tabbed</em> or the upcoming <code>Gtk2::URxvt</code> perl
181module, which features a tabbed urxvt (murxvt) terminal as an example
182embedding application.
183</dd>
184<p></p>
78<dt><strong><a name="item_how_do_i_know_which_rxvt_2dunicode_version_i_27m_u">How do I know which rxvt-unicode version I'm using?</a></strong><br /> 185<dt><strong><a name="item_how_do_i_know_which_rxvt_2dunicode_version_i_27m_u">How do I know which rxvt-unicode version I'm using?</a></strong><br />
79</dt> 186</dt>
80<dd> 187<dd>
81The version number is displayed with the usage (-h). Also the escape 188The version number is displayed with the usage (-h). Also the escape
82sequence <code>ESC [ 8 n</code> sets the window title to the version number. 189sequence <code>ESC [ 8 n</code> sets the window title to the version number. When
190using the rxvtc client, the version displayed is that of the
191daemon.
83</dd> 192</dd>
84<p></p> 193<p></p>
85<dt><strong><a name="item_i_am_using_debian_gnu_2flinux_and_have_a_problem_2">I am using Debian GNU/Linux and have a problem...</a></strong><br /> 194<dt><strong><a name="item_i_am_using_debian_gnu_2flinux_and_have_a_problem_2">I am using Debian GNU/Linux and have a problem...</a></strong><br />
86</dt> 195</dt>
87<dd> 196<dd>
… …
145<dd> 254<dd>
146Most likely it's the empty definition for <code>enacs=</code>. Just replace it by 255Most likely it's the empty definition for <code>enacs=</code>. Just replace it by
147<code>enacs=\E[0@</code> and try again. 256<code>enacs=\E[0@</code> and try again.
148</dd> 257</dd>
149<p></p> 258<p></p>
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 /> 259<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 />
151</dt> 260</dt>
152<dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br /> 261<dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br />
153</dt> 262</dt>
154<dd> 263<dd>
155One reason you might want this is that some distributions or operating 264One reason you might want this is that some distributions or operating
… …
309<p>In that case, select a font of your taste and add it to the font list, 418<p>In that case, select a font of your taste and add it to the font list,
310e.g.:</p> 419e.g.:</p>
311</dd> 420</dd>
312<dd> 421<dd>
313<pre> 422<pre>
314 urxvt -fn basefont,font2,font3...</pre> 423 rxvt -fn basefont,font2,font3...</pre>
315</dd> 424</dd>
316<dd> 425<dd>
317<p>When rxvt-unicode sees a character, it will first look at the base 426<p>When rxvt-unicode sees a character, it will first look at the base
318font. If the base font does not contain the character, it will go to the 427font. If the base font does not contain the character, it will go to the
319next font, and so on. Specifying your own fonts will also speed up this 428next font, and so on. Specifying your own fonts will also speed up this
… …
693<dd> 802<dd>
694Make sure that mouse reporting is actually turned off since killing 803Make sure that mouse reporting is actually turned off since killing
695some editors prematurely may leave the mouse in mouse report mode. I've 804some editors prematurely may leave the mouse in mouse report mode. I've
696heard that tcsh may use mouse reporting unless it otherwise specified. A 805heard that tcsh may use mouse reporting unless it otherwise specified. A
697quick check is to see if cut/paste works when the Alt or Shift keys are 806quick check is to see if cut/paste works when the Alt or Shift keys are
698depressed. See <code>urxvt(7)</code> 807depressed. See <code>rxvt(7)</code>
699</dd> 808</dd>
700<p></p> 809<p></p>
701<dt><strong><a name="item_what_27s_with_this_bold_2fblink_stuff_3f">What's with this bold/blink stuff?</a></strong><br /> 810<dt><strong><a name="item_what_27s_with_this_bold_2fblink_stuff_3f">What's with this bold/blink stuff?</a></strong><br />
702</dt> 811</dt>
703<dd> 812<dd>
… …
777 URxvt.color14: #73f7ff 886 URxvt.color14: #73f7ff
778 URxvt.color7: #e1dddd 887 URxvt.color7: #e1dddd
779 URxvt.color15: #e1dddd</pre> 888 URxvt.color15: #e1dddd</pre>
780</dd> 889</dd>
781<p></p> 890<p></p>
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 /> 891<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 />
783</dt> 892</dt>
784<dd> 893<dd>
785Try <code>urxvtd -f -o</code>, which tells urxvtd to open the 894Try <code>rxvtd -f -o</code>, which tells rxvtd to open the
786display, create the listening socket and then fork. 895display, create the listening socket and then fork.
787</dd> 896</dd>
788<p></p> 897<p></p>
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 /> 898<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 />
790</dt> 899</dt>
… …
811</dd> 920</dd>
812<dd> 921<dd>
813<pre> 922<pre>
814 # use Backspace = ^H 923 # use Backspace = ^H
815 $ stty erase ^H 924 $ stty erase ^H
816 $ urxvt</pre> 925 $ rxvt</pre>
817</dd> 926</dd>
818<dd> 927<dd>
819<pre> 928<pre>
820 # use Backspace = ^? 929 # use Backspace = ^?
821 $ stty erase ^? 930 $ stty erase ^?
822 $ urxvt</pre> 931 $ rxvt</pre>
823</dd>
824<dd> 932</dd>
933<dd>
825<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code> as documented in urxvt(7).</p> 934<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code> as documented in rxvt(7).</p>
826</dd> 935</dd>
827<dd> 936<dd>
828<p>For an existing rxvt-unicode:</p> 937<p>For an existing rxvt-unicode:</p>
829</dd> 938</dd>
830<dd> 939<dd>
… …
868There are some compile-time selections available via configure. Unless 977There are some compile-time selections available via configure. Unless
869you have run ``configure'' with the <a href="#item__2d_2ddisable_2dresources"><code>--disable-resources</code></a> option you can 978you have run ``configure'' with the <a href="#item__2d_2ddisable_2dresources"><code>--disable-resources</code></a> option you can
870use the `keysym' resource to alter the keystrings associated with keysyms. 979use the `keysym' resource to alter the keystrings associated with keysyms.
871</dd> 980</dd>
872<dd> 981<dd>
873<p>Here's an example for a URxvt session started using <code>urxvt -name URxvt</code></p> 982<p>Here's an example for a URxvt session started using <code>rxvt -name URxvt</code></p>
874</dd> 983</dd>
875<dd> 984<dd>
876<pre> 985<pre>
877 URxvt.keysym.Home: \033[1~ 986 URxvt.keysym.Home: \033[1~
878 URxvt.keysym.End: \033[4~ 987 URxvt.keysym.End: \033[4~
… …
1704</table><dt><strong><a name="item_1011"><strong><code>Ps = 1011</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br /> 1813</table><dt><strong><a name="item_1011"><strong><code>Ps = 1011</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1705</dt> 1814</dt>
1706<table> 1815<table>
1707<tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr> 1816<tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr>
1708<tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr> 1817<tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr>
1818</table><dt><strong><a name="item_1021"><strong><code>Ps = 1021</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1819</dt>
1820<table>
1821<tr><td>h</td><td>Bold/italic implies high intensity (see option -is)</td></tr>
1822<tr><td>l</td><td>Font styles have no effect on intensity (Compile styles)</td></tr>
1709</table><dt><strong><a name="item_ps__3d_1047"><strong><code>Ps = 1047</code> </strong>&gt;</a></strong><br /> 1823</table><dt><strong><a name="item_ps__3d_1047"><strong><code>Ps = 1047</code> </strong>&gt;</a></strong><br />
1710</dt> 1824</dt>
1711<table> 1825<table>
1712<tr><td>h</td><td>Use Alternate Screen Buffer</td></tr> 1826<tr><td>h</td><td>Use Alternate Screen Buffer</td></tr>
1713<tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr> 1827<tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr>
… …
2827 window op and some xterm/OSC escape sequences 2941 window op and some xterm/OSC escape sequences
2828 tripleclickwords 2942 tripleclickwords
2829 settable insecure mode 2943 settable insecure mode
2830 keysym remapping support 2944 keysym remapping support
2831 cursor blinking and underline cursor 2945 cursor blinking and underline cursor
2832 -embed and -pty-fd options</pre> 2946 -embed, -pty-fd and -hold options</pre>
2833</dd> 2947</dd>
2834<p></p> 2948<p></p>
2835<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br /> 2949<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br />
2836</dt> 2950</dt>
2837<dd> 2951<dd>
2838Enable extended ISO 14755 support (see urxvt(1), or 2952Enable extended ISO 14755 support (see rxvt(1), or
2839<em>doc/rxvt.1.txt</em>). Basic support (section 5.1) is enabled by 2953<em>doc/rxvt.1.txt</em>). Basic support (section 5.1) is enabled by
2840<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with 2954<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with
2841this switch. 2955this switch.
2842</dd> 2956</dd>
2843<p></p> 2957<p></p>
… …
2890<p></p> 3004<p></p>
2891<dt><strong><a name="item_resize">--enable-smart-resize (default: on)</a></strong><br /> 3005<dt><strong><a name="item_resize">--enable-smart-resize (default: on)</a></strong><br />
2892</dt> 3006</dt>
2893<dd> 3007<dd>
2894Add smart growth/shrink behaviour when changing font size via hot 3008Add smart growth/shrink behaviour when changing font size via hot
2895keys. This should keep in a fixed position the urxvt corner which is 3009keys. This should keep the window corner which is closest to a corner of
2896closest to a corner of the screen. 3010the screen in a fixed position.
2897</dd> 3011</dd>
2898<p></p> 3012<p></p>
2899<dt><strong><a name="item_blank">--enable-pointer-blank (default: on)</a></strong><br /> 3013<dt><strong><a name="item_blank">--enable-pointer-blank (default: on)</a></strong><br />
2900</dt> 3014</dt>
2901<dd> 3015<dd>
2902Add support to have the pointer disappear when typing or inactive. 3016Add support to have the pointer disappear when typing or inactive.
3017</dd>
3018<p></p>
3019<dt><strong><a name="item_perl">--enable-perl (default: off)</a></strong><br />
3020</dt>
3021<dd>
3022Enable an embedded perl interpreter. See the <strong>rxvtperl(3)</strong> manpage
3023(<em>doc/rxvtperl.txt</em>) for more info on this feature, or the files in
3024<em>src/perl-ext/</em> for the extensions that are installed by default.
2903</dd> 3025</dd>
2904<p></p> 3026<p></p>
2905<dt><strong>--with-name=NAME (default: urxvt)</strong><br /> 3027<dt><strong>--with-name=NAME (default: urxvt)</strong><br />
2906</dt> 3028</dt>
2907<dd> 3029<dd>

Diff Legend

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