ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.html
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.html (file contents):
Revision 1.80 by root, Sat Jun 2 04:58:58 2007 UTC vs.
Revision 1.81 by root, Sun Jun 24 22:12:18 2007 UTC

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

Diff Legend

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