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