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.42 by root, Thu Jan 12 23:11:23 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_the_new_selection_selects_pieces_that_are_too_big_">The new selection selects pieces that are too big/too small, can I
79change this?</a></strong><br />
80</dt>
81<dd>
82Yes. For example, if you want to select smaller pieces (``words'') you can
83use the following resource:
84</dd>
85<dd>
86<pre>
87 URxvt.selection.pattern-0: ([[:word:]]+)</pre>
88</dd>
89<dd>
90<p>If you click more than twice, the selection will be extended
91more and more.</p>
92</dd>
93<dd>
94<p>To get a selection that is very similar to the old code, try this pattern:</p>
95</dd>
96<dd>
97<pre>
98 URxvt.selection.pattern-0: ([^&quot;&amp;'()*,;&lt;=&gt;?@[\\\\]^`{|})]+)</pre>
99</dd>
100<p></p>
101<dt><strong><a name="item_i_don_27t_like_the_new_selection_2fpopups_2fhotkey">I don't like the new selection/popups/hotkeys/perl, how do I
102change/disable it?</a></strong><br />
103</dt>
104<dd>
105You can disable the perl extension completely by setting the
106<strong>perl-ext-common</strong> resource to the empty string, which also keeps
107rxvt-unicode from initialising perl, saving memory.
108</dd>
109<dd>
110<p>If you only want to disable specific features, you first have to
111identify which perl extension is responsible. For this, read the section
112<strong>PREPACKAGED EXTENSIONS</strong> in the <code>rxvtperl(3)</code> manpage. For
113example, to disable the <strong>selection-popup</strong> and <strong>option-popup</strong>, specify
114this <strong>perl-ext-common</strong> resource:</p>
115</dd>
116<dd>
117<pre>
118 URxvt.perl-ext-common: default,-selection-popup,-option-popup</pre>
119</dd>
120<dd>
121<p>This will keep the default extensions, but disable the two popup
122extensions. Some extensions can also be configured, for example,
123scrollback search mode is triggered by <strong>M-s</strong>. You can move it to any
124other combination either by setting the <strong>searchable-scrollback</strong> resource:</p>
125</dd>
126<dd>
127<pre>
128 URxvt.searchable-scrollback: CM-s</pre>
129</dd>
130<p></p>
131<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 />
132</dt>
133<dd>
134I often get asked about this, and I think, no, they didn't cause extra
135bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
136that the urxvt binary is larger (due to some encoding tables always being
137compiled in), but it actually uses less memory (RSS) after startup. Even
138with <code>--disable-everything</code>, this comparison is a bit unfair, as many
139features unique to urxvt (locale, encoding conversion, iso14755 etc.) are
140already in use in this mode.
141</dd>
142<dd>
143<pre>
144 text data bss drs rss filename
145 98398 1664 24 15695 1824 rxvt --disable-everything
146 188985 9048 66616 18222 1788 urxvt --disable-everything</pre>
147</dd>
148<dd>
149<p>When you <a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> (which _is_ unfair, as this involves xft
150and full locale/XIM support which are quite bloaty inside libX11 and my
151libc), the two diverge, but not unreasnobaly so.</p>
152</dd>
153<dd>
154<pre>
155 text data bss drs rss filename
156 163431 2152 24 20123 2060 rxvt --enable-everything
157 1035683 49680 66648 29096 3680 urxvt --enable-everything</pre>
158</dd>
159<dd>
160<p>The very large size of the text section is explained by the east-asian
161encoding tables, which, if unused, take up disk space but nothing else
162and can be compiled out unless you rely on X11 core fonts that use those
163encodings. The BSS size comes from the 64k emergency buffer that my c++
164compiler allocates (but of course doesn't use unless you are out of
165memory). Also, using an xft font instead of a core font immediately adds a
166few megabytes of RSS. Xft indeed is responsible for a lot of RSS even when
167not used.</p>
168</dd>
169<dd>
170<p>Of course, due to every character using two or four bytes instead of one,
171a large scrollback buffer will ultimately make rxvt-unicode use more
172memory.</p>
173</dd>
174<dd>
175<p>Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this
176still fares rather well. And compared to some monsters like gnome-terminal
177(21152k + extra 4204k in separate processes) or konsole (22200k + extra
17843180k in daemons that stay around after exit, plus half a minute of
179startup time, including the hundreds of warnings it spits out), it fares
180extremely well *g*.</p>
181</dd>
182<p></p>
183<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 />
184</dt>
185<dd>
186Is this a question? :) It comes up very often. The simple answer is: I had
187to write it, and C++ allowed me to write and maintain it in a fraction
188of the time and effort (which is a scarce resource for me). Put even
189shorter: It simply wouldn't exist without C++.
190</dd>
191<dd>
192<p>My personal stance on this is that C++ is less portable than C, but in
193the case of rxvt-unicode this hardly matters, as its portability limits
194are defined by things like X11, pseudo terminals, locale support and unix
195domain sockets, which are all less portable than C++ itself.</p>
196</dd>
197<dd>
198<p>Regarding the bloat, see the above question: It's easy to write programs
199in C that use gobs of memory, an certainly possible to write programs in
200C++ that don't. C++ also often comes with large libraries, but this is
201not necessarily the case with GCC. Here is what rxvt links against on my
202system with a minimal config:</p>
203</dd>
204<dd>
205<pre>
206 libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
207 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaadde000)
208 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab01d000)
209 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)</pre>
210</dd>
211<dd>
212<p>And here is rxvt-unicode:</p>
213</dd>
214<dd>
215<pre>
216 libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
217 libgcc_s.so.1 =&gt; /lib/libgcc_s.so.1 (0x00002aaaaada2000)
218 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaaeb0000)
219 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab0ee000)
220 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)</pre>
221</dd>
222<dd>
223<p>No large bloated libraries (of course, none were linked in statically),
224except maybe libX11 :)</p>
225</dd>
226<p></p>
227<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 />
228</dt>
229<dd>
230rxvt-unicode does not directly support tabs. It will work fine with
231tabbing functionality of many window managers or similar tabbing programs,
232and its embedding-features allow it to be embedded into other programs,
233as witnessed by <em>doc/rxvt-tabbed</em> or the upcoming <code>Gtk2::URxvt</code> perl
234module, which features a tabbed urxvt (murxvt) terminal as an example
235embedding application.
236</dd>
237<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 /> 238<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> 239</dt>
80<dd> 240<dd>
81The version number is displayed with the usage (-h). Also the escape 241The 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. 242sequence <code>ESC [ 8 n</code> sets the window title to the version number. When
243using the rxvtc client, the version displayed is that of the
244daemon.
83</dd> 245</dd>
84<p></p> 246<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 /> 247<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> 248</dt>
87<dd> 249<dd>
99probably should use the Debian BTS, too, because, after all, it's also a 261probably should use the Debian BTS, too, because, after all, it's also a
100bug in the Debian version and it serves as a reminder for other users that 262bug in the Debian version and it serves as a reminder for other users that
101might encounter the same issue.</p> 263might encounter the same issue.</p>
102</dd> 264</dd>
103<p></p> 265<p></p>
266<dt><strong><a name="item_i_am_maintaining_rxvt_2dunicode_for_distribution_2">I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?</a></strong><br />
267</dt>
268<dd>
269You should build one binary with the default options. <em>configure</em>
270now enables most useful options, and the trend goes to making them
271runtime-switchable, too, so there is usually no drawback to enbaling them,
272except higher disk and possibly memory usage. The perl interpreter should
273be enabled, as important functionality (menus, selection, likely more in
274the future) depends on it.
275</dd>
276<dd>
277<p>You should not overwrite the <code>perl-ext-common</code> snd <code>perl-ext</code> resources
278system-wide (except maybe with <code>defaults</code>). This will result in useful
279behaviour. If your distribution aims at low memory, add an empty
280<code>perl-ext-common</code> resource to the app-defaults file. This will keep the
281perl interpreter disabled until the user enables it.</p>
282</dd>
283<dd>
284<p>If you can/want build more binaries, I recommend building a minimal
285one with <code>--disable-everything</code> (very useful) and a maximal one with
286<a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> (less useful, it will be very big due to a lot of
287encodings built-in that increase download times and are rarely used).</p>
288</dd>
289<p></p>
290<dt><strong><a name="item_i_need_to_make_it_setuid_2fsetgid_to_support_utmp_">I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?</a></strong><br />
291</dt>
292<dd>
293Likely not. While I honestly try to make it secure, and am probably not
294bad at it, I think it is simply unreasonable to expect all of freetype
295+ fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be
296secure. Also, rxvt-unicode disables some options when it detects that it
297runs setuid or setgid, which is not nice. Besides, with the embedded perl
298interpreter the possibility for security problems easily multiplies.
299</dd>
300<dd>
301<p>Elevated privileges are only required for utmp and pty operations on some
302systems (for example, GNU/Linux doesn't need any extra privileges for
303ptys, but some need it for utmp support). It is planned to mvoe this into
304a forked handler process, but this is not yet done.</p>
305</dd>
306<dd>
307<p>So, while setuid/setgid operation is supported and not a problem on your
308typical single-user-no-other-logins unix desktop, always remember that
309its an awful lot of code, most of which isn't checked for security issues
310regularly.</p>
311</dd>
312<p></p>
104<dt><strong><a name="item_when_i_log_2din_to_another_system_it_tells_me_abou">When I log-in to another system it tells me about missing terminfo data?</a></strong><br /> 313<dt><strong><a name="item_when_i_log_2din_to_another_system_it_tells_me_abou">When I log-in to another system it tells me about missing terminfo data?</a></strong><br />
105</dt> 314</dt>
106<dd> 315<dd>
107The terminal description used by rxvt-unicode is not as widely available 316The terminal description used by rxvt-unicode is not as widely available
108as that for xterm, or even rxvt (for which the same problem often arises). 317as that for xterm, or even rxvt (for which the same problem often arises).
145<dd> 354<dd>
146Most likely it's the empty definition for <code>enacs=</code>. Just replace it by 355Most likely it's the empty definition for <code>enacs=</code>. Just replace it by
147<code>enacs=\E[0@</code> and try again. 356<code>enacs=\E[0@</code> and try again.
148</dd> 357</dd>
149<p></p> 358<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 /> 359<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> 360</dt>
152<dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br /> 361<dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br />
153</dt> 362</dt>
154<dd> 363<dd>
155One reason you might want this is that some distributions or operating 364One 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, 518<p>In that case, select a font of your taste and add it to the font list,
310e.g.:</p> 519e.g.:</p>
311</dd> 520</dd>
312<dd> 521<dd>
313<pre> 522<pre>
314 urxvt -fn basefont,font2,font3...</pre> 523 rxvt -fn basefont,font2,font3...</pre>
315</dd> 524</dd>
316<dd> 525<dd>
317<p>When rxvt-unicode sees a character, it will first look at the base 526<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 527font. 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 528next font, and so on. Specifying your own fonts will also speed up this
693<dd> 902<dd>
694Make sure that mouse reporting is actually turned off since killing 903Make sure that mouse reporting is actually turned off since killing
695some editors prematurely may leave the mouse in mouse report mode. I've 904some editors prematurely may leave the mouse in mouse report mode. I've
696heard that tcsh may use mouse reporting unless it otherwise specified. A 905heard 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 906quick check is to see if cut/paste works when the Alt or Shift keys are
698depressed. See <code>urxvt(7)</code> 907depressed. See <code>rxvt(7)</code>
699</dd> 908</dd>
700<p></p> 909<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 /> 910<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> 911</dt>
703<dd> 912<dd>
777 URxvt.color14: #73f7ff 986 URxvt.color14: #73f7ff
778 URxvt.color7: #e1dddd 987 URxvt.color7: #e1dddd
779 URxvt.color15: #e1dddd</pre> 988 URxvt.color15: #e1dddd</pre>
780</dd> 989</dd>
781<p></p> 990<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 /> 991<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> 992</dt>
784<dd> 993<dd>
785Try <code>urxvtd -f -o</code>, which tells urxvtd to open the 994Try <code>rxvtd -f -o</code>, which tells rxvtd to open the
786display, create the listening socket and then fork. 995display, create the listening socket and then fork.
787</dd> 996</dd>
788<p></p> 997<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 /> 998<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> 999</dt>
811</dd> 1020</dd>
812<dd> 1021<dd>
813<pre> 1022<pre>
814 # use Backspace = ^H 1023 # use Backspace = ^H
815 $ stty erase ^H 1024 $ stty erase ^H
816 $ urxvt</pre> 1025 $ rxvt</pre>
817</dd> 1026</dd>
818<dd> 1027<dd>
819<pre> 1028<pre>
820 # use Backspace = ^? 1029 # use Backspace = ^?
821 $ stty erase ^? 1030 $ stty erase ^?
822 $ urxvt</pre> 1031 $ rxvt</pre>
823</dd>
824<dd> 1032</dd>
1033<dd>
825<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code> as documented in urxvt(7).</p> 1034<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code> as documented in rxvt(7).</p>
826</dd> 1035</dd>
827<dd> 1036<dd>
828<p>For an existing rxvt-unicode:</p> 1037<p>For an existing rxvt-unicode:</p>
829</dd> 1038</dd>
830<dd> 1039<dd>
868There are some compile-time selections available via configure. Unless 1077There 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 1078you 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. 1079use the `keysym' resource to alter the keystrings associated with keysyms.
871</dd> 1080</dd>
872<dd> 1081<dd>
873<p>Here's an example for a URxvt session started using <code>urxvt -name URxvt</code></p> 1082<p>Here's an example for a URxvt session started using <code>rxvt -name URxvt</code></p>
874</dd> 1083</dd>
875<dd> 1084<dd>
876<pre> 1085<pre>
877 URxvt.keysym.Home: \033[1~ 1086 URxvt.keysym.Home: \033[1~
878 URxvt.keysym.End: \033[4~ 1087 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 /> 1913</table><dt><strong><a name="item_1011"><strong><code>Ps = 1011</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1705</dt> 1914</dt>
1706<table> 1915<table>
1707<tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr> 1916<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> 1917<tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr>
1918</table><dt><strong><a name="item_1021"><strong><code>Ps = 1021</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1919</dt>
1920<table>
1921<tr><td>h</td><td>Bold/italic implies high intensity (see option -is)</td></tr>
1922<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 /> 1923</table><dt><strong><a name="item_ps__3d_1047"><strong><code>Ps = 1047</code> </strong>&gt;</a></strong><br />
1710</dt> 1924</dt>
1711<table> 1925<table>
1712<tr><td>h</td><td>Use Alternate Screen Buffer</td></tr> 1926<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> 1927<tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr>
1745<tr><td>Ps = 10</td><td>Change colour of text foreground to Pt (NB: may change in future)</td></tr> 1959<tr><td>Ps = 10</td><td>Change colour of text foreground to Pt (NB: may change in future)</td></tr>
1746<tr><td>Ps = 11</td><td>Change colour of text background to Pt (NB: may change in future)</td></tr> 1960<tr><td>Ps = 11</td><td>Change colour of text background to Pt (NB: may change in future)</td></tr>
1747<tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr> 1961<tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr>
1748<tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr> 1962<tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr>
1749<tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr> 1963<tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr>
1750<tr><td>Ps = 18</td><td>Change colour of bold characters to Pt</td></tr> 1964<tr><td>Ps = 18</td><td>Change colour of bold characters to Pt [deprecated, see 706]</td></tr>
1751<tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt</td></tr> 1965<tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt [deprecated, see 707]</td></tr>
1752<tr><td>Ps = 20</td><td>Change default background to Pt</td></tr> 1966<tr><td>Ps = 20</td><td>Change default background to Pt</td></tr>
1753<tr><td>Ps = 39</td><td>Change default foreground colour to Pt.</td></tr> 1967<tr><td>Ps = 39</td><td>Change default foreground colour to Pt.</td></tr>
1754<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr> 1968<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr>
1755<tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr> 1969<tr><td>Ps = 49</td><td>Change default background colour to Pt.</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> 1970<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>
1757<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr> 1971<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</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> 1972<tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).</td></tr>
1759<tr><td>Ps = 703</td><td>Menubar command Pt (Compile menubar).</td></tr> 1973<tr><td>Ps = 703</td><td>Menubar command Pt (Compile menubar).</td></tr>
1760<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr> 1974<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr>
1761<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr> 1975<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr>
1976<tr><td>Ps = 706</td><td>Change colour of bold characters to Pt</td></tr>
1977<tr><td>Ps = 707</td><td>Change colour of underlined characters to Pt</td></tr>
1762<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr> 1978<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr>
1763<tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr> 1979<tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1764<tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr> 1980<tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1765<tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr> 1981<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> 1982<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> 1983<tr><td>Ps = 721</td><td>Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).</td></tr>
1984<tr><td>Ps = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr>
1768</table><p></p></dl> 1985</table><p></p></dl>
1769<p></p> 1986<p></p>
1770<p> 1987<p>
1771</p> 1988</p>
1772<hr /> 1989<hr />
2682Write user and tty to lastlog file (used by programs like 2899Write user and tty to lastlog file (used by programs like
2683<em>lastlogin</em>) at start of rxvt execution. This option requires 2900<em>lastlogin</em>) at start of rxvt execution. This option requires
2684--enable-utmp to also be specified. 2901--enable-utmp to also be specified.
2685</dd> 2902</dd>
2686<p></p> 2903<p></p>
2687<dt><strong><a name="item_background">--enable-xpm-background (default: off)</a></strong><br /> 2904<dt><strong><a name="item_background">--enable-xpm-background (default: on)</a></strong><br />
2688</dt> 2905</dt>
2689<dd> 2906<dd>
2690Add support for XPM background pixmaps. 2907Add support for XPM background pixmaps.
2691</dd> 2908</dd>
2692<p></p> 2909<p></p>
2693<dt><strong><a name="item_transparency">--enable-transparency (default: off)</a></strong><br /> 2910<dt><strong><a name="item_transparency">--enable-transparency (default: on)</a></strong><br />
2694</dt> 2911</dt>
2695<dd> 2912<dd>
2696Add support for inheriting parent backgrounds thus giving a fake 2913Add support for inheriting parent backgrounds thus giving a fake
2697transparency to the term. 2914transparency to the term.
2698</dd> 2915</dd>
2707</dt> 2924</dt>
2708<dd> 2925<dd>
2709Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>). 2926Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>).
2710</dd> 2927</dd>
2711<p></p> 2928<p></p>
2712<dt><strong><a name="item_menubar">--enable-menubar (default: off)</a></strong><br /> 2929<dt><strong><a name="item_menubar">--enable-menubar (default: off) [DEPRECATED]</a></strong><br />
2713</dt> 2930</dt>
2714<dd> 2931<dd>
2715Add support for our menu bar system (this interacts badly with 2932Add support for our menu bar system (this interacts badly with dynamic
2716dynamic locale switching currently). 2933locale switching currently). This option is DEPRECATED and will be removed
2934in the future.
2717</dd> 2935</dd>
2718<p></p> 2936<p></p>
2719<dt><strong><a name="item_scroll">--enable-rxvt-scroll (default: on)</a></strong><br /> 2937<dt><strong><a name="item_scroll">--enable-rxvt-scroll (default: on)</a></strong><br />
2720</dt> 2938</dt>
2721<dd> 2939<dd>
2771<p></p> 2989<p></p>
2772<dt><strong><a name="item__2d_2ddisable_2dresources">--disable-resources</a></strong><br /> 2990<dt><strong><a name="item__2d_2ddisable_2dresources">--disable-resources</a></strong><br />
2773</dt> 2991</dt>
2774<dd> 2992<dd>
2775Removes any support for resource checking. 2993Removes any support for resource checking.
2776</dd>
2777<p></p>
2778<dt><strong><a name="item__2d_2denable_2dxgetdefault">--enable-xgetdefault</a></strong><br />
2779</dt>
2780<dd>
2781Make resources checking via <code>XGetDefault()</code> instead of our small
2782version which only checks ~/.Xdefaults, or if that doesn't exist then
2783~/.Xresources.
2784</dd>
2785<dd>
2786<p>Please note that nowadays, things like XIM will automatically pull in and
2787use the full X resource manager, so the overhead of using it might be very
2788small, if nonexistant.</p>
2789</dd> 2994</dd>
2790<p></p> 2995<p></p>
2791<dt><strong><a name="item_strings">--enable-strings (default: off)</a></strong><br /> 2996<dt><strong><a name="item_strings">--enable-strings (default: off)</a></strong><br />
2792</dt> 2997</dt>
2793<dd> 2998<dd>
2817</dd> 3022</dd>
2818<dd> 3023<dd>
2819<pre> 3024<pre>
2820 MWM-hints 3025 MWM-hints
2821 EWMH-hints (pid, utf8 names) and protocols (ping) 3026 EWMH-hints (pid, utf8 names) and protocols (ping)
2822 seperate underline colour 3027 seperate underline colour (-underlineColor)
2823 settable border widths and borderless switch 3028 settable border widths and borderless switch (-w, -b, -bl)
2824 settable extra linespacing 3029 settable extra linespacing /-lsp)
2825 iso-14755-2 and -3, and visual feedback 3030 iso-14755-2 and -3, and visual feedback
2826 backindex and forwardindex escape sequence 3031 backindex and forwardindex escape sequence
2827 window op and some xterm/OSC escape sequences 3032 window op and some xterm/OSC escape sequences
2828 tripleclickwords 3033 tripleclickwords (-tcw)
2829 settable insecure mode 3034 settable insecure mode (-insecure)
2830 keysym remapping support 3035 keysym remapping support
2831 cursor blinking and underline cursor 3036 cursor blinking and underline cursor (-cb, -uc)
2832 -embed and -pty-fd options</pre> 3037 XEmbed support (-embed)
3038 user-pty (-pty-fd)
3039 hold on exit (-hold)
3040 skip builtin block graphics (-sbg)
3041 sgr modes 90..97 and 100..107</pre>
2833</dd> 3042</dd>
2834<p></p> 3043<p></p>
2835<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br /> 3044<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br />
2836</dt> 3045</dt>
2837<dd> 3046<dd>
2838Enable extended ISO 14755 support (see urxvt(1), or 3047Enable extended ISO 14755 support (see rxvt(1), or
2839<em>doc/rxvt.1.txt</em>). Basic support (section 5.1) is enabled by 3048<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 3049<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with
2841this switch. 3050this switch.
2842</dd> 3051</dd>
2843<p></p> 3052<p></p>
2890<p></p> 3099<p></p>
2891<dt><strong><a name="item_resize">--enable-smart-resize (default: on)</a></strong><br /> 3100<dt><strong><a name="item_resize">--enable-smart-resize (default: on)</a></strong><br />
2892</dt> 3101</dt>
2893<dd> 3102<dd>
2894Add smart growth/shrink behaviour when changing font size via hot 3103Add smart growth/shrink behaviour when changing font size via hot
2895keys. This should keep in a fixed position the urxvt corner which is 3104keys. This should keep the window corner which is closest to a corner of
2896closest to a corner of the screen. 3105the screen in a fixed position.
2897</dd> 3106</dd>
2898<p></p> 3107<p></p>
2899<dt><strong><a name="item_blank">--enable-pointer-blank (default: on)</a></strong><br /> 3108<dt><strong><a name="item_blank">--enable-pointer-blank (default: on)</a></strong><br />
2900</dt> 3109</dt>
2901<dd> 3110<dd>
2902Add support to have the pointer disappear when typing or inactive. 3111Add support to have the pointer disappear when typing or inactive.
3112</dd>
3113<p></p>
3114<dt><strong><a name="item_perl">--enable-perl (default: off)</a></strong><br />
3115</dt>
3116<dd>
3117Enable an embedded perl interpreter. See the <strong>rxvtperl(3)</strong>
3118manpage (<em>doc/rxvtperl.txt</em>) for more info on this feature, or the files
3119in <em>src/perl-ext/</em> for the extensions that are installed by default. The
3120perl interpreter that is used can be specified via the <code>PERL</code> environment
3121variable when running configure.
2903</dd> 3122</dd>
2904<p></p> 3123<p></p>
2905<dt><strong>--with-name=NAME (default: urxvt)</strong><br /> 3124<dt><strong>--with-name=NAME (default: urxvt)</strong><br />
2906</dt> 3125</dt>
2907<dd> 3126<dd>

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines