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