ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/cvsroot/rxvt-unicode/doc/rxvt.7.html
Revision: 1.87
Committed: Sun Nov 25 09:26:05 2007 UTC (18 years, 10 months ago) by root
Content type: text/html
Branch: MAIN
Changes since 1.86: +4 -5 lines
Log Message:
*** empty log message ***

File Contents

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