doc/rxvt.7.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml">
   3 <head>
   4 <title>REFERENCE - FAQ, command sequences and other background information</title>
   5 <link rev="made" href="mailto:perl-binary@plan9.de" />
   6 </head>
   7
   8 <body style="background-color: white">
   9
  10 <p><a name="__index__"></a></p>
  11 <!-- INDEX BEGIN -->
  12
  13 <ul>
  14
  15         <li><a href="#name">NAME</a></li>
  16         <li><a href="#synopsis">SYNOPSIS</a></li>
  17         <li><a href="#description">DESCRIPTION</a></li>
  18         <li><a href="#frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></li>
  19         <li><a href="#rxvt_technical_reference">RXVT TECHNICAL REFERENCE</a></li>
  20         <li><a href="#description">DESCRIPTION</a></li>
  21         <li><a href="#definitions">Definitions</a></li>
  22         <li><a href="#values">Values</a></li>
  23         <li><a href="#escape_sequences">Escape Sequences</a></li>
  24         <li><a href="#csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></li>
  25         <li><a href="#dec_private_modes">DEC Private Modes</a></li>
  26         <li><a href="#xterm_operating_system_commands">XTerm Operating System Commands</a></li>
  27         <li><a href="#menubar">menuBar</a></li>
  28         <ul>
  29
  30                 <li><a href="#overview_of_menubar_operation">Overview of menuBar operation</a></li>
  31                 <li><a href="#commands">Commands</a></li>
  32                 <li><a href="#adding_and_accessing_menus">Adding and accessing menus</a></li>
  33                 <li><a href="#removing_menus">Removing menus</a></li>
  34                 <li><a href="#quick_arrows">Quick Arrows</a></li>
  35                 <li><a href="#command_summary">Command Summary</a></li>
  36         </ul>
  37
  38         <li><a href="#xpm">XPM</a></li>
  39         <li><a href="#mouse_reporting">Mouse Reporting</a></li>
  40         <li><a href="#key_codes">Key Codes</a></li>
  41         <li><a href="#configure_options">CONFIGURE OPTIONS</a></li>
  42         <li><a href="#authors">AUTHORS</a></li>
  43 </ul>
  44 <!-- INDEX END -->
  45
  46 <hr />
  47 <p>
  48 </p>
  49 <h1><a name="name">NAME</a></h1>
  50 <p>RXVT REFERENCE - FAQ, command sequences and other background information</p>
  51 <p>
  52 </p>
  53 <hr />
  54 <h1><a name="synopsis">SYNOPSIS</a></h1>
  55 <pre>
  56    # set a new font set
  57    printf '\33]50;%s\007' 9x15,xft:Kochi&quot; Mincho&quot;</pre>
  58 <pre>
  59    # change the locale and tell rxvt-unicode about it
  60    export LC_CTYPE=ja_JP.EUC-JP; printf &quot;\33]701;$LC_CTYPE\007&quot;</pre>
  61 <pre>
  62    # set window title
  63    printf '\33]2;%s\007' &quot;new window title&quot;</pre>
  64 <p>
  65 </p>
  66 <hr />
  67 <h1><a name="description">DESCRIPTION</a></h1>
  68 <p>This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
  69 all escape sequences, and other background information.</p>
  70 <p>The newest version of this document is
  71 also available on the World Wide Web at
  72 <a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p>
  73 <p>
  74 </p>
  75 <hr />
  76 <h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1>
  77 <dl>
  78 <dt><strong><a name="item_how_do_i_know_which_rxvt_2dunicode_version_i_27m_u">How do I know which rxvt-unicode version I'm using?</a></strong><br />
  79 </dt>
  80 <dd>
  81 The version number is displayed with the usage (-h). Also the escape
  82 sequence <code>ESC [ 8 n</code> sets the window title to the version number.
  83 </dd>
  84 <p></p>
  85 <dt><strong><a name="item_i_am_using_debian_gnu_2flinux_and_have_a_problem_2">I am using Debian GNU/Linux and have a problem...</a></strong><br />
  86 </dt>
  87 <dd>
  88 The Debian GNU/Linux package of rxvt-unicode contains large patches that
  89 considerably change the behaviour of rxvt-unicode. Before reporting a
  90 bug to the original rxvt-unicode author please download and install the
  91 genuine version (<a href="http://software.schmorp.de#rxvt-unicode">http://software.schmorp.de#rxvt-unicode</a>) and try to
  92 reproduce the problem. If you cannot, chances are that the problems are
  93 specific to Debian GNU/Linux, in which case it should be reported via the
  94 Debian Bug Tracking System (use <code>reportbug</code> to report the bug).
  95 </dd>
  96 <dd>
  97 <p>For other problems that also affect the Debian package, you can and
  98 probably should use the Debian BTS, too, because, after all, it's also a
  99 bug in the Debian version and it serves as a reminder for other users that
 100 might encounter the same issue.</p>
 101 </dd>
 102 <p></p>
 103 <dt><strong><a name="item_when_i_log_2din_to_another_system_it_tells_me_abou">When I log-in to another system it tells me about missing terminfo data?</a></strong><br />
 104 </dt>
 105 <dd>
 106 The terminal description used by rxvt-unicode is not as widely available
 107 as that for xterm, or even rxvt (for which the same problem often arises).
 108 </dd>
 109 <dd>
 110 <p>The correct solution for this problem is to install the terminfo, this can
 111 be done like this (with ncurses' infocmp):</p>
 112 </dd>
 113 <dd>
 114 <pre>
 115    REMOTE=remotesystem.domain
 116    infocmp rxvt-unicode | ssh $REMOTE &quot;cat &gt;/tmp/ti &amp;&amp; tic /tmp/ti&quot;</pre>
 117 </dd>
 118 <dd>
 119 <p>... or by installing rxvt-unicode normally on the remote system,</p>
 120 </dd>
 121 <dd>
 122 <p>If you cannot or do not want to do this, then you can simply set
 123 <code>TERM=rxvt</code> or even <code>TERM=xterm</code>, and live with the small number of
 124 problems arising, which includes wrong keymapping, less and different
 125 colours and some refresh errors in fullscreen applications. It's a nice
 126 quick-and-dirty workaround for rare cases, though.</p>
 127 </dd>
 128 <dd>
 129 <p>If you always want to do this (and are fine with the consequences) you
 130 can either recompile rxvt-unicode with the desired TERM value or use a
 131 resource to set it:</p>
 132 </dd>
 133 <dd>
 134 <pre>
 135    URxvt.termName: rxvt</pre>
 136 </dd>
 137 <dd>
 138 <p>If you don't plan to use <strong>rxvt</strong> (quite common...) you could also replace
 139 the rxvt terminfo file with the rxvt-unicode one.</p>
 140 </dd>
 141 <p></p>
 142 <dt><strong><a name="item_bash_27s_readline_does_not_work_correctly_under_rx"><code>bash</code>'s readline does not work correctly under rxvt.</a></strong><br />
 143 </dt>
 144 <dt><strong><a name="item_i_need_a_termcap_file_entry_2e">I need a termcap file entry.</a></strong><br />
 145 </dt>
 146 <dd>
 147 One reason you might want this is that some distributions or operating
 148 systems still compile some programs using the long-obsoleted termcap
 149 (Fedora Core's bash is one example) and rely on a termcap entry for
 150 <code>rxvt-unicode</code>.
 151 </dd>
 152 <dd>
 153 <p>You could use rxvt's termcap entry with resonable results in many cases.
 154 You can also create a termcap entry by using terminfo's infocmp program
 155 like this:</p>
 156 </dd>
 157 <dd>
 158 <pre>
 159    infocmp -C rxvt-unicode</pre>
 160 </dd>
 161 <dd>
 162 <p>Or you could use this termcap entry, generated by the command above:</p>
 163 </dd>
 164 <dd>
 165 <pre>
 166    rxvt-unicode|rxvt-unicode terminal (X Window System):\
 167            :am:bw:eo:km:mi:ms:xn:xo:\
 168            :co#80:it#8:li#24:\
 169            :AL=\E[%dL:DC=\E[%dP:DL=\E[%dM:DO=\E[%dB:IC=\E[%d@:\
 170            :K1=\EOw:K2=\EOu:K3=\EOy:K4=\EOq:K5=\EOs:LE=\E[%dD:\
 171            :RI=\E[%dC:SF=\E[%dS:SR=\E[%dT:UP=\E[%dA:ae=^O:al=\E[L:\
 172            :as=^N:bl=^G:cd=\E[J:ce=\E[K:cl=\E[H\E[2J:cm=\E[%i%d;%dH:\
 173            :cr=^M:cs=\E[%i%d;%dr:ct=\E[3g:dc=\E[P:dl=\E[M:do=^J:\
 174            :ec=\E[%dX:ei=\E[4l:ho=\E[H:i1=\E[?47l\E=\E[?1l:ic=\E[@:\
 175            :im=\E[4h:is=\E[r\E[m\E[2J\E[H\E[?7h\E[?1;3;4;6l\E[4l:\
 176            :k0=\E[21~:k1=\E[11~:k2=\E[12~:k3=\E[13~:k4=\E[14~:\
 177            :k5=\E[15~:k6=\E[17~:k7=\E[18~:k8=\E[19~:k9=\E[20~:\
 178            :kD=\E[3~:kI=\E[2~:kN=\E[6~:kP=\E[5~:kb=\177:kd=\EOB:\
 179            :ke=\E[?1l\E&gt;:kh=\E[7~:kl=\EOD:kr=\EOC:ks=\E[?1h\E=:\
 180            :ku=\EOA:le=^H:mb=\E[5m:md=\E[1m:me=\E[m\017:mr=\E[7m:\
 181            :nd=\E[C:rc=\E8:sc=\E7:se=\E[27m:sf=^J:so=\E[7m:sr=\EM:\
 182            :st=\EH:ta=^I:te=\E[r\E[?1049l:ti=\E[?1049h:ue=\E[24m:\
 183            :up=\E[A:us=\E[4m:vb=\E[?5h\E[?5l:ve=\E[?25h:vi=\E[?25l:\
 184            :vs=\E[?25h:</pre>
 185 </dd>
 186 <p></p>
 187 <dt><strong><a name="item_why_does_ls_no_longer_have_coloured_output_3f">Why does <code>ls</code> no longer have coloured output?</a></strong><br />
 188 </dt>
 189 <dd>
 190 The <code>ls</code> in the GNU coreutils unfortunately doesn't use terminfo to
 191 decide wether a terminal has colour, but uses it's own configuration
 192 file. Needless to say, <code>rxvt-unicode</code> is not in it's default file (among
 193 with most other terminals supporting colour). Either add:
 194 </dd>
 195 <dd>
 196 <pre>
 197    TERM rxvt-unicode</pre>
 198 </dd>
 199 <dd>
 200 <p>to <code>/etc/DIR_COLORS</code> or simply add:</p>
 201 </dd>
 202 <dd>
 203 <pre>
 204    alias ls='ls --color=auto'</pre>
 205 </dd>
 206 <dd>
 207 <p>to your <code>.profile</code> or <code>.bashrc</code>.</p>
 208 </dd>
 209 <p></p>
 210 <dt><strong><a name="item_why_doesn_27t_vim_2femacs_etc_2e_use_the_88_colour">Why doesn't vim/emacs etc. use the 88 colour mode?</a></strong><br />
 211 </dt>
 212 <dt><strong><a name="item_why_doesn_27t_vim_2femacs_etc_2e_make_use_of_itali">Why doesn't vim/emacs etc. make use of italic?</a></strong><br />
 213 </dt>
 214 <dt><strong><a name="item_why_are_the_secondary_screen_2drelated_options_not">Why are the secondary screen-related options not working properly?</a></strong><br />
 215 </dt>
 216 <dd>
 217 Make sure you are using <code>TERM=rxvt-unicode</code>. Some pre-packaged
 218 distributions (most notably Debian GNU/Linux) break rxvt-unicode
 219 by setting <code>TERM</code> to <code>rxvt</code>, which doesn't have these extra
 220 features. Unfortunately, some of these (most notably, again, Debian
 221 GNU/Linux) furthermore fail to even install the <code>rxvt-unicode</code> terminfo
 222 file, so you will need to install it on your own (See the question <strong>When
 223 I log-in to another system it tells me about missing terminfo data?</strong> on
 224 how to do this).
 225 </dd>
 226 <p></p>
 227 <dt><strong><a name="item_my_numerical_keypad_acts_weird_and_generates_diffe">My numerical keypad acts weird and generates differing output?</a></strong><br />
 228 </dt>
 229 <dd>
 230 Some Debian GNUL/Linux users seem to have this problem, although no
 231 specific details were reported so far. It is possible that this is caused
 232 by the wrong <code>TERM</code> setting, although the details of wether and how
 233 this can happen are unknown, as <code>TERM=rxvt</code> should offer a compatible
 234 keymap. See the answer to the previous question, and please report if that
 235 helped.
 236 </dd>
 237 <p></p>
 238 <dt><strong><a name="item_rxvt_2dunicode_does_not_seem_to_understand_the_sel">Rxvt-unicode does not seem to understand the selected encoding?</a></strong><br />
 239 </dt>
 240 <dt><strong><a name="item_unicode_does_not_seem_to_work_3f">Unicode does not seem to work?</a></strong><br />
 241 </dt>
 242 <dd>
 243 If you encounter strange problems like typing an accented character but
 244 getting two unrelated other characters or similar, or if program output is
 245 subtly garbled, then you should check your locale settings.
 246 </dd>
 247 <dd>
 248 <p>Rxvt-unicode must be started with the same <code>LC_CTYPE</code> setting as the
 249 programs. Often rxvt-unicode is started in the <a href="#item_c"><code>C</code></a> locale, while the
 250 login script running within the rxvt-unicode window changes the locale to
 251 something else, e.g. <code>en_GB.UTF-8</code>. Needless to say, this is not going to work.</p>
 252 </dd>
 253 <dd>
 254 <p>The best thing is to fix your startup environment, as you will likely run
 255 into other problems. If nothing works you can try this in your .profile.</p>
 256 </dd>
 257 <dd>
 258 <pre>
 259   printf '\e]701;%s\007' &quot;$LC_CTYPE&quot;</pre>
 260 </dd>
 261 <dd>
 262 <p>If this doesn't work, then maybe you use a <code>LC_CTYPE</code> specification not
 263 supported on your systems. Some systems have a <code>locale</code> command which
 264 displays this (also, <code>perl -e0</code> can be used to check locale settings, as
 265 it will complain loudly if it cannot set the locale). If it displays something
 266 like:</p>
 267 </dd>
 268 <dd>
 269 <pre>
 270   locale: Cannot set LC_CTYPE to default locale: ...</pre>
 271 </dd>
 272 <dd>
 273 <p>Then the locale you specified is not supported on your system.</p>
 274 </dd>
 275 <dd>
 276 <p>If nothing works and you are sure that everything is set correctly then
 277 you will need to remember a little known fact: Some programs just don't
 278 support locales :(</p>
 279 </dd>
 280 <p></p>
 281 <dt><strong><a name="item_why_do_some_characters_look_so_much_different_than">Why do some characters look so much different than others?</a></strong><br />
 282 </dt>
 283 <dt><strong><a name="item_how_does_rxvt_2dunicode_choose_fonts_3f">How does rxvt-unicode choose fonts?</a></strong><br />
 284 </dt>
 285 <dd>
 286 Most fonts do not contain the full range of Unicode, which is
 287 fine. Chances are that the font you (or the admin/package maintainer of
 288 your system/os) have specified does not cover all the characters you want
 289 to display.
 290 </dd>
 291 <dd>
 292 <p><strong>rxvt-unicode</strong> makes a best-effort try at finding a replacement
 293 font. Often the result is fine, but sometimes the chosen font looks
 294 bad/ugly/wrong. Some fonts have totally strange characters that don't
 295 resemble the correct glyph at all, and rxvt-unicode lacks the artificial
 296 intelligence to detect that a specific glyph is wrong: it has to believe
 297 the font that the characters it claims to contain indeed look correct.</p>
 298 </dd>
 299 <dd>
 300 <p>In that case, select a font of your taste and add it to the font list,
 301 e.g.:</p>
 302 </dd>
 303 <dd>
 304 <pre>
 305    rxvt -fn basefont,font2,font3...</pre>
 306 </dd>
 307 <dd>
 308 <p>When rxvt-unicode sees a character, it will first look at the base
 309 font. If the base font does not contain the character, it will go to the
 310 next font, and so on. Specifying your own fonts will also speed up this
 311 search and use less resources within rxvt-unicode and the X-server.</p>
 312 </dd>
 313 <dd>
 314 <p>The only limitation is that none of the fonts may be larger than the base
 315 font, as the base font defines the terminal character cell size, which
 316 must be the same due to the way terminals work.</p>
 317 </dd>
 318 <p></p>
 319 <dt><strong><a name="item_why_do_some_chinese_characters_look_so_different_t">Why do some chinese characters look so different than others?</a></strong><br />
 320 </dt>
 321 <dd>
 322 This is because there is a difference between script and language --
 323 rxvt-unicode does not know which language the text that is output is,
 324 as it only knows the unicode character codes. If rxvt-unicode first
 325 sees a japanese/chinese character, it might choose a japanese font for
 326 display. Subsequent japanese characters will use that font. Now, many
 327 chinese characters aren't represented in japanese fonts, so when the first
 328 non-japanese character comes up, rxvt-unicode will look for a chinese font
 329 -- unfortunately at this point, it will still use the japanese font for
 330 chinese characters that are also in the japanese font.
 331 </dd>
 332 <dd>
 333 <p>The workaround is easy: just tag a chinese font at the end of your font
 334 list (see the previous question). The key is to view the font list as
 335 a preference list: If you expect more japanese, list a japanese font
 336 first. If you expect more chinese, put a chinese font first.</p>
 337 </dd>
 338 <dd>
 339 <p>In the future it might be possible to switch language preferences at
 340 runtime (the internal data structure has no problem with using different
 341 fonts for the same character at the same time, but no interface for this
 342 has been designed yet).</p>
 343 </dd>
 344 <dd>
 345 <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>
 346 </dd>
 347 <p></p>
 348 <dt><strong><a name="item_why_does_rxvt_2dunicode_sometimes_leave_pixel_drop">Why does rxvt-unicode sometimes leave pixel droppings?</a></strong><br />
 349 </dt>
 350 <dd>
 351 Most fonts were not designed for terminal use, which means that character
 352 size varies a lot. A font that is otherwise fine for terminal use might
 353 contain some characters that are simply too wide. Rxvt-unicode will avoid
 354 these characters. For characters that are just ``a bit'' too wide a special
 355 ``careful'' rendering mode is used that redraws adjacent characters.
 356 </dd>
 357 <dd>
 358 <p>All of this requires that fonts do not lie about character sizes,
 359 however: Xft fonts often draw glyphs larger than their acclaimed bounding
 360 box, and rxvt-unicode has no way of detecting this (the correct way is to
 361 ask for the character bounding box, which unfortunately is wrong in these
 362 cases).</p>
 363 </dd>
 364 <dd>
 365 <p>It's not clear (to me at least), wether this is a bug in Xft, freetype,
 366 or the respective font. If you encounter this problem you might try using
 367 the <code>-lsp</code> option to give the font more height. If that doesn't work, you
 368 might be forced to use a different font.</p>
 369 </dd>
 370 <dd>
 371 <p>All of this is not a problem when using X11 core fonts, as their bounding
 372 box data is correct.</p>
 373 </dd>
 374 <p></p>
 375 <dt><strong><a name="item_compose">My Compose (Multi_key) key is no longer working.</a></strong><br />
 376 </dt>
 377 <dd>
 378 The most common causes for this are that either your locale is not set
 379 correctly, or you specified a <strong>preeditStyle</strong> that is not supported by
 380 your input method. For example, if you specified <strong>OverTheSpot</strong> and
 381 your input method (e.g. the default input method handling Compose keys)
 382 does not support this (for instance because it is not visual), then
 383 rxvt-unicode will continue without an input method.
 384 </dd>
 385 <dd>
 386 <p>In this case either do not specify a <strong>preeditStyle</strong> or specify more than
 387 one pre-edit style, such as <strong>OverTheSpot,Root,None</strong>.</p>
 388 </dd>
 389 <p></p>
 390 <dt><strong><a name="item_i_cannot_type_ctrl_2dshift_2d2_to_get_an_ascii_nul">I cannot type <code>Ctrl-Shift-2</code> to get an ASCII NUL character due to ISO 14755</a></strong><br />
 391 </dt>
 392 <dd>
 393 Either try <code>Ctrl-2</code> alone (it often is mapped to ASCII NUL even on
 394 international keyboards) or simply use ISO 14755 support to your
 395 advantage, typing &lt;Ctrl-Shift-0&gt; to get a ASCII NUL. This works for other
 396 codes, too, such as <code>Ctrl-Shift-1-d</code> to type the default telnet escape
 397 character and so on.
 398 </dd>
 399 <p></p>
 400 <dt><strong><a name="item_how_can_i_keep_rxvt_2dunicode_from_using_reverse_v">How can I keep rxvt-unicode from using reverse video so much?</a></strong><br />
 401 </dt>
 402 <dd>
 403 First of all, make sure you are running with the right terminal settings
 404 (<code>TERM=rxvt-unicode</code>), which will get rid of most of these effects. Then
 405 make sure you have specified colours for italic and bold, as otherwise
 406 rxvt-unicode might use reverse video to simulate the effect:
 407 </dd>
 408 <dd>
 409 <pre>
 410    URxvt.colorBD:  white
 411    URxvt.colorIT:  green</pre>
 412 </dd>
 413 <p></p>
 414 <dt><strong><a name="item_colours">Some programs assume totally weird colours (red instead of blue), how can I fix that?</a></strong><br />
 415 </dt>
 416 <dd>
 417 For some unexplainable reason, some rare programs assume a very weird
 418 colour palette when confronted with a terminal with more than the standard
 419 8 colours (rxvt-unicode supports 88). The right fix is, of course, to fix
 420 these programs not to assume non-ISO colours without very good reasons.
 421 </dd>
 422 <dd>
 423 <p>In the meantime, you can either edit your <code>rxvt-unicode</code> terminfo
 424 definition to only claim 8 colour support or use <code>TERM=rxvt</code>, which will
 425 fix colours but keep you from using other rxvt-unicode features.</p>
 426 </dd>
 427 <p></p>
 428 <dt><strong><a name="item_i_am_on_freebsd_and_rxvt_2dunicode_does_not_seem_t">I am on FreeBSD and rxvt-unicode does not seem to work at all.</a></strong><br />
 429 </dt>
 430 <dd>
 431 Rxvt-unicode requires the symbol <code>__STDC_ISO_10646__</code> to be defined
 432 in your compile environment, or an implementation that implements it,
 433 wether it defines the symbol or not. <code>__STDC_ISO_10646__</code> requires that
 434 <strong>wchar_t</strong> is represented as unicode.
 435 </dd>
 436 <dd>
 437 <p>As you might have guessed, FreeBSD does neither define this symobl nor
 438 does it support it. Instead, it uses it's own internal representation of
 439 <strong>wchar_t</strong>. This is, of course, completely fine with respect to standards.</p>
 440 </dd>
 441 <dd>
 442 <p>However, <code>__STDC_ISO_10646__</code> is the only sane way to support
 443 multi-language apps in an OS, as using a locale-dependent (and
 444 non-standardized) representation of <strong>wchar_t</strong> makes it impossible to
 445 convert between <strong>wchar_t</strong> (as used by X11 and your applications) and any
 446 other encoding without implementing OS-specific-wrappers for each and
 447 every locale. There simply are no APIs to convert <strong>wchar_t</strong> into anything
 448 except the current locale encoding.</p>
 449 </dd>
 450 <dd>
 451 <p>Some applications (such as the formidable <strong>mlterm</strong>) work around this
 452 by carrying their own replacement functions for character set handling
 453 with them, and either implementing OS-dependent hacks or doing multiple
 454 conversions (which is slow and unreliable in case the OS implements
 455 encodings slightly different than the terminal emulator).</p>
 456 </dd>
 457 <dd>
 458 <p>The rxvt-unicode author insists that the right way to fix this is in the
 459 system libraries once and for all, instead of forcing every app to carry
 460 complete replacements for them :)</p>
 461 </dd>
 462 <p></p>
 463 <dt><strong><a name="item_how_does_rxvt_2dunicode_determine_the_encoding_to_">How does rxvt-unicode determine the encoding to use?</a></strong><br />
 464 </dt>
 465 <dt><strong><a name="item_is_there_an_option_to_switch_encodings_3f">Is there an option to switch encodings?</a></strong><br />
 466 </dt>
 467 <dd>
 468 Unlike some other terminals, rxvt-unicode has no encoding switch, and no
 469 specific ``utf-8'' mode, such as xterm. In fact, it doesn't even know about
 470 UTF-8 or any other encodings with respect to terminal I/O.
 471 </dd>
 472 <dd>
 473 <p>The reasons is that there exists a perfectly fine mechanism for selecting
 474 the encoding, doing I/O and (most important) communicating this to all
 475 applications so everybody agrees on character properties such as width
 476 and code number. This mechanism is the <em>locale</em>. Applications not using
 477 that info will have problems (for example, <code>xterm</code> gets the width of
 478 characters wrong as it uses it's own, locale-independent table under all
 479 locales).</p>
 480 </dd>
 481 <dd>
 482 <p>Rxvt-unicode uses the <code>LC_CTYPE</code> locale category to select encoding. All
 483 programs doing the same (that is, most) will automatically agree in the
 484 interpretation of characters.</p>
 485 </dd>
 486 <dd>
 487 <p>Unfortunately, there is no system-independent way to select locales, nor
 488 is there a standard on how locale specifiers will look like.</p>
 489 </dd>
 490 <dd>
 491 <p>On most systems, the content of the <code>LC_CTYPE</code> environment variable
 492 contains an arbitrary string which corresponds to an already-installed
 493 locale. Common names for locales are <code>en_US.UTF-8</code>, <code>de_DE.ISO-8859-15</code>,
 494 <code>ja_JP.EUC-JP</code>, i.e. <code>language_country.encoding</code>, but other forms
 495 (i.e. <code>de</code> or <code>german</code>) are also common.</p>
 496 </dd>
 497 <dd>
 498 <p>Rxvt-unicode ignores all other locale categories, and except for
 499 the encoding, ignores country or language-specific settings,
 500 i.e. <code>de_DE.UTF-8</code> and <code>ja_JP.UTF-8</code> are the normally same to
 501 rxvt-unicode.</p>
 502 </dd>
 503 <dd>
 504 <p>If you want to use a specific encoding you have to make sure you start
 505 rxvt-unicode with the correct <code>LC_CTYPE</code> category.</p>
 506 </dd>
 507 <p></p>
 508 <dt><strong><a name="item_can_i_switch_locales_at_runtime_3f">Can I switch locales at runtime?</a></strong><br />
 509 </dt>
 510 <dd>
 511 Yes, using an escape sequence. Try something like this, which sets
 512 rxvt-unicode's idea of <code>LC_CTYPE</code>.
 513 </dd>
 514 <dd>
 515 <pre>
 516   printf '\e]701;%s\007' ja_JP.SJIS</pre>
 517 </dd>
 518 <dd>
 519 <p>See also the previous answer.</p>
 520 </dd>
 521 <dd>
 522 <p>Sometimes this capability is rather handy when you want to work in
 523 one locale (e.g. <code>de_DE.UTF-8</code>) but some programs don't support it
 524 (e.g. UTF-8). For example, I use this script to start <code>xjdic</code>, which
 525 first switches to a locale supported by xjdic and back later:</p>
 526 </dd>
 527 <dd>
 528 <pre>
 529    printf '\e]701;%s\007' ja_JP.SJIS
 530    xjdic -js
 531    printf '\e]701;%s\007' de_DE.UTF-8</pre>
 532 </dd>
 533 <dd>
 534 <p>You can also use xterm's <code>luit</code> program, which usually works fine, except
 535 for some locales where character width differs between program- and
 536 rxvt-unicode-locales.</p>
 537 </dd>
 538 <p></p>
 539 <dt><strong><a name="item_can_i_switch_the_fonts_at_runtime_3f">Can I switch the fonts at runtime?</a></strong><br />
 540 </dt>
 541 <dd>
 542 Yes, using an escape sequence. Try something like this, which has the same
 543 effect as using the <code>-fn</code> switch, and takes effect immediately:
 544 </dd>
 545 <dd>
 546 <pre>
 547    printf '\e]50;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre>
 548 </dd>
 549 <dd>
 550 <p>This is useful if you e.g. work primarily with japanese (and prefer a
 551 japanese font), but you have to switch to chinese temporarily, where
 552 japanese fonts would only be in your way.</p>
 553 </dd>
 554 <dd>
 555 <p>You can think of this as a kind of manual ISO-2022 switching.</p>
 556 </dd>
 557 <p></p>
 558 <dt><strong><a name="item_why_do_italic_characters_look_as_if_clipped_3f">Why do italic characters look as if clipped?</a></strong><br />
 559 </dt>
 560 <dd>
 561 Many fonts have difficulties with italic characters and hinting. For
 562 example, the otherwise very nicely hinted font <code>xft:Bitstream Vera Sans
 563 Mono</code> completely fails in it's italic face. A workaround might be to
 564 enable freetype autohinting, i.e. like this:
 565 </dd>
 566 <dd>
 567 <pre>
 568    URxvt.italicFont:        xft:Bitstream Vera Sans Mono:italic:autohint=true
 569    URxvt.boldItalicFont:    xft:Bitstream Vera Sans Mono:bold:italic:autohint=true</pre>
 570 </dd>
 571 <p></p>
 572 <dt><strong><a name="item_my_input_method_wants__3csome_encoding_3e_but_i_wa">My input method wants &lt;some encoding&gt; but I want UTF-8, what can I do?</a></strong><br />
 573 </dt>
 574 <dd>
 575 You can specify separate locales for the input method and the rest of the
 576 terminal, using the resource <code>imlocale</code>:
 577 </dd>
 578 <dd>
 579 <pre>
 580    URxvt*imlocale: ja_JP.EUC-JP</pre>
 581 </dd>
 582 <dd>
 583 <p>Now you can start your terminal with <code>LC_CTYPE=ja_JP.UTF-8</code> and still
 584 use your input method. Please note, however, that you will not be able to
 585 input characters outside <code>EUC-JP</code> in a normal way then, as your input
 586 method limits you.</p>
 587 </dd>
 588 <p></p>
 589 <dt><strong><a name="item_rxvt_2dunicode_uses_gobs_of_memory_2c_how_can_i_re">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></strong><br />
 590 </dt>
 591 <dd>
 592 Rxvt-unicode tries to obey the rule of not charging you for something you
 593 don't use. One thing you should try is to configure out all settings that
 594 you don't need, for example, Xft support is a resource hog by design,
 595 when used. Compiling it out ensures that no Xft font will be loaded
 596 accidentally when rxvt-unicode tries to find a font for your characters.
 597 </dd>
 598 <dd>
 599 <p>Also, many people (me included) like large windows and even larger
 600 scrollback buffers: Without <a href="#item__2d_2denable_2dunicode3"><code>--enable-unicode3</code></a>, rxvt-unicode will use
 601 6 bytes per screen cell. For a 160x?? window this amounts to almost a
 602 kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
 603 use 10 Megabytes of memory. With <a href="#item__2d_2denable_2dunicode3"><code>--enable-unicode3</code></a> it gets worse, as
 604 rxvt-unicode then uses 8 bytes per screen cell.</p>
 605 </dd>
 606 <p></p>
 607 <dt><strong><a name="item_can_i_speed_up_xft_rendering_somehow_3f">Can I speed up Xft rendering somehow?</a></strong><br />
 608 </dt>
 609 <dd>
 610 Yes, the most obvious way to speed it up is to avoid Xft entirely, as
 611 it is simply slow. If you still want Xft fonts you might try to disable
 612 antialiasing (by appending <code>:antialiasing=false</code>), which saves lots of
 613 memory and also speeds up rendering considerably.
 614 </dd>
 615 <p></p>
 616 <dt><strong><a name="item_rxvt_2dunicode_doesn_27t_seem_to_anti_2dalias_its_">Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?</a></strong><br />
 617 </dt>
 618 <dd>
 619 Rxvt-unicode will use whatever you specify as a font. If it needs to
 620 fall back to it's default font search list it will prefer X11 core
 621 fonts, because they are small and fast, and then use Xft fonts. It has
 622 antialiasing disabled for most of them, because the author thinks they
 623 look best that way.
 624 </dd>
 625 <dd>
 626 <p>If you want antialiasing, you have to specify the fonts manually.</p>
 627 </dd>
 628 <p></p>
 629 <dt><strong><a name="item_mouse_cut_2fpaste_suddenly_no_longer_works_2e">Mouse cut/paste suddenly no longer works.</a></strong><br />
 630 </dt>
 631 <dd>
 632 Make sure that mouse reporting is actually turned off since killing
 633 some editors prematurely may leave the mouse in mouse report mode. I've
 634 heard that tcsh may use mouse reporting unless it otherwise specified. A
 635 quick check is to see if cut/paste works when the Alt or Shift keys are
 636 depressed. See <code>rxvt(7)</code>
 637 </dd>
 638 <p></p>
 639 <dt><strong><a name="item_what_27s_with_this_bold_2fblink_stuff_3f">What's with this bold/blink stuff?</a></strong><br />
 640 </dt>
 641 <dd>
 642 If no bold colour is set via <code>colorBD:</code>, bold will invert text using the
 643 standard foreground colour.
 644 </dd>
 645 <dd>
 646 <p>For the standard background colour, blinking will actually make the
 647 text blink when compiled with <code>--enable-blinking</code>. with standard
 648 colours. Without <code>--enable-blinking</code>, the blink attribute will be
 649 ignored.</p>
 650 </dd>
 651 <dd>
 652 <p>On ANSI colours, bold/blink attributes are used to set high-intensity
 653 foreground/background colors.</p>
 654 </dd>
 655 <dd>
 656 <p>color0-7 are the low-intensity colors.</p>
 657 </dd>
 658 <dd>
 659 <p>color8-15 are the corresponding high-intensity colors.</p>
 660 </dd>
 661 <p></p>
 662 <dt><strong><a name="item_i_don_27t_like_the_screen_colors_2e_how_do_i_chang">I don't like the screen colors.  How do I change them?</a></strong><br />
 663 </dt>
 664 <dd>
 665 You can change the screen colors at run-time using <em>~/.Xdefaults</em>
 666 resources (or as long-options).
 667 </dd>
 668 <dd>
 669 <p>Here are values that are supposed to resemble a VGA screen,
 670 including the murky brown that passes for low-intensity yellow:</p>
 671 </dd>
 672 <dd>
 673 <pre>
 674    URxvt.color0:   #000000
 675    URxvt.color1:   #A80000
 676    URxvt.color2:   #00A800
 677    URxvt.color3:   #A8A800
 678    URxvt.color4:   #0000A8
 679    URxvt.color5:   #A800A8
 680    URxvt.color6:   #00A8A8
 681    URxvt.color7:   #A8A8A8</pre>
 682 </dd>
 683 <dd>
 684 <pre>
 685    URxvt.color8:   #000054
 686    URxvt.color9:   #FF0054
 687    URxvt.color10:  #00FF54
 688    URxvt.color11:  #FFFF54
 689    URxvt.color12:  #0000FF
 690    URxvt.color13:  #FF00FF
 691    URxvt.color14:  #00FFFF
 692    URxvt.color15:  #FFFFFF</pre>
 693 </dd>
 694 <dd>
 695 <p>And here is a more complete set of non-standard colors described (not by
 696 me) as ``pretty girly''.</p>
 697 </dd>
 698 <dd>
 699 <pre>
 700    URxvt.cursorColor:  #dc74d1
 701    URxvt.pointerColor: #dc74d1
 702    URxvt.background:   #0e0e0e
 703    URxvt.foreground:   #4ad5e1
 704    URxvt.color0:       #000000
 705    URxvt.color8:       #8b8f93
 706    URxvt.color1:       #dc74d1
 707    URxvt.color9:       #dc74d1
 708    URxvt.color2:       #0eb8c7
 709    URxvt.color10:      #0eb8c7
 710    URxvt.color3:       #dfe37e
 711    URxvt.color11:      #dfe37e
 712    URxvt.color5:       #9e88f0
 713    URxvt.color13:      #9e88f0
 714    URxvt.color6:       #73f7ff
 715    URxvt.color14:      #73f7ff
 716    URxvt.color7:       #e1dddd
 717    URxvt.color15:      #e1dddd</pre>
 718 </dd>
 719 <p></p>
 720 <dt><strong><a name="item_how_can_i_start_rxvtd_in_a_race_2dfree_way_3f">How can I start rxvtd in a race-free way?</a></strong><br />
 721 </dt>
 722 <dd>
 723 Despite it's name, rxvtd is not a real daemon, but more like a
 724 server that answers rxvtc's requests, so it doesn't background
 725 itself.
 726 </dd>
 727 <dd>
 728 <p>To ensure rxvtd is listening on it's socket, you can use the
 729 following method to wait for the startup message before continuing:</p>
 730 </dd>
 731 <dd>
 732 <pre>
 733   { rxvtd &amp; } | read</pre>
 734 </dd>
 735 <p></p>
 736 <dt><strong><a name="item_what_27s_with_the_strange_backspace_2fdelete_key_b">What's with the strange Backspace/Delete key behaviour?</a></strong><br />
 737 </dt>
 738 <dd>
 739 Assuming that the physical Backspace key corresponds to the
 740 BackSpace keysym (not likely for Linux ... see the following
 741 question) there are two standard values that can be used for
 742 Backspace: <code>^H</code> and <code>^?</code>.
 743 </dd>
 744 <dd>
 745 <p>Historically, either value is correct, but rxvt-unicode adopts the debian
 746 policy of using <code>^?</code> when unsure, because it's the one only only correct
 747 choice :).</p>
 748 </dd>
 749 <dd>
 750 <p>Rxvt-unicode tries to inherit the current stty settings and uses the value
 751 of `erase' to guess the value for backspace.  If rxvt-unicode wasn't
 752 started from a terminal (say, from a menu or by remote shell), then the
 753 system value of `erase', which corresponds to CERASE in &lt;termios.h&gt;, will
 754 be used (which may not be the same as your stty setting).</p>
 755 </dd>
 756 <dd>
 757 <p>For starting a new rxvt-unicode:</p>
 758 </dd>
 759 <dd>
 760 <pre>
 761    # use Backspace = ^H
 762    $ stty erase ^H
 763    $ rxvt</pre>
 764 </dd>
 765 <dd>
 766 <pre>
 767    # use Backspace = ^?
 768    $ stty erase ^?
 769    $ rxvt</pre>
 770 </dd>
 771 <dd>
 772 <p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code> as documented in rxvt(7).</p>
 773 </dd>
 774 <dd>
 775 <p>For an existing rxvt-unicode:</p>
 776 </dd>
 777 <dd>
 778 <pre>
 779    # use Backspace = ^H
 780    $ stty erase ^H
 781    $ echo -n &quot;^[[36h&quot;</pre>
 782 </dd>
 783 <dd>
 784 <pre>
 785    # use Backspace = ^?
 786    $ stty erase ^?
 787    $ echo -n &quot;^[[36l&quot;</pre>
 788 </dd>
 789 <dd>
 790 <p>This helps satisfy some of the Backspace discrepancies that occur, but
 791 if you use Backspace = <code>^H</code>, make sure that the termcap/terminfo value
 792 properly reflects that.</p>
 793 </dd>
 794 <dd>
 795 <p>The Delete key is a another casualty of the ill-defined Backspace problem.
 796 To avoid confusion between the Backspace and Delete keys, the Delete
 797 key has been assigned an escape sequence to match the vt100 for Execute
 798 (<code>ESC [ 3 ~</code>) and is in the supplied termcap/terminfo.</p>
 799 </dd>
 800 <dd>
 801 <p>Some other Backspace problems:</p>
 802 </dd>
 803 <dd>
 804 <p>some editors use termcap/terminfo,
 805 some editors (vim I'm told) expect Backspace = ^H,
 806 GNU Emacs (and Emacs-like editors) use ^H for help.</p>
 807 </dd>
 808 <dd>
 809 <p>Perhaps someday this will all be resolved in a consistent manner.</p>
 810 </dd>
 811 <p></p>
 812 <dt><strong><a name="item_i_don_27t_like_the_key_2dbindings_2e_how_do_i_chan">I don't like the key-bindings.  How do I change them?</a></strong><br />
 813 </dt>
 814 <dd>
 815 There are some compile-time selections available via configure. Unless
 816 you have run ``configure'' with the <a href="#item__2d_2ddisable_2dresources"><code>--disable-resources</code></a> option you can
 817 use the `keysym' resource to alter the keystrings associated with keysyms.
 818 </dd>
 819 <dd>
 820 <p>Here's an example for a URxvt session started using <code>rxvt -name URxvt</code></p>
 821 </dd>
 822 <dd>
 823 <pre>
 824    URxvt.keysym.Home:          \033[1~
 825    URxvt.keysym.End:           \033[4~
 826    URxvt.keysym.C-apostrophe:  \033&lt;C-'&gt;
 827    URxvt.keysym.C-slash:       \033&lt;C-/&gt;
 828    URxvt.keysym.C-semicolon:   \033&lt;C-;&gt;
 829    URxvt.keysym.C-grave:       \033&lt;C-`&gt;
 830    URxvt.keysym.C-comma:       \033&lt;C-,&gt;
 831    URxvt.keysym.C-period:      \033&lt;C-.&gt;
 832    URxvt.keysym.C-0x60:        \033&lt;C-`&gt;
 833    URxvt.keysym.C-Tab:         \033&lt;C-Tab&gt;
 834    URxvt.keysym.C-Return:      \033&lt;C-Return&gt;
 835    URxvt.keysym.S-Return:      \033&lt;S-Return&gt;
 836    URxvt.keysym.S-space:       \033&lt;S-Space&gt;
 837    URxvt.keysym.M-Up:          \033&lt;M-Up&gt;
 838    URxvt.keysym.M-Down:        \033&lt;M-Down&gt;
 839    URxvt.keysym.M-Left:        \033&lt;M-Left&gt;
 840    URxvt.keysym.M-Right:       \033&lt;M-Right&gt;
 841    URxvt.keysym.M-C-0:         list \033&lt;M-C- 0123456789 &gt;
 842    URxvt.keysym.M-C-a:         list \033&lt;M-C- abcdefghijklmnopqrstuvwxyz &gt;
 843    URxvt.keysym.F12:           command:\033]701;zh_CN.GBK\007</pre>
 844 </dd>
 845 <dd>
 846 <p>See some more examples in the documentation for the <strong>keysym</strong> resource.</p>
 847 </dd>
 848 <p></p>
 849 <dt><strong><a name="item_i_27m_using_keyboard_model_xxx_that_has_extra_prio">I'm using keyboard model XXX that has extra Prior/Next/Insert keys.
 850 How do I make use of them?  For example, the Sun Keyboard type 4
 851 has the following mappings that rxvt-unicode doesn't recognize.</a></strong><br />
 852 </dt>
 853 <dd>
 854 <pre>
 855    KP_Insert == Insert
 856    F22 == Print
 857    F27 == Home
 858    F29 == Prior
 859    F33 == End
 860    F35 == Next</pre>
 861 </dd>
 862 <dd>
 863 <p>Rather than have rxvt-unicode try to accommodate all the various possible
 864 keyboard mappings, it is better to use `xmodmap' to remap the keys as
 865 required for your particular machine.</p>
 866 </dd>
 867 <dt><strong><a name="item_how_do_i_distinguish_wether_i_27m_running_rxvt_2du">How do I distinguish wether I'm running rxvt-unicode or a regular xterm?
 868 I need this to decide about setting colors etc.</a></strong><br />
 869 </dt>
 870 <dd>
 871 rxvt and rxvt-unicode always export the variable ``COLORTERM'', so you can
 872 check and see if that is set. Note that several programs, JED, slrn,
 873 Midnight Commander automatically check this variable to decide whether or
 874 not to use color.
 875 </dd>
 876 <p></p>
 877 <dt><strong><a name="item_how_do_i_set_the_correct_2c_full_ip_address_for_th">How do I set the correct, full IP address for the DISPLAY variable?</a></strong><br />
 878 </dt>
 879 <dd>
 880 If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
 881 insecure mode then it is possible to use the following shell script
 882 snippets to correctly set the display. If your version of rxvt-unicode
 883 wasn't also compiled with ESCZ_ANSWER (as assumed in these snippets) then
 884 the COLORTERM variable can be used to distinguish rxvt-unicode from a
 885 regular xterm.
 886 </dd>
 887 <dd>
 888 <p>Courtesy of Chuck Blake &lt;<a href="mailto:cblake@BBN.COM">cblake@BBN.COM</a>&gt; with the following shell script
 889 snippets:</p>
 890 </dd>
 891 <dd>
 892 <pre>
 893    # Bourne/Korn/POSIX family of shells:
 894    [ ${TERM:-foo} = foo ] &amp;&amp; TERM=xterm # assume an xterm if we don't know
 895    if [ ${TERM:-foo} = xterm ]; then
 896       stty -icanon -echo min 0 time 15 # see if enhanced rxvt or not
 897       echo -n '^[Z'
 898       read term_id
 899       stty icanon echo
 900       if [ &quot;&quot;${term_id} = '^[[?1;2C' -a ${DISPLAY:-foo} = foo ]; then
 901          echo -n '^[[7n'        # query the rxvt we are in for the DISPLAY string
 902          read DISPLAY           # set it in our local shell
 903       fi
 904    fi</pre>
 905 </dd>
 906 <p></p>
 907 <dt><strong><a name="item_how_do_i_compile_the_manual_pages_for_myself_3f">How do I compile the manual pages for myself?</a></strong><br />
 908 </dt>
 909 <dd>
 910 You need to have a recent version of perl installed as <em>/usr/bin/perl</em>,
 911 one that comes with <em>pod2man</em>, <em>pod2text</em> and <em>pod2html</em>. Then go to
 912 the doc subdirectory and enter <code>make alldoc</code>.
 913 </dd>
 914 <p></p>
 915 <dt><strong><a name="item_my_question_isn_27t_answered_here_2c_can_i_ask_a_h">My question isn't answered here, can I ask a human?</a></strong><br />
 916 </dt>
 917 <dd>
 918 Before sending me mail, you could go to IRC: <code>irc.freenode.net</code>,
 919 channel <code>#rxvt-unicode</code> has some rxvt-unicode enthusiasts that might be
 920 interested in learning about new and exciting problems (but not FAQs :).
 921 </dd>
 922 <p></p></dl>
 923 <p>
 924 </p>
 925 <hr />
 926 <h1><a name="rxvt_technical_reference">RXVT TECHNICAL REFERENCE</a></h1>
 927 <p>
 928 </p>
 929 <hr />
 930 <h1><a name="description">DESCRIPTION</a></h1>
 931 <p>The rest of this document describes various technical aspects of
 932 <strong>rxvt-unicode</strong>. First the description of supported command sequences,
 933 followed by menu and pixmap support and last by a description of all
 934 features selectable at <code>configure</code> time.</p>
 935 <p>
 936 </p>
 937 <hr />
 938 <h1><a name="definitions">Definitions</a></h1>
 939 <dl>
 940 <dt><strong><a name="item_c"><strong><code>c</code> </strong>&gt;</a></strong><br />
 941 </dt>
 942 <dd>
 943 The literal character c.
 944 </dd>
 945 <p></p>
 946 <dt><strong><a name="item_c"><strong><code>C</code> </strong>&gt;</a></strong><br />
 947 </dt>
 948 <dd>
 949 A single (required) character.
 950 </dd>
 951 <p></p>
 952 <dt><strong><a name="item_ps"><strong><code>Ps</code> </strong>&gt;</a></strong><br />
 953 </dt>
 954 <dd>
 955 A single (usually optional) numeric parameter, composed of one or more
 956 digits.
 957 </dd>
 958 <p></p>
 959 <dt><strong><a name="item_pm"><strong><code>Pm</code> </strong>&gt;</a></strong><br />
 960 </dt>
 961 <dd>
 962 A multiple numeric parameter composed of any number of single numeric
 963 parameters, separated by <code>;</code> character(s).
 964 </dd>
 965 <p></p>
 966 <dt><strong><a name="item_pt"><strong><code>Pt</code> </strong>&gt;</a></strong><br />
 967 </dt>
 968 <dd>
 969 A text parameter composed of printable characters.
 970 </dd>
 971 <p></p></dl>
 972 <p>
 973 </p>
 974 <hr />
 975 <h1><a name="values">Values</a></h1>
 976 <dl>
 977 <dt><strong><a name="item_enq"><strong><code>ENQ</code> </strong>&gt;</a></strong><br />
 978 </dt>
 979 <dd>
 980 Enquiry (Ctrl-E) = Send Device Attributes (DA)
 981 request attributes from terminal. See <strong><a href="#item_esc__5b_ps_c"><code>ESC [ Ps c</code></a> </strong>&gt;.
 982 </dd>
 983 <p></p>
 984 <dt><strong><a name="item_bel"><strong><code>BEL</code> </strong>&gt;</a></strong><br />
 985 </dt>
 986 <dd>
 987 Bell (Ctrl-G)
 988 </dd>
 989 <p></p>
 990 <dt><strong><a name="item_bs"><strong><code>BS</code> </strong>&gt;</a></strong><br />
 991 </dt>
 992 <dd>
 993 Backspace (Ctrl-H)
 994 </dd>
 995 <p></p>
 996 <dt><strong><a name="item_tab"><strong><code>TAB</code> </strong>&gt;</a></strong><br />
 997 </dt>
 998 <dd>
 999 Horizontal Tab (HT) (Ctrl-I)
1000 </dd>
1001 <p></p>
1002 <dt><strong><a name="item_lf"><strong><code>LF</code> </strong>&gt;</a></strong><br />
1003 </dt>
1004 <dd>
1005 Line Feed or New Line (NL) (Ctrl-J)
1006 </dd>
1007 <p></p>
1008 <dt><strong><a name="item_vt"><strong><code>VT</code> </strong>&gt;</a></strong><br />
1009 </dt>
1010 <dd>
1011 Vertical Tab (Ctrl-K) same as <strong><a href="#item_lf"><code>LF</code></a> </strong>&gt;
1012 </dd>
1013 <p></p>
1014 <dt><strong><a name="item_ff"><strong><code>FF</code> </strong>&gt;</a></strong><br />
1015 </dt>
1016 <dd>
1017 Form Feed or New Page (NP) (Ctrl-L) same as <strong><a href="#item_lf"><code>LF</code></a> </strong>&gt;
1018 </dd>
1019 <p></p>
1020 <dt><strong><a name="item_cr"><strong><code>CR</code> </strong>&gt;</a></strong><br />
1021 </dt>
1022 <dd>
1023 Carriage Return (Ctrl-M)
1024 </dd>
1025 <p></p>
1026 <dt><strong><a name="item_so"><strong><code>SO</code> </strong>&gt;</a></strong><br />
1027 </dt>
1028 <dd>
1029 Shift Out (Ctrl-N), invokes the G1 character set.
1030 Switch to Alternate Character Set
1031 </dd>
1032 <p></p>
1033 <dt><strong><a name="item_si"><strong><code>SI</code> </strong>&gt;</a></strong><br />
1034 </dt>
1035 <dd>
1036 Shift In (Ctrl-O), invokes the G0 character set (the default).
1037 Switch to Standard Character Set
1038 </dd>
1039 <p></p>
1040 <dt><strong><a name="item_spc"><strong><code>SPC</code> </strong>&gt;</a></strong><br />
1041 </dt>
1042 <dd>
1043 Space Character
1044 </dd>
1045 <p></p></dl>
1046 <p>
1047 </p>
1048 <hr />
1049 <h1><a name="escape_sequences">Escape Sequences</a></h1>
1050 <dl>
1051 <dt><strong><a name="item_esc__23_8"><strong><code>ESC # 8</code> </strong>&gt;</a></strong><br />
1052 </dt>
1053 <dd>
1054 DEC Screen Alignment Test (DECALN)
1055 </dd>
1056 <p></p>
1057 <dt><strong><a name="item_esc_7"><strong><code>ESC 7</code> </strong>&gt;</a></strong><br />
1058 </dt>
1059 <dd>
1060 Save Cursor (SC)
1061 </dd>
1062 <p></p>
1063 <dt><strong><a name="item_esc_8"><strong><code>ESC 8</code> </strong>&gt;</a></strong><br />
1064 </dt>
1065 <dd>
1066 Restore Cursor
1067 </dd>
1068 <p></p>
1069 <dt><strong><a name="item_esc__3d"><strong><code>ESC =</code> </strong>&gt;</a></strong><br />
1070 </dt>
1071 <dd>
1072 Application Keypad (SMKX). See also next sequence.
1073 </dd>
1074 <p></p>
1075 <dt><strong><a name="item_esc"><strong><code>ESC</code> </strong>&gt;&gt;</a></strong><br />
1076 </dt>
1077 <dd>
1078 Normal Keypad (RMKX)
1079 </dd>
1080 <dd>
1081 <p><strong>Note:</strong> If the numeric keypad is activated, eg, <strong>Num_Lock</strong> has been
1082 pressed, numbers or control functions are generated by the numeric keypad
1083 (see Key Codes).</p>
1084 </dd>
1085 <p></p>
1086 <dt><strong><a name="item_esc_d"><strong><code>ESC D</code> </strong>&gt;</a></strong><br />
1087 </dt>
1088 <dd>
1089 Index (IND)
1090 </dd>
1091 <p></p>
1092 <dt><strong><a name="item_esc_e"><strong><code>ESC E</code> </strong>&gt;</a></strong><br />
1093 </dt>
1094 <dd>
1095 Next Line (NEL)
1096 </dd>
1097 <p></p>
1098 <dt><strong><a name="item_esc_h"><strong><code>ESC H</code> </strong>&gt;</a></strong><br />
1099 </dt>
1100 <dd>
1101 Tab Set (HTS)
1102 </dd>
1103 <p></p>
1104 <dt><strong><a name="item_esc_m"><strong><code>ESC M</code> </strong>&gt;</a></strong><br />
1105 </dt>
1106 <dd>
1107 Reverse Index (RI)
1108 </dd>
1109 <p></p>
1110 <dt><strong><a name="item_esc_n"><strong><code>ESC N</code> </strong>&gt;</a></strong><br />
1111 </dt>
1112 <dd>
1113 Single Shift Select of G2 Character Set (SS2): affects next character
1114 only <em>unimplemented</em>
1115 </dd>
1116 <p></p>
1117 <dt><strong><a name="item_esc_o"><strong><code>ESC O</code> </strong>&gt;</a></strong><br />
1118 </dt>
1119 <dd>
1120 Single Shift Select of G3 Character Set (SS3): affects next character
1121 only <em>unimplemented</em>
1122 </dd>
1123 <p></p>
1124 <dt><strong><a name="item_esc_z"><strong><code>ESC Z</code> </strong>&gt;</a></strong><br />
1125 </dt>
1126 <dd>
1127 Obsolete form of returns: <strong><code>ESC [ ? 1 ; 2 C</code> </strong>&gt; <em>rxvt-unicode compile-time option</em>
1128 </dd>
1129 <p></p>
1130 <dt><strong><a name="item_esc_c"><strong><code>ESC c</code> </strong>&gt;</a></strong><br />
1131 </dt>
1132 <dd>
1133 Full reset (RIS)
1134 </dd>
1135 <p></p>
1136 <dt><strong><a name="item_esc_n"><strong><code>ESC n</code> </strong>&gt;</a></strong><br />
1137 </dt>
1138 <dd>
1139 Invoke the G2 Character Set (LS2)
1140 </dd>
1141 <p></p>
1142 <dt><strong><a name="item_esc_o"><strong><code>ESC o</code> </strong>&gt;</a></strong><br />
1143 </dt>
1144 <dd>
1145 Invoke the G3 Character Set (LS3)
1146 </dd>
1147 <p></p>
1148 <dt><strong><strong><code>ESC ( C</code> </strong>&gt;</strong><br />
1149 </dt>
1150 <dd>
1151 Designate G0 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.
1152 </dd>
1153 <p></p>
1154 <dt><strong><a name="item_esc__29_c"><strong><code>ESC ) C</code> </strong>&gt;</a></strong><br />
1155 </dt>
1156 <dd>
1157 Designate G1 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.
1158 </dd>
1159 <p></p>
1160 <dt><strong><a name="item_esc__2a_c"><strong><code>ESC * C</code> </strong>&gt;</a></strong><br />
1161 </dt>
1162 <dd>
1163 Designate G2 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.
1164 </dd>
1165 <p></p>
1166 <dt><strong><a name="item_esc__2b_c"><strong><code>ESC + C</code> </strong>&gt;</a></strong><br />
1167 </dt>
1168 <dd>
1169 Designate G3 Character Set (ISO 2022), see below for values of <a href="#item_c"><code>C</code></a>.
1170 </dd>
1171 <p></p>
1172 <dt><strong><a name="item_esc__24_c"><strong><code>ESC $ C</code> </strong>&gt;</a></strong><br />
1173 </dt>
1174 <dd>
1175 Designate Kanji Character Set
1176 </dd>
1177 <dd>
1178 <p>Where <strong><a href="#item_c"><code>C</code></a> </strong>&gt; is one of:</p>
1179 </dd>
1180 <table>
1181 <tr><td>C = 0 </td><td>DEC Special Character and Line Drawing Set</td></tr>
1182 <tr><td>C = A </td><td>United Kingdom (UK)</td></tr>
1183 <tr><td>C = B </td><td>United States (USASCII)</td></tr>
1184 <tr><td>C = <</td><td>Multinational character set unimplemented</td></tr>
1185 <tr><td>C = 5 </td><td>Finnish character set unimplemented</td></tr>
1186 <tr><td>C = C </td><td>Finnish character set unimplemented</td></tr>
1187 <tr><td>C = K </td><td>German character set unimplemented</td></tr>
1188 </table><p></p></dl>
1189 <p></p>
1190 <p>
1191 </p>
1192 <hr />
1193 <h1><a name="csi__command_sequence_introducer__sequences">CSI (Command Sequence Introducer) Sequences</a></h1>
1194 <dl>
1195 <dt><strong><a name="item_esc__5b_ps__40"><strong><code>ESC [ Ps @</code> </strong>&gt;</a></strong><br />
1196 </dt>
1197 <dd>
1198 Insert <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; (Blank) <code>Character(s)</code> [default: 1] (ICH)
1199 </dd>
1200 <p></p>
1201 <dt><strong><a name="item_esc__5b_ps_a"><strong><code>ESC [ Ps A</code> </strong>&gt;</a></strong><br />
1202 </dt>
1203 <dd>
1204 Cursor Up <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] (CUU)
1205 </dd>
1206 <p></p>
1207 <dt><strong><a name="item_esc__5b_ps_b"><strong><code>ESC [ Ps B</code> </strong>&gt;</a></strong><br />
1208 </dt>
1209 <dd>
1210 Cursor Down <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] (CUD)
1211 </dd>
1212 <p></p>
1213 <dt><strong><a name="item_esc__5b_ps_c"><strong><code>ESC [ Ps C</code> </strong>&gt;</a></strong><br />
1214 </dt>
1215 <dd>
1216 Cursor Forward <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] (CUF)
1217 </dd>
1218 <p></p>
1219 <dt><strong><a name="item_esc__5b_ps_d"><strong><code>ESC [ Ps D</code> </strong>&gt;</a></strong><br />
1220 </dt>
1221 <dd>
1222 Cursor Backward <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] (CUB)
1223 </dd>
1224 <p></p>
1225 <dt><strong><a name="item_esc__5b_ps_e"><strong><code>ESC [ Ps E</code> </strong>&gt;</a></strong><br />
1226 </dt>
1227 <dd>
1228 Cursor Down <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] and to first column
1229 </dd>
1230 <p></p>
1231 <dt><strong><a name="item_esc__5b_ps_f"><strong><code>ESC [ Ps F</code> </strong>&gt;</a></strong><br />
1232 </dt>
1233 <dd>
1234 Cursor Up <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; Times [default: 1] and to first column
1235 </dd>
1236 <p></p>
1237 <dt><strong><a name="item_esc__5b_ps_g"><strong><code>ESC [ Ps G</code> </strong>&gt;</a></strong><br />
1238 </dt>
1239 <dd>
1240 Cursor to Column <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; (HPA)
1241 </dd>
1242 <p></p>
1243 <dt><strong><a name="item_esc__5b_ps_3bps_h"><strong><code>ESC [ Ps;Ps H</code> </strong>&gt;</a></strong><br />
1244 </dt>
1245 <dd>
1246 Cursor Position [row;column] [default: 1;1] (CUP)
1247 </dd>
1248 <p></p>
1249 <dt><strong><a name="item_esc__5b_ps_i"><strong><code>ESC [ Ps I</code> </strong>&gt;</a></strong><br />
1250 </dt>
1251 <dd>
1252 Move forward <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; tab stops [default: 1]
1253 </dd>
1254 <p></p>
1255 <dt><strong><a name="item_esc__5b_ps_j"><strong><code>ESC [ Ps J</code> </strong>&gt;</a></strong><br />
1256 </dt>
1257 <dd>
1258 Erase in Display (ED)
1259 </dd>
1260 <table>
1261 <tr><td>Ps = 0</td><td>Clear Below (default)</td></tr>
1262 <tr><td>Ps = 1</td><td>Clear Above</td></tr>
1263 <tr><td>Ps = 2</td><td>Clear All</td></tr>
1264 </table><p></p>
1265 <dt><strong><a name="item_esc__5b_ps_k"><strong><code>ESC [ Ps K</code> </strong>&gt;</a></strong><br />
1266 </dt>
1267 <dd>
1268 Erase in Line (EL)
1269 </dd>
1270 <table>
1271 <tr><td>Ps = 0</td><td>Clear to Right (default)</td></tr>
1272 <tr><td>Ps = 1</td><td>Clear to Left</td></tr>
1273 <tr><td>Ps = 2</td><td>Clear All</td></tr>
1274 </table><p></p>
1275 <dt><strong><a name="item_esc__5b_ps_l"><strong><code>ESC [ Ps L</code> </strong>&gt;</a></strong><br />
1276 </dt>
1277 <dd>
1278 Insert <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; <code>Line(s)</code> [default: 1] (IL)
1279 </dd>
1280 <p></p>
1281 <dt><strong><a name="item_esc__5b_ps_m"><strong><code>ESC [ Ps M</code> </strong>&gt;</a></strong><br />
1282 </dt>
1283 <dd>
1284 Delete <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; <code>Line(s)</code> [default: 1] (DL)
1285 </dd>
1286 <p></p>
1287 <dt><strong><a name="item_esc__5b_ps_p"><strong><code>ESC [ Ps P</code> </strong>&gt;</a></strong><br />
1288 </dt>
1289 <dd>
1290 Delete <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; <code>Character(s)</code> [default: 1] (DCH)
1291 </dd>
1292 <p></p>
1293 <dt><strong><a name="item_esc__5b_ps_3bps_3bps_3bps_3bps_t"><strong><code>ESC [ Ps;Ps;Ps;Ps;Ps T</code> </strong>&gt;</a></strong><br />
1294 </dt>
1295 <dd>
1296 Initiate . <em>unimplemented</em> Parameters are
1297 [func;startx;starty;firstrow;lastrow].
1298 </dd>
1299 <p></p>
1300 <dt><strong><a name="item_esc__5b_ps_w"><strong><code>ESC [ Ps W</code> </strong>&gt;</a></strong><br />
1301 </dt>
1302 <dd>
1303 Tabulator functions
1304 </dd>
1305 <table>
1306 <tr><td>Ps = 0</td><td>Tab Set (HTS)</td></tr>
1307 <tr><td>Ps = 2</td><td>Tab Clear (TBC), Clear Current Column (default)</td></tr>
1308 <tr><td>Ps = 5</td><td>Tab Clear (TBC), Clear All</td></tr>
1309 </table><p></p>
1310 <dt><strong><a name="item_esc__5b_ps_x"><strong><code>ESC [ Ps X</code> </strong>&gt;</a></strong><br />
1311 </dt>
1312 <dd>
1313 Erase <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; <code>Character(s)</code> [default: 1] (ECH)
1314 </dd>
1315 <p></p>
1316 <dt><strong><a name="item_esc__5b_ps_z"><strong><code>ESC [ Ps Z</code> </strong>&gt;</a></strong><br />
1317 </dt>
1318 <dd>
1319 Move backward <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; [default: 1] tab stops
1320 </dd>
1321 <p></p>
1322 <dt><strong><a name="item_esc__5b_ps__27"><strong><code>ESC [ Ps '</code> </strong>&gt;</a></strong><br />
1323 </dt>
1324 <dd>
1325 See <strong><a href="#item_esc__5b_ps_g"><code>ESC [ Ps G</code></a> </strong>&gt;
1326 </dd>
1327 <p></p>
1328 <dt><strong><a name="item_esc__5b_ps_a"><strong><code>ESC [ Ps a</code> </strong>&gt;</a></strong><br />
1329 </dt>
1330 <dd>
1331 See <strong><a href="#item_esc__5b_ps_c"><code>ESC [ Ps C</code></a> </strong>&gt;
1332 </dd>
1333 <p></p>
1334 <dt><strong><a name="item_esc__5b_ps_c"><strong><code>ESC [ Ps c</code> </strong>&gt;</a></strong><br />
1335 </dt>
1336 <dd>
1337 Send Device Attributes (DA)
1338 <strong><code>Ps = 0</code> </strong>&gt; (or omitted): request attributes from terminal
1339 returns: <strong><code>ESC [ ? 1 ; 2 c</code> </strong>&gt; (``I am a VT100 with Advanced Video
1340 Option'')
1341 </dd>
1342 <p></p>
1343 <dt><strong><a name="item_esc__5b_ps_d"><strong><code>ESC [ Ps d</code> </strong>&gt;</a></strong><br />
1344 </dt>
1345 <dd>
1346 Cursor to Line <strong><a href="#item_ps"><code>Ps</code></a> </strong>&gt; (VPA)
1347 </dd>
1348 <p></p>
1349 <dt><strong><a name="item_esc__5b_ps_e"><strong><code>ESC [ Ps e</code> </strong>&gt;</a></strong><br />
1350 </dt>
1351 <dd>
1352 See <strong><a href="#item_esc__5b_ps_a"><code>ESC [ Ps A</code></a> </strong>&gt;
1353 </dd>
1354 <p></p>
1355 <dt><strong><a name="item_esc__5b_ps_3bps_f"><strong><code>ESC [ Ps;Ps f</code> </strong>&gt;</a></strong><br />
1356 </dt>
1357 <dd>
1358 Horizontal and Vertical Position [row;column] (HVP) [default: 1;1]
1359 </dd>
1360 <p></p>
1361 <dt><strong><a name="item_esc__5b_ps_g"><strong><code>ESC [ Ps g</code> </strong>&gt;</a></strong><br />
1362 </dt>
1363 <dd>
1364 Tab Clear (TBC)
1365 </dd>
1366 <table>
1367 <tr><td>Ps = 0</td><td>Clear Current Column (default)</td></tr>
1368 <tr><td>Ps = 3</td><td>Clear All (TBC)</td></tr>
1369 </table><p></p>
1370 <dt><strong><a name="item_esc__5b_pm_h"><strong><code>ESC [ Pm h</code> </strong>&gt;</a></strong><br />
1371 </dt>
1372 <dd>
1373 Set Mode (SM). See <strong><a href="#item_esc__5b_pm_l"><code>ESC [ Pm l</code></a> </strong>&gt; sequence for description of <a href="#item_pm"><code>Pm</code></a>.
1374 </dd>
1375 <p></p>
1376 <dt><strong><a name="item_esc__5b_ps_i"><strong><code>ESC [ Ps i</code> </strong>&gt;</a></strong><br />
1377 </dt>
1378 <dd>
1379 Printing. See also the <code>print-pipe</code> resource.
1380 </dd>
1381 <table>
1382 <tr><td>Ps = 0</td><td>print screen (MC0)</td></tr>
1383 <tr><td>Ps = 4</td><td>disable transparent print mode (MC4)</td></tr>
1384 <tr><td>Ps = 5</td><td>enable transparent print mode (MC5)</td></tr>
1385 </table><p></p>
1386 <dt><strong><a name="item_esc__5b_pm_l"><strong><code>ESC [ Pm l</code> </strong>&gt;</a></strong><br />
1387 </dt>
1388 <dd>
1389 Reset Mode (RM)
1390 </dd>
1391 <dl>
1392 <dt><strong><a name="item_ps__3d_4"><strong><code>Ps = 4</code> </strong>&gt;</a></strong><br />
1393 </dt>
1394 <table>
1395 <tr><td>h</td><td>Insert Mode (SMIR)</td></tr>
1396 <tr><td>l</td><td>Replace Mode (RMIR)</td></tr>
1397 </table><dt><strong><a name="item_20"><strong><code>Ps = 20</code> </strong>&gt; (partially implemented)</a></strong><br />
1398 </dt>
1399 <table>
1400 <tr><td>h</td><td>Automatic Newline (LNM)</td></tr>
1401 <tr><td>l</td><td>Normal Linefeed (LNM)</td></tr>
1402 </table></dl>
1403 <dt><strong><a name="item_esc__5b_pm_m"><strong><code>ESC [ Pm m</code> </strong>&gt;</a></strong><br />
1404 </dt>
1405 <dd>
1406 Character Attributes (SGR)
1407 </dd>
1408 <table>
1409 <tr><td>Ps = 0</td><td>Normal (default)</td></tr>
1410 <tr><td>Ps = 1 / 21</td><td>On / Off Bold (bright fg)</td></tr>
1411 <tr><td>Ps = 3 / 23</td><td>On / Off Italic</td></tr>
1412 <tr><td>Ps = 4 / 24</td><td>On / Off Underline</td></tr>
1413 <tr><td>Ps = 5 / 25</td><td>On / Off Slow Blink (bright bg)</td></tr>
1414 <tr><td>Ps = 6 / 26</td><td>On / Off Rapid Blink (bright bg)</td></tr>
1415 <tr><td>Ps = 7 / 27</td><td>On / Off Inverse</td></tr>
1416 <tr><td>Ps = 8 / 27</td><td>On / Off Invisible (NYI)</td></tr>
1417 <tr><td>Ps = 30 / 40</td><td>fg/bg Black</td></tr>
1418 <tr><td>Ps = 31 / 41</td><td>fg/bg Red</td></tr>
1419 <tr><td>Ps = 32 / 42</td><td>fg/bg Green</td></tr>
1420 <tr><td>Ps = 33 / 43</td><td>fg/bg Yellow</td></tr>
1421 <tr><td>Ps = 34 / 44</td><td>fg/bg Blue</td></tr>
1422 <tr><td>Ps = 35 / 45</td><td>fg/bg Magenta</td></tr>
1423 <tr><td>Ps = 36 / 46</td><td>fg/bg Cyan</td></tr>
1424 <tr><td>Ps = 38;5 / 48;5</td><td>set fg/bg to color #m (ISO 8613-6)</td></tr>
1425 <tr><td>Ps = 37 / 47</td><td>fg/bg White</td></tr>
1426 <tr><td>Ps = 39 / 49</td><td>fg/bg Default</td></tr>
1427 <tr><td>Ps = 90 / 100</td><td>fg/bg Bright Black</td></tr>
1428 <tr><td>Ps = 91 / 101</td><td>fg/bg Bright Red</td></tr>
1429 <tr><td>Ps = 92 / 102</td><td>fg/bg Bright Green</td></tr>
1430 <tr><td>Ps = 93 / 103</td><td>fg/bg Bright Yellow</td></tr>
1431 <tr><td>Ps = 94 / 104</td><td>fg/bg Bright Blue</td></tr>
1432 <tr><td>Ps = 95 / 105</td><td>fg/bg Bright Magenta</td></tr>
1433 <tr><td>Ps = 96 / 106</td><td>fg/bg Bright Cyan</td></tr>
1434 <tr><td>Ps = 97 / 107</td><td>fg/bg Bright White</td></tr>
1435 <tr><td>Ps = 99 / 109</td><td>fg/bg Bright Default</td></tr>
1436 </table><p></p>
1437 <dt><strong><a name="item_esc__5b_ps_n"><strong><code>ESC [ Ps n</code> </strong>&gt;</a></strong><br />
1438 </dt>
1439 <dd>
1440 Device Status Report (DSR)
1441 </dd>
1442 <table>
1443 <tr><td>Ps = 5</td><td>Status Report ESC [ 0 n (``OK'')</td></tr>
1444 <tr><td>Ps = 6</td><td>Report Cursor Position (CPR) [row;column] as ESC [ r ; c R</td></tr>
1445 <tr><td>Ps = 7</td><td>Request Display Name</td></tr>
1446 <tr><td>Ps = 8</td><td>Request Version Number (place in window title)</td></tr>
1447 </table><p></p>
1448 <dt><strong><a name="item_esc__5b_ps_3bps_r"><strong><code>ESC [ Ps;Ps r</code> </strong>&gt;</a></strong><br />
1449 </dt>
1450 <dd>
1451 Set Scrolling Region [top;bottom]
1452 [default: full size of window] (CSR)
1453 </dd>
1454 <p></p>
1455 <dt><strong><a name="item_esc__5b_s"><strong><code>ESC [ s</code> </strong>&gt;</a></strong><br />
1456 </dt>
1457 <dd>
1458 Save Cursor (SC)
1459 </dd>
1460 <p></p>
1461 <dt><strong><a name="item_esc__5b_ps_3bpt_t"><strong><code>ESC [ Ps;Pt t</code> </strong>&gt;</a></strong><br />
1462 </dt>
1463 <dd>
1464 Window Operations
1465 </dd>
1466 <table>
1467 <tr><td>Ps = 1</td><td>Deiconify (map) window</td></tr>
1468 <tr><td>Ps = 2</td><td>Iconify window</td></tr>
1469 <tr><td>Ps = 3</td><td>ESC [ 3 ; X ; Y t Move window to (X|Y)</td></tr>
1470 <tr><td>Ps = 4</td><td>ESC [ 4 ; H ; W t Resize to WxH pixels</td></tr>
1471 <tr><td>Ps = 5</td><td>Raise window</td></tr>
1472 <tr><td>Ps = 6</td><td>Lower window</td></tr>
1473 <tr><td>Ps = 7</td><td>Refresh screen once</td></tr>
1474 <tr><td>Ps = 8</td><td>ESC [ 8 ; R ; C t Resize to R rows and C columns</td></tr>
1475 <tr><td>Ps = 11</td><td>Report window state (responds with Ps = 1 or Ps = 2)</td></tr>
1476 <tr><td>Ps = 13</td><td>Report window position (responds with Ps = 3)</td></tr>
1477 <tr><td>Ps = 14</td><td>Report window pixel size (responds with Ps = 4)</td></tr>
1478 <tr><td>Ps = 18</td><td>Report window text size (responds with Ps = 7)</td></tr>
1479 <tr><td>Ps = 19</td><td>Currently the same as Ps = 18, but responds with Ps = 9</td></tr>
1480 <tr><td>Ps = 20</td><td>Reports icon label (ESC ] L NAME \234)</td></tr>
1481 <tr><td>Ps = 21</td><td>Reports window title (ESC ] l NAME \234)</td></tr>
1482 <tr><td>Ps = 24..</td><td>Set window height to Ps rows</td></tr>
1483 </table><p></p>
1484 <dt><strong><a name="item_esc__5b_u"><strong><code>ESC [ u</code> </strong>&gt;</a></strong><br />
1485 </dt>
1486 <dd>
1487 Restore Cursor
1488 </dd>
1489 <p></p>
1490 <dt><strong><a name="item_esc__5b_ps_x"><strong><code>ESC [ Ps x</code> </strong>&gt;</a></strong><br />
1491 </dt>
1492 <dd>
1493 Request Terminal Parameters (DECREQTPARM)
1494 </dd>
1495 <p></p></dl>
1496 <p></p>
1497 <p>
1498 </p>
1499 <hr />
1500 <h1><a name="dec_private_modes">DEC Private Modes</a></h1>
1501 <dl>
1502 <dt><strong><a name="item_esc__5b__3f_pm_h"><strong><code>ESC [ ? Pm h</code> </strong>&gt;</a></strong><br />
1503 </dt>
1504 <dd>
1505 DEC Private Mode Set (DECSET)
1506 </dd>
1507 <p></p>
1508 <dt><strong><a name="item_esc__5b__3f_pm_l"><strong><code>ESC [ ? Pm l</code> </strong>&gt;</a></strong><br />
1509 </dt>
1510 <dd>
1511 DEC Private Mode Reset (DECRST)
1512 </dd>
1513 <p></p>
1514 <dt><strong><a name="item_esc__5b__3f_pm_r"><strong><code>ESC [ ? Pm r</code> </strong>&gt;</a></strong><br />
1515 </dt>
1516 <dd>
1517 Restore previously saved DEC Private Mode Values.
1518 </dd>
1519 <p></p>
1520 <dt><strong><a name="item_esc__5b__3f_pm_s"><strong><code>ESC [ ? Pm s</code> </strong>&gt;</a></strong><br />
1521 </dt>
1522 <dd>
1523 Save DEC Private Mode Values.
1524 </dd>
1525 <p></p>
1526 <dt><strong><a name="item_esc__5b__3f_pm_t"><strong><code>ESC [ ? Pm t</code> </strong>&gt;</a></strong><br />
1527 </dt>
1528 <dd>
1529 Toggle DEC Private Mode Values (rxvt extension). <em>where</em>
1530 </dd>
1531 <dl>
1532 <dt><strong><a name="item_1"><strong><code>Ps = 1</code> </strong>&gt; (DECCKM)</a></strong><br />
1533 </dt>
1534 <table>
1535 <tr><td>h</td><td>Application Cursor Keys</td></tr>
1536 <tr><td>l</td><td>Normal Cursor Keys</td></tr>
1537 </table><dt><strong><a name="item_2"><strong><code>Ps = 2</code> </strong>&gt; (ANSI/VT52 mode)</a></strong><br />
1538 </dt>
1539 <table>
1540 <tr><td>h</td><td>Enter VT52 mode</td></tr>
1541 <tr><td>l</td><td>Enter VT52 mode</td></tr>
1542 </table><dt><strong><a name="item_ps__3d_3"><strong><code>Ps = 3</code> </strong>&gt;</a></strong><br />
1543 </dt>
1544 <table>
1545 <tr><td>h</td><td>132 Column Mode (DECCOLM)</td></tr>
1546 <tr><td>l</td><td>80 Column Mode (DECCOLM)</td></tr>
1547 </table><dt><strong><strong><code>Ps = 4</code> </strong>&gt;</strong><br />
1548 </dt>
1549 <table>
1550 <tr><td>h</td><td>Smooth (Slow) Scroll (DECSCLM)</td></tr>
1551 <tr><td>l</td><td>Jump (Fast) Scroll (DECSCLM)</td></tr>
1552 </table><dt><strong><a name="item_ps__3d_5"><strong><code>Ps = 5</code> </strong>&gt;</a></strong><br />
1553 </dt>
1554 <table>
1555 <tr><td>h</td><td>Reverse Video (DECSCNM)</td></tr>
1556 <tr><td>l</td><td>Normal Video (DECSCNM)</td></tr>
1557 </table><dt><strong><a name="item_ps__3d_6"><strong><code>Ps = 6</code> </strong>&gt;</a></strong><br />
1558 </dt>
1559 <table>
1560 <tr><td>h</td><td>Origin Mode (DECOM)</td></tr>
1561 <tr><td>l</td><td>Normal Cursor Mode (DECOM)</td></tr>
1562 </table><dt><strong><a name="item_ps__3d_7"><strong><code>Ps = 7</code> </strong>&gt;</a></strong><br />
1563 </dt>
1564 <table>
1565 <tr><td>h</td><td>Wraparound Mode (DECAWM)</td></tr>
1566 <tr><td>l</td><td>No Wraparound Mode (DECAWM)</td></tr>
1567 </table><dt><strong><a name="item_ps__3d_8_unimplemented"><strong><code>Ps = 8</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1568 </dt>
1569 <table>
1570 <tr><td>h</td><td>Auto-repeat Keys (DECARM)</td></tr>
1571 <tr><td>l</td><td>No Auto-repeat Keys (DECARM)</td></tr>
1572 </table><dt><strong><a name="item_ps__3d_9_x10_xterm"><strong><code>Ps = 9</code> </strong>&gt; X10 XTerm</a></strong><br />
1573 </dt>
1574 <table>
1575 <tr><td>h</td><td>Send Mouse X & Y on button press.</td></tr>
1576 <tr><td>l</td><td>No mouse reporting.</td></tr>
1577 </table><dt><strong><a name="item_10"><strong><code>Ps = 10</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1578 </dt>
1579 <table>
1580 <tr><td>h</td><td>menuBar visible</td></tr>
1581 <tr><td>l</td><td>menuBar invisible</td></tr>
1582 </table><dt><strong><a name="item_ps__3d_25"><strong><code>Ps = 25</code> </strong>&gt;</a></strong><br />
1583 </dt>
1584 <table>
1585 <tr><td>h</td><td>Visible cursor {cnorm/cvvis}</td></tr>
1586 <tr><td>l</td><td>Invisible cursor {civis}</td></tr>
1587 </table><dt><strong><a name="item_ps__3d_30"><strong><code>Ps = 30</code> </strong>&gt;</a></strong><br />
1588 </dt>
1589 <table>
1590 <tr><td>h</td><td>scrollBar visisble</td></tr>
1591 <tr><td>l</td><td>scrollBar invisisble</td></tr>
1592 </table><dt><strong><a name="item_35"><strong><code>Ps = 35</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1593 </dt>
1594 <table>
1595 <tr><td>h</td><td>Allow XTerm Shift+key sequences</td></tr>
1596 <tr><td>l</td><td>Disallow XTerm Shift+key sequences</td></tr>
1597 </table><dt><strong><a name="item_ps__3d_38_unimplemented"><strong><code>Ps = 38</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1598 </dt>
1599 <dd>
1600 Enter Tektronix Mode (DECTEK)
1601 </dd>
1602 <p></p>
1603 <dt><strong><a name="item_ps__3d_40"><strong><code>Ps = 40</code> </strong>&gt;</a></strong><br />
1604 </dt>
1605 <table>
1606 <tr><td>h</td><td>Allow 80/132 Mode</td></tr>
1607 <tr><td>l</td><td>Disallow 80/132 Mode</td></tr>
1608 </table><dt><strong><a name="item_ps__3d_44_unimplemented"><strong><code>Ps = 44</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1609 </dt>
1610 <table>
1611 <tr><td>h</td><td>Turn On Margin Bell</td></tr>
1612 <tr><td>l</td><td>Turn Off Margin Bell</td></tr>
1613 </table><dt><strong><a name="item_ps__3d_45_unimplemented"><strong><code>Ps = 45</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1614 </dt>
1615 <table>
1616 <tr><td>h</td><td>Reverse-wraparound Mode</td></tr>
1617 <tr><td>l</td><td>No Reverse-wraparound Mode</td></tr>
1618 </table><dt><strong><a name="item_ps__3d_46_unimplemented"><strong><code>Ps = 46</code> </strong>&gt; <em>unimplemented</em></a></strong><br />
1619 </dt>
1620 <dt><strong><a name="item_ps__3d_47"><strong><code>Ps = 47</code> </strong>&gt;</a></strong><br />
1621 </dt>
1622 <table>
1623 <tr><td>h</td><td>Use Alternate Screen Buffer</td></tr>
1624 <tr><td>l</td><td>Use Normal Screen Buffer</td></tr>
1625 </table><p></p>
1626 <dt><strong><a name="item_ps__3d_66"><strong><code>Ps = 66</code> </strong>&gt;</a></strong><br />
1627 </dt>
1628 <table>
1629 <tr><td>h</td><td>Application Keypad (DECPAM) == ESC =</td></tr>
1630 <tr><td>l</td><td>Normal Keypad (DECPNM) == ESC ></td></tr>
1631 </table><dt><strong><a name="item_ps__3d_67"><strong><code>Ps = 67</code> </strong>&gt;</a></strong><br />
1632 </dt>
1633 <table>
1634 <tr><td>h</td><td>Backspace key sends BS (DECBKM)</td></tr>
1635 <tr><td>l</td><td>Backspace key sends DEL</td></tr>
1636 </table><dt><strong><a name="item_1000"><strong><code>Ps = 1000</code> </strong>&gt; (X11 XTerm)</a></strong><br />
1637 </dt>
1638 <table>
1639 <tr><td>h</td><td>Send Mouse X & Y on button press and release.</td></tr>
1640 <tr><td>l</td><td>No mouse reporting.</td></tr>
1641 </table><dt><strong><a name="item_1001"><strong><code>Ps = 1001</code> </strong>&gt; (X11 XTerm) <em>unimplemented</em></a></strong><br />
1642 </dt>
1643 <table>
1644 <tr><td>h</td><td>Use Hilite Mouse Tracking.</td></tr>
1645 <tr><td>l</td><td>No mouse reporting.</td></tr>
1646 </table><dt><strong><a name="item_1010"><strong><code>Ps = 1010</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1647 </dt>
1648 <table>
1649 <tr><td>h</td><td>Don't scroll to bottom on TTY output</td></tr>
1650 <tr><td>l</td><td>Scroll to bottom on TTY output</td></tr>
1651 </table><dt><strong><a name="item_1011"><strong><code>Ps = 1011</code> </strong>&gt; (<strong>rxvt</strong>)</a></strong><br />
1652 </dt>
1653 <table>
1654 <tr><td>h</td><td>Scroll to bottom when a key is pressed</td></tr>
1655 <tr><td>l</td><td>Don't scroll to bottom when a key is pressed</td></tr>
1656 </table><dt><strong><a name="item_ps__3d_1047"><strong><code>Ps = 1047</code> </strong>&gt;</a></strong><br />
1657 </dt>
1658 <table>
1659 <tr><td>h</td><td>Use Alternate Screen Buffer</td></tr>
1660 <tr><td>l</td><td>Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it</td></tr>
1661 </table><dt><strong><a name="item_ps__3d_1048"><strong><code>Ps = 1048</code> </strong>&gt;</a></strong><br />
1662 </dt>
1663 <table>
1664 <tr><td>h</td><td>Save cursor position</td></tr>
1665 <tr><td>l</td><td>Restore cursor position</td></tr>
1666 </table><dt><strong><a name="item_ps__3d_1049"><strong><code>Ps = 1049</code> </strong>&gt;</a></strong><br />
1667 </dt>
1668 <table>
1669 <tr><td>h</td><td>Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it</td></tr>
1670 <tr><td>l</td><td>Use Normal Screen Buffer</td></tr>
1671 </table></dl>
1672 </dl>
1673 <p></p>
1674 <p>
1675 </p>
1676 <hr />
1677 <h1><a name="xterm_operating_system_commands">XTerm Operating System Commands</a></h1>
1678 <dl>
1679 <dt><strong><a name="item_esc__5d_ps_3bpt_st"><strong><code>ESC ] Ps;Pt ST</code> </strong>&gt;</a></strong><br />
1680 </dt>
1681 <dd>
1682 Set XTerm Parameters. 8-bit ST: 0x9c, 7-bit ST sequence: ESC \ (0x1b,
1683 0x5c), backwards compatible terminator BEL (0x07) is also accepted. any
1684 <strong>octet</strong> can be escaped by prefixing it with SYN (0x16, ^V).
1685 </dd>
1686 <table>
1687 <tr><td>Ps = 0</td><td>Change Icon Name and Window Title to Pt</td></tr>
1688 <tr><td>Ps = 1</td><td>Change Icon Name to Pt</td></tr>
1689 <tr><td>Ps = 2</td><td>Change Window Title to Pt</td></tr>
1690 <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>
1691 <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>
1692 <tr><td>Ps = 10</td><td>Change colour of text foreground to Pt (NB: may change in future)</td></tr>
1693 <tr><td>Ps = 11</td><td>Change colour of text background to Pt (NB: may change in future)</td></tr>
1694 <tr><td>Ps = 12</td><td>Change colour of text cursor foreground to Pt</td></tr>
1695 <tr><td>Ps = 13</td><td>Change colour of mouse foreground to Pt</td></tr>
1696 <tr><td>Ps = 17</td><td>Change colour of highlight characters to Pt</td></tr>
1697 <tr><td>Ps = 18</td><td>Change colour of bold characters to Pt</td></tr>
1698 <tr><td>Ps = 19</td><td>Change colour of underlined characters to Pt</td></tr>
1699 <tr><td>Ps = 20</td><td>Change default background to Pt</td></tr>
1700 <tr><td>Ps = 39</td><td>Change default foreground colour to Pt rxvt compile-time option</td></tr>
1701 <tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr>
1702 <tr><td>Ps = 49</td><td>Change default background colour to Pt rxvt compile-time option</td></tr>
1703 <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>
1704 <tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr>
1705 <tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (rxvt extension)</td></tr>
1706 <tr><td>Ps = 703</td><td>Menubar command Pt rxvt compile-time option (rxvt-unicode extension)</td></tr>
1707 <tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr>
1708 <tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt</td></tr>
1709 <tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr>
1710 <tr><td>Ps = 711</td><td>Set bold fontset to Pt. Similar to Ps = 50.</td></tr>
1711 <tr><td>Ps = 712</td><td>Set italic fontset to Pt. Similar to Ps = 50.</td></tr>
1712 <tr><td>Ps = 713</td><td>Set bold-italic fontset to Pt. Similar to Ps = 50.</td></tr>
1713 </table><p></p></dl>
1714 <p></p>
1715 <p>
1716 </p>
1717 <hr />
1718 <h1><a name="menubar">menuBar</a></h1>
1719 <p><strong>The exact syntax used is <em>almost</em> solidified. </strong>&gt;
1720 In the menus, <strong>DON'T</strong> try to use menuBar commands that add or remove a
1721 menuBar.</p>
1722 <p>Note that in all of the commands, the <strong><em>/path/</em> </strong>&gt; <em>cannot</em> be
1723 omitted: use <strong>./</strong> to specify a menu relative to the current menu.</p>
1724 <p>
1725 </p>
1726 <h2><a name="overview_of_menubar_operation">Overview of menuBar operation</a></h2>
1727 <p>For the menuBar XTerm escape sequence <code>ESC ] 703 ; Pt ST</code>, the syntax
1728 of <a href="#item_pt"><code>Pt</code></a> can be used for a variety of tasks:</p>
1729 <p>At the top level is the current menuBar which is a member of a circular
1730 linked-list of other such menuBars.</p>
1731 <p>The menuBar acts as a parent for the various drop-down menus, which in
1732 turn, may have labels, separator lines, menuItems and subMenus.</p>
1733 <p>The menuItems are the useful bits: you can use them to mimic keyboard
1734 input or even to send text or escape sequences back to rxvt.</p>
1735 <p>The menuBar syntax is intended to provide a simple yet robust method of
1736 constructing and manipulating menus and navigating through the
1737 menuBars.</p>
1738 <p>The first step is to use the tag <strong>[menu:<em>name</em>] </strong>&gt; which creates
1739 the menuBar called <em>name</em> and allows access. You may now or menus,
1740 subMenus, and menuItems. Finally, use the tag <strong>[done]</strong> to set the
1741 menuBar access as <strong>readonly</strong> to prevent accidental corruption of the
1742 menus. To re-access the current menuBar for alterations, use the tag
1743 <strong>[menu]</strong>, make the alterations and then use <strong>[done]</strong></p>
1744 <p></p>
1745 <p>
1746 </p>
1747 <h2><a name="commands">Commands</a></h2>
1748 <dl>
1749 <dt><strong><a name="item__5bmenu_3a_2bname_5d"><strong>[menu:+<em>name</em>] </strong>&gt;</a></strong><br />
1750 </dt>
1751 <dd>
1752 access the named menuBar for creation or alteration. If a new menuBar
1753 is created, it is called <em>name</em> (max of 15 chars) and the current
1754 menuBar is pushed onto the stack
1755 </dd>
1756 <p></p>
1757 <dt><strong><a name="item__5bmenu_5d"><strong>[menu]</strong></a></strong><br />
1758 </dt>
1759 <dd>
1760 access the current menuBar for alteration
1761 </dd>
1762 <p></p>
1763 <dt><strong><a name="item__5btitle_3a_2bstring_5d"><strong>[title:+<em>string</em>] </strong>&gt;</a></strong><br />
1764 </dt>
1765 <dd>
1766 set the current menuBar's title to <em>string</em>, which may contain the
1767 following format specifiers:
1768 <strong>%%</strong> : literal <strong>%</strong> character
1769 <strong>%n</strong> : rxvt name (as per the <strong>-name</strong> command-line option)
1770 <strong>%v</strong> : rxvt version
1771 </dd>
1772 <p></p>
1773 <dt><strong><a name="item__5bdone_5d"><strong>[done]</strong></a></strong><br />
1774 </dt>
1775 <dd>
1776 set menuBar access as <strong>readonly</strong>.
1777 End-of-file tag for <strong>[read:+<em>file</em>] </strong>&gt; operations.
1778 </dd>
1779 <p></p>
1780 <dt><strong><a name="item__5bread_3a_2bfile_5d"><strong>[read:+<em>file</em>] </strong>&gt;</a></strong><br />
1781 </dt>
1782 <dd>
1783 read menu commands directly from <em>file</em> (extension ``.menu'' will be
1784 appended if required.) Start reading at a line with <strong>[menu]</strong> or <strong>&lt;
1785 [menu:+<em>name</em> </strong>&gt; and continuing until <strong>[done]</strong> is encountered.
1786 </dd>
1787 <dd>
1788 <p>Blank and comment lines (starting with <strong>#</strong>) are ignored. Actually,
1789 since any invalid menu commands are also ignored, almost anything could
1790 be construed as a comment line, but this may be tightened up in the
1791 future ... so don't count on it!.</p>
1792 </dd>
1793 <p></p>
1794 <dt><strong><a name="item__5bread_3a_2bfile_3b_2bname_5d"><strong>[read:+<em>file</em>;+<em>name</em>] </strong>&gt;</a></strong><br />
1795 </dt>
1796 <dd>
1797 The same as <strong>[read:+<em>file</em>] </strong>&gt;, but start reading at a line with
1798 <strong>[menu:+<em>name</em>] </strong>&gt; and continuing until <strong>[done:+<em>name</em>] </strong>&gt; or
1799 <strong>[done]</strong> is encountered.
1800 </dd>
1801 <p></p>
1802 <dt><strong><a name="item__5bdump_5d"><strong>[dump]</strong></a></strong><br />
1803 </dt>
1804 <dd>
1805 dump all menuBars to the file <strong>/tmp/rxvt-PID</strong> in a format suitable for
1806 later rereading.
1807 </dd>
1808 <p></p>
1809 <dt><strong><a name="item__5brm_3aname_5d"><strong>[rm:name]</strong></a></strong><br />
1810 </dt>
1811 <dd>
1812 remove the named menuBar
1813 </dd>
1814 <p></p>
1815 <dt><strong><a name="item__5brm_5d__5brm_3a_5d"><strong>[rm] [rm:]</strong></a></strong><br />
1816 </dt>
1817 <dd>
1818 remove the current menuBar
1819 </dd>
1820 <p></p>
1821 <dt><strong><a name="item__5brm_2a_5d__5brm_3a_2a_5d"><strong>[rm*] [rm:*]</strong></a></strong><br />
1822 </dt>
1823 <dd>
1824 remove all menuBars
1825 </dd>
1826 <p></p>
1827 <dt><strong><a name="item__5bswap_5d"><strong>[swap]</strong></a></strong><br />
1828 </dt>
1829 <dd>
1830 swap the top two menuBars
1831 </dd>
1832 <p></p>
1833 <dt><strong><a name="item__5bprev_5d"><strong>[prev]</strong></a></strong><br />
1834 </dt>
1835 <dd>
1836 access the previous menuBar
1837 </dd>
1838 <p></p>
1839 <dt><strong><a name="item__5bnext_5d"><strong>[next]</strong></a></strong><br />
1840 </dt>
1841 <dd>
1842 access the next menuBar
1843 </dd>
1844 <p></p>
1845 <dt><strong><a name="item__5bshow_5d"><strong>[show]</strong></a></strong><br />
1846 </dt>
1847 <dd>
1848 Enable display of the menuBar
1849 </dd>
1850 <p></p>
1851 <dt><strong><a name="item__5bhide_5d"><strong>[hide]</strong></a></strong><br />
1852 </dt>
1853 <dd>
1854 Disable display of the menuBar
1855 </dd>
1856 <p></p>
1857 <dt><strong><a name="item__5bpixmap_3a_2bname_5d"><strong>[pixmap:+<em>name</em>] </strong>&gt;</a></strong><br />
1858 </dt>
1859 <dt><strong><a name="item__5bpixmap_3a_2bname_3bscaling_5d"><strong>[pixmap:+<em>name</em>;<em>scaling</em>] </strong>&gt;</a></strong><br />
1860 </dt>
1861 <dd>
1862 (set the background pixmap globally
1863 </dd>
1864 <dd>
1865 <p><strong>A Future implementation <em>may</em> make this local to the menubar </strong>&gt;)</p>
1866 </dd>
1867 <p></p>
1868 <dt><strong><a name="item__5b_3a_2bcommand_3a_5d"><strong>[:+<em>command</em>:] </strong>&gt;</a></strong><br />
1869 </dt>
1870 <dd>
1871 ignore the menu readonly status and issue a <em>command</em> to or a menu or
1872 menuitem or change the ; a useful shortcut for setting the quick arrows
1873 from a menuBar.
1874 </dd>
1875 <p></p></dl>
1876 <p></p>
1877 <p>
1878 </p>
1879 <h2><a name="adding_and_accessing_menus">Adding and accessing menus</a></h2>
1880 <p>The following commands may also be <strong>+</strong> prefixed.</p>
1881 <dl>
1882 <dt><strong><a name="item__2f_2b"><strong>/+</strong></a></strong><br />
1883 </dt>
1884 <dd>
1885 access menuBar top level
1886 </dd>
1887 <p></p>
1888 <dt><strong><a name="item__2e_2f_2b"><strong>./+</strong></a></strong><br />
1889 </dt>
1890 <dd>
1891 access current menu level
1892 </dd>
1893 <p></p>
1894 <dt><strong><a name="item__2e_2e_2f_2b"><strong>../+</strong></a></strong><br />
1895 </dt>
1896 <dd>
1897 access parent menu (1 level up)
1898 </dd>
1899 <p></p>
1900 <dt><strong><a name="item__2e_2e_2f_2e_2e_2f"><strong>../../</strong></a></strong><br />
1901 </dt>
1902 <dd>
1903 access parent menu (multiple levels up)
1904 </dd>
1905 <p></p>
1906 <dt><strong><a name="item__2fpath_2fmenu"><strong><em>/path/</em>menu </strong>&gt;</a></strong><br />
1907 </dt>
1908 <dd>
1909 add/access menu
1910 </dd>
1911 <p></p>
1912 <dt><strong><a name="item__2fpath_2fmenu_2f_2a"><strong><em>/path/</em>menu/* </strong>&gt;</a></strong><br />
1913 </dt>
1914 <dd>
1915 add/access menu and clear it if it exists
1916 </dd>
1917 <p></p>
1918 <dt><strong><a name="item__2fpath_2f_7b_2d_7d"><strong><em>/path/</em>{-} </strong>&gt;</a></strong><br />
1919 </dt>
1920 <dd>
1921 add separator
1922 </dd>
1923 <p></p>
1924 <dt><strong><a name="item__2fpath_2f_7bitem_7d"><strong><em>/path/</em>{item} </strong>&gt;</a></strong><br />
1925 </dt>
1926 <dd>
1927 add <strong>item</strong> as a label
1928 </dd>
1929 <p></p>
1930 <dt><strong><a name="item__2fpath_2f_7bitem_7d_action"><strong><em>/path/</em>{item} action </strong>&gt;</a></strong><br />
1931 </dt>
1932 <dd>
1933 add/alter <em>menuitem</em> with an associated <em>action</em>
1934 </dd>
1935 <p></p>
1936 <dt><strong><a name="item__2fpath_2f_7bitem_7d_7bright_2dtext_7d"><strong><em>/path/</em>{item}{right-text} </strong>&gt;</a></strong><br />
1937 </dt>
1938 <dd>
1939 add/alter <em>menuitem</em> with <strong>right-text</strong> as the right-justified text
1940 and as the associated <em>action</em>
1941 </dd>
1942 <p></p>
1943 <dt><strong><a name="item__2fpath_2f_7bitem_7d_7brtext_7d_action"><strong><em>/path/</em>{item}{rtext} action </strong>&gt;</a></strong><br />
1944 </dt>
1945 <dd>
1946 add/alter <em>menuitem</em> with an associated <em>action</em> and with <strong>rtext</strong> as
1947 the right-justified text.
1948 </dd>
1949 <p></p></dl>
1950 <dl>
1951 <dt><strong><a name="item_special_characters_in_action_must_be_backslash_2de">Special characters in <em>action</em> must be backslash-escaped:</a></strong><br />
1952 </dt>
1953 <dd>
1954 <strong>\a \b \E \e \n \r \t \octal</strong>
1955 </dd>
1956 <p></p>
1957 <dt><strong><a name="item_or_in_control_2dcharacter_notation_3a">or in control-character notation:</a></strong><br />
1958 </dt>
1959 <dd>
1960 <strong>^@, ^A .. ^Z .. ^_, ^?</strong>
1961 </dd>
1962 <p></p></dl>
1963 <p>To send a string starting with a <strong>NUL</strong> (<strong>^@</strong>) character to the
1964 program, start <em>action</em> with a pair of <strong>NUL</strong> characters (<strong>^@^@</strong>),
1965 the first of which will be stripped off and the balance directed to the
1966 program. Otherwise if <em>action</em> begins with <strong>NUL</strong> followed by
1967 non-+<strong>NUL</strong> characters, the leading <strong>NUL</strong> is stripped off and the
1968 balance is sent back to rxvt.</p>
1969 <p>As a convenience for the many Emacs-type editors, <em>action</em> may start
1970 with <strong>M-</strong> (eg, <strong>M-$</strong> is equivalent to <strong>\E$</strong>) and a <strong>CR</strong> will be
1971 appended if missed from <strong>M-x</strong> commands.</p>
1972 <p>As a convenience for issuing XTerm <strong>ESC ]</strong> sequences from a menubar (or
1973 quick arrow), a <strong>BEL</strong> (<strong>^G</strong>) will be appended if needed.</p>
1974 <dl>
1975 <dt><strong><a name="item_for_example_2c">For example,</a></strong><br />
1976 </dt>
1977 <dd>
1978 <strong>M-xapropos</strong> is equivalent to <strong>\Exapropos\r</strong>
1979 </dd>
1980 <p></p>
1981 <dt><strong><a name="item_and">and</a></strong><br />
1982 </dt>
1983 <dd>
1984 <strong>\E]703;mona;100</strong> is equivalent to <strong>\E]703;mona;100\a</strong>
1985 </dd>
1986 <p></p></dl>
1987 <p>The option <strong>{<em>right-rtext</em>} </strong>&gt; will be right-justified. In the
1988 absence of a specified action, this text will be used as the <em>action</em>
1989 as well.</p>
1990 <dl>
1991 <dt><strong>For example,</strong><br />
1992 </dt>
1993 <dd>
1994 <strong>/File/{Open}{^X^F}</strong> is equivalent to <strong>/File/{Open}{^X^F} ^X^F</strong>
1995 </dd>
1996 <p></p></dl>
1997 <p>The left label <em>is</em> necessary, since it's used for matching, but
1998 implicitly hiding the left label (by using same name for both left and
1999 right labels), or explicitly hiding the left label (by preceeding it
2000 with a dot), makes it possible to have right-justified text only.</p>
2001 <dl>
2002 <dt><strong>For example,</strong><br />
2003 </dt>
2004 <dd>
2005 <strong>/File/{Open}{Open} Open-File-Action</strong>
2006 </dd>
2007 <p></p>
2008 <dt><strong><a name="item_or_hiding_it">or hiding it</a></strong><br />
2009 </dt>
2010 <dd>
2011 <strong>/File/{.anylabel}{Open} Open-File-Action</strong>
2012 </dd>
2013 <p></p></dl>
2014 <p></p>
2015 <p>
2016 </p>
2017 <h2><a name="removing_menus">Removing menus</a></h2>
2018 <dl>
2019 <dt><strong><a name="item__2d_2f_2a_2b"><strong>-/*+ </strong>&gt;</a></strong><br />
2020 </dt>
2021 <dd>
2022 remove all menus from the menuBar, the same as <strong>[clear]</strong>
2023 </dd>
2024 <p></p>
2025 <dt><strong><a name="item__2d_2b_2fpathmenu_2b"><strong>-+<em>/path</em>menu+ </strong>&gt;</a></strong><br />
2026 </dt>
2027 <dd>
2028 remove menu
2029 </dd>
2030 <p></p>
2031 <dt><strong><a name="item__2d_2b_2fpath_7bitem_7d_2b"><strong>-+<em>/path</em>{item}+ </strong>&gt;</a></strong><br />
2032 </dt>
2033 <dd>
2034 remove item
2035 </dd>
2036 <p></p>
2037 <dt><strong><a name="item__2d_2b_2fpath_7b_2d_7d"><strong>-+<em>/path</em>{-} </strong>&gt;</a></strong><br />
2038 </dt>
2039 <dd>
2040 remove separator)
2041 </dd>
2042 <p></p>
2043 <dt><strong><a name="item__2d_2fpath_2fmenu_2f_2a"><strong>-/path/menu/*</strong></a></strong><br />
2044 </dt>
2045 <dd>
2046 remove all items, separators and submenus from menu
2047 </dd>
2048 <p></p></dl>
2049 <p></p>
2050 <p>
2051 </p>
2052 <h2><a name="quick_arrows">Quick Arrows</a></h2>
2053 <p>The menus also provide a hook for <em>quick arrows</em> to provide easier
2054 user access. If nothing has been explicitly set, the default is to
2055 emulate the curror keys. The syntax permits each arrow to be altered
2056 individually or all four at once without re-entering their common
2057 beginning/end text. For example, to explicitly associate cursor actions
2058 with the arrows, any of the following forms could be used:</p>
2059 <dl>
2060 <dt><strong><a name="item__3cr_3e_2bright"><strong>&lt;r</strong>+<em>Right</em> &gt;&gt;</a></strong><br />
2061 </dt>
2062 <dt><strong><a name="item__3cl_3e_2bleft"><strong>&lt;l</strong>+<em>Left</em> &gt;&gt;</a></strong><br />
2063 </dt>
2064 <dt><strong><a name="item__3cu_3e_2bup"><strong>&lt;u</strong>+<em>Up</em> &gt;&gt;</a></strong><br />
2065 </dt>
2066 <dt><strong><a name="item__3cd_3e_2bdown"><strong>&lt;d</strong>+<em>Down</em> &gt;&gt;</a></strong><br />
2067 </dt>
2068 <dd>
2069 Define actions for the respective arrow buttons
2070 </dd>
2071 <p></p>
2072 <dt><strong><a name="item__3cb_3e_2bbegin"><strong>&lt;b</strong>+<em>Begin</em> &gt;&gt;</a></strong><br />
2073 </dt>
2074 <dt><strong><a name="item__3ce_3e_2bend"><strong>&lt;e</strong>+<em>End</em> &gt;&gt;</a></strong><br />
2075 </dt>
2076 <dd>
2077 Define common beginning/end parts for <em>quick arrows</em> which used in
2078 conjunction with the above &lt;r&gt; &lt;l&gt; &lt;u&gt; &lt;d&gt; constructs
2079 </dd>
2080 <p></p></dl>
2081 <dl>
2082 <dt><strong><a name="item_for_example_2c_define_arrows_individually_2c">For example, define arrows individually,</a></strong><br />
2083 </dt>
2084 <dd>
2085 <pre>
2086  &lt;u&gt;\E[A</pre>
2087 </dd>
2088 <dd>
2089 <pre>
2090  &lt;d&gt;\E[B</pre>
2091 </dd>
2092 <dd>
2093 <pre>
2094  &lt;r&gt;\E[C</pre>
2095 </dd>
2096 <dd>
2097 <pre>
2098  &lt;l&gt;\E[D</pre>
2099 </dd>
2100 <dt><strong><a name="item_or_all_at_once">or all at once</a></strong><br />
2101 </dt>
2102 <dd>
2103 <pre>
2104  &lt;u&gt;\E[AZ&lt;&gt;&lt;d&gt;\E[BZ&lt;&gt;&lt;r&gt;\E[CZ&lt;&gt;&lt;l&gt;\E[D</pre>
2105 </dd>
2106 <dt><strong><a name="item_compactly">or more compactly (factoring out common parts)</a></strong><br />
2107 </dt>
2108 <dd>
2109 <pre>
2110  &lt;b&gt;\E[&lt;u&gt;AZ&lt;&gt;&lt;d&gt;BZ&lt;&gt;&lt;r&gt;CZ&lt;&gt;&lt;l&gt;D</pre>
2111 </dd>
2112 </dl>
2113 <p></p>
2114 <p>
2115 </p>
2116 <h2><a name="command_summary">Command Summary</a></h2>
2117 <p>A short summary of the most <em>common</em> commands:</p>
2118 <dl>
2119 <dt><strong><a name="item__5bmenu_3aname_5d">[menu:name]</a></strong><br />
2120 </dt>
2121 <dd>
2122 use an existing named menuBar or start a new one
2123 </dd>
2124 <p></p>
2125 <dt><strong>[menu]</strong><br />
2126 </dt>
2127 <dd>
2128 use the current menuBar
2129 </dd>
2130 <p></p>
2131 <dt><strong><a name="item__5btitle_3astring_5d">[title:string]</a></strong><br />
2132 </dt>
2133 <dd>
2134 set menuBar title
2135 </dd>
2136 <p></p>
2137 <dt><strong>[done]</strong><br />
2138 </dt>
2139 <dd>
2140 set menu access to readonly and, if reading from a file, signal EOF
2141 </dd>
2142 <p></p>
2143 <dt><strong><a name="item__5bdone_3aname_5d">[done:name]</a></strong><br />
2144 </dt>
2145 <dd>
2146 if reading from a file using [read:file;name] signal EOF
2147 </dd>
2148 <p></p>
2149 <dt><strong>[rm:name]</strong><br />
2150 </dt>
2151 <dd>
2152 remove named <code>menuBar(s)</code>
2153 </dd>
2154 <p></p>
2155 <dt><strong>[rm] [rm:]</strong><br />
2156 </dt>
2157 <dd>
2158 remove current menuBar
2159 </dd>
2160 <p></p>
2161 <dt><strong>[rm*] [rm:*]</strong><br />
2162 </dt>
2163 <dd>
2164 remove all <code>menuBar(s)</code>
2165 </dd>
2166 <p></p>
2167 <dt><strong>[swap]</strong><br />
2168 </dt>
2169 <dd>
2170 swap top two menuBars
2171 </dd>
2172 <p></p>
2173 <dt><strong>[prev]</strong><br />
2174 </dt>
2175 <dd>
2176 access the previous menuBar
2177 </dd>
2178 <p></p>
2179 <dt><strong>[next]</strong><br />
2180 </dt>
2181 <dd>
2182 access the next menuBar
2183 </dd>
2184 <p></p>
2185 <dt><strong>[show]</strong><br />
2186 </dt>
2187 <dd>
2188 map menuBar
2189 </dd>
2190 <p></p>
2191 <dt><strong>[hide]</strong><br />
2192 </dt>
2193 <dd>
2194 unmap menuBar
2195 </dd>
2196 <p></p>
2197 <dt><strong><a name="item__5bpixmap_3bfile_5d">[pixmap;file]</a></strong><br />
2198 </dt>
2199 <dt><strong><a name="item__5bpixmap_3bfile_3bscaling_5d">[pixmap;file;scaling]</a></strong><br />
2200 </dt>
2201 <dd>
2202 set a background pixmap
2203 </dd>
2204 <p></p>
2205 <dt><strong><a name="item__5bread_3afile_5d">[read:file]</a></strong><br />
2206 </dt>
2207 <dt><strong><a name="item__5bread_3afile_3bname_5d">[read:file;name]</a></strong><br />
2208 </dt>
2209 <dd>
2210 read in a menu from a file
2211 </dd>
2212 <p></p>
2213 <dt><strong>[dump]</strong><br />
2214 </dt>
2215 <dd>
2216 dump out all menuBars to /tmp/rxvt-PID
2217 </dd>
2218 <p></p>
2219 <dt><strong><a name="item__2f">/</a></strong><br />
2220 </dt>
2221 <dd>
2222 access menuBar top level
2223 </dd>
2224 <p></p>
2225 <dt><strong><a name="item__2e_2f">./</a></strong><br />
2226 </dt>
2227 <dt><strong><a name="item__2e_2e_2f">../</a></strong><br />
2228 </dt>
2229 <dt><strong>../../</strong><br />
2230 </dt>
2231 <dd>
2232 access current or parent menu level
2233 </dd>
2234 <p></p>
2235 <dt><strong>/path/menu</strong><br />
2236 </dt>
2237 <dd>
2238 add/access menu
2239 </dd>
2240 <p></p>
2241 <dt><strong>/path/{-}</strong><br />
2242 </dt>
2243 <dd>
2244 add separator
2245 </dd>
2246 <p></p>
2247 <dt><strong>/path/{item}{rtext} action</strong><br />
2248 </dt>
2249 <dd>
2250 add/alter menu item
2251 </dd>
2252 <p></p>
2253 <dt><strong><a name="item__2d_2f_2a">-/*</a></strong><br />
2254 </dt>
2255 <dd>
2256 remove all menus from the menuBar
2257 </dd>
2258 <p></p>
2259 <dt><strong><a name="item__2d_2fpath_2fmenu">-/path/menu</a></strong><br />
2260 </dt>
2261 <dd>
2262 remove menu items, separators and submenus from menu
2263 </dd>
2264 <p></p>
2265 <dt><strong>-/path/menu</strong><br />
2266 </dt>
2267 <dd>
2268 remove menu
2269 </dd>
2270 <p></p>
2271 <dt><strong><a name="item__2d_2fpath_2f_7bitem_7d">-/path/{item}</a></strong><br />
2272 </dt>
2273 <dd>
2274 remove item
2275 </dd>
2276 <p></p>
2277 <dt><strong><a name="item__2d_2fpath_2f_7b_2d_7d">-/path/{-}</a></strong><br />
2278 </dt>
2279 <dd>
2280 remove separator
2281 </dd>
2282 <p></p>
2283 <dt><strong><a name="item__3cb_3ebegin_3cr_3eright_3cl_3eleft_3cu_3eup_3cd_3">&lt;b&gt;Begin&lt;r&gt;Right&lt;l&gt;Left&lt;u&gt;Up&lt;d&gt;Down&lt;e&gt;End</a></strong><br />
2284 </dt>
2285 <dd>
2286 menu quick arrows
2287 </dd>
2288 <p></p></dl>
2289 <p>
2290 </p>
2291 <hr />
2292 <h1><a name="xpm">XPM</a></h1>
2293 <p>For the XPM XTerm escape sequence <strong><code>ESC ] 20 ; Pt ST</code> </strong>&gt; then value
2294 of <strong><a href="#item_pt"><code>Pt</code></a> </strong>&gt; can be the name of the background pixmap followed by a
2295 sequence of scaling/positioning commands separated by semi-colons. The
2296 scaling/positioning commands are as follows:</p>
2297 <dl>
2298 <dt><strong><a name="item_query_scale_2fposition">query scale/position</a></strong><br />
2299 </dt>
2300 <dd>
2301 <strong>?</strong>
2302 </dd>
2303 <p></p>
2304 <dt><strong><a name="item_change_scale_and_position">change scale and position</a></strong><br />
2305 </dt>
2306 <dd>
2307 <strong>WxH+X+Y</strong>
2308 </dd>
2309 <dd>
2310 <p><strong>WxH+X</strong> (== <strong>WxH+X+X</strong>)</p>
2311 </dd>
2312 <dd>
2313 <p><strong>WxH</strong> (same as <strong>WxH+50+50</strong>)</p>
2314 </dd>
2315 <dd>
2316 <p><strong>W+X+Y</strong> (same as <strong>WxW+X+Y</strong>)</p>
2317 </dd>
2318 <dd>
2319 <p><strong>W+X</strong> (same as <strong>WxW+X+X</strong>)</p>
2320 </dd>
2321 <dd>
2322 <p><strong>W</strong> (same as <strong>WxW+50+50</strong>)</p>
2323 </dd>
2324 <p></p>
2325 <dt><strong><a name="item_position">change position (absolute)</a></strong><br />
2326 </dt>
2327 <dd>
2328 <strong>=+X+Y</strong>
2329 </dd>
2330 <dd>
2331 <p><strong>=+X</strong> (same as <strong>=+X+Y</strong>)</p>
2332 </dd>
2333 <p></p>
2334 <dt><strong>change position (relative)</strong><br />
2335 </dt>
2336 <dd>
2337 <strong>+X+Y</strong>
2338 </dd>
2339 <dd>
2340 <p><strong>+X</strong> (same as <strong>+X+Y</strong>)</p>
2341 </dd>
2342 <p></p>
2343 <dt><strong><a name="item_rescale">rescale (relative)</a></strong><br />
2344 </dt>
2345 <dd>
2346 <strong>Wx0</strong> -&gt; <strong>W *= (W/100)</strong>
2347 </dd>
2348 <dd>
2349 <p><strong>0xH</strong> -&gt; <strong>H *= (H/100)</strong></p>
2350 </dd>
2351 <p></p></dl>
2352 <p>For example:</p>
2353 <dl>
2354 <dt><strong><a name="item__5ce_5d20_3bfunky_5ca"><strong>\E]20;funky\a</strong></a></strong><br />
2355 </dt>
2356 <dd>
2357 load <strong>funky.xpm</strong> as a tiled image
2358 </dd>
2359 <p></p>
2360 <dt><strong><a name="item__5ce_5d20_3bmona_3b100_5ca"><strong>\E]20;mona;100\a</strong></a></strong><br />
2361 </dt>
2362 <dd>
2363 load <strong>mona.xpm</strong> with a scaling of 100%
2364 </dd>
2365 <p></p>
2366 <dt><strong><a name="item__5ce_5d20_3b_3b200_3b_3f_5ca"><strong>\E]20;;200;?\a</strong></a></strong><br />
2367 </dt>
2368 <dd>
2369 rescale the current pixmap to 200% and display the image geometry in
2370 the title
2371 </dd>
2372 <p></p></dl>
2373 <p>
2374 </p>
2375 <hr />
2376 <h1><a name="mouse_reporting">Mouse Reporting</a></h1>
2377 <dl>
2378 <dt><strong><a name="item_esc__5b_m__3cb_3e__3cx_3e__3cy_3e"><strong><code>ESC [ M &lt;b&gt; &lt;x&gt; &lt;y&gt;</code> </strong>&gt;</a></strong><br />
2379 </dt>
2380 <dd>
2381 report mouse position
2382 </dd>
2383 <p></p></dl>
2384 <p>The lower 2 bits of <strong><code>&lt;b&gt;</code> </strong>&gt; indicate the button:</p>
2385 <dl>
2386 <dt><strong><a name="item_button__3d__28_3cb_3e__2d_space_29__26_3">Button = <strong><code>(&lt;b&gt; - SPACE) &amp; 3</code> </strong>&gt;</a></strong><br />
2387 </dt>
2388 <table>
2389 <tr><td>0</td><td>Button1 pressed</td></tr>
2390 <tr><td>1</td><td>Button2 pressed</td></tr>
2391 <tr><td>2</td><td>Button3 pressed</td></tr>
2392 <tr><td>3</td><td>button released (X11 mouse report)</td></tr>
2393 </table></dl>
2394 <p>The upper bits of <strong><code>&lt;b&gt;</code> </strong>&gt; indicate the modifiers when the
2395 button was pressed and are added together (X11 mouse report only):</p>
2396 <dl>
2397 <dt><strong><a name="item_state__3d__28_3cb_3e__2d_space_29__26_60">State = <strong><code>(&lt;b&gt; - SPACE) &amp; 60</code> </strong>&gt;</a></strong><br />
2398 </dt>
2399 <table>
2400 <tr><td>4</td><td>Shift</td></tr>
2401 <tr><td>8</td><td>Meta</td></tr>
2402 <tr><td>16</td><td>Control</td></tr>
2403 <tr><td>32</td><td>Double Click (Rxvt extension)</td></tr>
2404 </table><p>Col = <strong><code>&lt;x&gt; - SPACE</code> </strong>&gt;</p>
2405 <p>Row = <strong><code>&lt;y&gt; - SPACE</code> </strong>&gt;</p>
2406 </dl>
2407 <p>
2408 </p>
2409 <hr />
2410 <h1><a name="key_codes">Key Codes</a></h1>
2411 <p>Note: <strong>Shift</strong> + <strong>F1</strong>-<strong>F10</strong> generates <strong>F11</strong>-<strong>F20</strong></p>
2412 <p>For the keypad, use <strong>Shift</strong> to temporarily override Application-Keypad
2413 setting use <strong>Num_Lock</strong> to toggle Application-Keypad setting if
2414 <strong>Num_Lock</strong> is off, toggle Application-Keypad setting. Also note that
2415 values of <strong>Home</strong>, <strong>End</strong>, <strong>Delete</strong> may have been compiled differently on
2416 your system.</p>
2417 <table>
2418 <tr><td></td><td>Normal</td><td>Shift</td><td>Control</td><td>Ctrl+Shift</td></tr>
2419 <tr><td>Tab</td><td>^I</td><td>ESC [ Z</td><td>^I</td><td>ESC [ Z</td></tr>
2420 <tr><td>BackSpace</td><td>^H</td><td>^?</td><td>^?</td><td>^?</td></tr>
2421 <tr><td>Find</td><td>ESC [ 1 ~</td><td>ESC [ 1 $</td><td>ESC [ 1 ^</td><td>ESC [ 1 @</td></tr>
2422 <tr><td>Insert</td><td>ESC [ 2 ~</td><td>paste</td><td>ESC [ 2 ^</td><td>ESC [ 2 @</td></tr>
2423 <tr><td>Execute</td><td>ESC [ 3 ~</td><td>ESC [ 3 $</td><td>ESC [ 3 ^</td><td>ESC [ 3 @</td></tr>
2424 <tr><td>Select</td><td>ESC [ 4 ~</td><td>ESC [ 4 $</td><td>ESC [ 4 ^</td><td>ESC [ 4 @</td></tr>
2425 <tr><td>Prior</td><td>ESC [ 5 ~</td><td>scroll-up</td><td>ESC [ 5 ^</td><td>ESC [ 5 @</td></tr>
2426 <tr><td>Next</td><td>ESC [ 6 ~</td><td>scroll-down</td><td>ESC [ 6 ^</td><td>ESC [ 6 @</td></tr>
2427 <tr><td>Home</td><td>ESC [ 7 ~</td><td>ESC [ 7 $</td><td>ESC [ 7 ^</td><td>ESC [ 7 @</td></tr>
2428 <tr><td>End</td><td>ESC [ 8 ~</td><td>ESC [ 8 $</td><td>ESC [ 8 ^</td><td>ESC [ 8 @</td></tr>
2429 <tr><td>Delete</td><td>ESC [ 3 ~</td><td>ESC [ 3 $</td><td>ESC [ 3 ^</td><td>ESC [ 3 @</td></tr>
2430 <tr><td>F1</td><td>ESC [ 11 ~</td><td>ESC [ 23 ~</td><td>ESC [ 11 ^</td><td>ESC [ 23 ^</td></tr>
2431 <tr><td>F2</td><td>ESC [ 12 ~</td><td>ESC [ 24 ~</td><td>ESC [ 12 ^</td><td>ESC [ 24 ^</td></tr>
2432 <tr><td>F3</td><td>ESC [ 13 ~</td><td>ESC [ 25 ~</td><td>ESC [ 13 ^</td><td>ESC [ 25 ^</td></tr>
2433 <tr><td>F4</td><td>ESC [ 14 ~</td><td>ESC [ 26 ~</td><td>ESC [ 14 ^</td><td>ESC [ 26 ^</td></tr>
2434 <tr><td>F5</td><td>ESC [ 15 ~</td><td>ESC [ 28 ~</td><td>ESC [ 15 ^</td><td>ESC [ 28 ^</td></tr>
2435 <tr><td>F6</td><td>ESC [ 17 ~</td><td>ESC [ 29 ~</td><td>ESC [ 17 ^</td><td>ESC [ 29 ^</td></tr>
2436 <tr><td>F7</td><td>ESC [ 18 ~</td><td>ESC [ 31 ~</td><td>ESC [ 18 ^</td><td>ESC [ 31 ^</td></tr>
2437 <tr><td>F8</td><td>ESC [ 19 ~</td><td>ESC [ 32 ~</td><td>ESC [ 19 ^</td><td>ESC [ 32 ^</td></tr>
2438 <tr><td>F9</td><td>ESC [ 20 ~</td><td>ESC [ 33 ~</td><td>ESC [ 20 ^</td><td>ESC [ 33 ^</td></tr>
2439 <tr><td>F10</td><td>ESC [ 21 ~</td><td>ESC [ 34 ~</td><td>ESC [ 21 ^</td><td>ESC [ 34 ^</td></tr>
2440 <tr><td>F11</td><td>ESC [ 23 ~</td><td>ESC [ 23 $</td><td>ESC [ 23 ^</td><td>ESC [ 23 @</td></tr>
2441 <tr><td>F12</td><td>ESC [ 24 ~</td><td>ESC [ 24 $</td><td>ESC [ 24 ^</td><td>ESC [ 24 @</td></tr>
2442 <tr><td>F13</td><td>ESC [ 25 ~</td><td>ESC [ 25 $</td><td>ESC [ 25 ^</td><td>ESC [ 25 @</td></tr>
2443 <tr><td>F14</td><td>ESC [ 26 ~</td><td>ESC [ 26 $</td><td>ESC [ 26 ^</td><td>ESC [ 26 @</td></tr>
2444 <tr><td>F15 (Help)</td><td>ESC [ 28 ~</td><td>ESC [ 28 $</td><td>ESC [ 28 ^</td><td>ESC [ 28 @</td></tr>
2445 <tr><td>F16 (Menu)</td><td>ESC [ 29 ~</td><td>ESC [ 29 $</td><td>ESC [ 29 ^</td><td>ESC [ 29 @</td></tr>
2446 <tr><td>F17</td><td>ESC [ 31 ~</td><td>ESC [ 31 $</td><td>ESC [ 31 ^</td><td>ESC [ 31 @</td></tr>
2447 <tr><td>F18</td><td>ESC [ 32 ~</td><td>ESC [ 32 $</td><td>ESC [ 32 ^</td><td>ESC [ 32 @</td></tr>
2448 <tr><td>F19</td><td>ESC [ 33 ~</td><td>ESC [ 33 $</td><td>ESC [ 33 ^</td><td>ESC [ 33 @</td></tr>
2449 <tr><td>F20</td><td>ESC [ 34 ~</td><td>ESC [ 34 $</td><td>ESC [ 34 ^</td><td>ESC [ 34 @</td></tr>
2450 <tr><td></td><td></td><td></td><td></td><td>Application</td></tr>
2451 <tr><td>Up</td><td>ESC [ A</td><td>ESC [ a</td><td>ESC O a</td><td>ESC O A</td></tr>
2452 <tr><td>Down</td><td>ESC [ B</td><td>ESC [ b</td><td>ESC O b</td><td>ESC O B</td></tr>
2453 <tr><td>Right</td><td>ESC [ C</td><td>ESC [ c</td><td>ESC O c</td><td>ESC O C</td></tr>
2454 <tr><td>Left</td><td>ESC [ D</td><td>ESC [ d</td><td>ESC O d</td><td>ESC O D</td></tr>
2455 <tr><td>KP_Enter</td><td>^M</td><td></td><td></td><td>ESC O M</td></tr>
2456 <tr><td>KP_F1</td><td>ESC O P</td><td></td><td></td><td>ESC O P</td></tr>
2457 <tr><td>KP_F2</td><td>ESC O Q</td><td></td><td></td><td>ESC O Q</td></tr>
2458 <tr><td>KP_F3</td><td>ESC O R</td><td></td><td></td><td>ESC O R</td></tr>
2459 <tr><td>KP_F4</td><td>ESC O S</td><td></td><td></td><td>ESC O S</td></tr>
2460 <tr><td>XK_KP_Multiply</td><td>*</td><td></td><td></td><td>ESC O j</td></tr>
2461 <tr><td>XK_KP_Add</td><td>+</td><td></td><td></td><td>ESC O k</td></tr>
2462 <tr><td>XK_KP_Separator</td><td>,</td><td></td><td></td><td>ESC O l</td></tr>
2463 <tr><td>XK_KP_Subtract</td><td>-</td><td></td><td></td><td>ESC O m</td></tr>
2464 <tr><td>XK_KP_Decimal</td><td>.</td><td></td><td></td><td>ESC O n</td></tr>
2465 <tr><td>XK_KP_Divide</td><td>/</td><td></td><td></td><td>ESC O o</td></tr>
2466 <tr><td>XK_KP_0</td><td>0</td><td></td><td></td><td>ESC O p</td></tr>
2467 <tr><td>XK_KP_1</td><td>1</td><td></td><td></td><td>ESC O q</td></tr>
2468 <tr><td>XK_KP_2</td><td>2</td><td></td><td></td><td>ESC O r</td></tr>
2469 <tr><td>XK_KP_3</td><td>3</td><td></td><td></td><td>ESC O s</td></tr>
2470 <tr><td>XK_KP_4</td><td>4</td><td></td><td></td><td>ESC O t</td></tr>
2471 <tr><td>XK_KP_5</td><td>5</td><td></td><td></td><td>ESC O u</td></tr>
2472 <tr><td>XK_KP_6</td><td>6</td><td></td><td></td><td>ESC O v</td></tr>
2473 <tr><td>XK_KP_7</td><td>7</td><td></td><td></td><td>ESC O w</td></tr>
2474 <tr><td>XK_KP_8</td><td>8</td><td></td><td></td><td>ESC O x</td></tr>
2475 <tr><td>XK_KP_9</td><td>9</td><td></td><td></td><td>ESC O y</td></tr>
2476 </table><p>
2477 </p>
2478 <hr />
2479 <h1><a name="configure_options">CONFIGURE OPTIONS</a></h1>
2480 <p>General hint: if you get compile errors, then likely your configuration
2481 hasn't been tested well. Either try with --enable-everything or use the
2482 ./reconf script as a base for experiments. ./reconf is used by myself,
2483 so it should generally be a working config. Of course, you should always
2484 report when a combination doesn't work, so it can be fixed. Marc Lehmann
2485 &lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt;.</p>
2486 <dl>
2487 <dt><strong><a name="item__2d_2denable_2deverything">--enable-everything</a></strong><br />
2488 </dt>
2489 <dd>
2490 Add support for all non-multichoice options listed in ``./configure
2491 --help''. Note that unlike other enable options this is order dependant.
2492 You can specify this and then disable options which this enables by
2493 <em>following</em> this with the appropriate commands.
2494 </dd>
2495 <p></p>
2496 <dt><strong><a name="item__2d_2denable_2dxft">--enable-xft</a></strong><br />
2497 </dt>
2498 <dd>
2499 Add support for Xft (anti-aliases, among others) fonts. Xft fonts are
2500 slower and require lots of memory, but as long as you don't use them, you
2501 don't pay for them.
2502 </dd>
2503 <p></p>
2504 <dt><strong><a name="item__2d_2denable_2dfont_2dstyles">--enable-font-styles</a></strong><br />
2505 </dt>
2506 <dd>
2507 Add support for <strong>bold</strong>, <em>italic</em> and <strong><em>bold italic</em> </strong>&gt; font
2508 styles. The fonts can be set manually or automatically.
2509 </dd>
2510 <p></p>
2511 <dt><strong><a name="item__2d_2dwith_2dcodesets_3dname_2c_2e_2e_2e">--with-codesets=NAME,...</a></strong><br />
2512 </dt>
2513 <dd>
2514 Compile in support for additional codeset (encoding) groups (eu, vn are
2515 always compiled in, which includes most 8-bit character sets). These
2516 codeset tables are currently only used for driving X11 core fonts, they
2517 are not required for Xft fonts. Compiling them in will make your binary
2518 bigger (together about 700kB), but it doesn't increase memory usage unless
2519 you use an X11 font requiring one of these encodings.
2520 </dd>
2521 <table>
2522 <tr><td>all</td><td>all available codeset groups</td></tr>
2523 <tr><td>zh</td><td>common chinese encodings</td></tr>
2524 <tr><td>zh_ext</td><td>rarely used but very big chinese encodigs</td></tr>
2525 <tr><td>jp</td><td>common japanese encodings</td></tr>
2526 <tr><td>jp_ext</td><td>rarely used but big japanese encodings</td></tr>
2527 <tr><td>kr</td><td>korean encodings</td></tr>
2528 </table><p></p>
2529 <dt><strong><a name="item__2d_2denable_2dxim">--enable-xim</a></strong><br />
2530 </dt>
2531 <dd>
2532 Add support for XIM (X Input Method) protocol. This allows using
2533 alternative input methods (e.g. kinput2) and will also correctly
2534 set up the input for people using dead keys or compose keys.
2535 </dd>
2536 <p></p>
2537 <dt><strong><a name="item__2d_2denable_2dunicode3">--enable-unicode3</a></strong><br />
2538 </dt>
2539 <dd>
2540 Enable direct support for displaying unicode codepoints above
2541 65535 (the basic multilingual page). This increases storage
2542 requirements per character from 2 to 4 bytes. X11 fonts do not yet
2543 support these extra characters, but Xft does.
2544 </dd>
2545 <dd>
2546 <p>Please note that rxvt-unicode can store unicode code points &gt;65535
2547 even without this flag, but the number of such characters is
2548 limited to a view thousand (shared with combining characters,
2549 see next switch), and right now rxvt-unicode cannot display them
2550 (input/output and cut&amp;paste still work, though).</p>
2551 </dd>
2552 <p></p>
2553 <dt><strong><a name="item__2d_2denable_2dcombining">--enable-combining</a></strong><br />
2554 </dt>
2555 <dd>
2556 Enable automatic composition of combining characters into
2557 composite characters. This is required for proper viewing of text
2558 where accents are encoded as seperate unicode characters. This is
2559 done by using precomposited characters when available or creating
2560 new pseudo-characters when no precomposed form exists.
2561 </dd>
2562 <dd>
2563 <p>Without --enable-unicode3, the number of additional precomposed
2564 characters is rather limited (2048, if this is full, rxvt will use the
2565 private use area, extending the number of combinations to 8448). With
2566 --enable-unicode3, no practical limit exists. This will also enable
2567 storage of characters &gt;65535.</p>
2568 </dd>
2569 <dd>
2570 <p>The combining table also contains entries for arabic presentation forms,
2571 but these are not currently used. Bug me if you want these to be used.</p>
2572 </dd>
2573 <p></p>
2574 <dt><strong><a name="item_fallback">--enable-fallback(=CLASS)</a></strong><br />
2575 </dt>
2576 <dd>
2577 When reading resource settings, also read settings for class CLASS
2578 (default: Rxvt). To disable resource fallback use --disable-fallback.
2579 </dd>
2580 <p></p>
2581 <dt><strong><a name="item__2d_2dwith_2dres_2dname_3dname">--with-res-name=NAME</a></strong><br />
2582 </dt>
2583 <dd>
2584 Use the given name (default: urxvt) as default application name when
2585 reading resources. Specify --with-res-name=rxvt to replace rxvt.
2586 </dd>
2587 <p></p>
2588 <dt><strong><a name="item__2d_2dwith_2dres_2dclass_3dclass">--with-res-class=CLASS</a></strong><br />
2589 </dt>
2590 <dd>
2591 Use the given class (default: URxvt) as default application class
2592 when reading resources.  Specify --with-res-class=Rxvt to replace
2593 rxvt.
2594 </dd>
2595 <p></p>
2596 <dt><strong><a name="item__2d_2denable_2dutmp">--enable-utmp</a></strong><br />
2597 </dt>
2598 <dd>
2599 Write user and tty to utmp file (used by programs like <em>w</em>) at
2600 start of rxvt execution and delete information when rxvt exits.
2601 </dd>
2602 <p></p>
2603 <dt><strong><a name="item__2d_2denable_2dwtmp">--enable-wtmp</a></strong><br />
2604 </dt>
2605 <dd>
2606 Write user and tty to wtmp file (used by programs like <em>last</em>) at
2607 start of rxvt execution and write logout when rxvt exits.  This
2608 option requires --enable-utmp to also be specified.
2609 </dd>
2610 <p></p>
2611 <dt><strong><a name="item__2d_2denable_2dlastlog">--enable-lastlog</a></strong><br />
2612 </dt>
2613 <dd>
2614 Write user and tty to lastlog file (used by programs like
2615 <em>lastlogin</em>) at start of rxvt execution.  This option requires
2616 --enable-utmp to also be specified.
2617 </dd>
2618 <p></p>
2619 <dt><strong><a name="item__2d_2denable_2dxpm_2dbackground">--enable-xpm-background</a></strong><br />
2620 </dt>
2621 <dd>
2622 Add support for XPM background pixmaps.
2623 </dd>
2624 <p></p>
2625 <dt><strong><a name="item__2d_2denable_2dtransparency">--enable-transparency</a></strong><br />
2626 </dt>
2627 <dd>
2628 Add support for inheriting parent backgrounds thus giving a fake
2629 transparency to the term.
2630 </dd>
2631 <p></p>
2632 <dt><strong><a name="item__2d_2denable_2dfading">--enable-fading</a></strong><br />
2633 </dt>
2634 <dd>
2635 Add support for fading the text when focus is lost.
2636 </dd>
2637 <p></p>
2638 <dt><strong><a name="item__2d_2denable_2dtinting">--enable-tinting</a></strong><br />
2639 </dt>
2640 <dd>
2641 Add support for tinting of transparent backgrounds.
2642 </dd>
2643 <p></p>
2644 <dt><strong><a name="item__2d_2denable_2dmenubar">--enable-menubar</a></strong><br />
2645 </dt>
2646 <dd>
2647 Add support for our menu bar system (this interacts badly with
2648 dynamic locale switching currently).
2649 </dd>
2650 <p></p>
2651 <dt><strong><a name="item__2d_2denable_2drxvt_2dscroll">--enable-rxvt-scroll</a></strong><br />
2652 </dt>
2653 <dd>
2654 Add support for the original rxvt scrollbar.
2655 </dd>
2656 <p></p>
2657 <dt><strong><a name="item__2d_2denable_2dnext_2dscroll">--enable-next-scroll</a></strong><br />
2658 </dt>
2659 <dd>
2660 Add support for a NeXT-like scrollbar.
2661 </dd>
2662 <p></p>
2663 <dt><strong><a name="item__2d_2denable_2dxterm_2dscroll">--enable-xterm-scroll</a></strong><br />
2664 </dt>
2665 <dd>
2666 Add support for an Xterm-like scrollbar.
2667 </dd>
2668 <p></p>
2669 <dt><strong><a name="item__2d_2denable_2dplain_2dscroll">--enable-plain-scroll</a></strong><br />
2670 </dt>
2671 <dd>
2672 Add support for a very unobtrusive, plain-looking scrollbar that
2673 is the favourite of the rxvt-unicode author, having used it for
2674 many years.
2675 </dd>
2676 <p></p>
2677 <dt><strong><a name="item__2d_2denable_2dhalf_2dshadow">--enable-half-shadow</a></strong><br />
2678 </dt>
2679 <dd>
2680 Make shadows on the scrollbar only half the normal width &amp; height.
2681 only applicable to rxvt scrollbars.
2682 </dd>
2683 <p></p>
2684 <dt><strong><a name="item__2d_2denable_2dttygid">--enable-ttygid</a></strong><br />
2685 </dt>
2686 <dd>
2687 Change tty device setting to group ``tty'' - only use this if
2688 your system uses this type of security.
2689 </dd>
2690 <p></p>
2691 <dt><strong><a name="item__2d_2ddisable_2dbackspace_2dkey">--disable-backspace-key</a></strong><br />
2692 </dt>
2693 <dd>
2694 Disable any handling of the backspace key by us - let the X server
2695 do it.
2696 </dd>
2697 <p></p>
2698 <dt><strong><a name="item__2d_2ddisable_2ddelete_2dkey">--disable-delete-key</a></strong><br />
2699 </dt>
2700 <dd>
2701 Disable any handling of the delete key by us - let the X server
2702 do it.
2703 </dd>
2704 <p></p>
2705 <dt><strong><a name="item__2d_2ddisable_2dresources">--disable-resources</a></strong><br />
2706 </dt>
2707 <dd>
2708 Remove all resources checking.
2709 </dd>
2710 <p></p>
2711 <dt><strong><a name="item__2d_2denable_2dxgetdefault">--enable-xgetdefault</a></strong><br />
2712 </dt>
2713 <dd>
2714 Make resources checking via <code>XGetDefault()</code> instead of our small
2715 version which only checks ~/.Xdefaults, or if that doesn't exist then
2716 ~/.Xresources.
2717 </dd>
2718 <dd>
2719 <p>Please note that nowadays, things like XIM will automatically pull in and
2720 use the full X resource manager, so the overhead of using it might be very
2721 small, if nonexistant.</p>
2722 </dd>
2723 <p></p>
2724 <dt><strong><a name="item__2d_2denable_2dstrings">--enable-strings</a></strong><br />
2725 </dt>
2726 <dd>
2727 Add support for our possibly faster <code>memset()</code> function and other
2728 various routines, overriding your system's versions which may
2729 have been hand-crafted in assembly or may require extra libraries
2730 to link in. (this breaks ANSI-C rules and has problems on many
2731 GNU/Linux systems).
2732 </dd>
2733 <p></p>
2734 <dt><strong><a name="item__2d_2ddisable_2dswapscreen">--disable-swapscreen</a></strong><br />
2735 </dt>
2736 <dd>
2737 Remove support for swap screen.
2738 </dd>
2739 <p></p>
2740 <dt><strong><a name="item__2d_2denable_2dfrills">--enable-frills</a></strong><br />
2741 </dt>
2742 <dd>
2743 Add support for many small features that are not essential but nice to
2744 have. Normally you want this, but for very small binaries you may want to
2745 disable this.
2746 </dd>
2747 <dd>
2748 <p>A non-exhaustive list of features enabled by <a href="#item__2d_2denable_2dfrills"><code>--enable-frills</code></a> (possibly
2749 in combination with other switches) is:</p>
2750 </dd>
2751 <dd>
2752 <pre>
2753   MWM-hints
2754   seperate underline colour
2755   settable border widths and borderless switch
2756   settable extra linespacing
2757   extra window properties (e.g. UTF-8 window names and PID)
2758   iso-14755-2 and -3, and visual feedback
2759   backindex and forwardindex escape sequence
2760   window op and locale change escape sequences
2761   tripleclickwords
2762   settable insecure mode
2763   keysym remapping support</pre>
2764 </dd>
2765 <p></p>
2766 <dt><strong><a name="item__2d_2denable_2diso14755">--enable-iso14755</a></strong><br />
2767 </dt>
2768 <dd>
2769 Enable extended ISO 14755 support (see rxvt(1), or
2770 <em>doc/rxvt.1.txt</em>). Basic support (section 5.1) is enabled by
2771 <a href="#item__2d_2denable_2dfrills"><code>--enable-frills</code></a>, while support for 5.2, 5.3 and 5.4 is enabled with
2772 this switch.
2773 </dd>
2774 <p></p>
2775 <dt><strong><a name="item__2d_2denable_2dkeepscrolling">--enable-keepscrolling</a></strong><br />
2776 </dt>
2777 <dd>
2778 Add support for continual scrolling of the display when you hold
2779 the mouse button down on a scrollbar arrow.
2780 </dd>
2781 <p></p>
2782 <dt><strong><a name="item__2d_2denable_2dmousewheel">--enable-mousewheel</a></strong><br />
2783 </dt>
2784 <dd>
2785 Add support for scrolling via mouse wheel or buttons 4 &amp; 5.
2786 </dd>
2787 <p></p>
2788 <dt><strong><a name="item__2d_2denable_2dslipwheeling">--enable-slipwheeling</a></strong><br />
2789 </dt>
2790 <dd>
2791 Add support for continual scrolling (using the mouse wheel as an
2792 accelerator) while the control key is held down.  This option
2793 requires --enable-mousewheel to also be specified.
2794 </dd>
2795 <p></p>
2796 <dt><strong><a name="item__2d_2ddisable_2dnew_2dselection">--disable-new-selection</a></strong><br />
2797 </dt>
2798 <dd>
2799 Remove support for mouse selection style like that of xterm.
2800 </dd>
2801 <p></p>
2802 <dt><strong><a name="item__2d_2denable_2ddmalloc">--enable-dmalloc</a></strong><br />
2803 </dt>
2804 <dd>
2805 Use Gray Watson's malloc - which is good for debugging See
2806 <a href="http://www.letters.com/dmalloc/">http://www.letters.com/dmalloc/</a> for details If you use either this or the
2807 next option, you may need to edit src/Makefile after compiling to point
2808 DINCLUDE and DLIB to the right places.
2809 </dd>
2810 <dd>
2811 <p>You can only use either this option and the following (should
2812 you use either) .</p>
2813 </dd>
2814 <p></p>
2815 <dt><strong><a name="item__2d_2denable_2ddlmalloc">--enable-dlmalloc</a></strong><br />
2816 </dt>
2817 <dd>
2818 Use Doug Lea's malloc - which is good for a production version
2819 See <a href="http://g.oswego.edu/dl/html/malloc.html">http://g.oswego.edu/dl/html/malloc.html</a> for details.
2820 </dd>
2821 <p></p>
2822 <dt><strong><a name="item__2d_2denable_2dsmart_2dresize">--enable-smart-resize</a></strong><br />
2823 </dt>
2824 <dd>
2825 Add smart growth/shrink behaviour when changing font size via from hot
2826 keys. This should keep in a fixed position the rxvt corner which is
2827 closest to a corner of the screen.
2828 </dd>
2829 <p></p>
2830 <dt><strong><a name="item__2d_2denable_2dcursor_2dblink">--enable-cursor-blink</a></strong><br />
2831 </dt>
2832 <dd>
2833 Add support for a blinking cursor.
2834 </dd>
2835 <p></p>
2836 <dt><strong><a name="item__2d_2denable_2dpointer_2dblank">--enable-pointer-blank</a></strong><br />
2837 </dt>
2838 <dd>
2839 Add support to have the pointer disappear when typing or inactive.
2840 </dd>
2841 <p></p>
2842 <dt><strong><a name="item__2d_2dwith_2dname_3dname">--with-name=NAME</a></strong><br />
2843 </dt>
2844 <dd>
2845 Set the basename for the installed binaries (default: <code>urxvt</code>, resulting
2846 in <code>urxvt</code>, <code>urxvtd</code> etc.). Specify <code>--with-name=rxvt</code> to replace with
2847 <code>rxvt</code>.
2848 </dd>
2849 <p></p>
2850 <dt><strong><a name="item__2d_2dwith_2dterm_3dname">--with-term=NAME</a></strong><br />
2851 </dt>
2852 <dd>
2853 Change the environmental variable for the terminal to NAME (default
2854 <code>rxvt-unicode</code>)
2855 </dd>
2856 <p></p>
2857 <dt><strong><a name="item__2d_2dwith_2dterminfo_3dpath">--with-terminfo=PATH</a></strong><br />
2858 </dt>
2859 <dd>
2860 Change the environmental variable for the path to the terminfo tree to
2861 PATH.
2862 </dd>
2863 <p></p>
2864 <dt><strong><a name="item__2d_2dwith_2dx">--with-x</a></strong><br />
2865 </dt>
2866 <dd>
2867 Use the X Window System (pretty much default, eh?).
2868 </dd>
2869 <p></p>
2870 <dt><strong><a name="item__2d_2dwith_2dxpm_2dincludes_3ddir">--with-xpm-includes=DIR</a></strong><br />
2871 </dt>
2872 <dd>
2873 Look for the XPM includes in DIR.
2874 </dd>
2875 <p></p>
2876 <dt><strong><a name="item__2d_2dwith_2dxpm_2dlibrary_3ddir">--with-xpm-library=DIR</a></strong><br />
2877 </dt>
2878 <dd>
2879 Look for the XPM library in DIR.
2880 </dd>
2881 <p></p>
2882 <dt><strong><a name="item__2d_2dwith_2dxpm">--with-xpm</a></strong><br />
2883 </dt>
2884 <dd>
2885 Not needed - define via --enable-xpm-background.
2886 </dd>
2887 <p></p></dl>
2888 <p>
2889 </p>
2890 <hr />
2891 <h1><a name="authors">AUTHORS</a></h1>
2892 <p>Marc Lehmann &lt;<a href="mailto:rxvt@schmorp.de">rxvt@schmorp.de</a>&gt; converted this document to pod and
2893 reworked it from the original Rxvt documentation, which was done by Geoff
2894 Wing &lt;<a href="mailto:gcw@pobox.com">gcw@pobox.com</a>&gt;, who in turn used the XTerm documentation and other
2895 sources.</p>
2896
2897 </body>
2898
2899 </html>