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.52 by root, Sat Jan 28 22:16:58 2006 UTC vs.
Revision 1.81 by root, Sun Jun 24 22:12:18 2007 UTC

1<?xml version="1.0" encoding="UTF-8"?>
1<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
2<html xmlns="http://www.w3.org/1999/xhtml"> 3<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
3<head> 4<head>
4<title>REFERENCE - FAQ, command sequences and other background information</title> 5 <title>RXVT REFERENCE</title>
5<link rev="made" href="mailto:perl-binary@plan9.de" /> 6 <meta name="description" content="Pod documentation for RXVT REFERENCE" />
6</head> 7 <meta name="inputfile" content="&lt;standard input&gt;" />
7 8 <meta name="outputfile" content="&lt;standard output&gt;" />
8<body style="background-color: white"> 9 <meta name="created" content="Mon Jun 25 00:11:17 2007" />
9 10 <meta name="generator" content="Pod::Xhtml 1.57" />
10<p><a name="__index__"></a></p> 11<link rel="stylesheet" href="http://res.tst.eu/pod.css"/></head>
12<body>
13<div class="pod">
11<!-- INDEX BEGIN --> 14<!-- INDEX START -->
15<h3 id="TOP">Index</h3>
12 16
13<ul>
14
15 <li><a href="#name">NAME</a></li> 17<ul><li><a href="#NAME">NAME</a></li>
16 <li><a href="#synopsis">SYNOPSIS</a></li> 18<li><a href="#SYNOPSIS">SYNOPSIS</a></li>
17 <li><a href="#description">DESCRIPTION</a></li> 19<li><a href="#DESCRIPTION">DESCRIPTION</a></li>
18 <li><a href="#frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></li> 20<li><a href="#RXVT_UNICODE_URXVT_FREQUENTLY_ASKED_">RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS</a>
19 <li><a href="#rxvt_technical_reference">RXVT TECHNICAL REFERENCE</a></li> 21<ul><li><a href="#Meta_Features_amp_Commandline_Issues">Meta, Features &amp; Commandline Issues</a>
20 <li><a href="#description">DESCRIPTION</a></li> 22<ul><li><a href="#My_question_isn_t_answered_here_can_">My question isn't answered here, can I ask a human?</a></li>
21 <li><a href="#definitions">Definitions</a></li> 23<li><a href="#Does_it_support_tabs_can_I_have_a_ta">Does it support tabs, can I have a tabbed rxvt-unicode?</a></li>
22 <li><a href="#values">Values</a></li> 24<li><a href="#How_do_I_know_which_rxvt_unicode_ver">How do I know which rxvt-unicode version I'm using?</a></li>
23 <li><a href="#escape_sequences">Escape Sequences</a></li> 25<li><a href="#Rxvt_unicode_uses_gobs_of_memory_how">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></li>
24 <li><a href="#csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></li> 26<li><a href="#How_can_I_start_urxvtd_in_a_race_fre">How can I start urxvtd in a race-free way?</a></li>
25 <li><a href="#dec_private_modes">DEC Private Modes</a></li> 27<li><a href="#How_can_I_start_urxvtd_automatically">How can I start urxvtd automatically when I run urxvtc?</a></li>
26 <li><a href="#xterm_operating_system_commands">XTerm Operating System Commands</a></li> 28<li><a href="#How_do_I_distinguish_whether_I_m_run">How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</a></li>
27 <li><a href="#xpm">XPM</a></li> 29<li><a href="#How_do_I_set_the_correct_full_IP_add">How do I set the correct, full IP address for the DISPLAY variable?</a></li>
28 <li><a href="#mouse_reporting">Mouse Reporting</a></li> 30<li><a href="#How_do_I_compile_the_manual_pages_on">How do I compile the manual pages on my own?</a></li>
29 <li><a href="#key_codes">Key Codes</a></li> 31<li><a href="#Isn_t_rxvt_unicode_supposed_to_be_sm">Isn't rxvt-unicode supposed to be small? Don't all those features bloat?</a></li>
30 <li><a href="#configure_options">CONFIGURE OPTIONS</a></li> 32<li><a href="#Why_C_isn_t_that_unportable_bloated_">Why C++, isn't that unportable/bloated/uncool?</a></li>
31 <li><a href="#authors">AUTHORS</a></li>
32</ul> 33</ul>
34</li>
35<li><a href="#Rendering_Font_amp_Look_and_Feel_Iss">Rendering, Font &amp; Look and Feel Issues</a>
36<ul><li><a href="#I_can_t_get_transparency_working_wha">I can't get transparency working, what am I doing wrong?</a></li>
37<li><a href="#Why_does_rxvt_unicode_sometimes_leav">Why does rxvt-unicode sometimes leave pixel droppings?</a></li>
38<li><a href="#How_can_I_keep_rxvt_unicode_from_usi">How can I keep rxvt-unicode from using reverse video so much?</a></li>
39<li><a href="#Some_programs_assume_totally_weird_c">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></li>
40<li><a href="#Can_I_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></li>
41<li><a href="#Why_do_italic_characters_look_as_if_">Why do italic characters look as if clipped?</a></li>
42<li><a href="#Can_I_speed_up_Xft_rendering_somehow">Can I speed up Xft rendering somehow?</a></li>
43<li><a href="#Rxvt_unicode_doesn_t_seem_to_anti_al">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></li>
44<li><a href="#What_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</a></li>
45<li><a href="#I_don_t_like_the_screen_colors_How_d">I don't like the screen colors. How do I change them?</a></li>
46<li><a href="#Why_do_some_characters_look_so_much_">Why do some characters look so much different than others?</a></li>
47<li><a href="#How_does_rxvt_unicode_choose_fonts">How does rxvt-unicode choose fonts?</a></li>
48<li><a href="#Why_do_some_chinese_characters_look_">Why do some chinese characters look so different than others?</a></li>
49</ul>
50</li>
51<li><a href="#Keyboard_Mouse_amp_User_Interaction">Keyboard, Mouse &amp; User Interaction</a>
52<ul><li><a href="#The_new_selection_selects_pieces_tha">The new selection selects pieces that are too big, how can I select single words?</a></li>
53<li><a href="#I_don_t_like_the_new_selection_popup">I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?</a></li>
54<li><a href="#The_cursor_moves_when_selecting_text">The cursor moves when selecting text in the current input line, how do I switch this off?</a></li>
55<li><a href="#During_rlogin_ssh_telnet_etc_session">During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?</a></li>
56<li><a href="#My_numerical_keypad_acts_weird_and_g">My numerical keypad acts weird and generates differing output?</a></li>
57<li><a href="#My_Compose_Multi_key_key_is_no_longe">My Compose (Multi_key) key is no longer working.</a></li>
58<li><a href="#I_cannot_type_code_Ctrl_Shift_2_code">I cannot type <code>Ctrl-Shift-2</code> to get an ASCII NUL character due to ISO 14755</a></li>
59<li><a href="#Mouse_cut_paste_suddenly_no_longer_w">Mouse cut/paste suddenly no longer works.</a></li>
60<li><a href="#What_s_with_the_strange_Backspace_De">What's with the strange Backspace/Delete key behaviour?</a></li>
61<li><a href="#I_don_t_like_the_key_bindings_How_do">I don't like the key-bindings. How do I change them?</a></li>
62<li><a href="#I_m_using_keyboard_model_XXX_that_ha">I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map</a></li>
63</ul>
64</li>
65<li><a href="#Terminal_Configuration">Terminal Configuration</a>
66<ul><li><a href="#Can_I_see_a_typical_configuration">Can I see a typical configuration?</a></li>
67<li><a href="#Why_doesn_t_rxvt_unicode_read_my_res">Why doesn't rxvt-unicode read my resources?</a></li>
68<li><a href="#When_I_log_in_to_another_system_it_t">When I log-in to another system it tells me about missing terminfo data?</a></li>
69<li><a href="#code_tic_code_outputs_some_error_whe"><code>tic</code> outputs some error when compiling the terminfo entry.</a></li>
70<li><a href="#code_bash_code_s_readline_does_not_w"><code>bash</code>'s readline does not work correctly under urxvt.</a></li>
71<li><a href="#I_need_a_termcap_file_entry">I need a termcap file entry.</a></li>
72<li><a href="#Why_does_code_ls_code_no_longer_have">Why does <code>ls</code> no longer have coloured output?</a></li>
73<li><a href="#Why_doesn_t_vim_emacs_etc_use_the_88">Why doesn't vim/emacs etc. use the 88 colour mode?</a></li>
74<li><a href="#Why_doesn_t_vim_emacs_etc_make_use_o">Why doesn't vim/emacs etc. make use of italic?</a></li>
75<li><a href="#Why_are_the_secondary_screen_related">Why are the secondary screen-related options not working properly?</a></li>
76</ul>
77</li>
78<li><a href="#Encoding_Locale_Input_Method_Issues">Encoding / Locale / Input Method Issues</a>
79<ul><li><a href="#Rxvt_unicode_does_not_seem_to_unders">Rxvt-unicode does not seem to understand the selected encoding?</a></li>
80<li><a href="#Unicode_does_not_seem_to_work">Unicode does not seem to work?</a></li>
81<li><a href="#How_does_rxvt_unicode_determine_the_">How does rxvt-unicode determine the encoding to use?</a></li>
82<li><a href="#Is_there_an_option_to_switch_encodin">Is there an option to switch encodings?</a></li>
83<li><a href="#Can_I_switch_locales_at_runtime">Can I switch locales at runtime?</a></li>
84<li><a href="#I_have_problems_getting_my_input_met">I have problems getting my input method working.</a></li>
85<li><a href="#My_input_method_wants_lt_some_encodi">My input method wants &lt;some encoding&gt; but I want UTF-8, what can I do?</a></li>
86<li><a href="#Rxvt_unicode_crashes_when_the_X_Inpu">Rxvt-unicode crashes when the X Input Method changes or exits.</a></li>
87</ul>
88</li>
89<li><a href="#Operating_Systems_Package_Maintainin">Operating Systems / Package Maintaining</a>
90<ul><li><a href="#I_am_using_Debian_GNU_Linux_and_have">I am using Debian GNU/Linux and have a problem...</a></li>
91<li><a href="#I_am_maintaining_rxvt_unicode_for_di">I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?</a></li>
92<li><a href="#I_need_to_make_it_setuid_setgid_to_s">I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?</a></li>
93<li><a href="#On_Solaris_9_many_line_drawing_chara">On Solaris 9, many line-drawing characters are too wide.</a></li>
94<li><a href="#I_am_on_FreeBSD_and_rxvt_unicode_doe">I am on FreeBSD and rxvt-unicode does not seem to work at all.</a></li>
95<li><a href="#I_use_Solaris_9_and_it_doesn_t_compi">I use Solaris 9 and it doesn't compile/work/etc.</a></li>
96<li><a href="#How_can_I_use_rxvt_unicode_under_cyg">How can I use rxvt-unicode under cygwin?</a></li>
97</ul>
98</li>
99</ul>
100</li>
101<li><a href="#RXVT_UNICODE_TECHNICAL_REFERENCE">RXVT-UNICODE TECHNICAL REFERENCE</a>
102<ul><li><a href="#Definitions">Definitions</a></li>
103<li><a href="#Values">Values</a></li>
104<li><a href="#Escape_Sequences">Escape Sequences</a></li>
105</ul>
106</li>
107<li><a href="#CSI">CSI</a>
108<ul><li><a href="#CSI_Command_Sequence_Introducer_Sequ">CSI (Command Sequence Introducer) Sequences</a></li>
109</ul>
110</li>
111<li><a href="#ESCOBPsA">ESCOBPsA</a></li>
112<li><a href="#ESCOBPsC">ESCOBPsC</a></li>
113<li><a href="#ESCOBPsG">ESCOBPsG</a></li>
114<li><a href="#PrivateModes">PrivateModes</a>
115<ul><li><a href="#DEC_Private_Modes">DEC Private Modes</a></li>
116</ul>
117</li>
118<li><a href="#Priv66">Priv66</a></li>
119<li><a href="#XTerm">XTerm</a>
120<ul><li><a href="#XTerm_Operating_System_Commands">XTerm Operating System Commands</a></li>
121</ul>
122</li>
123<li><a href="#XPM">XPM</a></li>
124<li><a href="#Mouse">Mouse</a></li>
125<li><a href="#Mouse_Reporting">Mouse Reporting</a></li>
126<li><a href="#KeyCodes">KeyCodes</a></li>
127<li><a href="#Key_Codes">Key Codes</a></li>
128<li><a href="#CONFIGURE_OPTIONS">CONFIGURE OPTIONS</a></li>
129<li><a href="#AUTHORS">AUTHORS</a>
130</li>
131</ul><hr />
33<!-- INDEX END --> 132<!-- INDEX END -->
34 133
35<hr /> 134<h1 id="NAME">NAME</h1><p><a href="#TOP" class="toplink">Top</a></p>
36<p> 135<div id="NAME_CONTENT">
37</p>
38<h1><a name="name">NAME</a></h1>
39<p>RXVT REFERENCE - FAQ, command sequences and other background information</p> 136<p>RXVT REFERENCE - FAQ, command sequences and other background information</p>
40<p> 137
41</p> 138</div>
42<hr /> 139<h1 id="SYNOPSIS">SYNOPSIS</h1><p><a href="#TOP" class="toplink">Top</a></p>
43<h1><a name="synopsis">SYNOPSIS</a></h1> 140<div id="SYNOPSIS_CONTENT">
44<pre>
45 # set a new font set 141<pre> # set a new font set
46 printf '\33]50;%s\007' 9x15,xft:Kochi&quot; Mincho&quot;</pre> 142 printf '\33]50;%s\007' 9x15,xft:Kochi&quot; Mincho&quot;
47<pre> 143
48 # change the locale and tell rxvt-unicode about it 144 # change the locale and tell rxvt-unicode about it
49 export LC_CTYPE=ja_JP.EUC-JP; printf &quot;\33]701;$LC_CTYPE\007&quot;</pre> 145 export LC_CTYPE=ja_JP.EUC-JP; printf &quot;\33]701;$LC_CTYPE\007&quot;
50<pre> 146
51 # set window title 147 # set window title
52 printf '\33]2;%s\007' &quot;new window title&quot;</pre> 148 printf '\33]2;%s\007' &quot;new window title&quot;
53<p> 149
54</p> 150</pre>
55<hr /> 151
56<h1><a name="description">DESCRIPTION</a></h1> 152</div>
153<h1 id="DESCRIPTION">DESCRIPTION</h1><p><a href="#TOP" class="toplink">Top</a></p>
154<div id="DESCRIPTION_CONTENT">
57<p>This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting 155<p>This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
58all escape sequences, and other background information.</p> 156all escape sequences, and other background information.</p>
59<p>The newest version of this document is 157<p>The newest version of this document is also available on the World Wide Web at
60also available on the World Wide Web at
61<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p> 158<a href="http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/rxvt-unicode/doc/rxvt.7.html</a>.</p>
62<p> 159
63</p> 160</div>
64<hr /> 161<h1 id="RXVT_UNICODE_URXVT_FREQUENTLY_ASKED_">RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS</h1><p><a href="#TOP" class="toplink">Top</a></p>
65<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> 162<div id="RXVT_UNICODE_URXVT_FREQUENTLY_ASKED_-2">
66<dl> 163
67<dt><strong><a name="item_the_new_selection_selects_pieces_that_are_too_big_">The new selection selects pieces that are too big, how can I select 164
68single words?</a></strong><br /> 165
69</dt> 166
70<dd> 167
71Yes. For example, if you want to select alphanumeric words, you can use 168</div>
72the following resource: 169<h2 id="Meta_Features_amp_Commandline_Issues">Meta, Features &amp; Commandline Issues</h2>
73</dd> 170<div id="Meta_Features_amp_Commandline_Issues-2">
74<dd> 171
172</div>
173<h3 id="My_question_isn_t_answered_here_can_">My question isn't answered here, can I ask a human?</h3>
174<div id="My_question_isn_t_answered_here_can_-2">
175<p>Before sending me mail, you could go to IRC: <code>irc.freenode.net</code>,
176channel <code>#rxvt-unicode</code> has some rxvt-unicode enthusiasts that might be
177interested in learning about new and exciting problems (but not FAQs :).</p>
178
179</div>
180<h3 id="Does_it_support_tabs_can_I_have_a_ta">Does it support tabs, can I have a tabbed rxvt-unicode?</h3>
181<div id="Does_it_support_tabs_can_I_have_a_ta-2">
182<p>Beginning with version 7.3, there is a perl extension that implements a
183simple tabbed terminal. It is installed by default, so any of these should
184give you tabs:</p>
185<pre> urxvt -pe tabbed
186
187 URxvt.perl-ext-common: default,tabbed
188
75<pre> 189</pre>
76 URxvt.selection.pattern-0: ([[:word:]]+)</pre> 190<p>It will also work fine with tabbing functionality of many window managers
77</dd> 191or similar tabbing programs, and its embedding-features allow it to be
78<dd> 192embedded into other programs, as witnessed by <cite>doc/rxvt-tabbed</cite> or
79<p>If you click more than twice, the selection will be extended 193the upcoming <code>Gtk2::URxvt</code> perl module, which features a tabbed urxvt
80more and more.</p> 194(murxvt) terminal as an example embedding application.</p>
81</dd> 195
82<dd> 196</div>
83<p>To get a selection that is very similar to the old code, try this pattern:</p> 197<h3 id="How_do_I_know_which_rxvt_unicode_ver">How do I know which rxvt-unicode version I'm using?</h3>
84</dd> 198<div id="How_do_I_know_which_rxvt_unicode_ver-2">
85<dd> 199<p>The version number is displayed with the usage (-h). Also the escape
200sequence <code>ESC [ 8 n</code> sets the window title to the version number. When
201using the urxvtc client, the version displayed is that of the
202daemon.</p>
203
204</div>
205<h3 id="Rxvt_unicode_uses_gobs_of_memory_how">Rxvt-unicode uses gobs of memory, how can I reduce that?</h3>
206<div id="Rxvt_unicode_uses_gobs_of_memory_how-2">
207<p>Rxvt-unicode tries to obey the rule of not charging you for something you
208don't use. One thing you should try is to configure out all settings that
209you don't need, for example, Xft support is a resource hog by design,
210when used. Compiling it out ensures that no Xft font will be loaded
211accidentally when rxvt-unicode tries to find a font for your characters.</p>
212<p>Also, many people (me included) like large windows and even larger
213scrollback buffers: Without <code>--enable-unicode3</code>, rxvt-unicode will use
2146 bytes per screen cell. For a 160x?? window this amounts to almost a
215kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
216use 10 Megabytes of memory. With <code>--enable-unicode3</code> it gets worse, as
217rxvt-unicode then uses 8 bytes per screen cell.</p>
218
219</div>
220<h3 id="How_can_I_start_urxvtd_in_a_race_fre">How can I start urxvtd in a race-free way?</h3>
221<div id="How_can_I_start_urxvtd_in_a_race_fre-2">
222<p>Try <code>urxvtd -f -o</code>, which tells urxvtd to open the
223display, create the listening socket and then fork.</p>
224
225</div>
226<h3 id="How_can_I_start_urxvtd_automatically">How can I start urxvtd automatically when I run urxvtc?</h3>
227<div id="How_can_I_start_urxvtd_automatically-2">
228<p>If you want to start urxvtd automatically whenever you run
229urxvtc and the daemon isn't running yet, use this script:</p>
230<pre> #!/bin/sh
231 urxvtc &quot;$@&quot;
232 if [ $? -eq 2 ]; then
233 urxvtd -q -o -f
234 urxvtc &quot;$@&quot;
235 fi
236
86<pre> 237</pre>
87 URxvt.selection.pattern-0: ([^&quot;&amp;'()*,;&lt;=&gt;?@[\\\\]^`{|})]+)</pre> 238<p>This tries to create a new terminal, and if fails with exit status 2,
88</dd> 239meaning it couldn't connect to the daemon, it will start the daemon and
89<dd> 240re-run the command. Subsequent invocations of the script will re-use the
90<p>Please also note that the <em>LeftClick Shift-LeftClik</em> combination also 241existing daemon.</p>
91selects words like the old code.</p> 242
92</dd> 243</div>
93<p></p> 244<h3 id="How_do_I_distinguish_whether_I_m_run">How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</h3>
94<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 245<div id="How_do_I_distinguish_whether_I_m_run-2">
95change/disable it?</a></strong><br /> 246<p>The original rxvt and rxvt-unicode always export the variable &quot;COLORTERM&quot;,
96</dt> 247so you can check and see if that is set. Note that several programs, JED,
97<dd> 248slrn, Midnight Commander automatically check this variable to decide
98You can disable the perl extension completely by setting the 249whether or not to use color.</p>
99<strong>perl-ext-common</strong> resource to the empty string, which also keeps 250
100rxvt-unicode from initialising perl, saving memory. 251</div>
101</dd> 252<h3 id="How_do_I_set_the_correct_full_IP_add">How do I set the correct, full IP address for the DISPLAY variable?</h3>
102<dd> 253<div id="How_do_I_set_the_correct_full_IP_add-2">
103<p>If you only want to disable specific features, you first have to 254<p>If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
104identify which perl extension is responsible. For this, read the section 255insecure mode then it is possible to use the following shell script
105<strong>PREPACKAGED EXTENSIONS</strong> in the <code>rxvtperl(3)</code> manpage. For 256snippets to correctly set the display. If your version of rxvt-unicode
106example, to disable the <strong>selection-popup</strong> and <strong>option-popup</strong>, specify 257wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then
107this <strong>perl-ext-common</strong> resource:</p> 258the COLORTERM variable can be used to distinguish rxvt-unicode from a
108</dd> 259regular xterm.</p>
109<dd> 260<p>Courtesy of Chuck Blake &lt;cblake@BBN.COM&gt; with the following shell script
261snippets:</p>
262<pre> # Bourne/Korn/POSIX family of shells:
263 [ ${TERM:-foo} = foo ] &amp;&amp; TERM=xterm # assume an xterm if we don't know
264 if [ ${TERM:-foo} = xterm ]; then
265 stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
266 echo -n '^[Z'
267 read term_id
268 stty icanon echo
269 if [ &quot;&quot;${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
270 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
271 read DISPLAY # set it in our local shell
272 fi
273 fi
274
110<pre> 275</pre>
111 URxvt.perl-ext-common: default,-selection-popup,-option-popup</pre> 276
112</dd> 277</div>
113<dd> 278<h3 id="How_do_I_compile_the_manual_pages_on">How do I compile the manual pages on my own?</h3>
114<p>This will keep the default extensions, but disable the two popup 279<div id="How_do_I_compile_the_manual_pages_on-2">
115extensions. Some extensions can also be configured, for example, 280<p>You need to have a recent version of perl installed as <cite>/usr/bin/perl</cite>,
116scrollback search mode is triggered by <strong>M-s</strong>. You can move it to any 281one that comes with <cite>pod2man</cite>, <cite>pod2text</cite> and <cite>pod2html</cite>. Then go to
117other combination either by setting the <strong>searchable-scrollback</strong> resource:</p> 282the doc subdirectory and enter <code>make alldoc</code>.</p>
118</dd> 283
119<dd> 284</div>
120<pre> 285<h3 id="Isn_t_rxvt_unicode_supposed_to_be_sm">Isn't rxvt-unicode supposed to be small? Don't all those features bloat?</h3>
121 URxvt.searchable-scrollback: CM-s</pre> 286<div id="Isn_t_rxvt_unicode_supposed_to_be_sm-2">
122</dd>
123<p></p>
124<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 />
125</dt>
126<dd>
127I often get asked about this, and I think, no, they didn't cause extra 287<p>I often get asked about this, and I think, no, they didn't cause extra
128bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 288bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
129that the urxvt binary is larger (due to some encoding tables always being 289that the urxvt binary is larger (due to some encoding tables always being
130compiled in), but it actually uses less memory (RSS) after startup. Even 290compiled in), but it actually uses less memory (RSS) after startup. Even
131with <code>--disable-everything</code>, this comparison is a bit unfair, as many 291with <code>--disable-everything</code>, this comparison is a bit unfair, as many
132features unique to urxvt (locale, encoding conversion, iso14755 etc.) are 292features unique to urxvt (locale, encoding conversion, iso14755 etc.) are
133already in use in this mode. 293already in use in this mode.</p>
134</dd>
135<dd>
136<pre>
137 text data bss drs rss filename 294<pre> text data bss drs rss filename
138 98398 1664 24 15695 1824 rxvt --disable-everything 295 98398 1664 24 15695 1824 rxvt --disable-everything
139 188985 9048 66616 18222 1788 urxvt --disable-everything</pre> 296 188985 9048 66616 18222 1788 urxvt --disable-everything
140</dd> 297
141<dd> 298</pre>
142<p>When you <a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> (which _is_ unfair, as this involves xft 299<p>When you <code>--enable-everything</code> (which <i>is</i> unfair, as this involves xft
143and full locale/XIM support which are quite bloaty inside libX11 and my 300and full locale/XIM support which are quite bloaty inside libX11 and my
144libc), the two diverge, but not unreasnobaly so.</p> 301libc), the two diverge, but not unreasonably so.</p>
145</dd>
146<dd>
147<pre>
148 text data bss drs rss filename 302<pre> text data bss drs rss filename
149 163431 2152 24 20123 2060 rxvt --enable-everything 303 163431 2152 24 20123 2060 rxvt --enable-everything
150 1035683 49680 66648 29096 3680 urxvt --enable-everything</pre> 304 1035683 49680 66648 29096 3680 urxvt --enable-everything
151</dd> 305
152<dd> 306</pre>
153<p>The very large size of the text section is explained by the east-asian 307<p>The very large size of the text section is explained by the east-asian
154encoding tables, which, if unused, take up disk space but nothing else 308encoding tables, which, if unused, take up disk space but nothing else
155and can be compiled out unless you rely on X11 core fonts that use those 309and can be compiled out unless you rely on X11 core fonts that use those
156encodings. The BSS size comes from the 64k emergency buffer that my c++ 310encodings. The BSS size comes from the 64k emergency buffer that my c++
157compiler allocates (but of course doesn't use unless you are out of 311compiler allocates (but of course doesn't use unless you are out of
158memory). Also, using an xft font instead of a core font immediately adds a 312memory). Also, using an xft font instead of a core font immediately adds a
159few megabytes of RSS. Xft indeed is responsible for a lot of RSS even when 313few megabytes of RSS. Xft indeed is responsible for a lot of RSS even when
160not used.</p> 314not used.</p>
161</dd>
162<dd>
163<p>Of course, due to every character using two or four bytes instead of one, 315<p>Of course, due to every character using two or four bytes instead of one,
164a large scrollback buffer will ultimately make rxvt-unicode use more 316a large scrollback buffer will ultimately make rxvt-unicode use more
165memory.</p> 317memory.</p>
166</dd>
167<dd>
168<p>Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this 318<p>Compared to e.g. Eterm (5112k), aterm (3132k) and xterm (4680k), this
169still fares rather well. And compared to some monsters like gnome-terminal 319still fares rather well. And compared to some monsters like gnome-terminal
170(21152k + extra 4204k in separate processes) or konsole (22200k + extra 320(21152k + extra 4204k in separate processes) or konsole (22200k + extra
17143180k in daemons that stay around after exit, plus half a minute of 32143180k in daemons that stay around after exit, plus half a minute of
172startup time, including the hundreds of warnings it spits out), it fares 322startup time, including the hundreds of warnings it spits out), it fares
173extremely well *g*.</p> 323extremely well *g*.</p>
174</dd> 324
175<p></p> 325</div>
176<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 /> 326<h3 id="Why_C_isn_t_that_unportable_bloated_">Why C++, isn't that unportable/bloated/uncool?</h3>
177</dt> 327<div id="Why_C_isn_t_that_unportable_bloated_-2">
178<dd>
179Is this a question? :) It comes up very often. The simple answer is: I had 328<p>Is this a question? :) It comes up very often. The simple answer is: I had
180to write it, and C++ allowed me to write and maintain it in a fraction 329to write it, and C++ allowed me to write and maintain it in a fraction
181of the time and effort (which is a scarce resource for me). Put even 330of the time and effort (which is a scarce resource for me). Put even
182shorter: It simply wouldn't exist without C++. 331shorter: It simply wouldn't exist without C++.</p>
183</dd>
184<dd>
185<p>My personal stance on this is that C++ is less portable than C, but in 332<p>My personal stance on this is that C++ is less portable than C, but in
186the case of rxvt-unicode this hardly matters, as its portability limits 333the case of rxvt-unicode this hardly matters, as its portability limits
187are defined by things like X11, pseudo terminals, locale support and unix 334are defined by things like X11, pseudo terminals, locale support and unix
188domain sockets, which are all less portable than C++ itself.</p> 335domain sockets, which are all less portable than C++ itself.</p>
189</dd>
190<dd>
191<p>Regarding the bloat, see the above question: It's easy to write programs 336<p>Regarding the bloat, see the above question: It's easy to write programs
192in C that use gobs of memory, an certainly possible to write programs in 337in C that use gobs of memory, an certainly possible to write programs in
193C++ that don't. C++ also often comes with large libraries, but this is 338C++ that don't. C++ also often comes with large libraries, but this is
194not necessarily the case with GCC. Here is what rxvt links against on my 339not necessarily the case with GCC. Here is what rxvt links against on my
195system with a minimal config:</p> 340system with a minimal config:</p>
196</dd>
197<dd>
198<pre>
199 libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 341<pre> libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
200 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaadde000) 342 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaadde000)
201 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab01d000) 343 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab01d000)
202 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)</pre> 344 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
203</dd> 345
204<dd> 346</pre>
205<p>And here is rxvt-unicode:</p> 347<p>And here is rxvt-unicode:</p>
206</dd>
207<dd>
208<pre>
209 libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000) 348<pre> libX11.so.6 =&gt; /usr/X11R6/lib/libX11.so.6 (0x00002aaaaabc3000)
210 libgcc_s.so.1 =&gt; /lib/libgcc_s.so.1 (0x00002aaaaada2000) 349 libgcc_s.so.1 =&gt; /lib/libgcc_s.so.1 (0x00002aaaaada2000)
211 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaaeb0000) 350 libc.so.6 =&gt; /lib/libc.so.6 (0x00002aaaaaeb0000)
212 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab0ee000) 351 libdl.so.2 =&gt; /lib/libdl.so.2 (0x00002aaaab0ee000)
213 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)</pre> 352 /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
214</dd> 353
215<dd> 354</pre>
216<p>No large bloated libraries (of course, none were linked in statically), 355<p>No large bloated libraries (of course, none were linked in statically),
217except maybe libX11 :)</p> 356except maybe libX11 :)</p>
218</dd> 357
219<p></p> 358
220<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 /> 359
221</dt> 360
222<dd> 361
223Beginning with version 7.3, there is a perl extension that implements a 362</div>
224simple tabbed terminal. It is installed by default, so any of these should 363<h2 id="Rendering_Font_amp_Look_and_Feel_Iss">Rendering, Font &amp; Look and Feel Issues</h2>
225give you tabs: 364<div id="Rendering_Font_amp_Look_and_Feel_Iss-2">
226</dd> 365
227<dd> 366</div>
367<h3 id="I_can_t_get_transparency_working_wha">I can't get transparency working, what am I doing wrong?</h3>
368<div id="I_can_t_get_transparency_working_wha-2">
369<p>First of all, transparency isn't officially supported in rxvt-unicode, so
370you are mostly on your own. Do not bug the author about it (but you may
371bug everybody else). Also, if you can't get it working consider it a rite
372of passage: ... and you failed.</p>
373<p>Here are four ways to get transparency. <strong>Do</strong> read the manpage and option
374descriptions for the programs mentioned and rxvt-unicode. Really, do it!</p>
375<p>1. Use inheritPixmap:</p>
376<pre> Esetroot wallpaper.jpg
377 urxvt -ip -tint red -sh 40
378
228<pre> 379</pre>
229 rxvt -pe tabbed</pre> 380<p>That works. If you think it doesn't, you lack transparency and tinting
230</dd> 381support, or you are unable to read.</p>
231<dd> 382<p>2. Use a simple pixmap and emulate pseudo-transparency. This enables you
383to use effects other than tinting and shading: Just shade/tint/whatever
384your picture with gimp or any other tool:</p>
385<pre> convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
386 urxvt -pixmap background.xpm -pe automove-background
387
232<pre> 388</pre>
389<p>That works. If you think it doesn't, you lack XPM and Perl support, or you
390are unable to read.</p>
391<p>3. Use an ARGB visual:</p>
392<pre> urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
393
394</pre>
395<p>This requires XFT support, and the support of your X-server. If that
396doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
397there yet, no matter what they claim. Rxvt-Unicode contains the necessary
398bugfixes and workarounds for Xft and Xlib to make it work, but that
399doesn't mean that your WM has the required kludges in place.</p>
400<p>4. Use xcompmgr and let it do the job:</p>
401<pre> xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \
402 -set _NET_WM_WINDOW_OPACITY 0xc0000000
403
404</pre>
405<p>Then click on a window you want to make transparent. Replace <code>0xc0000000</code>
406by other values to change the degree of opacity. If it doesn't work and
407your server crashes, you got to keep the pieces.</p>
408
409</div>
410<h3 id="Why_does_rxvt_unicode_sometimes_leav">Why does rxvt-unicode sometimes leave pixel droppings?</h3>
411<div id="Why_does_rxvt_unicode_sometimes_leav-2">
412<p>Most fonts were not designed for terminal use, which means that character
413size varies a lot. A font that is otherwise fine for terminal use might
414contain some characters that are simply too wide. Rxvt-unicode will avoid
415these characters. For characters that are just &quot;a bit&quot; too wide a special
416&quot;careful&quot; rendering mode is used that redraws adjacent characters.</p>
417<p>All of this requires that fonts do not lie about character sizes,
418however: Xft fonts often draw glyphs larger than their acclaimed bounding
419box, and rxvt-unicode has no way of detecting this (the correct way is to
420ask for the character bounding box, which unfortunately is wrong in these
421cases).</p>
422<p>It's not clear (to me at least), whether this is a bug in Xft, freetype,
423or the respective font. If you encounter this problem you might try using
424the <code>-lsp</code> option to give the font more height. If that doesn't work, you
425might be forced to use a different font.</p>
426<p>All of this is not a problem when using X11 core fonts, as their bounding
427box data is correct.</p>
428
429</div>
430<h3 id="How_can_I_keep_rxvt_unicode_from_usi">How can I keep rxvt-unicode from using reverse video so much?</h3>
431<div id="How_can_I_keep_rxvt_unicode_from_usi-2">
432<p>First of all, make sure you are running with the right terminal settings
433(<code>TERM=rxvt-unicode</code>), which will get rid of most of these effects. Then
434make sure you have specified colours for italic and bold, as otherwise
435rxvt-unicode might use reverse video to simulate the effect:</p>
436<pre> URxvt.colorBD: white
437 URxvt.colorIT: green
438
439</pre>
440
441</div>
442<h3 id="Some_programs_assume_totally_weird_c">Some programs assume totally weird colours (red instead of blue), how can I fix that?</h3>
443<div id="Some_programs_assume_totally_weird_c-2">
444<p>For some unexplainable reason, some rare programs assume a very weird
445colour palette when confronted with a terminal with more than the standard
4468 colours (rxvt-unicode supports 88). The right fix is, of course, to fix
447these programs not to assume non-ISO colours without very good reasons.</p>
448<p>In the meantime, you can either edit your <code>rxvt-unicode</code> terminfo
449definition to only claim 8 colour support or use <code>TERM=rxvt</code>, which will
450fix colours but keep you from using other rxvt-unicode features.</p>
451
452</div>
453<h3 id="Can_I_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</h3>
454<div id="Can_I_switch_the_fonts_at_runtime_CO">
455<p>Yes, using an escape sequence. Try something like this, which has the same
456effect as using the <code>-fn</code> switch, and takes effect immediately:</p>
457<pre> printf '\33]50;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;
458
459</pre>
460<p>This is useful if you e.g. work primarily with japanese (and prefer a
461japanese font), but you have to switch to chinese temporarily, where
462japanese fonts would only be in your way.</p>
463<p>You can think of this as a kind of manual ISO-2022 switching.</p>
464
465</div>
466<h3 id="Why_do_italic_characters_look_as_if_">Why do italic characters look as if clipped?</h3>
467<div id="Why_do_italic_characters_look_as_if_-2">
468<p>Many fonts have difficulties with italic characters and hinting. For
469example, the otherwise very nicely hinted font <code>xft:Bitstream Vera Sans
470Mono</code> completely fails in its italic face. A workaround might be to
471enable freetype autohinting, i.e. like this:</p>
472<pre> URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
473 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
474
475</pre>
476
477</div>
478<h3 id="Can_I_speed_up_Xft_rendering_somehow">Can I speed up Xft rendering somehow?</h3>
479<div id="Can_I_speed_up_Xft_rendering_somehow-2">
480<p>Yes, the most obvious way to speed it up is to avoid Xft entirely, as
481it is simply slow. If you still want Xft fonts you might try to disable
482antialiasing (by appending <code>:antialias=false</code>), which saves lots of
483memory and also speeds up rendering considerably.</p>
484
485</div>
486<h3 id="Rxvt_unicode_doesn_t_seem_to_anti_al">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</h3>
487<div id="Rxvt_unicode_doesn_t_seem_to_anti_al-2">
488<p>Rxvt-unicode will use whatever you specify as a font. If it needs to
489fall back to its default font search list it will prefer X11 core
490fonts, because they are small and fast, and then use Xft fonts. It has
491antialiasing disabled for most of them, because the author thinks they
492look best that way.</p>
493<p>If you want antialiasing, you have to specify the fonts manually.</p>
494
495</div>
496<h3 id="What_s_with_this_bold_blink_stuff">What's with this bold/blink stuff?</h3>
497<div id="What_s_with_this_bold_blink_stuff_CO">
498<p>If no bold colour is set via <code>colorBD:</code>, bold will invert text using the
499standard foreground colour.</p>
500<p>For the standard background colour, blinking will actually make the
501text blink when compiled with <code>--enable-blinking</code>. with standard
502colours. Without <code>--enable-blinking</code>, the blink attribute will be
503ignored.</p>
504<p>On ANSI colours, bold/blink attributes are used to set high-intensity
505foreground/background colors.</p>
506<p>color0-7 are the low-intensity colors.</p>
507<p>color8-15 are the corresponding high-intensity colors.</p>
508
509</div>
510<h3 id="I_don_t_like_the_screen_colors_How_d">I don't like the screen colors. How do I change them?</h3>
511<div id="I_don_t_like_the_screen_colors_How_d-2">
512<p>You can change the screen colors at run-time using <cite>~/.Xdefaults</cite>
513resources (or as long-options).</p>
514<p>Here are values that are supposed to resemble a VGA screen,
515including the murky brown that passes for low-intensity yellow:</p>
516<pre> URxvt.color0: #000000
517 URxvt.color1: #A80000
518 URxvt.color2: #00A800
519 URxvt.color3: #A8A800
520 URxvt.color4: #0000A8
521 URxvt.color5: #A800A8
522 URxvt.color6: #00A8A8
523 URxvt.color7: #A8A8A8
524
525 URxvt.color8: #000054
526 URxvt.color9: #FF0054
527 URxvt.color10: #00FF54
528 URxvt.color11: #FFFF54
529 URxvt.color12: #0000FF
530 URxvt.color13: #FF00FF
531 URxvt.color14: #00FFFF
532 URxvt.color15: #FFFFFF
533
534</pre>
535<p>And here is a more complete set of non-standard colors.</p>
536<pre> URxvt.cursorColor: #dc74d1
537 URxvt.pointerColor: #dc74d1
538 URxvt.background: #0e0e0e
539 URxvt.foreground: #4ad5e1
540 URxvt.color0: #000000
541 URxvt.color8: #8b8f93
542 URxvt.color1: #dc74d1
543 URxvt.color9: #dc74d1
544 URxvt.color2: #0eb8c7
545 URxvt.color10: #0eb8c7
546 URxvt.color3: #dfe37e
547 URxvt.color11: #dfe37e
548 URxvt.color5: #9e88f0
549 URxvt.color13: #9e88f0
550 URxvt.color6: #73f7ff
551 URxvt.color14: #73f7ff
552 URxvt.color7: #e1dddd
553 URxvt.color15: #e1dddd
554
555</pre>
556<p>They have been described (not by me) as &quot;pretty girly&quot;.</p>
557
558</div>
559<h3 id="Why_do_some_characters_look_so_much_">Why do some characters look so much different than others?</h3>
560<div id="Why_do_some_characters_look_so_much_-2">
561<p>See next entry.</p>
562
563</div>
564<h3 id="How_does_rxvt_unicode_choose_fonts">How does rxvt-unicode choose fonts?</h3>
565<div id="How_does_rxvt_unicode_choose_fonts_C">
566<p>Most fonts do not contain the full range of Unicode, which is
567fine. Chances are that the font you (or the admin/package maintainer of
568your system/os) have specified does not cover all the characters you want
569to display.</p>
570<p><strong>rxvt-unicode</strong> makes a best-effort try at finding a replacement
571font. Often the result is fine, but sometimes the chosen font looks
572bad/ugly/wrong. Some fonts have totally strange characters that don't
573resemble the correct glyph at all, and rxvt-unicode lacks the artificial
574intelligence to detect that a specific glyph is wrong: it has to believe
575the font that the characters it claims to contain indeed look correct.</p>
576<p>In that case, select a font of your taste and add it to the font list,
577e.g.:</p>
578<pre> urxvt -fn basefont,font2,font3...
579
580</pre>
581<p>When rxvt-unicode sees a character, it will first look at the base
582font. If the base font does not contain the character, it will go to the
583next font, and so on. Specifying your own fonts will also speed up this
584search and use less resources within rxvt-unicode and the X-server.</p>
585<p>The only limitation is that none of the fonts may be larger than the base
586font, as the base font defines the terminal character cell size, which
587must be the same due to the way terminals work.</p>
588
589</div>
590<h3 id="Why_do_some_chinese_characters_look_">Why do some chinese characters look so different than others?</h3>
591<div id="Why_do_some_chinese_characters_look_-2">
592<p>This is because there is a difference between script and language --
593rxvt-unicode does not know which language the text that is output is,
594as it only knows the unicode character codes. If rxvt-unicode first
595sees a japanese/chinese character, it might choose a japanese font for
596display. Subsequent japanese characters will use that font. Now, many
597chinese characters aren't represented in japanese fonts, so when the first
598non-japanese character comes up, rxvt-unicode will look for a chinese font
599-- unfortunately at this point, it will still use the japanese font for
600chinese characters that are also in the japanese font.</p>
601<p>The workaround is easy: just tag a chinese font at the end of your font
602list (see the previous question). The key is to view the font list as
603a preference list: If you expect more japanese, list a japanese font
604first. If you expect more chinese, put a chinese font first.</p>
605<p>In the future it might be possible to switch language preferences at
606runtime (the internal data structure has no problem with using different
607fonts for the same character at the same time, but no interface for this
608has been designed yet).</p>
609<p>Until then, you might get away with switching fonts at runtime (see <a href="#Can_I_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a> later in this document).</p>
610
611</div>
612<h2 id="Keyboard_Mouse_amp_User_Interaction">Keyboard, Mouse &amp; User Interaction</h2>
613<div id="Keyboard_Mouse_amp_User_Interaction_">
614
615</div>
616<h3 id="The_new_selection_selects_pieces_tha">The new selection selects pieces that are too big, how can I select single words?</h3>
617<div id="The_new_selection_selects_pieces_tha-2">
618<p>If you want to select e.g. alphanumeric words, you can use the following
619setting:</p>
620<pre> URxvt.selection.pattern-0: ([[:word:]]+)
621
622</pre>
623<p>If you click more than twice, the selection will be extended
624more and more.</p>
625<p>To get a selection that is very similar to the old code, try this pattern:</p>
626<pre> URxvt.selection.pattern-0: ([^&quot;&amp;'()*,;&lt;=&gt;?@[\\\\]^`{|})]+)
627
628</pre>
629<p>Please also note that the <i>LeftClick Shift-LeftClik</i> combination also
630selects words like the old code.</p>
631
632</div>
633<h3 id="I_don_t_like_the_new_selection_popup">I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?</h3>
634<div id="I_don_t_like_the_new_selection_popup-2">
635<p>You can disable the perl extension completely by setting the
636<strong>perl-ext-common</strong> resource to the empty string, which also keeps
637rxvt-unicode from initialising perl, saving memory.</p>
638<p>If you only want to disable specific features, you first have to
639identify which perl extension is responsible. For this, read the section
640<strong>PREPACKAGED EXTENSIONS</strong> in the urxvtperl(3) manpage. For
641example, to disable the <strong>selection-popup</strong> and <strong>option-popup</strong>, specify
642this <strong>perl-ext-common</strong> resource:</p>
643<pre> URxvt.perl-ext-common: default,-selection-popup,-option-popup
644
645</pre>
646<p>This will keep the default extensions, but disable the two popup
647extensions. Some extensions can also be configured, for example,
648scrollback search mode is triggered by <strong>M-s</strong>. You can move it to any
649other combination either by setting the <strong>searchable-scrollback</strong> resource:</p>
650<pre> URxvt.searchable-scrollback: CM-s
651
652</pre>
653
654</div>
655<h3 id="The_cursor_moves_when_selecting_text">The cursor moves when selecting text in the current input line, how do I switch this off?</h3>
656<div id="The_cursor_moves_when_selecting_text-2">
657<p>See next entry.</p>
658
659</div>
660<h3 id="During_rlogin_ssh_telnet_etc_session">During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?</h3>
661<div id="During_rlogin_ssh_telnet_etc_session-2">
662<p>These are caused by the <code>readline</code> perl extension. Under normal
663circumstances, it will move your cursor around when you click into the
664line that contains it. It tries hard not to do this at the wrong moment,
665but when running a program that doesn't parse cursor movements or in some
666cases during rlogin sessions, it fails to detect this properly.</p>
667<p>You can permanently switch this feature off by disabling the <code>readline</code>
668extension:</p>
233 URxvt.perl-ext-common: default,tabbed</pre> 669<pre> URxvt.perl-ext-common: default,-readline
234</dd> 670
235<dd> 671</pre>
236<p>It will also work fine with tabbing functionality of many window managers 672
237or similar tabbing programs, and its embedding-features allow it to be 673</div>
238embedded into other programs, as witnessed by <em>doc/rxvt-tabbed</em> or 674<h3 id="My_numerical_keypad_acts_weird_and_g">My numerical keypad acts weird and generates differing output?</h3>
239the upcoming <code>Gtk2::URxvt</code> perl module, which features a tabbed urxvt 675<div id="My_numerical_keypad_acts_weird_and_g-2">
240(murxvt) terminal as an example embedding application.</p> 676<p>Some Debian GNUL/Linux users seem to have this problem, although no
241</dd> 677specific details were reported so far. It is possible that this is caused
242<p></p> 678by the wrong <code>TERM</code> setting, although the details of whether and how
243<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 /> 679this can happen are unknown, as <code>TERM=rxvt</code> should offer a compatible
244</dt> 680keymap. See the answer to the previous question, and please report if that
245<dd> 681helped.</p>
246The version number is displayed with the usage (-h). Also the escape 682
247sequence <code>ESC [ 8 n</code> sets the window title to the version number. When 683</div>
248using the rxvtc client, the version displayed is that of the 684<h3 id="My_Compose_Multi_key_key_is_no_longe">My Compose (Multi_key) key is no longer working.</h3>
249daemon. 685<div id="My_Compose_Multi_key_key_is_no_longe-2">
250</dd> 686<p>The most common causes for this are that either your locale is not set
251<p></p> 687correctly, or you specified a <strong>preeditStyle</strong> that is not supported by
252<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 /> 688your input method. For example, if you specified <strong>OverTheSpot</strong> and
253</dt> 689your input method (e.g. the default input method handling Compose keys)
254<dd> 690does not support this (for instance because it is not visual), then
255The Debian GNU/Linux package of rxvt-unicode in sarge contains large 691rxvt-unicode will continue without an input method.</p>
256patches that considerably change the behaviour of rxvt-unicode (but 692<p>In this case either do not specify a <strong>preeditStyle</strong> or specify more than
257unfortunately this notice has been removed). Before reporting a bug to 693one pre-edit style, such as <strong>OverTheSpot,Root,None</strong>.</p>
258the original rxvt-unicode author please download and install the genuine 694
259version (<a href="http://software.schmorp.de#rxvt-unicode">http://software.schmorp.de#rxvt-unicode</a>) and try to reproduce 695</div>
260the problem. If you cannot, chances are that the problems are specific to 696<h3 id="I_cannot_type_code_Ctrl_Shift_2_code">I cannot type <code>Ctrl-Shift-2</code> to get an ASCII NUL character due to ISO 14755</h3>
261Debian GNU/Linux, in which case it should be reported via the Debian Bug 697<div id="I_cannot_type_code_Ctrl_Shift_2_code-2">
262Tracking System (use <code>reportbug</code> to report the bug). 698<p>Either try <code>Ctrl-2</code> alone (it often is mapped to ASCII NUL even on
263</dd> 699international keyboards) or simply use ISO 14755 support to your
264<dd> 700advantage, typing &lt;Ctrl-Shift-0&gt; to get a ASCII NUL. This works for other
265<p>For other problems that also affect the Debian package, you can and 701codes, too, such as <code>Ctrl-Shift-1-d</code> to type the default telnet escape
266probably should use the Debian BTS, too, because, after all, it's also a 702character and so on.</p>
267bug in the Debian version and it serves as a reminder for other users that 703
268might encounter the same issue.</p> 704</div>
269</dd> 705<h3 id="Mouse_cut_paste_suddenly_no_longer_w">Mouse cut/paste suddenly no longer works.</h3>
270<p></p> 706<div id="Mouse_cut_paste_suddenly_no_longer_w-2">
271<dt><strong><a name="item_i_am_maintaining_rxvt_2dunicode_for_distribution_2">I am maintaining rxvt-unicode for distribution/OS XXX, any 707<p>Make sure that mouse reporting is actually turned off since killing
272recommendation?</a></strong><br /> 708some editors prematurely may leave the mouse in mouse report mode. I've
273</dt> 709heard that tcsh may use mouse reporting unless it otherwise specified. A
274<dd> 710quick check is to see if cut/paste works when the Alt or Shift keys are
275You should build one binary with the default options. <em>configure</em> 711depressed.</p>
276now enables most useful options, and the trend goes to making them 712
277runtime-switchable, too, so there is usually no drawback to enbaling them, 713</div>
278except higher disk and possibly memory usage. The perl interpreter should 714<h3 id="What_s_with_the_strange_Backspace_De">What's with the strange Backspace/Delete key behaviour?</h3>
279be enabled, as important functionality (menus, selection, likely more in 715<div id="What_s_with_the_strange_Backspace_De-2">
280the future) depends on it. 716<p>Assuming that the physical Backspace key corresponds to the
281</dd> 717Backspace keysym (not likely for Linux ... see the following
282<dd> 718question) there are two standard values that can be used for
283<p>You should not overwrite the <code>perl-ext-common</code> snd <code>perl-ext</code> resources 719Backspace: <code>^H</code> and <code>^?</code>.</p>
284system-wide (except maybe with <code>defaults</code>). This will result in useful 720<p>Historically, either value is correct, but rxvt-unicode adopts the debian
285behaviour. If your distribution aims at low memory, add an empty 721policy of using <code>^?</code> when unsure, because it's the one and only correct
286<code>perl-ext-common</code> resource to the app-defaults file. This will keep the 722choice :).</p>
287perl interpreter disabled until the user enables it.</p> 723<p>Rxvt-unicode tries to inherit the current stty settings and uses the value
288</dd> 724of `erase' to guess the value for backspace. If rxvt-unicode wasn't
289<dd> 725started from a terminal (say, from a menu or by remote shell), then the
290<p>If you can/want build more binaries, I recommend building a minimal 726system value of `erase', which corresponds to CERASE in &lt;termios.h&gt;, will
291one with <code>--disable-everything</code> (very useful) and a maximal one with 727be used (which may not be the same as your stty setting).</p>
292<a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> (less useful, it will be very big due to a lot of 728<p>For starting a new rxvt-unicode:</p>
293encodings built-in that increase download times and are rarely used).</p> 729<pre> # use Backspace = ^H
294</dd> 730 $ stty erase ^H
295<p></p> 731 $ urxvt
296<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 /> 732
297</dt> 733 # use Backspace = ^?
298<dd> 734 $ stty erase ^?
299It should be, starting with release 7.1. You are encouraged to properly 735 $ urxvt
300install urxvt with privileges necessary for your OS now. 736
301</dd> 737</pre>
302<dd> 738<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code>.</p>
303<p>When rxvt-unicode detects that it runs setuid or setgid, it will fork 739<p>For an existing rxvt-unicode:</p>
304into a helper process for privileged operations (pty handling on some 740<pre> # use Backspace = ^H
305systems, utmp/wtmp/lastlog handling on others) and drop privileges 741 $ stty erase ^H
306immediately. This is much safer than most other terminals that keep 742 $ echo -n &quot;^[[36h&quot;
307privileges while running (but is more relevant to urxvt, as it contains 743
308things as perl interpreters, which might be ``helpful'' to attackers).</p> 744 # use Backspace = ^?
309</dd> 745 $ stty erase ^?
310<dd> 746 $ echo -n &quot;^[[36l&quot;
311<p>This forking is done as the very first within main(), which is very early 747
312and reduces possible bugs to initialisation code run before main(), or 748</pre>
313things like the dynamic loader of your system, which should result in very 749<p>This helps satisfy some of the Backspace discrepancies that occur, but
314little risk.</p> 750if you use Backspace = <code>^H</code>, make sure that the termcap/terminfo value
315</dd> 751properly reflects that.</p>
316<p></p> 752<p>The Delete key is a another casualty of the ill-defined Backspace problem.
753To avoid confusion between the Backspace and Delete keys, the Delete
754key has been assigned an escape sequence to match the vt100 for Execute
755(<code>ESC [ 3 ~</code>) and is in the supplied termcap/terminfo.</p>
756<p>Some other Backspace problems:</p>
757<p>some editors use termcap/terminfo,
758some editors (vim I'm told) expect Backspace = ^H,
759GNU Emacs (and Emacs-like editors) use ^H for help.</p>
760<p>Perhaps someday this will all be resolved in a consistent manner.</p>
761
762</div>
763<h3 id="I_don_t_like_the_key_bindings_How_do">I don't like the key-bindings. How do I change them?</h3>
764<div id="I_don_t_like_the_key_bindings_How_do-2">
765<p>There are some compile-time selections available via configure. Unless
766you have run &quot;configure&quot; with the <code>--disable-resources</code> option you can
767use the `keysym' resource to alter the keystrings associated with keysyms.</p>
768<p>Here's an example for a URxvt session started using <code>urxvt -name URxvt</code></p>
769<pre> URxvt.keysym.Home: \033[1~
770 URxvt.keysym.End: \033[4~
771 URxvt.keysym.C-apostrophe: \033&lt;C-'&gt;
772 URxvt.keysym.C-slash: \033&lt;C-/&gt;
773 URxvt.keysym.C-semicolon: \033&lt;C-;&gt;
774 URxvt.keysym.C-grave: \033&lt;C-`&gt;
775 URxvt.keysym.C-comma: \033&lt;C-,&gt;
776 URxvt.keysym.C-period: \033&lt;C-.&gt;
777 URxvt.keysym.C-0x60: \033&lt;C-`&gt;
778 URxvt.keysym.C-Tab: \033&lt;C-Tab&gt;
779 URxvt.keysym.C-Return: \033&lt;C-Return&gt;
780 URxvt.keysym.S-Return: \033&lt;S-Return&gt;
781 URxvt.keysym.S-space: \033&lt;S-Space&gt;
782 URxvt.keysym.M-Up: \033&lt;M-Up&gt;
783 URxvt.keysym.M-Down: \033&lt;M-Down&gt;
784 URxvt.keysym.M-Left: \033&lt;M-Left&gt;
785 URxvt.keysym.M-Right: \033&lt;M-Right&gt;
786 URxvt.keysym.M-C-0: list \033&lt;M-C- 0123456789 &gt;
787 URxvt.keysym.M-C-a: list \033&lt;M-C- abcdefghijklmnopqrstuvwxyz &gt;
788 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007
789
790</pre>
791<p>See some more examples in the documentation for the <strong>keysym</strong> resource.</p>
792
793</div>
794<h3 id="I_m_using_keyboard_model_XXX_that_ha">I'm using keyboard model XXX that has extra Prior/Next/Insert keys. How do I make use of them? For example, the Sun Keyboard type 4 has the following map</h3>
795<div id="I_m_using_keyboard_model_XXX_that_ha-2">
796<pre> KP_Insert == Insert
797 F22 == Print
798 F27 == Home
799 F29 == Prior
800 F33 == End
801 F35 == Next
802
803</pre>
804<p>Rather than have rxvt-unicode try to accommodate all the various possible
805keyboard mappings, it is better to use `xmodmap' to remap the keys as
806required for your particular machine.</p>
807
808
809
810
811
812
813
814
815</div>
816<h2 id="Terminal_Configuration">Terminal Configuration</h2>
817<div id="Terminal_Configuration_CONTENT">
818
819</div>
820<h3 id="Can_I_see_a_typical_configuration">Can I see a typical configuration?</h3>
821<div id="Can_I_see_a_typical_configuration_CO">
822<p>The default configuration tries to be xterm-like, which I don't like that
823much, but it's least surprise to regular users.</p>
824<p>As a rxvt or rxvt-unicode user, you are practically supposed to invest
825time into customising your terminal. To get you started, here is the
826author's .Xdefaults entries, with comments on what they do. It's certainly
827not <i>typical</i>, but what's typical...</p>
828<pre> URxvt.cutchars: &quot;()*,&lt;&gt;[]{}|'
829 URxvt.print-pipe: cat &gt;/tmp/xxx
830
831</pre>
832<p>These are just for testing stuff.</p>
833<pre> URxvt.imLocale: ja_JP.UTF-8
834 URxvt.preeditType: OnTheSpot,None
835
836</pre>
837<p>This tells rxvt-unicode to use a special locale when communicating with
838the X Input Method, and also tells it to only use the OnTheSpot pre-edit
839type, which requires the <code>xim-onthespot</code> perl extension but rewards me
840with correct-looking fonts.</p>
841<pre> URxvt.perl-lib: /root/lib/urxvt
842 URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard
843 URxvt.selection.pattern-0: ( at .*? line \\d+)
844 URxvt.selection.pattern-1: ^(/[^:]+):\
845 URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/
846 URxvt.selection-autotransform.1: s/^ at (.*?) line (\\d+)$/:e \\Q$1\\E\\x0d:$2\\x0d/
847
848</pre>
849<p>This is my perl configuration. The first two set the perl library
850directory and also tells urxvt to use a large number of extensions. I
851develop for myself mostly, so I actually use most of the extensions I
852write.</p>
853<p>The selection stuff mainly makes the selection perl-error-message aware
854and tells it to convert perl error messages into vi-commands to load the
855relevant file and go tot he error line number.</p>
856<pre> URxvt.scrollstyle: plain
857 URxvt.secondaryScroll: true
858
859</pre>
860<p>As the documentation says: plain is the preferred scrollbar for the
861author. The <code>secondaryScroll</code> configures urxvt to scroll in full-screen
862apps, like screen, so lines scrolled out of screen end up in urxvt's
863scrollback buffer.</p>
864<pre> URxvt.background: #000000
865 URxvt.foreground: gray90
866 URxvt.color7: gray90
867 URxvt.colorBD: #ffffff
868 URxvt.cursorColor: #e0e080
869 URxvt.throughColor: #8080f0
870 URxvt.highlightColor: #f0f0f0
871
872</pre>
873<p>Some colours. Not sure which ones are being used or even non-defaults, but
874these are in my .Xdefaults. Most notably, they set foreground/background
875to light gray/black, and also make sure that the colour 7 matches the
876default foreground colour.</p>
877<pre> URxvt.underlineColor: yellow
878
879</pre>
880<p>Another colour, makes underline lines look different. Sometimes hurts, but
881is mostly a nice effect.</p>
882<pre> URxvt.geometry: 154x36
883 URxvt.loginShell: false
884 URxvt.meta: ignore
885 URxvt.utmpInhibit: true
886
887</pre>
888<p>Uh, well, should be mostly self-explanatory. By specifying some defaults
889manually, I can quickly switch them for testing.</p>
890<pre> URxvt.saveLines: 8192
891
892</pre>
893<p>A large scrollback buffer is essential. Really.</p>
894<pre> URxvt.mapAlert: true
895
896</pre>
897<p>The only case I use it is for my IRC window, which I like to keep
898iconified till people msg me (which beeps).</p>
899<pre> URxvt.visualBell: true
900
901</pre>
902<p>The audible bell is often annoying, especially when in a crowd.</p>
903<pre> URxvt.insecure: true
904
905</pre>
906<p>Please don't hack my mutt! Ooops...</p>
907<pre> URxvt.pastableTabs: false
908
909</pre>
910<p>I once thought this is a great idea.</p>
911<pre> urxvt.font: 9x15bold,\
912 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
913 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
914 [codeset=JISX0208]xft:Kochi Gothic, \
915 xft:Bitstream Vera Sans Mono:autohint=true, \
916 xft:Code2000:antialias=false
917 urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
918 urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
919 urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
920
921</pre>
922<p>I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
923overwhelmed. A special note: the <code>9x15bold</code> mentioned above is actually
924the version from XFree-3.3, as XFree-4 replaced it by a totally different
925font (different glyphs for <code>;</code> and many other harmless characters),
926while the second font is actually the <code>9x15bold</code> from XFree4/XOrg. The
927bold version has less chars than the medium version, so I use it for rare
928characters, too. When editing sources with vim, I use italic for comments
929and other stuff, which looks quite good with Bitstream Vera anti-aliased.</p>
930<p>Terminus is a quite bad font (many very wrong glyphs), but for most of my
931purposes, it works, and gives a different look, as my normal (Non-bold)
932font is already bold, and I want to see a difference between bold and
933normal fonts.</p>
934<p>Please note that I used the <code>urxvt</code> instance name and not the <code>URxvt</code>
935class name. Thats because I use different configs for different purposes,
936for example, my IRC window is started with <code>-name IRC</code>, and uses these
937defaults:</p>
938<pre> IRC*title: IRC
939 IRC*geometry: 87x12+535+542
940 IRC*saveLines: 0
941 IRC*mapAlert: true
942 IRC*font: suxuseuro
943 IRC*boldFont: suxuseuro
944 IRC*colorBD: white
945 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
946 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007
947
948</pre>
949<p><code>Alt-Shift-1</code> and <code>Alt-Shift-2</code> switch between two different font
950sizes. <code>suxuseuro</code> allows me to keep an eye (and actually read)
951stuff while keeping a very small window. If somebody pastes something
952complicated (e.g. japanese), I temporarily switch to a larger font.</p>
953<p>The above is all in my <code>.Xdefaults</code> (I don't use <code>.Xresources</code> nor
954<code>xrdb</code>). I also have some resources in a separate <code>.Xdefaults-hostname</code>
955file for different hosts, for example, on ym main desktop, I use:</p>
956<pre> URxvt.keysym.C-M-q: command:\033[3;5;5t
957 URxvt.keysym.C-M-y: command:\033[3;5;606t
958 URxvt.keysym.C-M-e: command:\033[3;1605;5t
959 URxvt.keysym.C-M-c: command:\033[3;1605;606t
960 URxvt.keysym.C-M-p: perl:test
961
962</pre>
963<p>The first for keysym definitions allow me to quickly bring some windows
964in the layout I like most. Ion users might start laughing but will stop
965immediately when I tell them that I use my own Fvwm2 module for much the
966same effect as Ion provides, and I only very rarely use the above key
967combinations :-&gt;</p>
968
969</div>
970<h3 id="Why_doesn_t_rxvt_unicode_read_my_res">Why doesn't rxvt-unicode read my resources?</h3>
971<div id="Why_doesn_t_rxvt_unicode_read_my_res-2">
972<p>Well, why, indeed? It does, in a way very similar to other X
973applications. Most importantly, this means that if you or your OS loads
974resources into the X display (the right way to do it), rxvt-unicode will
975ignore any resource files in your home directory. It will only read
976<cite>$HOME/.Xdefaults</cite> when no resources are attached to the display.</p>
977<p>If you have or use an <cite>$HOME/.Xresources</cite> file, chances are that
978resources are loaded into your X-server. In this case, you have to
979re-login after every change (or run <cite>xrdb -merge $HOME/.Xresources</cite>).</p>
980<p>Also consider the form resources have to use:</p>
981<pre> URxvt.resource: value
982
983</pre>
984<p>If you want to use another form (there are lots of different ways of
985specifying resources), make sure you understand whether and why it
986works. If unsure, use the form above.</p>
987
988</div>
317<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 /> 989<h3 id="When_I_log_in_to_another_system_it_t">When I log-in to another system it tells me about missing terminfo data?</h3>
318</dt> 990<div id="When_I_log_in_to_another_system_it_t-2">
319<dd>
320The terminal description used by rxvt-unicode is not as widely available 991<p>The terminal description used by rxvt-unicode is not as widely available
321as that for xterm, or even rxvt (for which the same problem often arises). 992as that for xterm, or even rxvt (for which the same problem often arises).</p>
322</dd>
323<dd>
324<p>The correct solution for this problem is to install the terminfo, this can 993<p>The correct solution for this problem is to install the terminfo, this can
325be done like this (with ncurses' infocmp):</p> 994be done like this (with ncurses' infocmp and works as user and admin):</p>
326</dd>
327<dd>
328<pre>
329 REMOTE=remotesystem.domain 995<pre> REMOTE=remotesystem.domain
330 infocmp rxvt-unicode | ssh $REMOTE &quot;cat &gt;/tmp/ti &amp;&amp; tic /tmp/ti&quot;</pre> 996 infocmp rxvt-unicode | ssh $REMOTE &quot;mkdir -p .terminfo &amp;&amp; cat &gt;/tmp/ti &amp;&amp; tic /tmp/ti&quot;
331</dd> 997
332<dd> 998</pre>
333<p>... or by installing rxvt-unicode normally on the remote system,</p> 999<p>... or by installing rxvt-unicode normally on the remote system,</p>
334</dd> 1000<p>One some systems you might need to set <code>$TERMINFO</code> to the full path of
335<dd> 1001<cite>$HOME/.terminfo</cite> for this to work.</p>
336<p>If you cannot or do not want to do this, then you can simply set 1002<p>If you cannot or do not want to do this, then you can simply set
337<code>TERM=rxvt</code> or even <code>TERM=xterm</code>, and live with the small number of 1003<code>TERM=rxvt</code> or even <code>TERM=xterm</code>, and live with the small number of
338problems arising, which includes wrong keymapping, less and different 1004problems arising, which includes wrong keymapping, less and different
339colours and some refresh errors in fullscreen applications. It's a nice 1005colours and some refresh errors in fullscreen applications. It's a nice
340quick-and-dirty workaround for rare cases, though.</p> 1006quick-and-dirty workaround for rare cases, though.</p>
341</dd>
342<dd>
343<p>If you always want to do this (and are fine with the consequences) you 1007<p>If you always want to do this (and are fine with the consequences) you
344can either recompile rxvt-unicode with the desired TERM value or use a 1008can either recompile rxvt-unicode with the desired TERM value or use a
345resource to set it:</p> 1009resource to set it:</p>
346</dd> 1010<pre> URxvt.termName: rxvt
347<dd> 1011
348<pre> 1012</pre>
349 URxvt.termName: rxvt</pre>
350</dd>
351<dd>
352<p>If you don't plan to use <strong>rxvt</strong> (quite common...) you could also replace 1013<p>If you don't plan to use <strong>rxvt</strong> (quite common...) you could also replace
353the rxvt terminfo file with the rxvt-unicode one.</p> 1014the rxvt terminfo file with the rxvt-unicode one and use <code>TERM=rxvt</code>.</p>
354</dd> 1015
355<p></p> 1016</div>
356<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 /> 1017<h3 id="code_tic_code_outputs_some_error_whe"><code>tic</code> outputs some error when compiling the terminfo entry.</h3>
357</dt> 1018<div id="code_tic_code_outputs_some_error_whe-2">
358<dd>
359Most likely it's the empty definition for <code>enacs=</code>. Just replace it by 1019<p>Most likely it's the empty definition for <code>enacs=</code>. Just replace it by
360<code>enacs=\E[0@</code> and try again. 1020<code>enacs=\E[0@</code> and try again.</p>
361</dd> 1021
362<p></p> 1022</div>
363<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 /> 1023<h3 id="code_bash_code_s_readline_does_not_w"><code>bash</code>'s readline does not work correctly under urxvt.</h3>
364</dt> 1024<div id="code_bash_code_s_readline_does_not_w-2">
365<dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br /> 1025<p>See next entry.</p>
366</dt> 1026
367<dd> 1027</div>
1028<h3 id="I_need_a_termcap_file_entry">I need a termcap file entry.</h3>
1029<div id="I_need_a_termcap_file_entry_CONTENT">
368One reason you might want this is that some distributions or operating 1030<p>One reason you might want this is that some distributions or operating
369systems still compile some programs using the long-obsoleted termcap 1031systems still compile some programs using the long-obsoleted termcap
370library (Fedora Core's bash is one example) and rely on a termcap entry 1032library (Fedora Core's bash is one example) and rely on a termcap entry
371for <code>rxvt-unicode</code>. 1033for <code>rxvt-unicode</code>.</p>
372</dd>
373<dd>
374<p>You could use rxvt's termcap entry with resonable results in many cases. 1034<p>You could use rxvt's termcap entry with reasonable results in many cases.
375You can also create a termcap entry by using terminfo's infocmp program 1035You can also create a termcap entry by using terminfo's infocmp program
376like this:</p> 1036like this:</p>
377</dd> 1037<pre> infocmp -C rxvt-unicode
378<dd> 1038
379<pre> 1039</pre>
380 infocmp -C rxvt-unicode</pre>
381</dd>
382<dd>
383<p>Or you could use this termcap entry, generated by the command above:</p> 1040<p>Or you could use this termcap entry, generated by the command above:</p>
384</dd>
385<dd>
386<pre>
387 rxvt-unicode|rxvt-unicode terminal (X Window System):\ 1041<pre> rxvt-unicode|rxvt-unicode terminal (X Window System):\
388 :am:bw:eo:km:mi:ms:xn:xo:\ 1042 :am:bw:eo:km:mi:ms:xn:xo:\
389 :co#80:it#8:li#24:lm#0:\ 1043 :co#80:it#8:li#24:lm#0:\
390 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\ 1044 :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
391 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\ 1045 :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
392 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\ 1046 :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=\E(B:al=\E[L:\
… …
401 :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\ 1055 :kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:ku=\EOA:le=^H:\
402 :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\ 1056 :mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:nd=\E[C:rc=\E8:\
403 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\ 1057 :sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:st=\EH:ta=^I:\
404 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\ 1058 :te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:up=\E[A:\
405 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\ 1059 :us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
406 :vs=\E[?25h:</pre> 1060 :vs=\E[?25h:
407</dd> 1061
408<p></p> 1062</pre>
409<dt><strong><a name="item_why_does_ls_no_longer_have_coloured_output_3f">Why does <code>ls</code> no longer have coloured output?</a></strong><br /> 1063
410</dt> 1064</div>
411<dd> 1065<h3 id="Why_does_code_ls_code_no_longer_have">Why does <code>ls</code> no longer have coloured output?</h3>
1066<div id="Why_does_code_ls_code_no_longer_have-2">
412The <code>ls</code> in the GNU coreutils unfortunately doesn't use terminfo to 1067<p>The <code>ls</code> in the GNU coreutils unfortunately doesn't use terminfo to
413decide wether a terminal has colour, but uses it's own configuration 1068decide whether a terminal has colour, but uses its own configuration
414file. Needless to say, <code>rxvt-unicode</code> is not in it's default file (among 1069file. Needless to say, <code>rxvt-unicode</code> is not in its default file (among
415with most other terminals supporting colour). Either add: 1070with most other terminals supporting colour). Either add:</p>
416</dd> 1071<pre> TERM rxvt-unicode
417<dd> 1072
418<pre> 1073</pre>
419 TERM rxvt-unicode</pre>
420</dd>
421<dd>
422<p>to <code>/etc/DIR_COLORS</code> or simply add:</p> 1074<p>to <code>/etc/DIR_COLORS</code> or simply add:</p>
423</dd> 1075<pre> alias ls='ls --color=auto'
424<dd> 1076
425<pre> 1077</pre>
426 alias ls='ls --color=auto'</pre>
427</dd>
428<dd>
429<p>to your <code>.profile</code> or <code>.bashrc</code>.</p> 1078<p>to your <code>.profile</code> or <code>.bashrc</code>.</p>
430</dd> 1079
431<p></p> 1080</div>
432<dt><strong><a name="item_why_doesn_27t_vim_2femacs_etc_2e_use_the_88_colour">Why doesn't vim/emacs etc. use the 88 colour mode?</a></strong><br /> 1081<h3 id="Why_doesn_t_vim_emacs_etc_use_the_88">Why doesn't vim/emacs etc. use the 88 colour mode?</h3>
433</dt> 1082<div id="Why_doesn_t_vim_emacs_etc_use_the_88-2">
1083<p>See next entry.</p>
1084
1085</div>
434<dt><strong><a name="item_why_doesn_27t_vim_2femacs_etc_2e_make_use_of_itali">Why doesn't vim/emacs etc. make use of italic?</a></strong><br /> 1086<h3 id="Why_doesn_t_vim_emacs_etc_make_use_o">Why doesn't vim/emacs etc. make use of italic?</h3>
435</dt> 1087<div id="Why_doesn_t_vim_emacs_etc_make_use_o-2">
1088<p>See next entry.</p>
1089
1090</div>
436<dt><strong><a name="item_why_are_the_secondary_screen_2drelated_options_not">Why are the secondary screen-related options not working properly?</a></strong><br /> 1091<h3 id="Why_are_the_secondary_screen_related">Why are the secondary screen-related options not working properly?</h3>
437</dt> 1092<div id="Why_are_the_secondary_screen_related-2">
438<dd>
439Make sure you are using <code>TERM=rxvt-unicode</code>. Some pre-packaged 1093<p>Make sure you are using <code>TERM=rxvt-unicode</code>. Some pre-packaged
440distributions (most notably Debian GNU/Linux) break rxvt-unicode 1094distributions (most notably Debian GNU/Linux) break rxvt-unicode
441by setting <code>TERM</code> to <code>rxvt</code>, which doesn't have these extra 1095by setting <code>TERM</code> to <code>rxvt</code>, which doesn't have these extra
442features. Unfortunately, some of these (most notably, again, Debian 1096features. Unfortunately, some of these (most notably, again, Debian
443GNU/Linux) furthermore fail to even install the <code>rxvt-unicode</code> terminfo 1097GNU/Linux) furthermore fail to even install the <code>rxvt-unicode</code> terminfo
444file, so you will need to install it on your own (See the question <strong>When 1098file, so you will need to install it on your own (See the question <strong>When
445I log-in to another system it tells me about missing terminfo data?</strong> on 1099I log-in to another system it tells me about missing terminfo data?</strong> on
446how to do this). 1100how to do this).</p>
447</dd> 1101
448<p></p> 1102
449<dt><strong><a name="item_my_numerical_keypad_acts_weird_and_generates_diffe">My numerical keypad acts weird and generates differing output?</a></strong><br /> 1103
450</dt> 1104
451<dd> 1105
452Some Debian GNUL/Linux users seem to have this problem, although no 1106</div>
453specific details were reported so far. It is possible that this is caused 1107<h2 id="Encoding_Locale_Input_Method_Issues">Encoding / Locale / Input Method Issues</h2>
454by the wrong <code>TERM</code> setting, although the details of wether and how 1108<div id="Encoding_Locale_Input_Method_Issues_">
455this can happen are unknown, as <code>TERM=rxvt</code> should offer a compatible 1109
456keymap. See the answer to the previous question, and please report if that 1110</div>
457helped.
458</dd>
459<p></p>
460<dt><strong><a name="item_rxvt_2dunicode_does_not_seem_to_understand_the_sel">Rxvt-unicode does not seem to understand the selected encoding?</a></strong><br /> 1111<h3 id="Rxvt_unicode_does_not_seem_to_unders">Rxvt-unicode does not seem to understand the selected encoding?</h3>
461</dt> 1112<div id="Rxvt_unicode_does_not_seem_to_unders-2">
462<dt><strong><a name="item_unicode_does_not_seem_to_work_3f">Unicode does not seem to work?</a></strong><br /> 1113<p>See next entry.</p>
463</dt> 1114
464<dd> 1115</div>
1116<h3 id="Unicode_does_not_seem_to_work">Unicode does not seem to work?</h3>
1117<div id="Unicode_does_not_seem_to_work_CONTEN">
465If you encounter strange problems like typing an accented character but 1118<p>If you encounter strange problems like typing an accented character but
466getting two unrelated other characters or similar, or if program output is 1119getting two unrelated other characters or similar, or if program output is
467subtly garbled, then you should check your locale settings. 1120subtly garbled, then you should check your locale settings.</p>
468</dd>
469<dd>
470<p>Rxvt-unicode must be started with the same <code>LC_CTYPE</code> setting as the 1121<p>Rxvt-unicode must be started with the same <code>LC_CTYPE</code> setting as the
471programs. Often rxvt-unicode is started in the <a href="#item_c"><code>C</code></a> locale, while the 1122programs running in it. Often rxvt-unicode is started in the <code>C</code> locale,
472login script running within the rxvt-unicode window changes the locale to 1123while the login script running within the rxvt-unicode window changes the
473something else, e.g. <code>en_GB.UTF-8</code>. Needless to say, this is not going to work.</p> 1124locale to something else, e.g. <code>en_GB.UTF-8</code>. Needless to say, this is
474</dd> 1125not going to work, and is the most common cause for problems.</p>
475<dd>
476<p>The best thing is to fix your startup environment, as you will likely run 1126<p>The best thing is to fix your startup environment, as you will likely run
477into other problems. If nothing works you can try this in your .profile.</p> 1127into other problems. If nothing works you can try this in your .profile.</p>
478</dd> 1128<pre> printf '\33]701;%s\007' &quot;$LC_CTYPE&quot; # $LANG or $LC_ALL are worth a try, too
479<dd> 1129
480<pre> 1130</pre>
481 printf '\e]701;%s\007' &quot;$LC_CTYPE&quot;</pre>
482</dd>
483<dd>
484<p>If this doesn't work, then maybe you use a <code>LC_CTYPE</code> specification not 1131<p>If this doesn't work, then maybe you use a <code>LC_CTYPE</code> specification not
485supported on your systems. Some systems have a <code>locale</code> command which 1132supported on your systems. Some systems have a <code>locale</code> command which
486displays this (also, <code>perl -e0</code> can be used to check locale settings, as 1133displays this (also, <code>perl -e0</code> can be used to check locale settings, as
487it will complain loudly if it cannot set the locale). If it displays something 1134it will complain loudly if it cannot set the locale). If it displays something
488like:</p> 1135like:</p>
489</dd> 1136<pre> locale: Cannot set LC_CTYPE to default locale: ...
490<dd> 1137
491<pre> 1138</pre>
492 locale: Cannot set LC_CTYPE to default locale: ...</pre>
493</dd>
494<dd>
495<p>Then the locale you specified is not supported on your system.</p> 1139<p>Then the locale you specified is not supported on your system.</p>
496</dd>
497<dd>
498<p>If nothing works and you are sure that everything is set correctly then 1140<p>If nothing works and you are sure that everything is set correctly then
499you will need to remember a little known fact: Some programs just don't 1141you will need to remember a little known fact: Some programs just don't
500support locales :(</p> 1142support locales :(</p>
501</dd> 1143
502<p></p> 1144</div>
503<dt><strong><a name="item_why_do_some_characters_look_so_much_different_than">Why do some characters look so much different than others?</a></strong><br /> 1145<h3 id="How_does_rxvt_unicode_determine_the_">How does rxvt-unicode determine the encoding to use?</h3>
504</dt> 1146<div id="How_does_rxvt_unicode_determine_the_-2">
505<dt><strong><a name="item_how_does_rxvt_2dunicode_choose_fonts_3f">How does rxvt-unicode choose fonts?</a></strong><br /> 1147<p>See next entry.</p>
506</dt> 1148
507<dd> 1149</div>
508Most fonts do not contain the full range of Unicode, which is 1150<h3 id="Is_there_an_option_to_switch_encodin">Is there an option to switch encodings?</h3>
509fine. Chances are that the font you (or the admin/package maintainer of 1151<div id="Is_there_an_option_to_switch_encodin-2">
510your system/os) have specified does not cover all the characters you want 1152<p>Unlike some other terminals, rxvt-unicode has no encoding switch, and no
511to display. 1153specific &quot;utf-8&quot; mode, such as xterm. In fact, it doesn't even know about
512</dd> 1154UTF-8 or any other encodings with respect to terminal I/O.</p>
513<dd> 1155<p>The reasons is that there exists a perfectly fine mechanism for selecting
514<p><strong>rxvt-unicode</strong> makes a best-effort try at finding a replacement 1156the encoding, doing I/O and (most important) communicating this to all
515font. Often the result is fine, but sometimes the chosen font looks 1157applications so everybody agrees on character properties such as width
516bad/ugly/wrong. Some fonts have totally strange characters that don't 1158and code number. This mechanism is the <i>locale</i>. Applications not using
517resemble the correct glyph at all, and rxvt-unicode lacks the artificial 1159that info will have problems (for example, <code>xterm</code> gets the width of
518intelligence to detect that a specific glyph is wrong: it has to believe 1160characters wrong as it uses its own, locale-independent table under all
519the font that the characters it claims to contain indeed look correct.</p> 1161locales).</p>
520</dd> 1162<p>Rxvt-unicode uses the <code>LC_CTYPE</code> locale category to select encoding. All
521<dd> 1163programs doing the same (that is, most) will automatically agree in the
522<p>In that case, select a font of your taste and add it to the font list, 1164interpretation of characters.</p>
523e.g.:</p> 1165<p>Unfortunately, there is no system-independent way to select locales, nor
524</dd> 1166is there a standard on how locale specifiers will look like.</p>
525<dd> 1167<p>On most systems, the content of the <code>LC_CTYPE</code> environment variable
1168contains an arbitrary string which corresponds to an already-installed
1169locale. Common names for locales are <code>en_US.UTF-8</code>, <code>de_DE.ISO-8859-15</code>,
1170<code>ja_JP.EUC-JP</code>, i.e. <code>language_country.encoding</code>, but other forms
1171(i.e. <code>de</code> or <code>german</code>) are also common.</p>
1172<p>Rxvt-unicode ignores all other locale categories, and except for
1173the encoding, ignores country or language-specific settings,
1174i.e. <code>de_DE.UTF-8</code> and <code>ja_JP.UTF-8</code> are the normally same to
1175rxvt-unicode.</p>
1176<p>If you want to use a specific encoding you have to make sure you start
1177rxvt-unicode with the correct <code>LC_CTYPE</code> category.</p>
1178
1179</div>
1180<h3 id="Can_I_switch_locales_at_runtime">Can I switch locales at runtime?</h3>
1181<div id="Can_I_switch_locales_at_runtime_CONT">
1182<p>Yes, using an escape sequence. Try something like this, which sets
1183rxvt-unicode's idea of <code>LC_CTYPE</code>.</p>
1184<pre> printf '\33]701;%s\007' ja_JP.SJIS
1185
526<pre> 1186</pre>
527 rxvt -fn basefont,font2,font3...</pre> 1187<p>See also the previous answer.</p>
1188<p>Sometimes this capability is rather handy when you want to work in
1189one locale (e.g. <code>de_DE.UTF-8</code>) but some programs don't support it
1190(e.g. UTF-8). For example, I use this script to start <code>xjdic</code>, which
1191first switches to a locale supported by xjdic and back later:</p>
1192<pre> printf '\33]701;%s\007' ja_JP.SJIS
1193 xjdic -js
1194 printf '\33]701;%s\007' de_DE.UTF-8
1195
1196</pre>
1197<p>You can also use xterm's <code>luit</code> program, which usually works fine, except
1198for some locales where character width differs between program- and
1199rxvt-unicode-locales.</p>
1200
1201</div>
1202<h3 id="I_have_problems_getting_my_input_met">I have problems getting my input method working.</h3>
1203<div id="I_have_problems_getting_my_input_met-2">
1204<p>Try a search engine, as this is slightly different for every input method server.</p>
1205<p>Here is a checklist:</p>
1206<dl>
1207 <dt>- Make sure your locale <i>and</i> the imLocale are supported on your OS.</dt>
1208 <dd>
1209 <p>Try <code>locale -a</code> or check the documentation for your OS.</p>
528</dd> 1210 </dd>
1211 <dt>- Make sure your locale or imLocale matches a locale supported by your XIM.</dt>
529<dd> 1212 <dd>
530<p>When rxvt-unicode sees a character, it will first look at the base 1213 <p>For example, <strong>kinput2</strong> does not support UTF-8 locales, you should use
531font. If the base font does not contain the character, it will go to the 1214<code>ja_JP.EUC-JP</code> or equivalent.</p>
532next font, and so on. Specifying your own fonts will also speed up this
533search and use less resources within rxvt-unicode and the X-server.</p>
534</dd> 1215 </dd>
1216 <dt>- Make sure your XIM server is actually running.</dt>
1217 <dt>- Make sure the <code>XMODIFIERS</code> environment variable is set correctly when <i>starting</i> rxvt-unicode.</dt>
535<dd> 1218 <dd>
536<p>The only limitation is that none of the fonts may be larger than the base 1219 <p>When you want to use e.g. <strong>kinput2</strong>, it must be set to
537font, as the base font defines the terminal character cell size, which 1220<code>@im=kinput2</code>. For <strong>scim</strong>, use <code>@im=SCIM</code>. You can see what input
538must be the same due to the way terminals work.</p> 1221method servers are running with this command:</p>
1222<pre> xprop -root XIM_SERVERS
1223
1224</pre>
539</dd> 1225 </dd>
540<p></p> 1226 <dt></dt>
541<dt><strong><a name="item_why_do_some_chinese_characters_look_so_different_t">Why do some chinese characters look so different than others?</a></strong><br />
542</dt> 1227</dl>
543<dd> 1228
544This is because there is a difference between script and language -- 1229</div>
545rxvt-unicode does not know which language the text that is output is, 1230<h3 id="My_input_method_wants_lt_some_encodi">My input method wants &lt;some encoding&gt; but I want UTF-8, what can I do?</h3>
546as it only knows the unicode character codes. If rxvt-unicode first 1231<div id="My_input_method_wants_lt_some_encodi-2">
547sees a japanese/chinese character, it might choose a japanese font for 1232<p>You can specify separate locales for the input method and the rest of the
548display. Subsequent japanese characters will use that font. Now, many 1233terminal, using the resource <code>imlocale</code>:</p>
549chinese characters aren't represented in japanese fonts, so when the first 1234<pre> URxvt.imlocale: ja_JP.EUC-JP
550non-japanese character comes up, rxvt-unicode will look for a chinese font 1235
551-- unfortunately at this point, it will still use the japanese font for 1236</pre>
552chinese characters that are also in the japanese font. 1237<p>Now you can start your terminal with <code>LC_CTYPE=ja_JP.UTF-8</code> and still
553</dd> 1238use your input method. Please note, however, that, depending on your Xlib
554<dd> 1239version, you may not be able to input characters outside <code>EUC-JP</code> in a
555<p>The workaround is easy: just tag a chinese font at the end of your font 1240normal way then, as your input method limits you.</p>
556list (see the previous question). The key is to view the font list as 1241
557a preference list: If you expect more japanese, list a japanese font 1242</div>
558first. If you expect more chinese, put a chinese font first.</p> 1243<h3 id="Rxvt_unicode_crashes_when_the_X_Inpu">Rxvt-unicode crashes when the X Input Method changes or exits.</h3>
559</dd> 1244<div id="Rxvt_unicode_crashes_when_the_X_Inpu-2">
560<dd> 1245<p>Unfortunately, this is unavoidable, as the XIM protocol is racy by
561<p>In the future it might be possible to switch language preferences at 1246design. Applications can avoid some crashes at the expense of memory
562runtime (the internal data structure has no problem with using different 1247leaks, and Input Methods can avoid some crashes by careful ordering at
563fonts for the same character at the same time, but no interface for this 1248exit time. <strong>kinput2</strong> (and derived input methods) generally succeeds,
564has been designed yet).</p> 1249while <strong>SCIM</strong> (or similar input methods) fails. In the end, however,
565</dd> 1250crashes cannot be completely avoided even if both sides cooperate.</p>
566<dd> 1251<p>So the only workaround is not to kill your Input Method Servers.</p>
567<p>Until then, you might get away with switching fonts at runtime (see <a href="#can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a> later in this document).</p> 1252
568</dd> 1253
569<p></p> 1254
570<dt><strong><a name="item_why_does_rxvt_2dunicode_sometimes_leave_pixel_drop">Why does rxvt-unicode sometimes leave pixel droppings?</a></strong><br /> 1255
571</dt> 1256
572<dd> 1257</div>
573Most fonts were not designed for terminal use, which means that character 1258<h2 id="Operating_Systems_Package_Maintainin">Operating Systems / Package Maintaining</h2>
574size varies a lot. A font that is otherwise fine for terminal use might 1259<div id="Operating_Systems_Package_Maintainin-2">
575contain some characters that are simply too wide. Rxvt-unicode will avoid 1260
576these characters. For characters that are just ``a bit'' too wide a special 1261</div>
577``careful'' rendering mode is used that redraws adjacent characters. 1262<h3 id="I_am_using_Debian_GNU_Linux_and_have">I am using Debian GNU/Linux and have a problem...</h3>
578</dd> 1263<div id="I_am_using_Debian_GNU_Linux_and_have-2">
579<dd> 1264<p>The Debian GNU/Linux package of rxvt-unicode in sarge contains large
580<p>All of this requires that fonts do not lie about character sizes, 1265patches that considerably change the behaviour of rxvt-unicode (but
581however: Xft fonts often draw glyphs larger than their acclaimed bounding 1266unfortunately this notice has been removed). Before reporting a bug to
582box, and rxvt-unicode has no way of detecting this (the correct way is to 1267the original rxvt-unicode author please download and install the genuine
583ask for the character bounding box, which unfortunately is wrong in these 1268version (<a href="http://software.schmorp.de#rxvt-unicode">http://software.schmorp.de#rxvt-unicode</a>) and try to reproduce
584cases).</p> 1269the problem. If you cannot, chances are that the problems are specific to
585</dd> 1270Debian GNU/Linux, in which case it should be reported via the Debian Bug
586<dd> 1271Tracking System (use <code>reportbug</code> to report the bug).</p>
587<p>It's not clear (to me at least), wether this is a bug in Xft, freetype, 1272<p>For other problems that also affect the Debian package, you can and
588or the respective font. If you encounter this problem you might try using 1273probably should use the Debian BTS, too, because, after all, it's also a
589the <code>-lsp</code> option to give the font more height. If that doesn't work, you 1274bug in the Debian version and it serves as a reminder for other users that
590might be forced to use a different font.</p> 1275might encounter the same issue.</p>
591</dd> 1276
592<dd> 1277</div>
593<p>All of this is not a problem when using X11 core fonts, as their bounding 1278<h3 id="I_am_maintaining_rxvt_unicode_for_di">I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?</h3>
594box data is correct.</p> 1279<div id="I_am_maintaining_rxvt_unicode_for_di-2">
595</dd> 1280<p>You should build one binary with the default options. <cite>configure</cite>
596<p></p> 1281now enables most useful options, and the trend goes to making them
1282runtime-switchable, too, so there is usually no drawback to enabling them,
1283except higher disk and possibly memory usage. The perl interpreter should
1284be enabled, as important functionality (menus, selection, likely more in
1285the future) depends on it.</p>
1286<p>You should not overwrite the <code>perl-ext-common</code> snd <code>perl-ext</code> resources
1287system-wide (except maybe with <code>defaults</code>). This will result in useful
1288behaviour. If your distribution aims at low memory, add an empty
1289<code>perl-ext-common</code> resource to the app-defaults file. This will keep the
1290perl interpreter disabled until the user enables it.</p>
1291<p>If you can/want build more binaries, I recommend building a minimal
1292one with <code>--disable-everything</code> (very useful) and a maximal one with
1293<code>--enable-everything</code> (less useful, it will be very big due to a lot of
1294encodings built-in that increase download times and are rarely used).</p>
1295
1296</div>
1297<h3 id="I_need_to_make_it_setuid_setgid_to_s">I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?</h3>
1298<div id="I_need_to_make_it_setuid_setgid_to_s-2">
1299<p>It should be, starting with release 7.1. You are encouraged to properly
1300install urxvt with privileges necessary for your OS now.</p>
1301<p>When rxvt-unicode detects that it runs setuid or setgid, it will fork
1302into a helper process for privileged operations (pty handling on some
1303systems, utmp/wtmp/lastlog handling on others) and drop privileges
1304immediately. This is much safer than most other terminals that keep
1305privileges while running (but is more relevant to urxvt, as it contains
1306things as perl interpreters, which might be &quot;helpful&quot; to attackers).</p>
1307<p>This forking is done as the very first within main(), which is very early
1308and reduces possible bugs to initialisation code run before main(), or
1309things like the dynamic loader of your system, which should result in very
1310little risk.</p>
1311
1312</div>
597<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 /> 1313<h3 id="On_Solaris_9_many_line_drawing_chara">On Solaris 9, many line-drawing characters are too wide.</h3>
598</dt> 1314<div id="On_Solaris_9_many_line_drawing_chara-2">
599<dd>
600Seems to be a known bug, read 1315<p>Seems to be a known bug, read
601<a href="http://nixdoc.net/files/forum/about34198.html">http://nixdoc.net/files/forum/about34198.html</a>. Some people use the 1316<a href="http://nixdoc.net/files/forum/about34198.html">http://nixdoc.net/files/forum/about34198.html</a>. Some people use the
602following ugly workaround to get non-double-wide-characters working: 1317following ugly workaround to get non-double-wide-characters working:</p>
603</dd>
604<dd>
605<pre>
606 #define wcwidth(x) wcwidth(x) &gt; 1 ? 1 : wcwidth(x)</pre> 1318<pre> #define wcwidth(x) wcwidth(x) &gt; 1 ? 1 : wcwidth(x)
607</dd> 1319
608<p></p>
609<dt><strong><a name="item_compose">My Compose (Multi_key) key is no longer working.</a></strong><br />
610</dt>
611<dd>
612The most common causes for this are that either your locale is not set
613correctly, or you specified a <strong>preeditStyle</strong> that is not supported by
614your input method. For example, if you specified <strong>OverTheSpot</strong> and
615your input method (e.g. the default input method handling Compose keys)
616does not support this (for instance because it is not visual), then
617rxvt-unicode will continue without an input method.
618</dd>
619<dd>
620<p>In this case either do not specify a <strong>preeditStyle</strong> or specify more than
621one pre-edit style, such as <strong>OverTheSpot,Root,None</strong>.</p>
622</dd>
623<p></p>
624<dt><strong><a name="item_i_cannot_type_ctrl_2dshift_2d2_to_get_an_ascii_nul">I cannot type <code>Ctrl-Shift-2</code> to get an ASCII NUL character due to ISO 14755</a></strong><br />
625</dt>
626<dd>
627Either try <code>Ctrl-2</code> alone (it often is mapped to ASCII NUL even on
628international keyboards) or simply use ISO 14755 support to your
629advantage, typing &lt;Ctrl-Shift-0&gt; to get a ASCII NUL. This works for other
630codes, too, such as <code>Ctrl-Shift-1-d</code> to type the default telnet escape
631character and so on.
632</dd>
633<p></p>
634<dt><strong><a name="item_how_can_i_keep_rxvt_2dunicode_from_using_reverse_v">How can I keep rxvt-unicode from using reverse video so much?</a></strong><br />
635</dt>
636<dd>
637First of all, make sure you are running with the right terminal settings
638(<code>TERM=rxvt-unicode</code>), which will get rid of most of these effects. Then
639make sure you have specified colours for italic and bold, as otherwise
640rxvt-unicode might use reverse video to simulate the effect:
641</dd>
642<dd>
643<pre> 1320</pre>
644 URxvt.colorBD: white 1321
645 URxvt.colorIT: green</pre> 1322</div>
646</dd>
647<p></p>
648<dt><strong><a name="item_colours">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></strong><br />
649</dt>
650<dd>
651For some unexplainable reason, some rare programs assume a very weird
652colour palette when confronted with a terminal with more than the standard
6538 colours (rxvt-unicode supports 88). The right fix is, of course, to fix
654these programs not to assume non-ISO colours without very good reasons.
655</dd>
656<dd>
657<p>In the meantime, you can either edit your <code>rxvt-unicode</code> terminfo
658definition to only claim 8 colour support or use <code>TERM=rxvt</code>, which will
659fix colours but keep you from using other rxvt-unicode features.</p>
660</dd>
661<p></p>
662<dt><strong><a name="item_i_am_on_freebsd_and_rxvt_2dunicode_does_not_seem_t">I am on FreeBSD and rxvt-unicode does not seem to work at all.</a></strong><br /> 1323<h3 id="I_am_on_FreeBSD_and_rxvt_unicode_doe">I am on FreeBSD and rxvt-unicode does not seem to work at all.</h3>
663</dt> 1324<div id="I_am_on_FreeBSD_and_rxvt_unicode_doe-2">
664<dd>
665Rxvt-unicode requires the symbol <code>__STDC_ISO_10646__</code> to be defined 1325<p>Rxvt-unicode requires the symbol <code>__STDC_ISO_10646__</code> to be defined
666in your compile environment, or an implementation that implements it, 1326in your compile environment, or an implementation that implements it,
667wether it defines the symbol or not. <code>__STDC_ISO_10646__</code> requires that 1327whether it defines the symbol or not. <code>__STDC_ISO_10646__</code> requires that
668<strong>wchar_t</strong> is represented as unicode. 1328<strong>wchar_t</strong> is represented as unicode.</p>
669</dd>
670<dd>
671<p>As you might have guessed, FreeBSD does neither define this symobl nor 1329<p>As you might have guessed, FreeBSD does neither define this symbol nor
672does it support it. Instead, it uses it's own internal representation of 1330does it support it. Instead, it uses its own internal representation of
673<strong>wchar_t</strong>. This is, of course, completely fine with respect to standards.</p> 1331<strong>wchar_t</strong>. This is, of course, completely fine with respect to standards.</p>
674</dd>
675<dd>
676<p>However, that means rxvt-unicode only works in <code>POSIX</code>, <code>ISO-8859-1</code> and 1332<p>However, that means rxvt-unicode only works in <code>POSIX</code>, <code>ISO-8859-1</code> and
677<code>UTF-8</code> locales under FreeBSD (which all use Unicode as <strong>wchar_t</strong>.</p> 1333<code>UTF-8</code> locales under FreeBSD (which all use Unicode as <strong>wchar_t</strong>.</p>
678</dd>
679<dd>
680<p><code>__STDC_ISO_10646__</code> is the only sane way to support multi-language 1334<p><code>__STDC_ISO_10646__</code> is the only sane way to support multi-language
681apps in an OS, as using a locale-dependent (and non-standardized) 1335apps in an OS, as using a locale-dependent (and non-standardized)
682representation of <strong>wchar_t</strong> makes it impossible to convert between 1336representation of <strong>wchar_t</strong> makes it impossible to convert between
683<strong>wchar_t</strong> (as used by X11 and your applications) and any other encoding 1337<strong>wchar_t</strong> (as used by X11 and your applications) and any other encoding
684without implementing OS-specific-wrappers for each and every locale. There 1338without implementing OS-specific-wrappers for each and every locale. There
685simply are no APIs to convert <strong>wchar_t</strong> into anything except the current 1339simply are no APIs to convert <strong>wchar_t</strong> into anything except the current
686locale encoding.</p> 1340locale encoding.</p>
687</dd>
688<dd>
689<p>Some applications (such as the formidable <strong>mlterm</strong>) work around this 1341<p>Some applications (such as the formidable <strong>mlterm</strong>) work around this
690by carrying their own replacement functions for character set handling 1342by carrying their own replacement functions for character set handling
691with them, and either implementing OS-dependent hacks or doing multiple 1343with them, and either implementing OS-dependent hacks or doing multiple
692conversions (which is slow and unreliable in case the OS implements 1344conversions (which is slow and unreliable in case the OS implements
693encodings slightly different than the terminal emulator).</p> 1345encodings slightly different than the terminal emulator).</p>
694</dd>
695<dd>
696<p>The rxvt-unicode author insists that the right way to fix this is in the 1346<p>The rxvt-unicode author insists that the right way to fix this is in the
697system libraries once and for all, instead of forcing every app to carry 1347system libraries once and for all, instead of forcing every app to carry
698complete replacements for them :)</p> 1348complete replacements for them :)</p>
699</dd> 1349
700<p></p> 1350</div>
701<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 /> 1351<h3 id="I_use_Solaris_9_and_it_doesn_t_compi">I use Solaris 9 and it doesn't compile/work/etc.</h3>
702</dt> 1352<div id="I_use_Solaris_9_and_it_doesn_t_compi-2">
703<dd>
704Try the diff in <em>doc/solaris9.patch</em> as a base. It fixes the worst 1353<p>Try the diff in <cite>doc/solaris9.patch</cite> as a base. It fixes the worst
705problems with <code>wcwidth</code> and a compile problem. 1354problems with <code>wcwidth</code> and a compile problem.</p>
706</dd> 1355
707<p></p> 1356</div>
708<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 /> 1357<h3 id="How_can_I_use_rxvt_unicode_under_cyg">How can I use rxvt-unicode under cygwin?</h3>
709</dt> 1358<div id="How_can_I_use_rxvt_unicode_under_cyg-2">
710<dd>
711rxvt-unicode should compile and run out of the box on cygwin, using 1359<p>rxvt-unicode should compile and run out of the box on cygwin, using
712the X11 libraries that come with cygwin. libW11 emulation is no 1360the X11 libraries that come with cygwin. libW11 emulation is no
713longer supported (and makes no sense, either, as it only supported a 1361longer supported (and makes no sense, either, as it only supported a
714single font). I recommend starting the X-server in <code>-multiwindow</code> or 1362single font). I recommend starting the X-server in <code>-multiwindow</code> or
715<code>-rootless</code> mode instead, which will result in similar look&amp;feel as the 1363<code>-rootless</code> mode instead, which will result in similar look&amp;feel as the
716old libW11 emulation. 1364old libW11 emulation.</p>
717</dd>
718<dd>
719<p>At the time of this writing, cygwin didn't seem to support any multi-byte 1365<p>At the time of this writing, cygwin didn't seem to support any multi-byte
720encodings (you might try <code>LC_CTYPE=C-UTF-8</code>), so you are likely limited 1366encodings (you might try <code>LC_CTYPE=C-UTF-8</code>), so you are likely limited
721to 8-bit encodings.</p> 1367to 8-bit encodings.</p>
722</dd> 1368
723<p></p> 1369</div>
724<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 /> 1370<h1 id="RXVT_UNICODE_TECHNICAL_REFERENCE">RXVT-UNICODE TECHNICAL REFERENCE</h1><p><a href="#TOP" class="toplink">Top</a></p>
725</dt> 1371<div id="RXVT_UNICODE_TECHNICAL_REFERENCE_CON">
726<dt><strong><a name="item_is_there_an_option_to_switch_encodings_3f">Is there an option to switch encodings?</a></strong><br />
727</dt>
728<dd>
729Unlike some other terminals, rxvt-unicode has no encoding switch, and no
730specific ``utf-8'' mode, such as xterm. In fact, it doesn't even know about
731UTF-8 or any other encodings with respect to terminal I/O.
732</dd>
733<dd>
734<p>The reasons is that there exists a perfectly fine mechanism for selecting
735the encoding, doing I/O and (most important) communicating this to all
736applications so everybody agrees on character properties such as width
737and code number. This mechanism is the <em>locale</em>. Applications not using
738that info will have problems (for example, <code>xterm</code> gets the width of
739characters wrong as it uses it's own, locale-independent table under all
740locales).</p>
741</dd>
742<dd>
743<p>Rxvt-unicode uses the <code>LC_CTYPE</code> locale category to select encoding. All
744programs doing the same (that is, most) will automatically agree in the
745interpretation of characters.</p>
746</dd>
747<dd>
748<p>Unfortunately, there is no system-independent way to select locales, nor
749is there a standard on how locale specifiers will look like.</p>
750</dd>
751<dd>
752<p>On most systems, the content of the <code>LC_CTYPE</code> environment variable
753contains an arbitrary string which corresponds to an already-installed
754locale. Common names for locales are <code>en_US.UTF-8</code>, <code>de_DE.ISO-8859-15</code>,
755<code>ja_JP.EUC-JP</code>, i.e. <code>language_country.encoding</code>, but other forms
756(i.e. <code>de</code> or <code>german</code>) are also common.</p>
757</dd>
758<dd>
759<p>Rxvt-unicode ignores all other locale categories, and except for
760the encoding, ignores country or language-specific settings,
761i.e. <code>de_DE.UTF-8</code> and <code>ja_JP.UTF-8</code> are the normally same to
762rxvt-unicode.</p>
763</dd>
764<dd>
765<p>If you want to use a specific encoding you have to make sure you start
766rxvt-unicode with the correct <code>LC_CTYPE</code> category.</p>
767</dd>
768<p></p>
769<dt><strong><a name="item_can_i_switch_locales_at_runtime_3f">Can I switch locales at runtime?</a></strong><br />
770</dt>
771<dd>
772Yes, using an escape sequence. Try something like this, which sets
773rxvt-unicode's idea of <code>LC_CTYPE</code>.
774</dd>
775<dd>
776<pre>
777 printf '\e]701;%s\007' ja_JP.SJIS</pre>
778</dd>
779<dd>
780<p>See also the previous answer.</p>
781</dd>
782<dd>
783<p>Sometimes this capability is rather handy when you want to work in
784one locale (e.g. <code>de_DE.UTF-8</code>) but some programs don't support it
785(e.g. UTF-8). For example, I use this script to start <code>xjdic</code>, which
786first switches to a locale supported by xjdic and back later:</p>
787</dd>
788<dd>
789<pre>
790 printf '\e]701;%s\007' ja_JP.SJIS
791 xjdic -js
792 printf '\e]701;%s\007' de_DE.UTF-8</pre>
793</dd>
794<dd>
795<p>You can also use xterm's <code>luit</code> program, which usually works fine, except
796for some locales where character width differs between program- and
797rxvt-unicode-locales.</p>
798</dd>
799<p></p>
800<dt><strong><a name="item_can_i_switch_the_fonts_at_runtime_3f">Can I switch the fonts at runtime?</a></strong><br />
801</dt>
802<dd>
803Yes, using an escape sequence. Try something like this, which has the same
804effect as using the <code>-fn</code> switch, and takes effect immediately:
805</dd>
806<dd>
807<pre>
808 printf '\e]50;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre>
809</dd>
810<dd>
811<p>This is useful if you e.g. work primarily with japanese (and prefer a
812japanese font), but you have to switch to chinese temporarily, where
813japanese fonts would only be in your way.</p>
814</dd>
815<dd>
816<p>You can think of this as a kind of manual ISO-2022 switching.</p>
817</dd>
818<p></p>
819<dt><strong><a name="item_why_do_italic_characters_look_as_if_clipped_3f">Why do italic characters look as if clipped?</a></strong><br />
820</dt>
821<dd>
822Many fonts have difficulties with italic characters and hinting. For
823example, the otherwise very nicely hinted font <code>xft:Bitstream Vera Sans
824Mono</code> completely fails in it's italic face. A workaround might be to
825enable freetype autohinting, i.e. like this:
826</dd>
827<dd>
828<pre>
829 URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
830 URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true</pre>
831</dd>
832<p></p>
833<dt><strong><a name="item_my_input_method_wants__3csome_encoding_3e_but_i_wa">My input method wants &lt;some encoding&gt; but I want UTF-8, what can I do?</a></strong><br />
834</dt>
835<dd>
836You can specify separate locales for the input method and the rest of the
837terminal, using the resource <code>imlocale</code>:
838</dd>
839<dd>
840<pre>
841 URxvt.imlocale: ja_JP.EUC-JP</pre>
842</dd>
843<dd>
844<p>Now you can start your terminal with <code>LC_CTYPE=ja_JP.UTF-8</code> and still
845use your input method. Please note, however, that you will not be able to
846input characters outside <code>EUC-JP</code> in a normal way then, as your input
847method limits you.</p>
848</dd>
849<p></p>
850<dt><strong><a name="item_rxvt_2dunicode_crashes_when_the_x_input_method_cha">Rxvt-unicode crashes when the X Input Method changes or exits.</a></strong><br />
851</dt>
852<dd>
853Unfortunately, this is unavoidable, as the XIM protocol is racy by
854design. Applications can avoid some crashes at the expense of memory
855leaks, and Input Methods can avoid some crashes by careful ordering at
856exit time. <strong>kinput2</strong> (and derived input methods) generally succeeds,
857while <strong>SCIM</strong> (or similar input methods) fails. In the end, however,
858crashes cannot be completely avoided even if both sides cooperate.
859</dd>
860<dd>
861<p>So the only workaround is not to kill your Input Method Servers.</p>
862</dd>
863<p></p>
864<dt><strong><a name="item_rxvt_2dunicode_uses_gobs_of_memory_2c_how_can_i_re">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></strong><br />
865</dt>
866<dd>
867Rxvt-unicode tries to obey the rule of not charging you for something you
868don't use. One thing you should try is to configure out all settings that
869you don't need, for example, Xft support is a resource hog by design,
870when used. Compiling it out ensures that no Xft font will be loaded
871accidentally when rxvt-unicode tries to find a font for your characters.
872</dd>
873<dd>
874<p>Also, many people (me included) like large windows and even larger
875scrollback buffers: Without <code>--enable-unicode3</code>, rxvt-unicode will use
8766 bytes per screen cell. For a 160x?? window this amounts to almost a
877kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
878use 10 Megabytes of memory. With <code>--enable-unicode3</code> it gets worse, as
879rxvt-unicode then uses 8 bytes per screen cell.</p>
880</dd>
881<p></p>
882<dt><strong><a name="item_can_i_speed_up_xft_rendering_somehow_3f">Can I speed up Xft rendering somehow?</a></strong><br />
883</dt>
884<dd>
885Yes, the most obvious way to speed it up is to avoid Xft entirely, as
886it is simply slow. If you still want Xft fonts you might try to disable
887antialiasing (by appending <code>:antialias=false</code>), which saves lots of
888memory and also speeds up rendering considerably.
889</dd>
890<p></p>
891<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 />
892</dt>
893<dd>
894Rxvt-unicode will use whatever you specify as a font. If it needs to
895fall back to it's default font search list it will prefer X11 core
896fonts, because they are small and fast, and then use Xft fonts. It has
897antialiasing disabled for most of them, because the author thinks they
898look best that way.
899</dd>
900<dd>
901<p>If you want antialiasing, you have to specify the fonts manually.</p>
902</dd>
903<p></p>
904<dt><strong><a name="item_mouse_cut_2fpaste_suddenly_no_longer_works_2e">Mouse cut/paste suddenly no longer works.</a></strong><br />
905</dt>
906<dd>
907Make sure that mouse reporting is actually turned off since killing
908some editors prematurely may leave the mouse in mouse report mode. I've
909heard that tcsh may use mouse reporting unless it otherwise specified. A
910quick check is to see if cut/paste works when the Alt or Shift keys are
911depressed.
912</dd>
913<p></p>
914<dt><strong><a name="item_what_27s_with_this_bold_2fblink_stuff_3f">What's with this bold/blink stuff?</a></strong><br />
915</dt>
916<dd>
917If no bold colour is set via <code>colorBD:</code>, bold will invert text using the
918standard foreground colour.
919</dd>
920<dd>
921<p>For the standard background colour, blinking will actually make the
922text blink when compiled with <code>--enable-blinking</code>. with standard
923colours. Without <code>--enable-blinking</code>, the blink attribute will be
924ignored.</p>
925</dd>
926<dd>
927<p>On ANSI colours, bold/blink attributes are used to set high-intensity
928foreground/background colors.</p>
929</dd>
930<dd>
931<p>color0-7 are the low-intensity colors.</p>
932</dd>
933<dd>
934<p>color8-15 are the corresponding high-intensity colors.</p>
935</dd>
936<p></p>
937<dt><strong><a name="item_i_don_27t_like_the_screen_colors_2e_how_do_i_chang">I don't like the screen colors. How do I change them?</a></strong><br />
938</dt>
939<dd>
940You can change the screen colors at run-time using <em>~/.Xdefaults</em>
941resources (or as long-options).
942</dd>
943<dd>
944<p>Here are values that are supposed to resemble a VGA screen,
945including the murky brown that passes for low-intensity yellow:</p>
946</dd>
947<dd>
948<pre>
949 URxvt.color0: #000000
950 URxvt.color1: #A80000
951 URxvt.color2: #00A800
952 URxvt.color3: #A8A800
953 URxvt.color4: #0000A8
954 URxvt.color5: #A800A8
955 URxvt.color6: #00A8A8
956 URxvt.color7: #A8A8A8</pre>
957</dd>
958<dd>
959<pre>
960 URxvt.color8: #000054
961 URxvt.color9: #FF0054
962 URxvt.color10: #00FF54
963 URxvt.color11: #FFFF54
964 URxvt.color12: #0000FF
965 URxvt.color13: #FF00FF
966 URxvt.color14: #00FFFF
967 URxvt.color15: #FFFFFF</pre>
968</dd>
969<dd>
970<p>And here is a more complete set of non-standard colors described (not by
971me) as ``pretty girly''.</p>
972</dd>
973<dd>
974<pre>
975 URxvt.cursorColor: #dc74d1
976 URxvt.pointerColor: #dc74d1
977 URxvt.background: #0e0e0e
978 URxvt.foreground: #4ad5e1
979 URxvt.color0: #000000
980 URxvt.color8: #8b8f93
981 URxvt.color1: #dc74d1
982 URxvt.color9: #dc74d1
983 URxvt.color2: #0eb8c7
984 URxvt.color10: #0eb8c7
985 URxvt.color3: #dfe37e
986 URxvt.color11: #dfe37e
987 URxvt.color5: #9e88f0
988 URxvt.color13: #9e88f0
989 URxvt.color6: #73f7ff
990 URxvt.color14: #73f7ff
991 URxvt.color7: #e1dddd
992 URxvt.color15: #e1dddd</pre>
993</dd>
994<p></p>
995<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 />
996</dt>
997<dd>
998Try <code>rxvtd -f -o</code>, which tells rxvtd to open the
999display, create the listening socket and then fork.
1000</dd>
1001<p></p>
1002<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 />
1003</dt>
1004<dd>
1005Assuming that the physical Backspace key corresponds to the
1006BackSpace keysym (not likely for Linux ... see the following
1007question) there are two standard values that can be used for
1008Backspace: <code>^H</code> and <code>^?</code>.
1009</dd>
1010<dd>
1011<p>Historically, either value is correct, but rxvt-unicode adopts the debian
1012policy of using <code>^?</code> when unsure, because it's the one only only correct
1013choice :).</p>
1014</dd>
1015<dd>
1016<p>Rxvt-unicode tries to inherit the current stty settings and uses the value
1017of `erase' to guess the value for backspace. If rxvt-unicode wasn't
1018started from a terminal (say, from a menu or by remote shell), then the
1019system value of `erase', which corresponds to CERASE in &lt;termios.h&gt;, will
1020be used (which may not be the same as your stty setting).</p>
1021</dd>
1022<dd>
1023<p>For starting a new rxvt-unicode:</p>
1024</dd>
1025<dd>
1026<pre>
1027 # use Backspace = ^H
1028 $ stty erase ^H
1029 $ rxvt</pre>
1030</dd>
1031<dd>
1032<pre>
1033 # use Backspace = ^?
1034 $ stty erase ^?
1035 $ rxvt</pre>
1036</dd>
1037<dd>
1038<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code>.</p>
1039</dd>
1040<dd>
1041<p>For an existing rxvt-unicode:</p>
1042</dd>
1043<dd>
1044<pre>
1045 # use Backspace = ^H
1046 $ stty erase ^H
1047 $ echo -n &quot;^[[36h&quot;</pre>
1048</dd>
1049<dd>
1050<pre>
1051 # use Backspace = ^?
1052 $ stty erase ^?
1053 $ echo -n &quot;^[[36l&quot;</pre>
1054</dd>
1055<dd>
1056<p>This helps satisfy some of the Backspace discrepancies that occur, but
1057if you use Backspace = <code>^H</code>, make sure that the termcap/terminfo value
1058properly reflects that.</p>
1059</dd>
1060<dd>
1061<p>The Delete key is a another casualty of the ill-defined Backspace problem.
1062To avoid confusion between the Backspace and Delete keys, the Delete
1063key has been assigned an escape sequence to match the vt100 for Execute
1064(<code>ESC [ 3 ~</code>) and is in the supplied termcap/terminfo.</p>
1065</dd>
1066<dd>
1067<p>Some other Backspace problems:</p>
1068</dd>
1069<dd>
1070<p>some editors use termcap/terminfo,
1071some editors (vim I'm told) expect Backspace = ^H,
1072GNU Emacs (and Emacs-like editors) use ^H for help.</p>
1073</dd>
1074<dd>
1075<p>Perhaps someday this will all be resolved in a consistent manner.</p>
1076</dd>
1077<p></p>
1078<dt><strong><a name="item_i_don_27t_like_the_key_2dbindings_2e_how_do_i_chan">I don't like the key-bindings. How do I change them?</a></strong><br />
1079</dt>
1080<dd>
1081There are some compile-time selections available via configure. Unless
1082you have run ``configure'' with the <a href="#item__2d_2ddisable_2dresources"><code>--disable-resources</code></a> option you can
1083use the `keysym' resource to alter the keystrings associated with keysyms.
1084</dd>
1085<dd>
1086<p>Here's an example for a URxvt session started using <code>rxvt -name URxvt</code></p>
1087</dd>
1088<dd>
1089<pre>
1090 URxvt.keysym.Home: \033[1~
1091 URxvt.keysym.End: \033[4~
1092 URxvt.keysym.C-apostrophe: \033&lt;C-'&gt;
1093 URxvt.keysym.C-slash: \033&lt;C-/&gt;
1094 URxvt.keysym.C-semicolon: \033&lt;C-;&gt;
1095 URxvt.keysym.C-grave: \033&lt;C-`&gt;
1096 URxvt.keysym.C-comma: \033&lt;C-,&gt;
1097 URxvt.keysym.C-period: \033&lt;C-.&gt;
1098 URxvt.keysym.C-0x60: \033&lt;C-`&gt;
1099 URxvt.keysym.C-Tab: \033&lt;C-Tab&gt;
1100 URxvt.keysym.C-Return: \033&lt;C-Return&gt;
1101 URxvt.keysym.S-Return: \033&lt;S-Return&gt;
1102 URxvt.keysym.S-space: \033&lt;S-Space&gt;
1103 URxvt.keysym.M-Up: \033&lt;M-Up&gt;
1104 URxvt.keysym.M-Down: \033&lt;M-Down&gt;
1105 URxvt.keysym.M-Left: \033&lt;M-Left&gt;
1106 URxvt.keysym.M-Right: \033&lt;M-Right&gt;
1107 URxvt.keysym.M-C-0: list \033&lt;M-C- 0123456789 &gt;
1108 URxvt.keysym.M-C-a: list \033&lt;M-C- abcdefghijklmnopqrstuvwxyz &gt;
1109 URxvt.keysym.F12: command:\033]701;zh_CN.GBK\007</pre>
1110</dd>
1111<dd>
1112<p>See some more examples in the documentation for the <strong>keysym</strong> resource.</p>
1113</dd>
1114<p></p>
1115<dt><strong><a name="item_i_27m_using_keyboard_model_xxx_that_has_extra_prio">I'm using keyboard model XXX that has extra Prior/Next/Insert keys.
1116How do I make use of them? For example, the Sun Keyboard type 4
1117has the following mappings that rxvt-unicode doesn't recognize.</a></strong><br />
1118</dt>
1119<dd>
1120<pre>
1121 KP_Insert == Insert
1122 F22 == Print
1123 F27 == Home
1124 F29 == Prior
1125 F33 == End
1126 F35 == Next</pre>
1127</dd>
1128<dd>
1129<p>Rather than have rxvt-unicode try to accommodate all the various possible
1130keyboard mappings, it is better to use `xmodmap' to remap the keys as
1131required for your particular machine.</p>
1132</dd>
1133<dt><strong><a name="item_how_do_i_distinguish_wether_i_27m_running_rxvt_2du">How do I distinguish wether I'm running rxvt-unicode or a regular xterm?
1134I need this to decide about setting colors etc.</a></strong><br />
1135</dt>
1136<dd>
1137rxvt and rxvt-unicode always export the variable ``COLORTERM'', so you can
1138check and see if that is set. Note that several programs, JED, slrn,
1139Midnight Commander automatically check this variable to decide whether or
1140not to use color.
1141</dd>
1142<p></p>
1143<dt><strong><a name="item_how_do_i_set_the_correct_2c_full_ip_address_for_th">How do I set the correct, full IP address for the DISPLAY variable?</a></strong><br />
1144</dt>
1145<dd>
1146If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
1147insecure mode then it is possible to use the following shell script
1148snippets to correctly set the display. If your version of rxvt-unicode
1149wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then
1150the COLORTERM variable can be used to distinguish rxvt-unicode from a
1151regular xterm.
1152</dd>
1153<dd>
1154<p>Courtesy of Chuck Blake &lt;<a href="mailto:cblake@BBN.COM">cblake@BBN.COM</a>&gt; with the following shell script
1155snippets:</p>
1156</dd>
1157<dd>
1158<pre>
1159 # Bourne/Korn/POSIX family of shells:
1160 [ ${TERM:-foo} = foo ] &amp;&amp; TERM=xterm # assume an xterm if we don't know
1161 if [ ${TERM:-foo} = xterm ]; then
1162 stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
1163 echo -n '^[Z'
1164 read term_id
1165 stty icanon echo
1166 if [ &quot;&quot;${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
1167 echo -n '^[[7n' # query the rxvt we are in for the DISPLAY string
1168 read DISPLAY # set it in our local shell
1169 fi
1170 fi</pre>
1171</dd>
1172<p></p>
1173<dt><strong><a name="item_how_do_i_compile_the_manual_pages_for_myself_3f">How do I compile the manual pages for myself?</a></strong><br />
1174</dt>
1175<dd>
1176You need to have a recent version of perl installed as <em>/usr/bin/perl</em>,
1177one that comes with <em>pod2man</em>, <em>pod2text</em> and <em>pod2html</em>. Then go to
1178the doc subdirectory and enter <code>make alldoc</code>.
1179</dd>
1180<p></p>
1181<dt><strong><a name="item_my_question_isn_27t_answered_here_2c_can_i_ask_a_h">My question isn't answered here, can I ask a human?</a></strong><br />
1182</dt>
1183<dd>
1184Before sending me mail, you could go to IRC: <code>irc.freenode.net</code>,
1185channel <code>#rxvt-unicode</code> has some rxvt-unicode enthusiasts that might be
1186interested in learning about new and exciting problems (but not FAQs :).
1187</dd>
1188<p></p></dl>
1189<p>
1190</p>
1191<hr />
1192<h1><a name="rxvt_technical_reference">RXVT TECHNICAL REFERENCE</a></h1>
1193<p>
1194</p>
1195<hr />
1196<h1><a name="description">DESCRIPTION</a></h1>
1197<p>The rest of this document describes various technical aspects of 1372<p>The rest of this document describes various technical aspects of
1198<strong>rxvt-unicode</strong>. First the description of supported command sequences, 1373<strong>rxvt-unicode</strong>. First the description of supported command sequences,
1199followed by pixmap support and last by a description of all features 1374followed by pixmap support and last by a description of all features
1200selectable at <code>configure</code> time.</p> 1375selectable at <code>configure</code> time.</p>
1201<p> 1376
1202</p> 1377</div>
1203<hr /> 1378<h2 id="Definitions">Definitions</h2>
1204<h1><a name="definitions">Definitions</a></h1> 1379<div id="Definitions_CONTENT">
1205<dl> 1380<dl>
1206<dt><strong><a name="item_c"><strong><code>c</code> </strong>&gt;</a></strong><br /> 1381 <dt><strong><code>c</code></strong></dt>
1207</dt>
1208<dd> 1382 <dd>
1209The literal character c. 1383 <p>The literal character c.</p>
1210</dd> 1384 </dd>
1211<p></p> 1385 <dt><strong><code>C</code></strong></dt>
1212<dt><strong><a name="item_c"><strong><code>C</code> </strong>&gt;</a></strong><br />
1213</dt>
1214<dd> 1386 <dd>
1215A single (required) character. 1387 <p>A single (required) character.</p>
1216</dd> 1388 </dd>
1217<p></p> 1389 <dt><strong><code>Ps</code></strong></dt>
1218<dt><strong><a name="item_ps"><strong><code>Ps</code> </strong>&gt;</a></strong><br />
1219</dt>
1220<dd> 1390 <dd>
1221A single (usually optional) numeric parameter, composed of one or more 1391 <p>A single (usually optional) numeric parameter, composed of one or more
1222digits. 1392digits.</p>
1223</dd> 1393 </dd>
1224<p></p> 1394 <dt><strong><code>Pm</code></strong></dt>
1225<dt><strong><a name="item_pm"><strong><code>Pm</code> </strong>&gt;</a></strong><br />
1226</dt>
1227<dd> 1395 <dd>
1228A multiple numeric parameter composed of any number of single numeric 1396 <p>A multiple numeric parameter composed of any number of single numeric
1229parameters, separated by <code>;</code> character(s). 1397parameters, separated by <code>;</code> character(s).</p>
1230</dd> 1398 </dd>
1231<p></p> 1399 <dt><strong><code>Pt</code></strong></dt>
1232<dt><strong><a name="item_pt"><strong><code>Pt</code> </strong>&gt;</a></strong><br />
1233</dt>
1234<dd> 1400 <dd>
1235A text parameter composed of printable characters. 1401 <p>A text parameter composed of printable characters.</p>
1236</dd> 1402 </dd>
1237<p></p></dl> 1403</dl>
1238<p> 1404
1239</p> 1405</div>
1240<hr /> 1406<h2 id="Values">Values</h2>
1241<h1><a name="values">Values</a></h1> 1407<div id="Values_CONTENT">
1242<dl> 1408<dl>
1243<dt><strong><a name="item_enq"><strong><code>ENQ</code> </strong>&gt;</a></strong><br /> 1409 <dt><strong><code>ENQ</code></strong></dt>
1244</dt>
1245<dd> 1410 <dd>
1246Enquiry (Ctrl-E) = Send Device Attributes (DA) 1411 <p>Enquiry (Ctrl-E) = Send Device Attributes (DA)
1247request attributes from terminal. See <strong><a href="#item_esc__5b_ps_c"><code>ESC [ Ps c</code></a> </strong>&gt;. 1412request attributes from terminal. See <strong><code>ESC [ Ps c</code></strong>.</p>
1248</dd> 1413 </dd>
1249<p></p> 1414 <dt><strong><code>BEL</code></strong></dt>
1250<dt><strong><a name="item_bel"><strong><code>BEL</code> </strong>&gt;</a></strong><br />
1251</dt>
1252<dd> 1415 <dd>
1253Bell (Ctrl-G) 1416 <p>Bell (Ctrl-G)</p>
1254</dd> 1417 </dd>
1255<p></p> 1418 <dt><strong><code>BS</code></strong></dt>
1256<dt><strong><a name="item_bs"><strong><code>BS</code> </strong>&gt;</a></strong><br />
1257</dt>
1258<dd> 1419 <dd>
1259Backspace (Ctrl-H) 1420 <p>Backspace (Ctrl-H)</p>
1260</dd> 1421 </dd>
1261<p></p> 1422 <dt><strong><code>TAB</code></strong></dt>
1262<dt><strong><a name="item_tab"><strong><code>TAB</code> </strong>&gt;</a></strong><br />
1263</dt>
1264<dd> 1423 <dd>
1265Horizontal Tab (HT) (Ctrl-I) 1424 <p>Horizontal Tab (HT) (Ctrl-I)</p>
1266</dd> 1425 </dd>
1267<p></p> 1426 <dt><strong><code>LF</code></strong></dt>
1268<dt><strong><a name="item_lf"><strong><code>LF</code> </strong>&gt;</a></strong><br />
1269</dt>
1270<dd> 1427 <dd>
1271Line Feed or New Line (NL) (Ctrl-J) 1428 <p>Line Feed or New Line (NL) (Ctrl-J)</p>
1272</dd> 1429 </dd>
1273<p></p> 1430 <dt><strong><code>VT</code></strong></dt>
1274<dt><strong><a name="item_vt"><strong><code>VT</code> </strong>&gt;</a></strong><br />
1275</dt>
1276<dd> 1431 <dd>
1277Vertical Tab (Ctrl-K) same as <strong><a href="#item_lf"><code>LF</code></a> </strong>&gt; 1432 <p>Vertical Tab (Ctrl-K) same as <strong><code>LF</code></strong></p>
1278</dd> 1433 </dd>
1279<p></p> 1434 <dt><strong><code>FF</code></strong></dt>
1280<dt><strong><a name="item_ff"><strong><code>FF</code> </strong>&gt;</a></strong><br />
1281</dt>
1282<dd> 1435 <dd>
1283Form Feed or New Page (NP) (Ctrl-L) same as <strong><a href="#item_lf"><code>LF</code></a> </strong>&gt; 1436 <p>Form Feed or New Page (NP) (Ctrl-L) same as <strong><code>LF</code></strong></p>
1284</dd> 1437 </dd>
1285<p></p> 1438 <dt><strong><code>CR</code></strong></dt>
1286<dt><strong><a name="item_cr"><strong><code>CR</code> </strong>&gt;</a></strong><br />
1287</dt>
1288<dd> 1439 <dd>
1289Carriage Return (Ctrl-M) 1440 <p>Carriage Return (Ctrl-M)</p>
1290</dd> 1441 </dd>
1291<p></p> 1442 <dt><strong><code>SO</code></strong></dt>
1292<dt><strong><a name="item_so"><strong><code>SO</code> </strong>&gt;</a></strong><br />
1293</dt>
1294<dd> 1443 <dd>
1295Shift Out (Ctrl-N), invokes the G1 character set. 1444 <p>Shift Out (Ctrl-N), invokes the G1 character set.
1296Switch to Alternate Character Set 1445Switch to Alternate Character Set</p>
1297</dd> 1446 </dd>
1298<p></p> 1447 <dt><strong><code>SI</code></strong></dt>
1299<dt><strong><a name="item_si"><strong><code>SI</code> </strong>&gt;</a></strong><br />
1300</dt>
1301<dd> 1448 <dd>
1302Shift In (Ctrl-O), invokes the G0 character set (the default). 1449 <p>Shift In (Ctrl-O), invokes the G0 character set (the default).
1303Switch to Standard Character Set 1450Switch to Standard Character Set</p>
1304</dd> 1451 </dd>
1305<p></p> 1452 <dt><strong><code>SPC</code></strong></dt>
1306<dt><strong><a name="item_spc"><strong><code>SPC</code> </strong>&gt;</a></strong><br />
1307</dt>
1308<dd> 1453 <dd>
1309Space Character 1454 <p>Space Character</p>
1310</dd> 1455 </dd>
1311<p></p></dl> 1456</dl>
1312<p> 1457
1313</p> 1458</div>
1314<hr />
1315<h1><a name="escape_sequences">Escape Sequences</a></h1> 1459<h2 id="Escape_Sequences">Escape Sequences</h2>
1460<div id="Escape_Sequences_CONTENT">
1316<dl> 1461<dl>
1317<dt><strong><a name="item_esc__23_8"><strong><code>ESC # 8</code> </strong>&gt;</a></strong><br /> 1462 <dt><strong><code>ESC # 8</code></strong></dt>
1318</dt>
1319<dd> 1463 <dd>
1320DEC Screen Alignment Test (DECALN) 1464 <p>DEC Screen Alignment Test (DECALN)</p>
1321</dd> 1465 </dd>
1322<p></p> 1466 <dt><strong><code>ESC 7</code></strong></dt>
1323<dt><strong><a name="item_esc_7"><strong><code>ESC 7</code> </strong>&gt;</a></strong><br />
1324</dt>
1325<dd> 1467 <dd>
1326Save Cursor (SC) 1468 <p>Save Cursor (SC)</p>
1327</dd> 1469 </dd>
1328<p></p> 1470 <dt><strong><code>ESC 8</code></strong></dt>
1329<dt><strong><a name="item_esc_8"><strong><code>ESC 8</code> </strong>&gt;</a></strong><br />
1330</dt>
1331<dd> 1471 <dd>
1332Restore Cursor 1472 <p>Restore Cursor</p>
1333</dd> 1473 </dd>
1334<p></p> 1474 <dt><strong><code>ESC =</code></strong></dt>
1335<dt><strong><a name="item_esc__3d"><strong><code>ESC =</code> </strong>&gt;</a></strong><br />
1336</dt>
1337<dd> 1475 <dd>
1338Application Keypad (SMKX). See also next sequence. 1476 <p>Application Keypad (SMKX). See also next sequence.</p>
1339</dd> 1477 </dd>
1340<p></p> 1478 <dt><strong><code>ESC</code></strong></dt>
1341<dt><strong><a name="item_esc"><strong><code>ESC</code> </strong>&gt;&gt;</a></strong><br />
1342</dt>
1343<dd> 1479 <dd>
1344Normal Keypad (RMKX) 1480 <p>Normal Keypad (RMKX)</p>
1345</dd>
1346<dd>
1347<p><strong>Note:</strong> If the numeric keypad is activated, eg, <strong>Num_Lock</strong> has been 1481 <p><strong>Note:</strong> If the numeric keypad is activated, eg, <strong>Num_Lock</strong> has been
1348pressed, numbers or control functions are generated by the numeric keypad 1482pressed, numbers or control functions are generated by the numeric keypad
1349(see Key Codes).</p> 1483(see Key Codes).</p>
1350</dd> 1484 </dd>
1351<p></p> 1485 <dt><strong><code>ESC D</code></strong></dt>
1352<dt><strong><a name="item_esc_d"><strong><code>ESC D</code> </strong>&gt;</a></strong><br />
1353</dt>
1354<dd> 1486 <dd>
1355Index (IND) 1487 <p>Index (IND)</p>
1356</dd> 1488 </dd>
1357<p></p> 1489 <dt><strong><code>ESC E</code></strong></dt>
1358<dt><strong><a name="item_esc_e"><strong><code>ESC E</code> </strong>&gt;</a></strong><br />
1359</dt>
1360<dd> 1490 <dd>
1361Next Line (NEL) 1491 <p>Next Line (NEL)</p>
1362</dd> 1492 </dd>
1363<p></p> 1493 <dt><strong><code>ESC H</code></strong></dt>
1364<dt><strong><a name="item_esc_h"><strong><code>ESC H</code> </strong>&gt;</a></strong><br />
1365</dt>
1366<dd> 1494 <dd>
1367Tab Set (HTS) 1495 <p>Tab Set (HTS)</p>
1368</dd> 1496 </dd>
1369<p></p> 1497 <dt><strong><code>ESC M</code></strong></dt>
1370<dt><strong><a name="item_esc_m"><strong><code>ESC M</code> </strong>&gt;</a></strong><br />
1371</dt>
1372<dd> 1498 <dd>
1373Reverse Index (RI) 1499 <p>Reverse Index (RI)</p>
1374</dd> 1500 </dd>
1375<p></p> 1501 <dt><strong><code>ESC N</code></strong></dt>
1376<dt><strong><a name="item_esc_n"><strong><code>ESC N</code> </strong>&gt;</a></strong><br />
1377</dt>
1378<dd> 1502 <dd>
1379Single Shift Select of G2 Character Set (SS2): affects next character 1503 <p>Single Shift Select of G2 Character Set (SS2): affects next character
1380only <em>unimplemented</em> 1504only <i>unimplemented</i></p>
1381</dd> 1505 </dd>
1382<p></p> 1506 <dt><strong><code>ESC O</code></strong></dt>
1383<dt><strong><a name="item_esc_o"><strong><code>ESC O</code> </strong>&gt;</a></strong><br />
1384</dt>
1385<dd> 1507 <dd>
1386Single Shift Select of G3 Character Set (SS3): affects next character 1508 <p>Single Shift Select of G3 Character Set (SS3): affects next character
1387only <em>unimplemented</em> 1509only <i>unimplemented</i></p>
1388</dd> 1510 </dd>
1389<p></p> 1511 <dt><strong><code>ESC Z</code></strong></dt>
1390<dt><strong><a name="item_esc_z"><strong><code>ESC Z</code> </strong>&gt;</a></strong><br />
1391</dt>
1392<dd> 1512 <dd>
1393Obsolete form of returns: <strong><code>ESC [ ? 1 ; 2 C</code> </strong>&gt; <em>rxvt-unicode compile-time option</em> 1513 <p>Obsolete form of returns: <strong><code>ESC [ ? 1 ; 2 C</code></strong> <i>rxvt-unicode compile-time option</i></p>
1394</dd> 1514 </dd>
1395<p></p> 1515 <dt><strong><code>ESC c</code></strong></dt>
1396<dt><strong><a name="item_esc_c"><strong><code>ESC c</code> </strong>&gt;</a></strong><br />
1397</dt>
1398<dd> 1516 <dd>
1399Full reset (RIS) 1517 <p>Full reset (RIS)</p>
1400</dd> 1518 </dd>
1401<p></p> 1519 <dt><strong><code>ESC n</code></strong></dt>
1402<dt><strong><a name="item_esc_n"><strong><code>ESC n</code> </strong>&gt;</a></strong><br />
1403</dt>
1404<dd> 1520 <dd>
1405Invoke the G2 Character Set (LS2) 1521 <p>Invoke the G2 Character Set (LS2)</p>
1406</dd> 1522 </dd>
1407<p></p> 1523 <dt><strong><code>ESC o</code></strong></dt>
1408<dt><strong><a name="item_esc_o"><strong><code>ESC o</code> </strong>&gt;</a></strong><br />
1409</dt>
1410<dd> 1524 <dd>
1411Invoke the G3 Character Set (LS3) 1525 <p>Invoke the G3 Character Set (LS3)</p>
1412</dd> 1526 </dd>
1413<p></p>
1414<dt><strong><strong><code>ESC ( C</code> </strong>&gt;</strong><br /> 1527 <dt><strong><code>ESC ( C</code></strong></dt>
1415</dt>
1416<dd> 1528 <dd>
1417Designate G0 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>. 1529 <p>Designate G0 Character Set (ISO 2022), see below for values of <code>C</code>.</p>
1418</dd> 1530 </dd>
1419<p></p> 1531 <dt><strong><code>ESC ) C</code></strong></dt>
1420<dt><strong><a name="item_esc__29_c"><strong><code>ESC ) C</code> </strong>&gt;</a></strong><br />
1421</dt>
1422<dd> 1532 <dd>
1423Designate G1 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>. 1533 <p>Designate G1 Character Set (ISO 2022), see below for values of <code>C</code>.</p>
1424</dd> 1534 </dd>
1425<p></p> 1535 <dt><strong><code>ESC * C</code></strong></dt>
1426<dt><strong><a name="item_esc__2a_c"><strong><code>ESC * C</code> </strong>&gt;</a></strong><br />
1427</dt>
1428<dd> 1536 <dd>
1429Designate G2 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>. 1537 <p>Designate G2 Character Set (ISO 2022), see below for values of <code>C</code>.</p>
1430</dd> 1538 </dd>
1431<p></p> 1539 <dt><strong><code>ESC + C</code></strong></dt>
1432<dt><strong><a name="item_esc__2b_c"><strong><code>ESC + C</code> </strong>&gt;</a></strong><br />
1433</dt>
1434<dd> 1540 <dd>
1435Designate G3 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>. 1541 <p>Designate G3 Character Set (ISO 2022), see below for values of <code>C</code>.</p>
1436</dd> 1542 </dd>
1437<p></p> 1543 <dt><strong><code>ESC $ C</code></strong></dt>
1438<dt><strong><a name="item_esc__24_c"><strong><code>ESC $ C</code> </strong>&gt;</a></strong><br />
1439</dt>
1440<dd> 1544 <dd>
1441Designate Kanji Character Set 1545 <p>Designate Kanji Character Set</p>
1546 <p>Where <strong><code>C</code></strong> is one of:</p>
1442</dd> 1547 </dd>
1443<dd>
1444<p>Where <strong><a href="#item_c"><code>C</code></a> </strong>&gt; is one of:</p>
1445</dd> 1548</dl>
1446<table> 1549<p><span id="CSI">CSI</span></p>
1447<tr><td>C = 0 </td><td>DEC Special Character and Line Drawing Set</td></tr> 1550
1448<tr><td>C = A </td><td>United Kingdom (UK)</td></tr> 1551</div>
1449<tr><td>C = B </td><td>United States (USASCII)</td></tr>
1450<tr><td>C = <</td><td>Multinational character set unimplemented</td></tr>
1451<tr><td>C = 5 </td><td>Finnish character set unimplemented</td></tr>
1452<tr><td>C = C </td><td>Finnish character set unimplemented</td></tr>
1453<tr><td>C = K </td><td>German character set unimplemented</td></tr>
1454</table><p></p></dl>
1455<p></p>
1456<p>
1457</p>
1458<hr />
1459<h1><a name="csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></h1> 1552<h2 id="CSI_Command_Sequence_Introducer_Sequ">CSI (Command Sequence Introducer) Sequences</h2>
1553<div id="CSI_Command_Sequence_Introducer_Sequ-2">
1460<dl> 1554<dl>
1461<dt><strong><a name="item_esc__5b_ps__40"><strong><code>ESC [ Ps @</code> </strong>&gt;</a></strong><br /> 1555 <dt><strong><code>ESC [ Ps @</code></strong></dt>
1462</dt>
1463<dd> 1556 <dd>
1464Insert <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; (Blank) <code>Character(s)</code> [default: 1] (ICH) 1557 <p>Insert <strong><code>Ps</code></strong> (Blank) Character(s) [default: 1] (ICH)<span id="ESCOBPsA">ESCOBPsA</span></p>
1465</dd> 1558 </dd>
1466<p></p> 1559 <dt><strong><code>ESC [ Ps A</code></strong></dt>
1467<dt><strong><a name="item_esc__5b_ps_a"><strong><code>ESC [ Ps A</code> </strong>&gt;</a></strong><br />
1468</dt>
1469<dd> 1560 <dd>
1470Cursor Up <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] (CUU) 1561 <p>Cursor Up <strong><code>Ps</code></strong> Times [default: 1] (CUU)</p>
1471</dd> 1562 </dd>
1472<p></p> 1563 <dt><strong><code>ESC [ Ps B</code></strong></dt>
1473<dt><strong><a name="item_esc__5b_ps_b"><strong><code>ESC [ Ps B</code> </strong>&gt;</a></strong><br />
1474</dt>
1475<dd> 1564 <dd>
1476Cursor Down <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] (CUD) 1565 <p>Cursor Down <strong><code>Ps</code></strong> Times [default: 1] (CUD)<span id="ESCOBPsC">ESCOBPsC</span></p>
1477</dd> 1566 </dd>
1478<p></p> 1567 <dt><strong><code>ESC [ Ps C</code></strong></dt>
1479<dt><strong><a name="item_esc__5b_ps_c"><strong><code>ESC [ Ps C</code> </strong>&gt;</a></strong><br />
1480</dt>
1481<dd> 1568 <dd>
1482Cursor Forward <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] (CUF) 1569 <p>Cursor Forward <strong><code>Ps</code></strong> Times [default: 1] (CUF)</p>
1483</dd> 1570 </dd>
1484<p></p> 1571 <dt><strong><code>ESC [ Ps D</code></strong></dt>
1485<dt><strong><a name="item_esc__5b_ps_d"><strong><code>ESC [ Ps D</code> </strong>&gt;</a></strong><br />
1486</dt>
1487<dd> 1572 <dd>
1488Cursor Backward <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] (CUB) 1573 <p>Cursor Backward <strong><code>Ps</code></strong> Times [default: 1] (CUB)</p>
1489</dd> 1574 </dd>
1490<p></p> 1575 <dt><strong><code>ESC [ Ps E</code></strong></dt>
1491<dt><strong><a name="item_esc__5b_ps_e"><strong><code>ESC [ Ps E</code> </strong>&gt;</a></strong><br />
1492</dt>
1493<dd> 1576 <dd>
1494Cursor Down <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] and to first column 1577 <p>Cursor Down <strong><code>Ps</code></strong> Times [default: 1] and to first column</p>
1495</dd> 1578 </dd>
1496<p></p> 1579 <dt><strong><code>ESC [ Ps F</code></strong></dt>
1497<dt><strong><a name="item_esc__5b_ps_f"><strong><code>ESC [ Ps F</code> </strong>&gt;</a></strong><br />
1498</dt>
1499<dd> 1580 <dd>
1500Cursor Up <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] and to first column 1581 <p>Cursor Up <strong><code>Ps</code></strong> Times [default: 1] and to first column<span id="ESCOBPsG">ESCOBPsG</span></p>
1501</dd> 1582 </dd>
1502<p></p> 1583 <dt><strong><code>ESC [ Ps G</code></strong></dt>
1503<dt><strong><a name="item_esc__5b_ps_g"><strong><code>ESC [ Ps G</code> </strong>&gt;</a></strong><br />
1504</dt>
1505<dd> 1584 <dd>
1506Cursor to Column <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; (HPA) 1585 <p>Cursor to Column <strong><code>Ps</code></strong> (HPA)</p>
1507</dd> 1586 </dd>
1508<p></p> 1587 <dt><strong><code>ESC [ Ps;Ps H</code></strong></dt>
1509<dt><strong><a name="item_esc__5b_ps_3bps_h"><strong><code>ESC [ Ps;Ps H</code> </strong>&gt;</a></strong><br />
1510</dt>
1511<dd> 1588 <dd>
1512Cursor Position [row;column] [default: 1;1] (CUP) 1589 <p>Cursor Position [row;column] [default: 1;1] (CUP)</p>
1513</dd> 1590 </dd>
1514<p></p> 1591 <dt><strong><code>ESC [ Ps I</code></strong></dt>
1515<dt><strong><a name="item_esc__5b_ps_i"><strong><code>ESC [ Ps I</code> </strong>&gt;</a></strong><br />
1516</dt>
1517<dd> 1592 <dd>
1518Move forward <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; tab stops [default: 1] 1593 <p>Move forward <strong><code>Ps</code></strong> tab stops [default: 1]</p>
1519</dd> 1594 </dd>
1520<p></p> 1595 <dt><strong><code>ESC [ Ps J</code></strong></dt>
1521<dt><strong><a name="item_esc__5b_ps_j"><strong><code>ESC [ Ps J</code> </strong>&gt;</a></strong><br />
1522</dt>
1523<dd> 1596 <dd>
1524Erase in Display (ED) 1597 <p>Erase in Display (ED)</p>
1525</dd> 1598 </dd>
1526<table> 1599 <dt><strong><code>ESC [ Ps K</code></strong></dt>
1527<tr><td>Ps = 0</td><td>Clear Below (default)</td></tr>
1528<tr><td>Ps = 1</td><td>Clear Above</td></tr>
1529<tr><td>Ps = 2</td><td>Clear All</td></tr>
1530</table><p></p>
1531<dt><strong><a name="item_esc__5b_ps_k"><strong><code>ESC [ Ps K</code> </strong>&gt;</a></strong><br />
1532</dt>
1533<dd> 1600 <dd>
1534Erase in Line (EL) 1601 <p>Erase in Line (EL)</p>
1535</dd> 1602 </dd>
1536<table> 1603 <dt><strong><code>ESC [ Ps L</code></strong></dt>
1537<tr><td>Ps = 0</td><td>Clear to Right (default)</td></tr>
1538<tr><td>Ps = 1</td><td>Clear to Left</td></tr>
1539<tr><td>Ps = 2</td><td>Clear All</td></tr>
1540</table><p></p>
1541<dt><strong><a name="item_esc__5b_ps_l"><strong><code>ESC [ Ps L</code> </strong>&gt;</a></strong><br />
1542</dt>
1543<dd> 1604 <dd>
1544Insert <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; <code>Line(s)</code> [default: 1] (IL) 1605 <p>Insert <strong><code>Ps</code></strong> Line(s) [default: 1] (IL)</p>
1545</dd> 1606 </dd>
1546<p></p> 1607 <dt><strong><code>ESC [ Ps M</code></strong></dt>
1547<dt><strong><a name="item_esc__5b_ps_m"><strong><code>ESC [ Ps M</code> </strong>&gt;</a></strong><br />
1548</dt>
1549<dd> 1608 <dd>
1550Delete <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; <code>Line(s)</code> [default: 1] (DL) 1609 <p>Delete <strong><code>Ps</code></strong> Line(s) [default: 1] (DL)</p>
1551</dd> 1610 </dd>
1552<p></p> 1611 <dt><strong><code>ESC [ Ps P</code></strong></dt>
1553<dt><strong><a name="item_esc__5b_ps_p"><strong><code>ESC [ Ps P</code> </strong>&gt;</a></strong><br />
1554</dt>
1555<dd> 1612 <dd>
1556Delete <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; <code>Character(s)</code> [default: 1] (DCH) 1613 <p>Delete <strong><code>Ps</code></strong> Character(s) [default: 1] (DCH)</p>
1557</dd> 1614 </dd>
1558<p></p> 1615 <dt><strong><code>ESC [ Ps;Ps;Ps;Ps;Ps T</code></strong></dt>
1559<dt><strong><a name="item_esc__5b_ps_3bps_3bps_3bps_3bps_t"><strong><code>ESC [ Ps;Ps;Ps;Ps;Ps T</code> </strong>&gt;</a></strong><br />
1560</dt>
1561<dd> 1616 <dd>
1562Initiate . <em>unimplemented</em> Parameters are 1617 <p>Initiate . <i>unimplemented</i> Parameters are
1563[func;startx;starty;firstrow;lastrow]. 1618[func;startx;starty;firstrow;lastrow].</p>
1564</dd> 1619 </dd>
1565<p></p> 1620 <dt><strong><code>ESC [ Ps W</code></strong></dt>
1566<dt><strong><a name="item_esc__5b_ps_w"><strong><code>ESC [ Ps W</code> </strong>&gt;</a></strong><br />
1567</dt>
1568<dd> 1621 <dd>
1569Tabulator functions 1622 <p>Tabulator functions</p>
1570</dd> 1623 </dd>
1571<table> 1624 <dt><strong><code>ESC [ Ps X</code></strong></dt>
1572<tr><td>Ps = 0</td><td>Tab Set (HTS)</td></tr>
1573<tr><td>Ps = 2</td><td>Tab Clear (TBC), Clear Current Column (default)</td></tr>
1574<tr><td>Ps = 5</td><td>Tab Clear (TBC), Clear All</td></tr>
1575</table><p></p>
1576<dt><strong><a name="item_esc__5b_ps_x"><strong><code>ESC [ Ps X</code> </strong>&gt;</a></strong><br />
1577</dt>
1578<dd> 1625 <dd>
1579Erase <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; <code>Character(s)</code> [default: 1] (ECH) 1626 <p>Erase <strong><code>Ps</code></strong> Character(s) [default: 1] (ECH)</p>
1580</dd> 1627 </dd>
1581<p></p> 1628 <dt><strong><code>ESC [ Ps Z</code></strong></dt>
1582<dt><strong><a name="item_esc__5b_ps_z"><strong><code>ESC [ Ps Z</code> </strong>&gt;</a></strong><br />
1583</dt>
1584<dd> 1629 <dd>
1585Move backward <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; [default: 1] tab stops 1630 <p>Move backward <strong><code>Ps</code></strong> [default: 1] tab stops</p>
1586</dd> 1631 </dd>
1587<p></p> 1632 <dt><strong><code>ESC [ Ps '</code></strong></dt>
1588<dt><strong><a name="item_esc__5b_ps__27"><strong><code>ESC [ Ps '</code> </strong>&gt;</a></strong><br />
1589</dt>
1590<dd> 1633 <dd>
1591See <strong><a href="#item_esc__5b_ps_g"><code>ESC [ Ps G</code></a> </strong>&gt; 1634 <p>See <strong><code>ESC [ Ps G</code></strong></p>
1592</dd> 1635 </dd>
1593<p></p> 1636 <dt><strong><code>ESC [ Ps a</code></strong></dt>
1594<dt><strong><a name="item_esc__5b_ps_a"><strong><code>ESC [ Ps a</code> </strong>&gt;</a></strong><br />
1595</dt>
1596<dd> 1637 <dd>
1597See <strong><a href="#item_esc__5b_ps_c"><code>ESC [ Ps C</code></a> </strong>&gt; 1638 <p>See <strong><code>ESC [ Ps C</code></strong></p>
1598</dd> 1639 </dd>
1599<p></p> 1640 <dt><strong><code>ESC [ Ps c</code></strong></dt>
1600<dt><strong><a name="item_esc__5b_ps_c"><strong><code>ESC [ Ps c</code> </strong>&gt;</a></strong><br />
1601</dt>
1602<dd> 1641 <dd>
1603Send Device Attributes (DA) 1642 <p>Send Device Attributes (DA)
1604<strong><code>Ps = 0</code> </strong>&gt; (or omitted): request attributes from terminal 1643<strong><code>Ps = 0</code></strong> (or omitted): request attributes from terminal
1605returns: <strong><code>ESC [ ? 1 ; 2 c</code> </strong>&gt; (``I am a VT100 with Advanced Video 1644returns: <strong><code>ESC [ ? 1 ; 2 c</code></strong> (``I am a VT100 with Advanced Video
1606Option'') 1645Option'')</p>
1607</dd> 1646 </dd>
1608<p></p> 1647 <dt><strong><code>ESC [ Ps d</code></strong></dt>
1609<dt><strong><a name="item_esc__5b_ps_d"><strong><code>ESC [ Ps d</code> </strong>&gt;</a></strong><br />
1610</dt>
1611<dd> 1648 <dd>
1612Cursor to Line <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; (VPA) 1649 <p>Cursor to Line <strong><code>Ps</code></strong> (VPA)</p>
1613</dd> 1650 </dd>
1614<p></p> 1651 <dt><strong><code>ESC [ Ps e</code></strong></dt>
1615<dt><strong><a name="item_esc__5b_ps_e"><strong><code>ESC [ Ps e</code> </strong>&gt;</a></strong><br />
1616</dt>
1617<dd> 1652 <dd>
1618See <strong><a href="#item_esc__5b_ps_a"><code>ESC [ Ps A</code></a> </strong>&gt; 1653 <p>See <strong><code>ESC [ Ps A</code></strong></p>
1619</dd> 1654 </dd>
1620<p></p> 1655 <dt><strong><code>ESC [ Ps;Ps f</code></strong></dt>
1621<dt><strong><a name="item_esc__5b_ps_3bps_f"><strong><code>ESC [ Ps;Ps f</code> </strong>&gt;</a></strong><br />
1622</dt>
1623<dd> 1656 <dd>
1624Horizontal and Vertical Position [row;column] (HVP) [default: 1;1] 1657 <p>Horizontal and Vertical Position [row;column] (HVP) [default: 1;1]</p>
1625</dd> 1658 </dd>
1626<p></p> 1659 <dt><strong><code>ESC [ Ps g</code></strong></dt>
1627<dt><strong><a name="item_esc__5b_ps_g"><strong><code>ESC [ Ps g</code> </strong>&gt;</a></strong><br />
1628</dt>
1629<dd> 1660 <dd>
1630Tab Clear (TBC) 1661 <p>Tab Clear (TBC)</p>
1631</dd> 1662 </dd>
1632<table> 1663 <dt><strong><code>ESC [ Pm h</code></strong></dt>
1633<tr><td>Ps = 0</td><td>Clear Current Column (default)</td></tr>
1634<tr><td>Ps = 3</td><td>Clear All (TBC)</td></tr>
1635</table><p></p>
1636<dt><strong><a name="item_esc__5b_pm_h"><strong><code>ESC [ Pm h</code> </strong>&gt;</a></strong><br />
1637</dt>
1638<dd> 1664 <dd>
1639Set Mode (SM). See <strong><a href="#item_esc__5b_pm_l"><code>ESC [ Pm l</code></a> </strong>&gt; sequence for description of <a href="#item_pm"><code>Pm</code></a>. 1665 <p>Set Mode (SM). See <strong><code>ESC [ Pm l</code></strong> sequence for description of <code>Pm</code>.</p>
1640</dd> 1666 </dd>
1641<p></p> 1667 <dt><strong><code>ESC [ Ps i</code></strong></dt>
1642<dt><strong><a name="item_esc__5b_ps_i"><strong><code>ESC [ Ps i</code> </strong>&gt;</a></strong><br />
1643</dt>
1644<dd> 1668 <dd>
1645Printing. See also the <code>print-pipe</code> resource. 1669 <p>Printing. See also the <code>print-pipe</code> resource.</p>
1646</dd> 1670 </dd>
1647<table> 1671 <dt><strong><code>ESC [ Pm l</code></strong></dt>
1648<tr><td>Ps = 0</td><td>print screen (MC0)</td></tr>
1649<tr><td>Ps = 4</td><td>disable transparent print mode (MC4)</td></tr>
1650<tr><td>Ps = 5</td><td>enable transparent print mode (MC5)</td></tr>
1651</table><p></p>
1652<dt><strong><a name="item_esc__5b_pm_l"><strong><code>ESC [ Pm l</code> </strong>&gt;</a></strong><br />
1653</dt>
1654<dd> 1672 <dd>
1655Reset Mode (RM) 1673 <p>Reset Mode (RM)</p>
1674 <p>
1675 <dl>
1676 <dt><strong><code>Ps = 4</code></strong></dt>
1677 <dt><strong><code>Ps = 20</code></strong> (partially implemented)</dt>
1678 </dl>
1679 </p>
1656</dd> 1680 </dd>
1681 <dt><strong><code>ESC [ Pm m</code></strong></dt>
1682 <dd>
1683 <p>Character Attributes (SGR)</p>
1684 </dd>
1685 <dt><strong><code>ESC [ Ps n</code></strong></dt>
1686 <dd>
1687 <p>Device Status Report (DSR)</p>
1688 </dd>
1689 <dt><strong><code>ESC [ Ps;Ps r</code></strong></dt>
1690 <dd>
1691 <p>Set Scrolling Region [top;bottom]
1692[default: full size of window] (CSR)</p>
1693 </dd>
1694 <dt><strong><code>ESC [ s</code></strong></dt>
1695 <dd>
1696 <p>Save Cursor (SC)</p>
1697 </dd>
1698 <dt><strong><code>ESC [ Ps;Pt t</code></strong></dt>
1699 <dd>
1700 <p>Window Operations</p>
1701 </dd>
1702 <dt><strong><code>ESC [ u</code></strong></dt>
1703 <dd>
1704 <p>Restore Cursor</p>
1705 </dd>
1706 <dt><strong><code>ESC [ Ps x</code></strong></dt>
1707 <dd>
1708 <p>Request Terminal Parameters (DECREQTPARM)</p>
1709 </dd>
1710</dl>
1711<p><span id="PrivateModes">PrivateModes</span></p>
1712
1713</div>
1714<h2 id="DEC_Private_Modes">DEC Private Modes</h2>
1715<div id="DEC_Private_Modes_CONTENT">
1657<dl> 1716<dl>
1658<dt><strong><a name="item_ps__3d_4"><strong><code>Ps = 4</code> </strong>&gt;</a></strong><br /> 1717 <dt><strong><code>ESC [ ? Pm h</code></strong></dt>
1659</dt>
1660<table>
1661<tr><td>h</td><td>Insert Mode (SMIR)</td></tr>
1662<tr><td>l</td><td>Replace Mode (RMIR)</td></tr>
1663</table><dt><strong><a name="item_20"><strong><code>Ps = 20</code> </strong>&gt; (partially implemented)</a></strong><br />
1664</dt>
1665<table>
1666<tr><td>h</td><td>Automatic Newline (LNM)</td></tr>
1667<tr><td>l</td><td>Normal Linefeed (LNM)</td></tr>
1668</table></dl>
1669<dt><strong><a name="item_esc__5b_pm_m"><strong><code>ESC [ Pm m</code> </strong>&gt;</a></strong><br />
1670</dt>
1671<dd> 1718 <dd>
1672Character Attributes (SGR) 1719 <p>DEC Private Mode Set (DECSET)</p>
1673</dd> 1720 </dd>
1674<table> 1721 <dt><strong><code>ESC [ ? Pm l</code></strong></dt>
1675<tr><td>Ps = 0</td><td>Normal (default)</td></tr>
1676<tr><td>Ps = 1 / 21</td><td>On / Off Bold (bright fg)</td></tr>
1677<tr><td>Ps = 3 / 23</td><td>On / Off Italic</td></tr>
1678<tr><td>Ps = 4 / 24</td><td>On / Off Underline</td></tr>
1679<tr><td>Ps = 5 / 25</td><td>On / Off Slow Blink (bright bg)</td></tr>
1680<tr><td>Ps = 6 / 26</td><td>On / Off Rapid Blink (bright bg)</td></tr>
1681<tr><td>Ps = 7 / 27</td><td>On / Off Inverse</td></tr>
1682<tr><td>Ps = 8 / 27</td><td>On / Off Invisible (NYI)</td></tr>
1683<tr><td>Ps = 30 / 40</td><td>fg/bg Black</td></tr>
1684<tr><td>Ps = 31 / 41</td><td>fg/bg Red</td></tr>
1685<tr><td>Ps = 32 / 42</td><td>fg/bg Green</td></tr>
1686<tr><td>Ps = 33 / 43</td><td>fg/bg Yellow</td></tr>
1687<tr><td>Ps = 34 / 44</td><td>fg/bg Blue</td></tr>
1688<tr><td>Ps = 35 / 45</td><td>fg/bg Magenta</td></tr>
1689<tr><td>Ps = 36 / 46</td><td>fg/bg Cyan</td></tr>
1690<tr><td>Ps = 38;5 / 48;5</td><td>set fg/bg to color #m (ISO 8613-6)</td></tr>
1691<tr><td>Ps = 37 / 47</td><td>fg/bg White</td></tr>
1692<tr><td>Ps = 39 / 49</td><td>fg/bg Default</td></tr>
1693<tr><td>Ps = 90 / 100</td><td>fg/bg Bright Black</td></tr>
1694<tr><td>Ps = 91 / 101</td><td>fg/bg Bright Red</td></tr>
1695<tr><td>Ps = 92 / 102</td><td>fg/bg Bright Green</td></tr>
1696<tr><td>Ps = 93 / 103</td><td>fg/bg Bright Yellow</td></tr>
1697<tr><td>Ps = 94 / 104</td><td>fg/bg Bright Blue</td></tr>
1698<tr><td>Ps = 95 / 105</td><td>fg/bg Bright Magenta</td></tr>
1699<tr><td>Ps = 96 / 106</td><td>fg/bg Bright Cyan</td></tr>
1700<tr><td>Ps = 97 / 107</td><td>fg/bg Bright White</td></tr>
1701<tr><td>Ps = 99 / 109</td><td>fg/bg Bright Default</td></tr>
1702</table><p></p>
1703<dt><strong><a name="item_esc__5b_ps_n"><strong><code>ESC [ Ps n</code> </strong>&gt;</a></strong><br />
1704</dt>
1705<dd> 1722 <dd>
1706Device Status Report (DSR) 1723 <p>DEC Private Mode Reset (DECRST)</p>
1707</dd> 1724 </dd>
1708<table> 1725 <dt><strong><code>ESC [ ? Pm r</code></strong></dt>
1709<tr><td>Ps = 5</td><td>Status Report ESC [ 0 n (``OK'')</td></tr>
1710<tr><td>Ps = 6</td><td>Report Cursor Position (CPR) [row;column] as ESC [ r ; c R</td></tr>
1711<tr><td>Ps = 7</td><td>Request Display Name</td></tr>
1712<tr><td>Ps = 8</td><td>Request Version Number (place in window title)</td></tr>
1713</table><p></p>
1714<dt><strong><a name="item_esc__5b_ps_3bps_r"><strong><code>ESC [ Ps;Ps r</code> </strong>&gt;</a></strong><br />
1715</dt>
1716<dd> 1726 <dd>
1717Set Scrolling Region [top;bottom] 1727 <p>Restore previously saved DEC Private Mode Values.</p>
1718[default: full size of window] (CSR)
1719</dd> 1728 </dd>
1720<p></p> 1729 <dt><strong><code>ESC [ ? Pm s</code></strong></dt>
1721<dt><strong><a name="item_esc__5b_s"><strong><code>ESC [ s</code> </strong>&gt;</a></strong><br />
1722</dt>
1723<dd> 1730 <dd>
1724Save Cursor (SC) 1731 <p>Save DEC Private Mode Values.</p>
1725</dd> 1732 </dd>
1726<p></p> 1733 <dt><strong><code>ESC [ ? Pm t</code></strong></dt>
1727<dt><strong><a name="item_esc__5b_ps_3bpt_t"><strong><code>ESC [ Ps;Pt t</code> </strong>&gt;</a></strong><br />
1728</dt>
1729<dd> 1734 <dd>
1730Window Operations 1735 <p>Toggle DEC Private Mode Values (rxvt extension). <i>where</i></p>
1736 <p>
1737 <dl>
1738 <dt><strong><code>Pm = 1</code></strong> (DECCKM)</dt>
1739 <dt><strong><code>Pm = 2</code></strong> (ANSI/VT52 mode)</dt>
1740 <dt><strong><code>Pm = 3</code></strong></dt>
1741 <dt><strong><code>Pm = 4</code></strong></dt>
1742 <dt><strong><code>Pm = 5</code></strong></dt>
1743 <dt><strong><code>Pm = 6</code></strong></dt>
1744 <dt><strong><code>Pm = 7</code></strong></dt>
1745 <dt><strong><code>Pm = 8</code></strong> <i>unimplemented</i></dt>
1746 <dt><strong><code>Pm = 9</code></strong> X10 XTerm</dt>
1747 <dt><strong><code>Pm = 25</code></strong></dt>
1748 <dt><strong><code>Pm = 30</code></strong></dt>
1749 <dt><strong><code>Pm = 35</code></strong> (<strong>rxvt</strong>)</dt>
1750 <dt><strong><code>Pm = 38</code></strong> <i>unimplemented</i></dt>
1751 <dd>
1752 <p>Enter Tektronix Mode (DECTEK)</p>
1753 </dd>
1754 <dt><strong><code>Pm = 40</code></strong></dt>
1755 <dt><strong><code>Pm = 44</code></strong> <i>unimplemented</i></dt>
1756 <dt><strong><code>Pm = 45</code></strong> <i>unimplemented</i></dt>
1757 <dt><strong><code>Pm = 46</code></strong> <i>unimplemented</i></dt>
1758 <dt><strong><code>Pm = 47</code></strong></dt>
1759 <dd>
1760 <p><span id="Priv66">Priv66</span></p>
1761 </dd>
1762 <dt><strong><code>Pm = 66</code></strong></dt>
1763 <dt><strong><code>Pm = 67</code></strong></dt>
1764 <dt><strong><code>Pm = 1000</code></strong> (X11 XTerm)</dt>
1765 <dt><strong><code>Pm = 1001</code></strong> (X11 XTerm) <i>unimplemented</i></dt>
1766 <dt><strong><code>Pm = 1010</code></strong> (<strong>rxvt</strong>)</dt>
1767 <dt><strong><code>Pm = 1011</code></strong> (<strong>rxvt</strong>)</dt>
1768 <dt><strong><code>Pm = 1021</code></strong> (<strong>rxvt</strong>)</dt>
1769 <dt><strong><code>Pm = 1047</code></strong></dt>
1770 <dt><strong><code>Pm = 1048</code></strong></dt>
1771 <dt><strong><code>Pm = 1049</code></strong></dt>
1772 </dl>
1773 </p>
1731</dd> 1774 </dd>
1732<table>
1733<tr><td>Ps = 1</td><td>Deiconify (map) window</td></tr>
1734<tr><td>Ps = 2</td><td>Iconify window</td></tr>
1735<tr><td>Ps = 3</td><td>ESC [ 3 ; X ; Y t Move window to (X|Y)</td></tr>
1736<tr><td>Ps = 4</td><td>ESC [ 4 ; H ; W t Resize to WxH pixels</td></tr>
1737<tr><td>Ps = 5</td><td>Raise window</td></tr>
1738<tr><td>Ps = 6</td><td>Lower window</td></tr>
1739<tr><td>Ps = 7</td><td>Refresh screen once</td></tr>
1740<tr><td>Ps = 8</td><td>ESC [ 8 ; R ; C t Resize to R rows and C columns</td></tr>
1741<tr><td>Ps = 11</td><td>Report window state (responds with Ps = 1 or Ps = 2)</td></tr>
1742<tr><td>Ps = 13</td><td>Report window position (responds with Ps = 3)</td></tr>
1743<tr><td>Ps = 14</td><td>Report window pixel size (responds with Ps = 4)</td></tr>
1744<tr><td>Ps = 18</td><td>Report window text size (responds with Ps = 7)</td></tr>
1745<tr><td>Ps = 19</td><td>Currently the same as Ps = 18, but responds with Ps = 9</td></tr>
1746<tr><td>Ps = 20</td><td>Reports icon label (ESC ] L NAME \234)</td></tr>
1747<tr><td>Ps = 21</td><td>Reports window title (ESC ] l NAME \234)</td></tr>
1748<tr><td>Ps = 24..</td><td>Set window height to Ps rows</td></tr>
1749</table><p></p>
1750<dt><strong><a name="item_esc__5b_u"><strong><code>ESC [ u</code> </strong>&gt;</a></strong><br />
1751</dt> 1775</dl>
1752<dd> 1776<p><span id="XTerm">XTerm</span></p>
1753Restore Cursor 1777
1754</dd> 1778</div>
1755<p></p> 1779<h2 id="XTerm_Operating_System_Commands">XTerm Operating System Commands</h2>
1756<dt><strong><a name="item_esc__5b_ps_x"><strong><code>ESC [ Ps x</code> </strong>&gt;</a></strong><br /> 1780<div id="XTerm_Operating_System_Commands_CONT">
1757</dt>
1758<dd>
1759Request Terminal Parameters (DECREQTPARM)
1760</dd>
1761<p></p></dl>
1762<p></p>
1763<p>
1764</p>
1765<hr />
1766<h1><a name="dec_private_modes">DEC Private Modes</a></h1>
1767<dl> 1781<dl>
1768<dt><strong><a name="item_esc__5b__3f_pm_h"><strong><code>ESC [ ? Pm h</code> </strong>&gt;</a></strong><br /> 1782 <dt><strong><code>ESC ] Ps;Pt ST</code></strong></dt>
1769</dt>
1770<dd> 1783 <dd>
1771DEC Private Mode Set (DECSET) 1784 <p>Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b,
17850x5c), backwards compatible terminator BEL (0x07) is also accepted. any
1786<strong>octet</strong> can be escaped by prefixing it with SYN (0x16, ^V).</p>
1772</dd> 1787 </dd>
1773<p></p>
1774<dt><strong><a name="item_esc__5b__3f_pm_l"><strong><code>ESC [ ? Pm l</code> </strong>&gt;</a></strong><br />
1775</dt>
1776<dd>
1777DEC Private Mode Reset (DECRST)
1778</dd>
1779<p></p>
1780<dt><strong><a name="item_esc__5b__3f_pm_r"><strong><code>ESC [ ? Pm r</code> </strong>&gt;</a></strong><br />
1781</dt>
1782<dd>
1783Restore previously saved DEC Private Mode Values.
1784</dd>
1785<p></p>
1786<dt><strong><a name="item_esc__5b__3f_pm_s"><strong><code>ESC [ ? Pm s</code> </strong>&gt;</a></strong><br />
1787</dt>
1788<dd>
1789Save DEC Private Mode Values.
1790</dd>
1791<p></p>
1792<dt><strong><a name="item_esc__5b__3f_pm_t"><strong><code>ESC [ ? Pm t</code> </strong>&gt;</a></strong><br />
1793</dt>
1794<dd>
1795Toggle DEC Private Mode Values (rxvt extension). <em>where</em>
1796</dd>
1797<dl>
1798<dt><strong><a name="item_1"><strong><code>Ps = 1</code> </strong>&gt; (DECCKM)</a></strong><br />
1799</dt>
1800<table>
1801<tr><td>h</td><td>Application Cursor Keys</td></tr>
1802<tr><td>l</td><td>Normal Cursor Keys</td></tr>
1803</table><dt><strong><a name="item_2"><strong><code>Ps = 2</code> </strong>&gt; (ANSI/VT52 mode)</a></strong><br />
1804</dt>
1805<table>
1806<tr><td>h</td><td>Enter VT52 mode</td></tr>
1807<tr><td>l</td><td>Enter VT52 mode</td></tr>
1808</table><dt><strong><a name="item_ps__3d_3"><strong><code>Ps = 3</code> </strong>&gt;</a></strong><br />
1809</dt>
1810<table>
1811<tr><td>h</td><td>132 Column Mode (DECCOLM)</td></tr>
1812<tr><td>l</td><td>80 Column Mode (DECCOLM)</td></tr>
1813</table><dt><strong><strong><code>Ps = 4</code> </strong>&gt;</strong><br />
1814</dt>
1815<table>
1816<tr><td>h</td><td>Smooth (Slow) Scroll (DECSCLM)</td></tr>
1817<tr><td>l</td><td>Jump (Fast) Scroll (DECSCLM)</td></tr>
1818</table><dt><strong><a name="item_ps__3d_5"><strong><code>Ps = 5</code> </strong>&gt;</a></strong><br />
1819</dt>
1820<table>
1821<tr><td>h</td><td>Reverse Video (DECSCNM)</td></tr>
1822<tr><td>l</td><td>Normal Video (DECSCNM)</td></tr>
1823</table><dt><strong><a name="item_ps__3d_6"><strong><code>Ps = 6</code> </strong>&gt;</a></strong><br />
1824</dt>
1825<table>
1826<tr><td>h</td><td>Origin Mode (DECOM)</td></tr>
1827<tr><td>l</td><td>Normal Cursor Mode (DECOM)</td></tr>
1828</table><dt><strong><a name="item_ps__3d_7"><strong><code>Ps = 7</code> </strong>&gt;</a></strong><br />
1829</dt>
1830<table>
1831<tr><td>h</td><td>Wraparound Mode (DECAWM)</td></tr>
1832<tr><td>l</td><td>No Wraparound Mode (DECAWM)</td></tr>
1833</table><dt><strong><a name="item_ps__3d_8_unimplemented"><strong><code>Ps = 8</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1834</dt>
1835<table>
1836<tr><td>h</td><td>Auto-repeat Keys (DECARM)</td></tr>
1837<tr><td>l</td><td>No Auto-repeat Keys (DECARM)</td></tr>
1838</table><dt><strong><a name="item_ps__3d_9_x10_xterm"><strong><code>Ps = 9</code> </strong>&gt; X10 XTerm</a></strong><br />
1839</dt>
1840<table>
1841<tr><td>h</td><td>Send Mouse X & Y on button press.</td></tr>
1842<tr><td>l</td><td>No mouse reporting.</td></tr>
1843</table><dt><strong><a name="item_ps__3d_25"><strong><code>Ps = 25</code> </strong>&gt;</a></strong><br />
1844</dt>
1845<table>
1846<tr><td>h</td><td>Visible cursor {cnorm/cvvis}</td></tr>
1847<tr><td>l</td><td>Invisible cursor {civis}</td></tr>
1848</table><dt><strong><a name="item_ps__3d_30"><strong><code>Ps = 30</code> </strong>&gt;</a></strong><br />
1849</dt>
1850<table>
1851<tr><td>h</td><td>scrollBar visisble</td></tr>
1852<tr><td>l</td><td>scrollBar invisisble</td></tr>
1853</table><dt><strong><a name="item_35"><strong><code>Ps = 35</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1854</dt>
1855<table>
1856<tr><td>h</td><td>Allow XTerm Shift+key sequences</td></tr>
1857<tr><td>l</td><td>Disallow XTerm Shift+key sequences</td></tr>
1858</table><dt><strong><a name="item_ps__3d_38_unimplemented"><strong><code>Ps = 38</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1859</dt>
1860<dd>
1861Enter Tektronix Mode (DECTEK)
1862</dd>
1863<p></p>
1864<dt><strong><a name="item_ps__3d_40"><strong><code>Ps = 40</code> </strong>&gt;</a></strong><br />
1865</dt>
1866<table>
1867<tr><td>h</td><td>Allow 80/132 Mode</td></tr>
1868<tr><td>l</td><td>Disallow 80/132 Mode</td></tr>
1869</table><dt><strong><a name="item_ps__3d_44_unimplemented"><strong><code>Ps = 44</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1870</dt>
1871<table>
1872<tr><td>h</td><td>Turn On Margin Bell</td></tr>
1873<tr><td>l</td><td>Turn Off Margin Bell</td></tr>
1874</table><dt><strong><a name="item_ps__3d_45_unimplemented"><strong><code>Ps = 45</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1875</dt>
1876<table>
1877<tr><td>h</td><td>Reverse-wraparound Mode</td></tr>
1878<tr><td>l</td><td>No Reverse-wraparound Mode</td></tr>
1879</table><dt><strong><a name="item_ps__3d_46_unimplemented"><strong><code>Ps = 46</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1880</dt>
1881<dt><strong><a name="item_ps__3d_47"><strong><code>Ps = 47</code> </strong>&gt;</a></strong><br />
1882</dt>
1883<table>
1884<tr><td>h</td><td>Use Alternate Screen Buffer</td></tr>
1885<tr><td>l</td><td>Use Normal Screen Buffer</td></tr>
1886</table><p></p>
1887<dt><strong><a name="item_ps__3d_66"><strong><code>Ps = 66</code> </strong>&gt;</a></strong><br />
1888</dt>
1889<table>
1890<tr><td>h</td><td>Application Keypad (DECPAM) == ESC =</td></tr>
1891<tr><td>l</td><td>Normal Keypad (DECPNM) == ESC ></td></tr>
1892</table><dt><strong><a name="item_ps__3d_67"><strong><code>Ps = 67</code> </strong>&gt;</a></strong><br />
1893</dt>
1894<table>
1895<tr><td>h</td><td>Backspace key sends BS (DECBKM)</td></tr>
1896<tr><td>l</td><td>Backspace key sends DEL</td></tr>
1897</table><dt><strong><a name="item_1000"><strong><code>Ps = 1000</code> </strong>&gt; (X11 XTerm)</a></strong><br />
1898</dt>
1899<table>
1900<tr><td>h</td><td>Send Mouse X & Y on button press and release.</td></tr>
1901<tr><td>l</td><td>No mouse reporting.</td></tr>
1902</table><dt><strong><a name="item_1001"><strong><code>Ps = 1001</code> </strong>&gt; (X11 XTerm) <em>unimplemented</em></a></strong><br />
1903</dt>
1904<table>
1905<tr><td>h</td><td>Use Hilite Mouse Tracking.</td></tr>
1906<tr><td>l</td><td>No mouse reporting.</td></tr>
1907</table><dt><strong><a name="item_1010"><strong><code>Ps = 1010</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1908</dt>
1909<table>
1910<tr><td>h</td><td>Don't scroll to bottom on TTY output</td></tr>
1911<tr><td>l</td><td>Scroll to bottom on TTY output</td></tr>
1912</table><dt><strong><a name="item_1011"><strong><code>Ps = 1011</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1913</dt>
1914<table>
1915<tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr>
1916<tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr>
1917</table><dt><strong><a name="item_1021"><strong><code>Ps = 1021</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1918</dt>
1919<table>
1920<tr><td>h</td><td>Bold/italic implies high intensity (see option -is)</td></tr>
1921<tr><td>l</td><td>Font styles have no effect on intensity (Compile styles)</td></tr>
1922</table><dt><strong><a name="item_ps__3d_1047"><strong><code>Ps = 1047</code> </strong>&gt;</a></strong><br />
1923</dt>
1924<table>
1925<tr><td>h</td><td>Use Alternate Screen Buffer</td></tr>
1926<tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr>
1927</table><dt><strong><a name="item_ps__3d_1048"><strong><code>Ps = 1048</code> </strong>&gt;</a></strong><br />
1928</dt>
1929<table>
1930<tr><td>h</td><td>Save cursor position</td></tr>
1931<tr><td>l</td><td>Restore cursor position</td></tr>
1932</table><dt><strong><a name="item_ps__3d_1049"><strong><code>Ps = 1049</code> </strong>&gt;</a></strong><br />
1933</dt>
1934<table>
1935<tr><td>h</td><td>Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it</td></tr>
1936<tr><td>l</td><td>Use Normal Screen Buffer</td></tr>
1937</table></dl>
1938</dl> 1788</dl>
1939<p></p> 1789
1940<p> 1790</div>
1941</p> 1791<h1 id="XPM">XPM</h1><p><a href="#TOP" class="toplink">Top</a></p>
1942<hr /> 1792<div id="XPM_CONTENT">
1943<h1><a name="xterm_operating_system_commands">XTerm Operating System Commands</a></h1>
1944<dl>
1945<dt><strong><a name="item_esc__5d_ps_3bpt_st"><strong><code>ESC ] Ps;Pt ST</code> </strong>&gt;</a></strong><br />
1946</dt>
1947<dd>
1948Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b,
19490x5c), backwards compatible terminator BEL (0x07) is also accepted. any
1950<strong>octet</strong> can be escaped by prefixing it with SYN (0x16, ^V).
1951</dd>
1952<table>
1953<tr><td>Ps = 0</td><td>Change Icon Name and Window Title to Pt</td></tr>
1954<tr><td>Ps = 1</td><td>Change Icon Name to Pt</td></tr>
1955<tr><td>Ps = 2</td><td>Change Window Title to Pt</td></tr>
1956<tr><td>Ps = 3</td><td>If Pt starts with a ?, query the (STRING) property of the window and return it. If Pt contains a =, set the named property to the given value, else delete the specified property.</td></tr>
1957<tr><td>Ps = 4</td><td>Pt is a semi-colon separated sequence of one or more semi-colon separated number/name pairs, where number is an index to a colour and name is the name of a colour. Each pair causes the numbered colour to be changed to name. Numbers 0-7 corresponds to low-intensity (normal) colours and 8-15 corresponds to high-intensity colours. 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=magenta, 6=cyan, 7=white</td></tr>
1958<tr><td>Ps = 10</td><td>Change colour of text foreground to Pt (NB: may change in future)</td></tr>
1959<tr><td>Ps = 11</td><td>Change colour of text background to Pt (NB: may change in future)</td></tr>
1960<tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr>
1961<tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr>
1962<tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr>
1963<tr><td>Ps = 18</td><td>Change colour of bold characters to Pt [deprecated, see 706]</td></tr>
1964<tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt [deprecated, see 707]</td></tr>
1965<tr><td>Ps = 20</td><td>Change background pixmap parameters (see section XPM) (Compile XPM).</td></tr>
1966<tr><td>Ps = 39</td><td>Change default foreground colour to Pt.</td></tr>
1967<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr>
1968<tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr>
1969<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 = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr>
1971<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 = 702</td><td>Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST.</td></tr>
1973<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr>
1974<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr>
1975<tr><td>Ps = 706</td><td>Change colour of bold characters to Pt</td></tr>
1976<tr><td>Ps = 707</td><td>Change colour of underlined characters to Pt</td></tr>
1977<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr>
1978<tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1979<tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1980<tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).</td></tr>
1981<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 = 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 = 777</td><td>Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl).</td></tr>
1984</table><p></p></dl>
1985<p></p>
1986<p>
1987</p>
1988<hr />
1989<h1><a name="xpm">XPM</a></h1>
1990<p>For the XPM XTerm escape sequence <strong><code>ESC ] 20 ; Pt ST</code> </strong>&gt; then value 1793<p>For the XPM XTerm escape sequence <strong><code>ESC ] 20 ; Pt ST</code></strong> then value
1991of <strong><a href="#item_pt"><code>Pt</code></a> </strong>&gt; can be the name of the background pixmap followed by a 1794of <strong><code>Pt</code></strong> can be the name of the background pixmap followed by a
1992sequence of scaling/positioning commands separated by semi-colons. The 1795sequence of scaling/positioning commands separated by semi-colons. The
1993scaling/positioning commands are as follows:</p> 1796scaling/positioning commands are as follows:</p>
1994<dl> 1797<dl>
1995<dt><strong><a name="item_query_scale_2fposition">query scale/position</a></strong><br /> 1798 <dt>query scale/position</dt>
1996</dt>
1997<dd> 1799 <dd>
1998<strong>?</strong> 1800 <p><strong>?</strong></p>
1999</dd> 1801 </dd>
2000<p></p> 1802 <dt>change scale and position</dt>
2001<dt><strong><a name="item_change_scale_and_position">change scale and position</a></strong><br />
2002</dt>
2003<dd> 1803 <dd>
2004<strong>WxH+X+Y</strong> 1804 <p><strong>WxH+X+Y</strong></p>
2005</dd>
2006<dd>
2007<p><strong>WxH+X</strong> (== <strong>WxH+X+X</strong>)</p> 1805 <p><strong>WxH+X</strong> (== <strong>WxH+X+X</strong>)</p>
2008</dd>
2009<dd>
2010<p><strong>WxH</strong> (same as <strong>WxH+50+50</strong>)</p> 1806 <p><strong>WxH</strong> (same as <strong>WxH+50+50</strong>)</p>
2011</dd>
2012<dd>
2013<p><strong>W+X+Y</strong> (same as <strong>WxW+X+Y</strong>)</p> 1807 <p><strong>W+X+Y</strong> (same as <strong>WxW+X+Y</strong>)</p>
2014</dd>
2015<dd>
2016<p><strong>W+X</strong> (same as <strong>WxW+X+X</strong>)</p> 1808 <p><strong>W+X</strong> (same as <strong>WxW+X+X</strong>)</p>
2017</dd>
2018<dd>
2019<p><strong>W</strong> (same as <strong>WxW+50+50</strong>)</p> 1809 <p><strong>W</strong> (same as <strong>WxW+50+50</strong>)</p>
2020</dd> 1810 </dd>
2021<p></p> 1811 <dt>change position (absolute)</dt>
2022<dt><strong><a name="item_position">change position (absolute)</a></strong><br />
2023</dt>
2024<dd> 1812 <dd>
2025<strong>=+X+Y</strong> 1813 <p><strong>=+X+Y</strong></p>
2026</dd>
2027<dd>
2028<p><strong>=+X</strong> (same as <strong>=+X+Y</strong>)</p> 1814 <p><strong>=+X</strong> (same as <strong>=+X+Y</strong>)</p>
2029</dd> 1815 </dd>
2030<p></p>
2031<dt><strong>change position (relative)</strong><br /> 1816 <dt>change position (relative)</dt>
2032</dt>
2033<dd> 1817 <dd>
2034<strong>+X+Y</strong> 1818 <p><strong>+X+Y</strong></p>
2035</dd>
2036<dd>
2037<p><strong>+X</strong> (same as <strong>+X+Y</strong>)</p> 1819 <p><strong>+X</strong> (same as <strong>+X+Y</strong>)</p>
2038</dd> 1820 </dd>
2039<p></p> 1821 <dt>rescale (relative)</dt>
2040<dt><strong><a name="item_rescale">rescale (relative)</a></strong><br />
2041</dt>
2042<dd> 1822 <dd>
2043<strong>Wx0</strong> -&gt; <strong>W *= (W/100)</strong> 1823 <p><strong>Wx0</strong> -&gt; <strong>W *= (W/100)</strong></p>
2044</dd>
2045<dd>
2046<p><strong>0xH</strong> -&gt; <strong>H *= (H/100)</strong></p> 1824 <p><strong>0xH</strong> -&gt; <strong>H *= (H/100)</strong></p>
2047</dd> 1825 </dd>
2048<p></p></dl> 1826</dl>
2049<p>For example:</p> 1827<p>For example:</p>
2050<dl> 1828<dl>
2051<dt><strong><a name="item__5ce_5d20_3bfunky_5ca"><strong>\E]20;funky\a</strong></a></strong><br /> 1829 <dt><strong>\E]20;funky\a</strong></dt>
2052</dt>
2053<dd> 1830 <dd>
2054load <strong>funky.xpm</strong> as a tiled image 1831 <p>load <strong>funky.xpm</strong> as a tiled image</p>
2055</dd> 1832 </dd>
2056<p></p> 1833 <dt><strong>\E]20;mona;100\a</strong></dt>
2057<dt><strong><a name="item__5ce_5d20_3bmona_3b100_5ca"><strong>\E]20;mona;100\a</strong></a></strong><br />
2058</dt>
2059<dd> 1834 <dd>
2060load <strong>mona.xpm</strong> with a scaling of 100% 1835 <p>load <strong>mona.xpm</strong> with a scaling of 100%</p>
2061</dd> 1836 </dd>
2062<p></p> 1837 <dt><strong>\E]20;;200;?\a</strong></dt>
2063<dt><strong><a name="item__5ce_5d20_3b_3b200_3b_3f_5ca"><strong>\E]20;;200;?\a</strong></a></strong><br />
2064</dt>
2065<dd> 1838 <dd>
2066rescale the current pixmap to 200% and display the image geometry in 1839 <p>rescale the current pixmap to 200% and display the image geometry in
2067the title 1840the title</p>
2068</dd> 1841 </dd>
2069<p></p></dl> 1842</dl>
2070<p> 1843
2071</p> 1844</div>
2072<hr /> 1845<h1 id="Mouse_Reporting">Mouse Reporting</h1><p><a href="#TOP" class="toplink">Top</a></p>
2073<h1><a name="mouse_reporting">Mouse Reporting</a></h1> 1846<div id="Mouse_Reporting_CONTENT">
2074<dl> 1847<dl>
2075<dt><strong><a name="item_esc__5b_m__3cb_3e__3cx_3e__3cy_3e"><strong><code>ESC [ M &lt;b&gt; &lt;x&gt; &lt;y&gt;</code> </strong>&gt;</a></strong><br /> 1848 <dt><strong><code>ESC [ M &lt;b&gt; &lt;x&gt; &lt;y&gt;</code></strong></dt>
2076</dt>
2077<dd> 1849 <dd>
2078report mouse position 1850 <p>report mouse position</p>
2079</dd> 1851 </dd>
2080<p></p></dl> 1852</dl>
2081<p>The lower 2 bits of <strong><code>&lt;b&gt;</code> </strong>&gt; indicate the button:</p> 1853<p>The lower 2 bits of <strong><code>&lt;b&gt;</code></strong> indicate the button:</p>
2082<dl> 1854<dl>
2083<dt><strong><a name="item_button__3d__28_3cb_3e__2d_space_29__26_3">Button = <strong><code>(&lt;b&gt; - SPACE) &amp; 3</code> </strong>&gt;</a></strong><br /> 1855 <dt>Button = <strong><code>(&lt;b&gt; - SPACE) &amp; 3</code></strong></dt>
2084</dt> 1856</dl>
2085<table>
2086<tr><td>0</td><td>Button1 pressed</td></tr>
2087<tr><td>1</td><td>Button2 pressed</td></tr>
2088<tr><td>2</td><td>Button3 pressed</td></tr>
2089<tr><td>3</td><td>button released (X11 mouse report)</td></tr>
2090</table></dl>
2091<p>The upper bits of <strong><code>&lt;b&gt;</code> </strong>&gt; indicate the modifiers when the 1857<p>The upper bits of <strong><code>&lt;b&gt;</code></strong> indicate the modifiers when the
2092button was pressed and are added together (X11 mouse report only):</p> 1858button was pressed and are added together (X11 mouse report only):</p>
2093<dl> 1859<dl>
2094<dt><strong><a name="item_state__3d__28_3cb_3e__2d_space_29__26_60">State = <strong><code>(&lt;b&gt; - SPACE) &amp; 60</code> </strong>&gt;</a></strong><br /> 1860 <dt>State = <strong><code>(&lt;b&gt; - SPACE) &amp; 60</code></strong></dt>
2095</dt> 1861 <dd>
2096<table>
2097<tr><td>4</td><td>Shift</td></tr>
2098<tr><td>8</td><td>Meta</td></tr>
2099<tr><td>16</td><td>Control</td></tr>
2100<tr><td>32</td><td>Double Click (Rxvt extension)</td></tr>
2101</table><p>Col = <strong><code>&lt;x&gt; - SPACE</code> </strong>&gt;</p> 1862 <p>Col = <strong><code>&lt;x&gt; - SPACE</code></strong></p>
2102<p>Row = <strong><code>&lt;y&gt; - SPACE</code> </strong>&gt;</p> 1863 <p>Row = <strong><code>&lt;y&gt; - SPACE</code></strong></p>
1864 </dd>
2103</dl> 1865</dl>
2104<p> 1866
2105</p> 1867</div>
2106<hr /> 1868<h1 id="Key_Codes">Key Codes</h1><p><a href="#TOP" class="toplink">Top</a></p>
2107<h1><a name="key_codes">Key Codes</a></h1> 1869<div id="Key_Codes_CONTENT">
2108<p>Note: <strong>Shift</strong> + <strong>F1</strong>-<strong>F10</strong> generates <strong>F11</strong>-<strong>F20</strong></p> 1870<p>Note: <strong>Shift</strong> + <strong>F1</strong>-<strong>F10</strong> generates <strong>F11</strong>-<strong>F20</strong></p>
2109<p>For the keypad, use <strong>Shift</strong> to temporarily override Application-Keypad 1871<p>For the keypad, use <strong>Shift</strong> to temporarily override Application-Keypad
2110setting use <strong>Num_Lock</strong> to toggle Application-Keypad setting if 1872setting use <strong>Num_Lock</strong> to toggle Application-Keypad setting if
2111<strong>Num_Lock</strong> is off, toggle Application-Keypad setting. Also note that 1873<strong>Num_Lock</strong> is off, toggle Application-Keypad setting. Also note that
2112values of <strong>Home</strong>, <strong>End</strong>, <strong>Delete</strong> may have been compiled differently on 1874values of <strong>Home</strong>, <strong>End</strong>, <strong>Delete</strong> may have been compiled differently on
2113your system.</p> 1875your system.</p>
2114<table> 1876
2115<tr><td></td><td>Normal</td><td>Shift</td><td>Control</td><td>Ctrl+Shift</td></tr> 1877</div>
2116<tr><td>Tab</td><td>^I</td><td>ESC [ Z</td><td>^I</td><td>ESC [ Z</td></tr> 1878<h1 id="CONFIGURE_OPTIONS">CONFIGURE OPTIONS</h1><p><a href="#TOP" class="toplink">Top</a></p>
2117<tr><td>BackSpace</td><td>^H</td><td>^?</td><td>^?</td><td>^?</td></tr> 1879<div id="CONFIGURE_OPTIONS_CONTENT">
2118<tr><td>Find</td><td>ESC [ 1 ~</td><td>ESC [ 1 $</td><td>ESC [ 1 ^</td><td>ESC [ 1 @</td></tr>
2119<tr><td>Insert</td><td>ESC [ 2 ~</td><td>paste</td><td>ESC [ 2 ^</td><td>ESC [ 2 @</td></tr>
2120<tr><td>Execute</td><td>ESC [ 3 ~</td><td>ESC [ 3 $</td><td>ESC [ 3 ^</td><td>ESC [ 3 @</td></tr>
2121<tr><td>Select</td><td>ESC [ 4 ~</td><td>ESC [ 4 $</td><td>ESC [ 4 ^</td><td>ESC [ 4 @</td></tr>
2122<tr><td>Prior</td><td>ESC [ 5 ~</td><td>scroll-up</td><td>ESC [ 5 ^</td><td>ESC [ 5 @</td></tr>
2123<tr><td>Next</td><td>ESC [ 6 ~</td><td>scroll-down</td><td>ESC [ 6 ^</td><td>ESC [ 6 @</td></tr>
2124<tr><td>Home</td><td>ESC [ 7 ~</td><td>ESC [ 7 $</td><td>ESC [ 7 ^</td><td>ESC [ 7 @</td></tr>
2125<tr><td>End</td><td>ESC [ 8 ~</td><td>ESC [ 8 $</td><td>ESC [ 8 ^</td><td>ESC [ 8 @</td></tr>
2126<tr><td>Delete</td><td>ESC [ 3 ~</td><td>ESC [ 3 $</td><td>ESC [ 3 ^</td><td>ESC [ 3 @</td></tr>
2127<tr><td>F1</td><td>ESC [ 11 ~</td><td>ESC [ 23 ~</td><td>ESC [ 11 ^</td><td>ESC [ 23 ^</td></tr>
2128<tr><td>F2</td><td>ESC [ 12 ~</td><td>ESC [ 24 ~</td><td>ESC [ 12 ^</td><td>ESC [ 24 ^</td></tr>
2129<tr><td>F3</td><td>ESC [ 13 ~</td><td>ESC [ 25 ~</td><td>ESC [ 13 ^</td><td>ESC [ 25 ^</td></tr>
2130<tr><td>F4</td><td>ESC [ 14 ~</td><td>ESC [ 26 ~</td><td>ESC [ 14 ^</td><td>ESC [ 26 ^</td></tr>
2131<tr><td>F5</td><td>ESC [ 15 ~</td><td>ESC [ 28 ~</td><td>ESC [ 15 ^</td><td>ESC [ 28 ^</td></tr>
2132<tr><td>F6</td><td>ESC [ 17 ~</td><td>ESC [ 29 ~</td><td>ESC [ 17 ^</td><td>ESC [ 29 ^</td></tr>
2133<tr><td>F7</td><td>ESC [ 18 ~</td><td>ESC [ 31 ~</td><td>ESC [ 18 ^</td><td>ESC [ 31 ^</td></tr>
2134<tr><td>F8</td><td>ESC [ 19 ~</td><td>ESC [ 32 ~</td><td>ESC [ 19 ^</td><td>ESC [ 32 ^</td></tr>
2135<tr><td>F9</td><td>ESC [ 20 ~</td><td>ESC [ 33 ~</td><td>ESC [ 20 ^</td><td>ESC [ 33 ^</td></tr>
2136<tr><td>F10</td><td>ESC [ 21 ~</td><td>ESC [ 34 ~</td><td>ESC [ 21 ^</td><td>ESC [ 34 ^</td></tr>
2137<tr><td>F11</td><td>ESC [ 23 ~</td><td>ESC [ 23 $</td><td>ESC [ 23 ^</td><td>ESC [ 23 @</td></tr>
2138<tr><td>F12</td><td>ESC [ 24 ~</td><td>ESC [ 24 $</td><td>ESC [ 24 ^</td><td>ESC [ 24 @</td></tr>
2139<tr><td>F13</td><td>ESC [ 25 ~</td><td>ESC [ 25 $</td><td>ESC [ 25 ^</td><td>ESC [ 25 @</td></tr>
2140<tr><td>F14</td><td>ESC [ 26 ~</td><td>ESC [ 26 $</td><td>ESC [ 26 ^</td><td>ESC [ 26 @</td></tr>
2141<tr><td>F15 (Help)</td><td>ESC [ 28 ~</td><td>ESC [ 28 $</td><td>ESC [ 28 ^</td><td>ESC [ 28 @</td></tr>
2142<tr><td>F16 (Menu)</td><td>ESC [ 29 ~</td><td>ESC [ 29 $</td><td>ESC [ 29 ^</td><td>ESC [ 29 @</td></tr>
2143<tr><td>F17</td><td>ESC [ 31 ~</td><td>ESC [ 31 $</td><td>ESC [ 31 ^</td><td>ESC [ 31 @</td></tr>
2144<tr><td>F18</td><td>ESC [ 32 ~</td><td>ESC [ 32 $</td><td>ESC [ 32 ^</td><td>ESC [ 32 @</td></tr>
2145<tr><td>F19</td><td>ESC [ 33 ~</td><td>ESC [ 33 $</td><td>ESC [ 33 ^</td><td>ESC [ 33 @</td></tr>
2146<tr><td>F20</td><td>ESC [ 34 ~</td><td>ESC [ 34 $</td><td>ESC [ 34 ^</td><td>ESC [ 34 @</td></tr>
2147<tr><td></td><td></td><td></td><td></td><td>Application</td></tr>
2148<tr><td>Up</td><td>ESC [ A</td><td>ESC [ a</td><td>ESC O a</td><td>ESC O A</td></tr>
2149<tr><td>Down</td><td>ESC [ B</td><td>ESC [ b</td><td>ESC O b</td><td>ESC O B</td></tr>
2150<tr><td>Right</td><td>ESC [ C</td><td>ESC [ c</td><td>ESC O c</td><td>ESC O C</td></tr>
2151<tr><td>Left</td><td>ESC [ D</td><td>ESC [ d</td><td>ESC O d</td><td>ESC O D</td></tr>
2152<tr><td>KP_Enter</td><td>^M</td><td></td><td></td><td>ESC O M</td></tr>
2153<tr><td>KP_F1</td><td>ESC O P</td><td></td><td></td><td>ESC O P</td></tr>
2154<tr><td>KP_F2</td><td>ESC O Q</td><td></td><td></td><td>ESC O Q</td></tr>
2155<tr><td>KP_F3</td><td>ESC O R</td><td></td><td></td><td>ESC O R</td></tr>
2156<tr><td>KP_F4</td><td>ESC O S</td><td></td><td></td><td>ESC O S</td></tr>
2157<tr><td>XK_KP_Multiply</td><td>*</td><td></td><td></td><td>ESC O j</td></tr>
2158<tr><td>XK_KP_Add</td><td>+</td><td></td><td></td><td>ESC O k</td></tr>
2159<tr><td>XK_KP_Separator</td><td>,</td><td></td><td></td><td>ESC O l</td></tr>
2160<tr><td>XK_KP_Subtract</td><td>-</td><td></td><td></td><td>ESC O m</td></tr>
2161<tr><td>XK_KP_Decimal</td><td>.</td><td></td><td></td><td>ESC O n</td></tr>
2162<tr><td>XK_KP_Divide</td><td>/</td><td></td><td></td><td>ESC O o</td></tr>
2163<tr><td>XK_KP_0</td><td>0</td><td></td><td></td><td>ESC O p</td></tr>
2164<tr><td>XK_KP_1</td><td>1</td><td></td><td></td><td>ESC O q</td></tr>
2165<tr><td>XK_KP_2</td><td>2</td><td></td><td></td><td>ESC O r</td></tr>
2166<tr><td>XK_KP_3</td><td>3</td><td></td><td></td><td>ESC O s</td></tr>
2167<tr><td>XK_KP_4</td><td>4</td><td></td><td></td><td>ESC O t</td></tr>
2168<tr><td>XK_KP_5</td><td>5</td><td></td><td></td><td>ESC O u</td></tr>
2169<tr><td>XK_KP_6</td><td>6</td><td></td><td></td><td>ESC O v</td></tr>
2170<tr><td>XK_KP_7</td><td>7</td><td></td><td></td><td>ESC O w</td></tr>
2171<tr><td>XK_KP_8</td><td>8</td><td></td><td></td><td>ESC O x</td></tr>
2172<tr><td>XK_KP_9</td><td>9</td><td></td><td></td><td>ESC O y</td></tr>
2173</table><p>
2174</p>
2175<hr />
2176<h1><a name="configure_options">CONFIGURE OPTIONS</a></h1>
2177<p>General hint: if you get compile errors, then likely your configuration 1880<p>General hint: if you get compile errors, then likely your configuration
2178hasn't been tested well. Either try with <a href="#item__2d_2denable_2deverything"><code>--enable-everything</code></a> or use 1881hasn't been tested well. Either try with <code>--enable-everything</code> or use
2179the <em>./reconf</em> script as a base for experiments. <em>./reconf</em> is used by 1882the default configuration (i.e. <code>--enable-xxx</code> or <code>--disable-xxx</code>). Of
2180myself, so it should generally be a working config. Of course, you should 1883course, you should always report when a combination doesn't work, so it
2181always report when a combination doesn't work, so it can be fixed. Marc 1884can be fixed. Marc Lehmann &lt;rxvt@schmorp.de&gt;.</p>
2182Lehmann &lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt;.</p>
2183<p>All</p> 1885<p>All</p>
2184<dl> 1886<dl>
2185<dt><strong><a name="item__2d_2denable_2deverything">--enable-everything</a></strong><br /> 1887 <dt>--enable-everything</dt>
2186</dt>
2187<dd> 1888 <dd>
2188Add (or remove) support for all non-multichoice options listed in ``./configure 1889 <p>Add (or remove) support for all non-multichoice options listed in &quot;./configure
2189--help''. 1890--help&quot;.</p>
2190</dd>
2191<dd>
2192<p>You can specify this and then disable options you do not like by 1891 <p>You can specify this and then disable options you do not like by
2193<em>following</em> this with the appropriate <code>--disable-...</code> arguments, 1892<i>following</i> this with the appropriate <code>--disable-...</code> arguments,
2194or you can start with a minimal configuration by specifying 1893or you can start with a minimal configuration by specifying
2195<code>--disable-everything</code> and than adding just the <code>--enable-...</code> arguments 1894<code>--disable-everything</code> and than adding just the <code>--enable-...</code> arguments
2196you want.</p> 1895you want.</p>
2197</dd> 1896 </dd>
2198<p></p> 1897 <dt>--enable-xft (default: enabled)</dt>
2199<dt><strong><a name="item_xft">--enable-xft (default: enabled)</a></strong><br />
2200</dt>
2201<dd> 1898 <dd>
2202Add support for Xft (anti-aliases, among others) fonts. Xft fonts are 1899 <p>Add support for Xft (anti-aliases, among others) fonts. Xft fonts are
2203slower and require lots of memory, but as long as you don't use them, you 1900slower and require lots of memory, but as long as you don't use them, you
2204don't pay for them. 1901don't pay for them.</p>
2205</dd> 1902 </dd>
2206<p></p> 1903 <dt>--enable-font-styles (default: on)</dt>
2207<dt><strong><a name="item_styles">--enable-font-styles (default: on)</a></strong><br />
2208</dt>
2209<dd> 1904 <dd>
2210Add support for <strong>bold</strong>, <em>italic</em> and <strong><em>bold italic</em> </strong>&gt; font 1905 <p>Add support for <strong>bold</strong>, <i>italic</i> and <strong><i>bold italic</i></strong> font
2211styles. The fonts can be set manually or automatically. 1906styles. The fonts can be set manually or automatically.</p>
2212</dd> 1907 </dd>
2213<p></p> 1908 <dt>--with-codesets=NAME,... (default: all)</dt>
2214<dt><strong><a name="item__2d_2dwith_2dcodesets_3dname_2c_2e_2e_2e__28defaul">--with-codesets=NAME,... (default: all)</a></strong><br />
2215</dt>
2216<dd> 1909 <dd>
2217Compile in support for additional codeset (encoding) groups (<code>eu</code>, <code>vn</code> 1910 <p>Compile in support for additional codeset (encoding) groups (<code>eu</code>, <code>vn</code>
2218are always compiled in, which includes most 8-bit character sets). These 1911are always compiled in, which includes most 8-bit character sets). These
2219codeset tables are used for driving X11 core fonts, they are not required 1912codeset tables are used for driving X11 core fonts, they are not required
2220for Xft fonts, although having them compiled in lets rxvt-unicode choose 1913for Xft fonts, although having them compiled in lets rxvt-unicode choose
2221replacement fonts more intelligently. Compiling them in will make your 1914replacement fonts more intelligently. Compiling them in will make your
2222binary bigger (all of together cost about 700kB), but it doesn't increase 1915binary bigger (all of together cost about 700kB), but it doesn't increase
2223memory usage unless you use a font requiring one of these encodings. 1916memory usage unless you use a font requiring one of these encodings.</p>
2224</dd> 1917 </dd>
2225<table> 1918 <dt>--enable-xim (default: on)</dt>
2226<tr><td>all</td><td>all available codeset groups</td></tr>
2227<tr><td>zh</td><td>common chinese encodings</td></tr>
2228<tr><td>zh_ext</td><td>rarely used but very big chinese encodigs</td></tr>
2229<tr><td>jp</td><td>common japanese encodings</td></tr>
2230<tr><td>jp_ext</td><td>rarely used but big japanese encodings</td></tr>
2231<tr><td>kr</td><td>korean encodings</td></tr>
2232</table><p></p>
2233<dt><strong><a name="item_xim">--enable-xim (default: on)</a></strong><br />
2234</dt>
2235<dd> 1919 <dd>
2236Add support for XIM (X Input Method) protocol. This allows using 1920 <p>Add support for XIM (X Input Method) protocol. This allows using
2237alternative input methods (e.g. kinput2) and will also correctly 1921alternative input methods (e.g. kinput2) and will also correctly
2238set up the input for people using dead keys or compose keys. 1922set up the input for people using dead keys or compose keys.</p>
2239</dd> 1923 </dd>
2240<p></p> 1924 <dt>--enable-unicode3 (default: off)</dt>
2241<dt><strong><a name="item_unicode3">--enable-unicode3 (default: off)</a></strong><br />
2242</dt>
2243<dd> 1925 <dd>
2244Recommended to stay off unless you really need non-BMP characters. 1926 <p>Recommended to stay off unless you really need non-BMP characters.</p>
2245</dd>
2246<dd>
2247<p>Enable direct support for displaying unicode codepoints above 1927 <p>Enable direct support for displaying unicode codepoints above
224865535 (the basic multilingual page). This increases storage 192865535 (the basic multilingual page). This increases storage
2249requirements per character from 2 to 4 bytes. X11 fonts do not yet 1929requirements per character from 2 to 4 bytes. X11 fonts do not yet
2250support these extra characters, but Xft does.</p> 1930support these extra characters, but Xft does.</p>
2251</dd>
2252<dd>
2253<p>Please note that rxvt-unicode can store unicode code points &gt;65535 1931 <p>Please note that rxvt-unicode can store unicode code points &gt;65535
2254even without this flag, but the number of such characters is 1932even without this flag, but the number of such characters is
2255limited to a view thousand (shared with combining characters, 1933limited to a few thousand (shared with combining characters,
2256see next switch), and right now rxvt-unicode cannot display them 1934see next switch), and right now rxvt-unicode cannot display them
2257(input/output and cut&amp;paste still work, though).</p> 1935(input/output and cut&amp;paste still work, though).</p>
2258</dd> 1936 </dd>
2259<p></p> 1937 <dt>--enable-combining (default: on)</dt>
2260<dt><strong><a name="item_combining">--enable-combining (default: on)</a></strong><br />
2261</dt>
2262<dd> 1938 <dd>
2263Enable automatic composition of combining characters into 1939 <p>Enable automatic composition of combining characters into
2264composite characters. This is required for proper viewing of text 1940composite characters. This is required for proper viewing of text
2265where accents are encoded as seperate unicode characters. This is 1941where accents are encoded as seperate unicode characters. This is
2266done by using precomposited characters when available or creating 1942done by using precomposited characters when available or creating
2267new pseudo-characters when no precomposed form exists. 1943new pseudo-characters when no precomposed form exists.</p>
2268</dd>
2269<dd>
2270<p>Without --enable-unicode3, the number of additional precomposed 1944 <p>Without --enable-unicode3, the number of additional precomposed
2271characters is somewhat limited (the 6400 private use characters will be 1945characters is somewhat limited (the 6400 private use characters will be
2272(ab-)used). With --enable-unicode3, no practical limit exists.</p> 1946(ab-)used). With --enable-unicode3, no practical limit exists.</p>
2273</dd>
2274<dd>
2275<p>This option will also enable storage (but not display) of characters 1947 <p>This option will also enable storage (but not display) of characters
2276beyond plane 0 (&gt;65535) when --enable-unicode3 was not specified.</p> 1948beyond plane 0 (&gt;65535) when --enable-unicode3 was not specified.</p>
2277</dd>
2278<dd>
2279<p>The combining table also contains entries for arabic presentation forms, 1949 <p>The combining table also contains entries for arabic presentation forms,
2280but these are not currently used. Bug me if you want these to be used (and 1950but these are not currently used. Bug me if you want these to be used (and
2281tell me how these are to be used...).</p> 1951tell me how these are to be used...).</p>
2282</dd> 1952 </dd>
2283<p></p> 1953 <dt>--enable-fallback(=CLASS) (default: Rxvt)</dt>
2284<dt><strong><a name="item_fallback">--enable-fallback(=CLASS) (default: Rxvt)</a></strong><br />
2285</dt>
2286<dd> 1954 <dd>
2287When reading resource settings, also read settings for class CLASS. To 1955 <p>When reading resource settings, also read settings for class CLASS. To
2288disable resource fallback use --disable-fallback. 1956disable resource fallback use --disable-fallback.</p>
2289</dd> 1957 </dd>
2290<p></p> 1958 <dt>--with-res-name=NAME (default: urxvt)</dt>
2291<dt><strong><a name="item_name">--with-res-name=NAME (default: urxvt)</a></strong><br />
2292</dt>
2293<dd> 1959 <dd>
2294Use the given name as default application name when 1960 <p>Use the given name as default application name when
2295reading resources. Specify --with-res-name=rxvt to replace rxvt. 1961reading resources. Specify --with-res-name=rxvt to replace rxvt.</p>
2296</dd> 1962 </dd>
2297<p></p> 1963 <dt>--with-res-class=CLASS /default: URxvt)</dt>
2298<dt><strong><a name="item__2d_2dwith_2dres_2dclass_3dclass__2fdefault_3a_urx">--with-res-class=CLASS /default: URxvt)</a></strong><br />
2299</dt>
2300<dd> 1964 <dd>
2301Use the given class as default application class 1965 <p>Use the given class as default application class
2302when reading resources. Specify --with-res-class=Rxvt to replace 1966when reading resources. Specify --with-res-class=Rxvt to replace
2303rxvt. 1967rxvt.</p>
2304</dd> 1968 </dd>
2305<p></p> 1969 <dt>--enable-utmp (default: on)</dt>
2306<dt><strong><a name="item_utmp">--enable-utmp (default: on)</a></strong><br />
2307</dt>
2308<dd> 1970 <dd>
2309Write user and tty to utmp file (used by programs like <em>w</em>) at 1971 <p>Write user and tty to utmp file (used by programs like <cite>w</cite>) at
2310start of rxvt execution and delete information when rxvt exits. 1972start of rxvt execution and delete information when rxvt exits.</p>
2311</dd> 1973 </dd>
2312<p></p> 1974 <dt>--enable-wtmp (default: on)</dt>
2313<dt><strong><a name="item_wtmp">--enable-wtmp (default: on)</a></strong><br />
2314</dt>
2315<dd> 1975 <dd>
2316Write user and tty to wtmp file (used by programs like <em>last</em>) at 1976 <p>Write user and tty to wtmp file (used by programs like <cite>last</cite>) at
2317start of rxvt execution and write logout when rxvt exits. This 1977start of rxvt execution and write logout when rxvt exits. This
2318option requires --enable-utmp to also be specified. 1978option requires --enable-utmp to also be specified.</p>
2319</dd> 1979 </dd>
2320<p></p> 1980 <dt>--enable-lastlog (default: on)</dt>
2321<dt><strong><a name="item_lastlog">--enable-lastlog (default: on)</a></strong><br />
2322</dt>
2323<dd> 1981 <dd>
2324Write user and tty to lastlog file (used by programs like 1982 <p>Write user and tty to lastlog file (used by programs like
2325<em>lastlogin</em>) at start of rxvt execution. This option requires 1983<cite>lastlogin</cite>) at start of rxvt execution. This option requires
2326--enable-utmp to also be specified. 1984--enable-utmp to also be specified.</p>
2327</dd> 1985 </dd>
2328<p></p> 1986 <dt>--enable-xpm-background (default: on)</dt>
2329<dt><strong><a name="item_background">--enable-xpm-background (default: on)</a></strong><br />
2330</dt>
2331<dd> 1987 <dd>
2332Add support for XPM background pixmaps. 1988 <p>Add support for XPM background pixmaps.</p>
2333</dd> 1989 </dd>
2334<p></p> 1990 <dt>--enable-transparency (default: on)</dt>
2335<dt><strong><a name="item_transparency">--enable-transparency (default: on)</a></strong><br />
2336</dt>
2337<dd> 1991 <dd>
2338Add support for inheriting parent backgrounds thus giving a fake 1992 <p>Add support for inheriting parent backgrounds thus giving a fake
2339transparency to the term. 1993transparency to the term.</p>
2340</dd> 1994 </dd>
2341<p></p> 1995 <dt>--enable-fading (default: on)</dt>
2342<dt><strong><a name="item_fading">--enable-fading (default: on)</a></strong><br />
2343</dt>
2344<dd> 1996 <dd>
2345Add support for fading the text when focus is lost (requires <code>--enable-transparency</code>). 1997 <p>Add support for fading the text when focus is lost (requires <code>--enable-transparency</code>).</p>
2346</dd> 1998 </dd>
2347<p></p> 1999 <dt>--enable-tinting (default: on)</dt>
2348<dt><strong><a name="item_tinting">--enable-tinting (default: on)</a></strong><br />
2349</dt>
2350<dd> 2000 <dd>
2351Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>). 2001 <p>Add support for tinting of transparent backgrounds (requires <code>--enable-transparency</code>).</p>
2352</dd> 2002 </dd>
2353<p></p> 2003 <dt>--enable-rxvt-scroll (default: on)</dt>
2354<dt><strong><a name="item_scroll">--enable-rxvt-scroll (default: on)</a></strong><br />
2355</dt>
2356<dd> 2004 <dd>
2357Add support for the original rxvt scrollbar. 2005 <p>Add support for the original rxvt scrollbar.</p>
2358</dd> 2006 </dd>
2359<p></p>
2360<dt><strong>--enable-next-scroll (default: on)</strong><br /> 2007 <dt>--enable-next-scroll (default: on)</dt>
2361</dt>
2362<dd> 2008 <dd>
2363Add support for a NeXT-like scrollbar. 2009 <p>Add support for a NeXT-like scrollbar.</p>
2364</dd> 2010 </dd>
2365<p></p>
2366<dt><strong>--enable-xterm-scroll (default: on)</strong><br /> 2011 <dt>--enable-xterm-scroll (default: on)</dt>
2367</dt>
2368<dd> 2012 <dd>
2369Add support for an Xterm-like scrollbar. 2013 <p>Add support for an Xterm-like scrollbar.</p>
2370</dd> 2014 </dd>
2371<p></p>
2372<dt><strong>--enable-plain-scroll (default: on)</strong><br /> 2015 <dt>--enable-plain-scroll (default: on)</dt>
2373</dt>
2374<dd> 2016 <dd>
2375Add support for a very unobtrusive, plain-looking scrollbar that 2017 <p>Add support for a very unobtrusive, plain-looking scrollbar that
2376is the favourite of the rxvt-unicode author, having used it for 2018is the favourite of the rxvt-unicode author, having used it for
2377many years. 2019many years.</p>
2378</dd> 2020 </dd>
2379<p></p> 2021 <dt>--enable-ttygid (default: off)</dt>
2380<dt><strong><a name="item_ttygid">--enable-ttygid (default: off)</a></strong><br />
2381</dt>
2382<dd> 2022 <dd>
2383Change tty device setting to group ``tty'' - only use this if 2023 <p>Change tty device setting to group &quot;tty&quot; - only use this if
2384your system uses this type of security. 2024your system uses this type of security.</p>
2385</dd> 2025 </dd>
2386<p></p> 2026 <dt>--disable-backspace-key</dt>
2387<dt><strong><a name="item__2d_2ddisable_2dbackspace_2dkey">--disable-backspace-key</a></strong><br />
2388</dt>
2389<dd> 2027 <dd>
2390Removes any handling of the backspace key by us - let the X server do it. 2028 <p>Removes any handling of the backspace key by us - let the X server do it.</p>
2391</dd> 2029 </dd>
2392<p></p> 2030 <dt>--disable-delete-key</dt>
2393<dt><strong><a name="item__2d_2ddisable_2ddelete_2dkey">--disable-delete-key</a></strong><br />
2394</dt>
2395<dd> 2031 <dd>
2396Removes any handling of the delete key by us - let the X server 2032 <p>Removes any handling of the delete key by us - let the X server
2397do it. 2033do it.</p>
2398</dd> 2034 </dd>
2399<p></p> 2035 <dt>--disable-resources</dt>
2400<dt><strong><a name="item__2d_2ddisable_2dresources">--disable-resources</a></strong><br />
2401</dt>
2402<dd> 2036 <dd>
2403Removes any support for resource checking. 2037 <p>Removes any support for resource checking.</p>
2404</dd> 2038 </dd>
2405<p></p> 2039 <dt>--disable-swapscreen</dt>
2406<dt><strong><a name="item__2d_2ddisable_2dswapscreen">--disable-swapscreen</a></strong><br />
2407</dt>
2408<dd> 2040 <dd>
2409Remove support for secondary/swap screen. 2041 <p>Remove support for secondary/swap screen.</p>
2410</dd> 2042 </dd>
2411<p></p> 2043 <dt>--enable-frills (default: on)</dt>
2412<dt><strong><a name="item_frills">--enable-frills (default: on)</a></strong><br />
2413</dt>
2414<dd> 2044 <dd>
2415Add support for many small features that are not essential but nice to 2045 <p>Add support for many small features that are not essential but nice to
2416have. Normally you want this, but for very small binaries you may want to 2046have. Normally you want this, but for very small binaries you may want to
2417disable this. 2047disable this.</p>
2418</dd>
2419<dd>
2420<p>A non-exhaustive list of features enabled by <code>--enable-frills</code> (possibly 2048 <p>A non-exhaustive list of features enabled by <code>--enable-frills</code> (possibly
2421in combination with other switches) is:</p> 2049in combination with other switches) is:</p>
2422</dd>
2423<dd>
2424<pre>
2425 MWM-hints 2050<pre> MWM-hints
2426 EWMH-hints (pid, utf8 names) and protocols (ping) 2051 EWMH-hints (pid, utf8 names) and protocols (ping)
2052 urgency hint
2427 seperate underline colour (-underlineColor) 2053 seperate underline colour (-underlineColor)
2428 settable border widths and borderless switch (-w, -b, -bl) 2054 settable border widths and borderless switch (-w, -b, -bl)
2429 visual selection (-depth) 2055 visual depth selection (-depth)
2430 settable extra linespacing /-lsp) 2056 settable extra linespacing /-lsp)
2431 iso-14755-2 and -3, and visual feedback 2057 iso-14755 5.1 (basic) support
2432 backindex and forwardindex escape sequence
2433 window op and some xterm/OSC escape sequences
2434 tripleclickwords (-tcw) 2058 tripleclickwords (-tcw)
2435 settable insecure mode (-insecure) 2059 settable insecure mode (-insecure)
2436 keysym remapping support 2060 keysym remapping support
2437 cursor blinking and underline cursor (-cb, -uc) 2061 cursor blinking and underline cursor (-cb, -uc)
2438 XEmbed support (-embed) 2062 XEmbed support (-embed)
2439 user-pty (-pty-fd) 2063 user-pty (-pty-fd)
2440 hold on exit (-hold) 2064 hold on exit (-hold)
2441 skip builtin block graphics (-sbg) 2065 skip builtin block graphics (-sbg)
2066 separate highlightcolor support (-hc)
2067
2068</pre>
2069 <p>It also enables some non-essential features otherwise disabled, such as:</p>
2070<pre> some round-trip time optimisations
2071 nearest color allocation on pseudocolor screens
2072 UTF8_STRING support for selection
2442 sgr modes 90..97 and 100..107</pre> 2073 sgr modes 90..97 and 100..107
2074 backindex and forwardindex escape sequences
2075 view change/zero scrollback escape sequences
2076 locale switching escape sequence
2077 window op and some xterm/OSC escape sequences
2078 rectangular selections
2079 trailing space removal for selections
2080 verbose X error handling
2081
2082</pre>
2443</dd> 2083 </dd>
2444<p></p> 2084 <dt>--enable-iso14755 (default: on)</dt>
2445<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br />
2446</dt>
2447<dd> 2085 <dd>
2448Enable extended ISO 14755 support (see rxvt(1), or 2086 <p>Enable extended ISO 14755 support (see rxvt(1), or
2449<em>doc/rxvt.1.txt</em>). Basic support (section 5.1) is enabled by 2087<cite>doc/rxvt.1.txt</cite>). Basic support (section 5.1) is enabled by
2450<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with 2088<code>--enable-frills</code>, while support for 5.2, 5.3 and 5.4 is enabled with
2451this switch. 2089this switch.</p>
2452</dd> 2090 </dd>
2453<p></p> 2091 <dt>--enable-keepscrolling (default: on)</dt>
2454<dt><strong><a name="item_keepscrolling">--enable-keepscrolling (default: on)</a></strong><br />
2455</dt>
2456<dd> 2092 <dd>
2457Add support for continual scrolling of the display when you hold 2093 <p>Add support for continual scrolling of the display when you hold
2458the mouse button down on a scrollbar arrow. 2094the mouse button down on a scrollbar arrow.</p>
2459</dd> 2095 </dd>
2460<p></p> 2096 <dt>--enable-mousewheel (default: on)</dt>
2461<dt><strong><a name="item_mousewheel">--enable-mousewheel (default: on)</a></strong><br />
2462</dt>
2463<dd> 2097 <dd>
2464Add support for scrolling via mouse wheel or buttons 4 &amp; 5. 2098 <p>Add support for scrolling via mouse wheel or buttons 4 &amp; 5.</p>
2465</dd> 2099 </dd>
2466<p></p> 2100 <dt>--enable-slipwheeling (default: on)</dt>
2467<dt><strong><a name="item_slipwheeling">--enable-slipwheeling (default: on)</a></strong><br />
2468</dt>
2469<dd> 2101 <dd>
2470Add support for continual scrolling (using the mouse wheel as an 2102 <p>Add support for continual scrolling (using the mouse wheel as an
2471accelerator) while the control key is held down. This option 2103accelerator) while the control key is held down. This option
2472requires --enable-mousewheel to also be specified. 2104requires --enable-mousewheel to also be specified.</p>
2473</dd> 2105 </dd>
2474<p></p> 2106 <dt>--disable-new-selection</dt>
2475<dt><strong><a name="item__2d_2ddisable_2dnew_2dselection">--disable-new-selection</a></strong><br />
2476</dt>
2477<dd> 2107 <dd>
2478Remove support for mouse selection style like that of xterm. 2108 <p>Remove support for mouse selection style like that of xterm.</p>
2479</dd> 2109 </dd>
2480<p></p> 2110 <dt>--enable-dmalloc (default: off)</dt>
2481<dt><strong><a name="item_dmalloc">--enable-dmalloc (default: off)</a></strong><br />
2482</dt>
2483<dd> 2111 <dd>
2484Use Gray Watson's malloc - which is good for debugging See 2112 <p>Use Gray Watson's malloc - which is good for debugging See
2485<a href="http://www.letters.com/dmalloc/">http://www.letters.com/dmalloc/</a> for details If you use either this or the 2113<a href="http://www.letters.com/dmalloc/">http://www.letters.com/dmalloc/</a> for details If you use either this or the
2486next option, you may need to edit src/Makefile after compiling to point 2114next option, you may need to edit src/Makefile after compiling to point
2487DINCLUDE and DLIB to the right places. 2115DINCLUDE and DLIB to the right places.</p>
2488</dd>
2489<dd>
2490<p>You can only use either this option and the following (should 2116 <p>You can only use either this option and the following (should
2491you use either) .</p> 2117you use either) .</p>
2492</dd> 2118 </dd>
2493<p></p> 2119 <dt>--enable-dlmalloc (default: off)</dt>
2494<dt><strong><a name="item_dlmalloc">--enable-dlmalloc (default: off)</a></strong><br />
2495</dt>
2496<dd> 2120 <dd>
2497Use Doug Lea's malloc - which is good for a production version 2121 <p>Use Doug Lea's malloc - which is good for a production version
2498See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details. 2122See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details.</p>
2499</dd> 2123 </dd>
2500<p></p> 2124 <dt>--enable-smart-resize (default: on)</dt>
2501<dt><strong><a name="item_resize">--enable-smart-resize (default: on)</a></strong><br />
2502</dt>
2503<dd> 2125 <dd>
2504Add smart growth/shrink behaviour when changing font size via hot 2126 <p>Add smart growth/shrink behaviour when changing font size via hot
2505keys. This should keep the window corner which is closest to a corner of 2127keys. This should keep the window corner which is closest to a corner of
2506the screen in a fixed position. 2128the screen in a fixed position.</p>
2507</dd> 2129 </dd>
2508<p></p> 2130 <dt>--enable-pointer-blank (default: on)</dt>
2509<dt><strong><a name="item_blank">--enable-pointer-blank (default: on)</a></strong><br />
2510</dt>
2511<dd> 2131 <dd>
2512Add support to have the pointer disappear when typing or inactive. 2132 <p>Add support to have the pointer disappear when typing or inactive.</p>
2513</dd> 2133 </dd>
2514<p></p> 2134 <dt>--enable-perl (default: on)</dt>
2515<dt><strong><a name="item_perl">--enable-perl (default: on)</a></strong><br />
2516</dt>
2517<dd> 2135 <dd>
2518Enable an embedded perl interpreter. See the <strong>rxvtperl(3)</strong> 2136 <p>Enable an embedded perl interpreter. See the <strong>rxvtperl(3)</strong>
2519manpage (<em>doc/rxvtperl.txt</em>) for more info on this feature, or the files 2137manpage (<cite>doc/rxvtperl.txt</cite>) for more info on this feature, or the
2520in <em>src/perl-ext/</em> for the extensions that are installed by default. The 2138files in <cite>src/perl-ext/</cite> for the extensions that are installed by
2521perl interpreter that is used can be specified via the <code>PERL</code> environment 2139default. The perl interpreter that is used can be specified via the
2522variable when running configure. 2140<code>PERL</code> environment variable when running configure. Even when compiled
2141in, perl will <i>not</i> be initialised when all extensions have been disabled
2142<code>-pe &quot;&quot; --perl-ext-common &quot;&quot;</code>, so it should be safe to enable from a
2143resource standpoint.</p>
2523</dd> 2144 </dd>
2524<p></p>
2525<dt><strong>--with-name=NAME (default: urxvt)</strong><br /> 2145 <dt>--with-name=NAME (default: urxvt)</dt>
2526</dt>
2527<dd> 2146 <dd>
2528Set the basename for the installed binaries, resulting 2147 <p>Set the basename for the installed binaries, resulting
2529in <code>urxvt</code>, <code>urxvtd</code> etc.). Specify <code>--with-name=rxvt</code> to replace with 2148in <code>urxvt</code>, <code>urxvtd</code> etc.). Specify <code>--with-name=rxvt</code> to replace with
2530<code>rxvt</code>. 2149<code>rxvt</code>.</p>
2531</dd> 2150 </dd>
2532<p></p>
2533<dt><strong>--with-term=NAME (default: rxvt-unicode)</strong><br /> 2151 <dt>--with-term=NAME (default: rxvt-unicode)</dt>
2534</dt>
2535<dd> 2152 <dd>
2536Change the environmental variable for the terminal to NAME. 2153 <p>Change the environmental variable for the terminal to NAME.</p>
2537</dd> 2154 </dd>
2538<p></p> 2155 <dt>--with-terminfo=PATH</dt>
2539<dt><strong><a name="item__2d_2dwith_2dterminfo_3dpath">--with-terminfo=PATH</a></strong><br />
2540</dt>
2541<dd> 2156 <dd>
2542Change the environmental variable for the path to the terminfo tree to 2157 <p>Change the environmental variable for the path to the terminfo tree to
2543PATH. 2158PATH.</p>
2544</dd> 2159 </dd>
2545<p></p> 2160 <dt>--with-x</dt>
2546<dt><strong><a name="item__2d_2dwith_2dx">--with-x</a></strong><br />
2547</dt>
2548<dd> 2161 <dd>
2549Use the X Window System (pretty much default, eh?). 2162 <p>Use the X Window System (pretty much default, eh?).</p>
2550</dd> 2163 </dd>
2551<p></p> 2164 <dt>--with-xpm-includes=DIR</dt>
2552<dt><strong><a name="item__2d_2dwith_2dxpm_2dincludes_3ddir">--with-xpm-includes=DIR</a></strong><br />
2553</dt>
2554<dd> 2165 <dd>
2555Look for the XPM includes in DIR. 2166 <p>Look for the XPM includes in DIR.</p>
2556</dd> 2167 </dd>
2557<p></p> 2168 <dt>--with-xpm-library=DIR</dt>
2558<dt><strong><a name="item__2d_2dwith_2dxpm_2dlibrary_3ddir">--with-xpm-library=DIR</a></strong><br />
2559</dt>
2560<dd> 2169 <dd>
2561Look for the XPM library in DIR. 2170 <p>Look for the XPM library in DIR.</p>
2562</dd> 2171 </dd>
2563<p></p> 2172 <dt>--with-xpm</dt>
2564<dt><strong><a name="item__2d_2dwith_2dxpm">--with-xpm</a></strong><br />
2565</dt>
2566<dd> 2173 <dd>
2567Not needed - define via --enable-xpm-background. 2174 <p>Not needed - define via --enable-xpm-background.</p>
2568</dd> 2175 </dd>
2569<p></p></dl> 2176</dl>
2570<p> 2177
2571</p> 2178</div>
2572<hr /> 2179<h1 id="AUTHORS">AUTHORS</h1><p><a href="#TOP" class="toplink">Top</a></p>
2573<h1><a name="authors">AUTHORS</a></h1> 2180<div id="AUTHORS_CONTENT">
2574<p>Marc Lehmann &lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt; converted this document to pod and 2181<p>Marc Lehmann &lt;rxvt@schmorp.de&gt; converted this document to pod and
2575reworked it from the original Rxvt documentation, which was done by Geoff 2182reworked it from the original Rxvt documentation, which was done by Geoff
2576Wing &lt;<a href="mailto:gcw@pobox.com">gcw@pobox.com</a>&gt;, who in turn used the XTerm documentation and other 2183Wing &lt;gcw@pobox.com&gt;, who in turn used the XTerm documentation and other
2577sources.</p> 2184sources.</p>
2578 2185
2579</body> 2186</div>
2580 2187</div></body>
2581</html> 2188</html>

Diff Legend

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