~kklimonda/ubuntu/lucid/rxvt-unicode/lp-514821

« back to all changes in this revision

Viewing changes to doc/rxvt.7.txt

  • Committer: Bazaar Package Importer
  • Author(s): Decklin Foster
  • Date: 2006-09-01 14:44:58 UTC
  • mfrom: (1.1.8 upstream) (3.1.1 etch)
  • Revision ID: james.westby@ubuntu.com-20060901144458-98hrz8zg01w8a3vy
Tags: 7.9-2
* Edit the comments in the app-defaults file, and disable all settings by
  default. If font autoselection fails, I would prefer to open a new bug
  specifically for that. (Closes: #385481)
* Reorganize and edit README.Debian, pushing as much as possible into FAQ
  format (with resource setting issues first).

Show diffs side-by-side

added added

removed removed

Lines of Context:
81
81
    re-run the command. Subsequent invocations of the script will re-use the
82
82
    existing daemon.
83
83
 
84
 
   How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.
 
84
   How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.
85
85
    The original rxvt and rxvt-unicode always export the variable
86
86
    "COLORTERM", so you can check and see if that is set. Note that several
87
87
    programs, JED, slrn, Midnight Commander automatically check this
131
131
 
132
132
    When you "--enable-everything" (which *is* unfair, as this involves xft
133
133
    and full locale/XIM support which are quite bloaty inside libX11 and my
134
 
    libc), the two diverge, but not unreasnobaly so.
 
134
    libc), the two diverge, but not unreasonably so.
135
135
 
136
136
        text    data     bss     drs     rss filename
137
137
      163431    2152      24   20123    2060 rxvt --enable-everything
185
185
       libgcc_s.so.1 => /lib/libgcc_s.so.1 (0x00002aaaaada2000)
186
186
       libc.so.6 => /lib/libc.so.6 (0x00002aaaaaeb0000)     
187
187
       libdl.so.2 => /lib/libdl.so.2 (0x00002aaaab0ee000)   
188
 
       /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)     
 
188
       /lib64/ld-linux-x86-64.so.2 (0x00002aaaaaaab000)
189
189
 
190
190
    No large bloated libraries (of course, none were linked in statically),
191
191
    except maybe libX11 :)
225
225
    This requires XFT support, and the support of your X-server. If that
226
226
    doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
227
227
    there yet, no matter what they claim. Rxvt-Unicode contains the
228
 
    neccessary bugfixes and workarounds for Xft and Xlib to make it work,
229
 
    but that doesn't mean that your WM has the required kludges in place.
 
228
    necessary bugfixes and workarounds for Xft and Xlib to make it work, but
 
229
    that doesn't mean that your WM has the required kludges in place.
230
230
 
231
231
    4. Use xcompmgr and let it do the job:
232
232
 
251
251
    way is to ask for the character bounding box, which unfortunately is
252
252
    wrong in these cases).
253
253
 
254
 
    It's not clear (to me at least), wether this is a bug in Xft, freetype,
 
254
    It's not clear (to me at least), whether this is a bug in Xft, freetype,
255
255
    or the respective font. If you encounter this problem you might try
256
256
    using the "-lsp" option to give the font more height. If that doesn't
257
257
    work, you might be forced to use a different font.
283
283
    Yes, using an escape sequence. Try something like this, which has the
284
284
    same effect as using the "-fn" switch, and takes effect immediately:
285
285
 
286
 
       printf '\e]50;%s\007' "9x15bold,xft:Kochi Gothic"
 
286
       printf '\33]50;%s\007' "9x15bold,xft:Kochi Gothic"
287
287
 
288
288
    This is useful if you e.g. work primarily with japanese (and prefer a
289
289
    japanese font), but you have to switch to chinese temporarily, where
294
294
   Why do italic characters look as if clipped?
295
295
    Many fonts have difficulties with italic characters and hinting. For
296
296
    example, the otherwise very nicely hinted font "xft:Bitstream Vera Sans
297
 
    Mono" completely fails in it's italic face. A workaround might be to
 
297
    Mono" completely fails in its italic face. A workaround might be to
298
298
    enable freetype autohinting, i.e. like this:
299
299
 
300
300
       URxvt.italicFont:        xft:Bitstream Vera Sans Mono:italic:autohint=true
308
308
 
309
309
   Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?
310
310
    Rxvt-unicode will use whatever you specify as a font. If it needs to
311
 
    fall back to it's default font search list it will prefer X11 core
312
 
    fonts, because they are small and fast, and then use Xft fonts. It has
 
311
    fall back to its default font search list it will prefer X11 core fonts,
 
312
    because they are small and fast, and then use Xft fonts. It has
313
313
    antialiasing disabled for most of them, because the author thinks they
314
314
    look best that way.
315
315
 
480
480
    but when running a program that doesn't parse cursor movements or in
481
481
    some cases during rlogin sessions, it fails to detect this properly.
482
482
 
483
 
    You can permamently switch this feature off by disabling the "readline"
 
483
    You can permanently switch this feature off by disabling the "readline"
484
484
    extension:
485
485
 
486
486
       URxvt.perl-ext-common: default,-readline
488
488
   My numerical keypad acts weird and generates differing output?
489
489
    Some Debian GNUL/Linux users seem to have this problem, although no
490
490
    specific details were reported so far. It is possible that this is
491
 
    caused by the wrong "TERM" setting, although the details of wether and
 
491
    caused by the wrong "TERM" setting, although the details of whether and
492
492
    how this can happen are unknown, as "TERM=rxvt" should offer a
493
493
    compatible keymap. See the answer to the previous question, and please
494
494
    report if that helped.
519
519
    depressed.
520
520
 
521
521
   What's with the strange Backspace/Delete key behaviour?
522
 
    Assuming that the physical Backspace key corresponds to the BackSpace
 
522
    Assuming that the physical Backspace key corresponds to the Backspace
523
523
    keysym (not likely for Linux ... see the following question) there are
524
524
    two standard values that can be used for Backspace: "^H" and "^?".
525
525
 
651
651
    write.
652
652
 
653
653
    The selection stuff mainly makes the selection perl-error-message aware
654
 
    and tells it to convert pelr error mssages into vi-commands to load the
 
654
    and tells it to convert perl error messages into vi-commands to load the
655
655
    relevant file and go tot he error line number.
656
656
 
657
657
       URxvt.scrollstyle:      plain
658
658
       URxvt.secondaryScroll:  true
659
659
 
660
660
    As the documentation says: plain is the preferred scrollbar for the
661
 
    author. The "secondaryScroll" confgiures urxvt to scroll in full-screen
662
 
    apps, like screen, so lines scorlled out of screen end up in urxvt's
 
661
    author. The "secondaryScroll" configures urxvt to scroll in full-screen
 
662
    apps, like screen, so lines scrolled out of screen end up in urxvt's
663
663
    scrollback buffer.
664
664
 
665
665
       URxvt.background:       #000000
720
720
       urxvt.boldItalicFont:   xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
721
721
 
722
722
    I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
723
 
    overwhelmed. A special note: the "9x15bold" mentioend above is actually
 
723
    overwhelmed. A special note: the "9x15bold" mentioned above is actually
724
724
    the version from XFree-3.3, as XFree-4 replaced it by a totally
725
725
    different font (different glyphs for ";" and many other harmless
726
726
    characters), while the second font is actually the "9x15bold" from
727
727
    XFree4/XOrg. The bold version has less chars than the medium version, so
728
 
    I use it for rare characters, too. Whene ditign sources with vim, I use
 
728
    I use it for rare characters, too. When editing sources with vim, I use
729
729
    italic for comments and other stuff, which looks quite good with
730
730
    Bitstream Vera anti-aliased.
731
731
 
786
786
      URxvt.resource: value
787
787
 
788
788
    If you want to use another form (there are lots of different ways of
789
 
    specifying resources), make sure you understand wether and why it works.
790
 
    If unsure, use the form above.
 
789
    specifying resources), make sure you understand whether and why it
 
790
    works. If unsure, use the form above.
791
791
 
792
792
   When I log-in to another system it tells me about missing terminfo data?
793
793
    The terminal description used by rxvt-unicode is not as widely available
830
830
    library (Fedora Core's bash is one example) and rely on a termcap entry
831
831
    for "rxvt-unicode".
832
832
 
833
 
    You could use rxvt's termcap entry with resonable results in many cases.
834
 
    You can also create a termcap entry by using terminfo's infocmp program
835
 
    like this:
 
833
    You could use rxvt's termcap entry with reasonable results in many
 
834
    cases. You can also create a termcap entry by using terminfo's infocmp
 
835
    program like this:
836
836
 
837
837
       infocmp -C rxvt-unicode
838
838
 
861
861
 
862
862
   Why does "ls" no longer have coloured output?
863
863
    The "ls" in the GNU coreutils unfortunately doesn't use terminfo to
864
 
    decide wether a terminal has colour, but uses it's own configuration
865
 
    file. Needless to say, "rxvt-unicode" is not in it's default file (among
 
864
    decide whether a terminal has colour, but uses its own configuration
 
865
    file. Needless to say, "rxvt-unicode" is not in its default file (among
866
866
    with most other terminals supporting colour). Either add:
867
867
 
868
868
       TERM rxvt-unicode
908
908
    run into other problems. If nothing works you can try this in your
909
909
    .profile.
910
910
 
911
 
      printf '\e]701;%s\007' "$LC_CTYPE"
 
911
      printf '\33]701;%s\007' "$LC_CTYPE"
912
912
 
913
913
    If this doesn't work, then maybe you use a "LC_CTYPE" specification not
914
914
    supported on your systems. Some systems have a "locale" command which
937
937
    this to all applications so everybody agrees on character properties
938
938
    such as width and code number. This mechanism is the *locale*.
939
939
    Applications not using that info will have problems (for example,
940
 
    "xterm" gets the width of characters wrong as it uses it's own,
 
940
    "xterm" gets the width of characters wrong as it uses its own,
941
941
    locale-independent table under all locales).
942
942
 
943
943
    Rxvt-unicode uses the "LC_CTYPE" locale category to select encoding. All
964
964
    Yes, using an escape sequence. Try something like this, which sets
965
965
    rxvt-unicode's idea of "LC_CTYPE".
966
966
 
967
 
      printf '\e]701;%s\007' ja_JP.SJIS
 
967
      printf '\33]701;%s\007' ja_JP.SJIS
968
968
 
969
969
    See also the previous answer.
970
970
 
973
973
    UTF-8). For example, I use this script to start "xjdic", which first
974
974
    switches to a locale supported by xjdic and back later:
975
975
 
976
 
       printf '\e]701;%s\007' ja_JP.SJIS
 
976
       printf '\33]701;%s\007' ja_JP.SJIS
977
977
       xjdic -js
978
 
       printf '\e]701;%s\007' de_DE.UTF-8
 
978
       printf '\33]701;%s\007' de_DE.UTF-8
979
979
 
980
980
    You can also use xterm's "luit" program, which usually works fine,
981
981
    except for some locales where character width differs between program-
999
999
    - Make sure the "XMODIFIERS" environment variable is set correctly when
1000
1000
    *starting* rxvt-unicode.
1001
1001
        When you want to use e.g. kinput2, it must be set to "@im=kinput2".
1002
 
        For scim, use "@im=SCIM". Youc an see what input method servers are
 
1002
        For scim, use "@im=SCIM". You can see what input method servers are
1003
1003
        running with this command:
1004
1004
 
1005
1005
           xprop -root XIM_SERVERS
1006
1006
 
1007
 
    *
 
1007
 
1008
1008
 
1009
1009
   My input method wants <some encoding> but I want UTF-8, what can I do?
1010
1010
    You can specify separate locales for the input method and the rest of
1046
1046
   I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?
1047
1047
    You should build one binary with the default options. configure now
1048
1048
    enables most useful options, and the trend goes to making them
1049
 
    runtime-switchable, too, so there is usually no drawback to enbaling
 
1049
    runtime-switchable, too, so there is usually no drawback to enabling
1050
1050
    them, except higher disk and possibly memory usage. The perl interpreter
1051
1051
    should be enabled, as important functionality (menus, selection, likely
1052
1052
    more in the future) depends on it.
1088
1088
   I am on FreeBSD and rxvt-unicode does not seem to work at all.
1089
1089
    Rxvt-unicode requires the symbol "__STDC_ISO_10646__" to be defined in
1090
1090
    your compile environment, or an implementation that implements it,
1091
 
    wether it defines the symbol or not. "__STDC_ISO_10646__" requires that
 
1091
    whether it defines the symbol or not. "__STDC_ISO_10646__" requires that
1092
1092
    wchar_t is represented as unicode.
1093
1093
 
1094
 
    As you might have guessed, FreeBSD does neither define this symobl nor
1095
 
    does it support it. Instead, it uses it's own internal representation of
 
1094
    As you might have guessed, FreeBSD does neither define this symbol nor
 
1095
    does it support it. Instead, it uses its own internal representation of
1096
1096
    wchar_t. This is, of course, completely fine with respect to standards.
1097
1097
 
1098
1098
    However, that means rxvt-unicode only works in "POSIX", "ISO-8859-1" and
1261
1261
 
1262
1262
        Where "C" is one of:
1263
1263
 
1264
 
           C = 0           DEC Special Character and Line Drawing Set 
1265
 
           C = A           United Kingdom (UK) 
1266
 
           C = B           United States (USASCII) 
1267
 
           C = <           Multinational character set unimplemented 
1268
 
           C = 5           Finnish character set unimplemented 
1269
 
           C = C           Finnish character set unimplemented 
1270
 
           C = K           German character set unimplemented 
1271
 
 
 
1264
   C = 0           DEC Special Character and Line Drawing Set 
 
1265
   C = A           United Kingdom (UK) 
 
1266
   C = B           United States (USASCII) 
 
1267
   C = <           Multinational character set unimplemented 
 
1268
   C = 5           Finnish character set unimplemented 
 
1269
   C = C           Finnish character set unimplemented 
 
1270
   C = K           German character set unimplemented 
1272
1271
 
1273
1272
 
1274
1273
  CSI (Command Sequence Introducer) Sequences
1305
1304
    "ESC [ Ps J"
1306
1305
        Erase in Display (ED)
1307
1306
 
1308
 
           Ps = 0          Clear Below (default) 
1309
 
           Ps = 1          Clear Above     
1310
 
           Ps = 2          Clear All       
1311
 
 
 
1307
   Ps = 0          Clear Below (default) 
 
1308
   Ps = 1          Clear Above     
 
1309
   Ps = 2          Clear All       
1312
1310
    "ESC [ Ps K"
1313
1311
        Erase in Line (EL)
1314
1312
 
1315
 
           Ps = 0          Clear to Right (default) 
1316
 
           Ps = 1          Clear to Left   
1317
 
           Ps = 2          Clear All       
1318
 
 
 
1313
   Ps = 0          Clear to Right (default) 
 
1314
   Ps = 1          Clear to Left   
 
1315
   Ps = 2          Clear All       
1319
1316
    "ESC [ Ps L"
1320
1317
        Insert "Ps" Line(s) [default: 1] (IL)
1321
1318
 
1332
1329
    "ESC [ Ps W"
1333
1330
        Tabulator functions
1334
1331
 
1335
 
           Ps = 0          Tab Set (HTS)   
1336
 
           Ps = 2          Tab Clear (TBC), Clear Current Column (default) 
1337
 
           Ps = 5          Tab Clear (TBC), Clear All 
1338
 
 
 
1332
   Ps = 0          Tab Set (HTS)   
 
1333
   Ps = 2          Tab Clear (TBC), Clear Current Column (default) 
 
1334
   Ps = 5          Tab Clear (TBC), Clear All 
1339
1335
    "ESC [ Ps X"
1340
1336
        Erase "Ps" Character(s) [default: 1] (ECH)
1341
1337
 
1365
1361
    "ESC [ Ps g"
1366
1362
        Tab Clear (TBC)
1367
1363
 
1368
 
           Ps = 0          Clear Current Column (default) 
1369
 
           Ps = 3          Clear All (TBC) 
1370
 
 
 
1364
   Ps = 0          Clear Current Column (default) 
 
1365
   Ps = 3          Clear All (TBC) 
1371
1366
    "ESC [ Pm h"
1372
1367
        Set Mode (SM). See "ESC [ Pm l" sequence for description of "Pm".
1373
1368
 
1374
1369
    "ESC [ Ps i"
1375
1370
        Printing. See also the "print-pipe" resource.
1376
1371
 
1377
 
           Ps = 0          print screen (MC0) 
1378
 
           Ps = 4          disable transparent print mode (MC4) 
1379
 
           Ps = 5          enable transparent print mode (MC5) 
1380
 
 
 
1372
   Ps = 0          print screen (MC0) 
 
1373
   Ps = 4          disable transparent print mode (MC4) 
 
1374
   Ps = 5          enable transparent print mode (MC5) 
1381
1375
    "ESC [ Pm l"
1382
1376
        Reset Mode (RM)
1383
1377
 
 
1378
   h               Insert Mode (SMIR) 
 
1379
   l               Replace Mode (RMIR) 
1384
1380
        "Ps = 4"
1385
 
               h               Insert Mode (SMIR) 
1386
 
               l               Replace Mode (RMIR) 
1387
 
 
 
1381
   h               Automatic Newline (LNM) 
 
1382
   l               Normal Linefeed (LNM) 
1388
1383
        "Ps = 20" (partially implemented)
1389
 
               h               Automatic Newline (LNM) 
1390
 
               l               Normal Linefeed (LNM) 
1391
1384
 
1392
1385
    "ESC [ Pm m"
1393
1386
        Character Attributes (SGR)
1394
1387
 
1395
 
           Ps = 0          Normal (default) 
1396
 
           Ps = 1 / 21     On / Off Bold (bright fg) 
1397
 
           Ps = 3 / 23     On / Off Italic 
1398
 
           Ps = 4 / 24     On / Off Underline 
1399
 
           Ps = 5 / 25     On / Off Slow Blink (bright bg) 
1400
 
           Ps = 6 / 26     On / Off Rapid Blink (bright bg) 
1401
 
           Ps = 7 / 27     On / Off Inverse 
1402
 
           Ps = 8 / 27     On / Off Invisible (NYI) 
1403
 
           Ps = 30 / 40    fg/bg Black     
1404
 
           Ps = 31 / 41    fg/bg Red       
1405
 
           Ps = 32 / 42    fg/bg Green     
1406
 
           Ps = 33 / 43    fg/bg Yellow    
1407
 
           Ps = 34 / 44    fg/bg Blue      
1408
 
           Ps = 35 / 45    fg/bg Magenta   
1409
 
           Ps = 36 / 46    fg/bg Cyan      
1410
 
           Ps = 38;5 / 48;5 set fg/bg to color #m (ISO 8613-6) 
1411
 
           Ps = 37 / 47    fg/bg White     
1412
 
           Ps = 39 / 49    fg/bg Default   
1413
 
           Ps = 90 / 100   fg/bg Bright Black 
1414
 
           Ps = 91 / 101   fg/bg Bright Red 
1415
 
           Ps = 92 / 102   fg/bg Bright Green 
1416
 
           Ps = 93 / 103   fg/bg Bright Yellow 
1417
 
           Ps = 94 / 104   fg/bg Bright Blue 
1418
 
           Ps = 95 / 105   fg/bg Bright Magenta 
1419
 
           Ps = 96 / 106   fg/bg Bright Cyan 
1420
 
           Ps = 97 / 107   fg/bg Bright White 
1421
 
           Ps = 99 / 109   fg/bg Bright Default 
1422
 
 
 
1388
   Ps = 0          Normal (default) 
 
1389
   Ps = 1 / 21     On / Off Bold (bright fg) 
 
1390
   Ps = 3 / 23     On / Off Italic 
 
1391
   Ps = 4 / 24     On / Off Underline 
 
1392
   Ps = 5 / 25     On / Off Slow Blink (bright bg) 
 
1393
   Ps = 6 / 26     On / Off Rapid Blink (bright bg) 
 
1394
   Ps = 7 / 27     On / Off Inverse 
 
1395
   Ps = 8 / 27     On / Off Invisible (NYI) 
 
1396
   Ps = 30 / 40    fg/bg Black     
 
1397
   Ps = 31 / 41    fg/bg Red       
 
1398
   Ps = 32 / 42    fg/bg Green     
 
1399
   Ps = 33 / 43    fg/bg Yellow    
 
1400
   Ps = 34 / 44    fg/bg Blue      
 
1401
   Ps = 35 / 45    fg/bg Magenta   
 
1402
   Ps = 36 / 46    fg/bg Cyan      
 
1403
   Ps = 38;5 / 48;5 set fg/bg to color #m (ISO 8613-6) 
 
1404
   Ps = 37 / 47    fg/bg White     
 
1405
   Ps = 39 / 49    fg/bg Default   
 
1406
   Ps = 90 / 100   fg/bg Bright Black 
 
1407
   Ps = 91 / 101   fg/bg Bright Red 
 
1408
   Ps = 92 / 102   fg/bg Bright Green 
 
1409
   Ps = 93 / 103   fg/bg Bright Yellow 
 
1410
   Ps = 94 / 104   fg/bg Bright Blue 
 
1411
   Ps = 95 / 105   fg/bg Bright Magenta 
 
1412
   Ps = 96 / 106   fg/bg Bright Cyan 
 
1413
   Ps = 97 / 107   fg/bg Bright White 
 
1414
   Ps = 99 / 109   fg/bg Bright Default 
1423
1415
    "ESC [ Ps n"
1424
1416
        Device Status Report (DSR)
1425
1417
 
1426
 
           Ps = 5          Status Report ESC [ 0 n (``OK'') 
1427
 
           Ps = 6          Report Cursor Position (CPR) [row;column] as ESC [ r ; c R 
1428
 
           Ps = 7          Request Display Name 
1429
 
           Ps = 8          Request Version Number (place in window title) 
1430
 
 
 
1418
   Ps = 5          Status Report ESC [ 0 n (``OK'') 
 
1419
   Ps = 6          Report Cursor Position (CPR) [row;column] as ESC [ r ; c R 
 
1420
   Ps = 7          Request Display Name 
 
1421
   Ps = 8          Request Version Number (place in window title) 
1431
1422
    "ESC [ Ps;Ps r"
1432
1423
        Set Scrolling Region [top;bottom] [default: full size of window]
1433
1424
        (CSR)
1438
1429
    "ESC [ Ps;Pt t"
1439
1430
        Window Operations
1440
1431
 
1441
 
           Ps = 1          Deiconify (map) window 
1442
 
           Ps = 2          Iconify window  
1443
 
           Ps = 3          ESC [ 3 ; X ; Y t Move window to (X|Y) 
1444
 
           Ps = 4          ESC [ 4 ; H ; W t Resize to WxH pixels 
1445
 
           Ps = 5          Raise window    
1446
 
           Ps = 6          Lower window    
1447
 
           Ps = 7          Refresh screen once 
1448
 
           Ps = 8          ESC [ 8 ; R ; C t Resize to R rows and C columns 
1449
 
           Ps = 11         Report window state (responds with Ps = 1 or Ps = 2) 
1450
 
           Ps = 13         Report window position (responds with Ps = 3) 
1451
 
           Ps = 14         Report window pixel size (responds with Ps = 4) 
1452
 
           Ps = 18         Report window text size (responds with Ps = 7) 
1453
 
           Ps = 19         Currently the same as Ps = 18, but responds with Ps = 9 
1454
 
           Ps = 20         Reports icon label (ESC ] L NAME \234) 
1455
 
           Ps = 21         Reports window title (ESC ] l NAME \234) 
1456
 
           Ps = 24..       Set window height to Ps rows 
1457
 
 
 
1432
   Ps = 1          Deiconify (map) window 
 
1433
   Ps = 2          Iconify window  
 
1434
   Ps = 3          ESC [ 3 ; X ; Y t Move window to (X|Y) 
 
1435
   Ps = 4          ESC [ 4 ; H ; W t Resize to WxH pixels 
 
1436
   Ps = 5          Raise window    
 
1437
   Ps = 6          Lower window    
 
1438
   Ps = 7          Refresh screen once 
 
1439
   Ps = 8          ESC [ 8 ; R ; C t Resize to R rows and C columns 
 
1440
   Ps = 11         Report window state (responds with Ps = 1 or Ps = 2) 
 
1441
   Ps = 13         Report window position (responds with Ps = 3) 
 
1442
   Ps = 14         Report window pixel size (responds with Ps = 4) 
 
1443
   Ps = 18         Report window text size (responds with Ps = 7) 
 
1444
   Ps = 19         Currently the same as Ps = 18, but responds with Ps = 9 
 
1445
   Ps = 20         Reports icon label (ESC ] L NAME \234) 
 
1446
   Ps = 21         Reports window title (ESC ] l NAME \234) 
 
1447
   Ps = 24..       Set window height to Ps rows 
1458
1448
    "ESC [ u"
1459
1449
        Restore Cursor
1460
1450
 
1479
1469
    "ESC [ ? Pm t"
1480
1470
        Toggle DEC Private Mode Values (rxvt extension). *where*
1481
1471
 
1482
 
        "Ps = 1" (DECCKM)
1483
 
               h               Application Cursor Keys 
1484
 
               l               Normal Cursor Keys 
1485
 
 
1486
 
        "Ps = 2" (ANSI/VT52 mode)
1487
 
               h               Enter VT52 mode 
1488
 
               l               Enter VT52 mode 
1489
 
 
1490
 
        "Ps = 3"
1491
 
               h               132 Column Mode (DECCOLM) 
1492
 
               l               80 Column Mode (DECCOLM) 
1493
 
 
1494
 
        "Ps = 4"
1495
 
               h               Smooth (Slow) Scroll (DECSCLM) 
1496
 
               l               Jump (Fast) Scroll (DECSCLM) 
1497
 
 
1498
 
        "Ps = 5"
1499
 
               h               Reverse Video (DECSCNM) 
1500
 
               l               Normal Video (DECSCNM) 
1501
 
 
1502
 
        "Ps = 6"
1503
 
               h               Origin Mode (DECOM) 
1504
 
               l               Normal Cursor Mode (DECOM) 
1505
 
 
1506
 
        "Ps = 7"
1507
 
               h               Wraparound Mode (DECAWM) 
1508
 
               l               No Wraparound Mode (DECAWM) 
1509
 
 
1510
 
        "Ps = 8" *unimplemented*
1511
 
               h               Auto-repeat Keys (DECARM) 
1512
 
               l               No Auto-repeat Keys (DECARM) 
1513
 
 
1514
 
        "Ps = 9" X10 XTerm
1515
 
               h               Send Mouse X & Y on button press. 
1516
 
               l               No mouse reporting. 
1517
 
 
1518
 
        "Ps = 25"
1519
 
               h               Visible cursor {cnorm/cvvis} 
1520
 
               l               Invisible cursor {civis} 
1521
 
 
1522
 
        "Ps = 30"
1523
 
               h               scrollBar visisble 
1524
 
               l               scrollBar invisisble 
1525
 
 
1526
 
        "Ps = 35" (rxvt)
1527
 
               h               Allow XTerm Shift+key sequences 
1528
 
               l               Disallow XTerm Shift+key sequences 
1529
 
 
1530
 
        "Ps = 38" *unimplemented*
 
1472
   h               Application Cursor Keys 
 
1473
   l               Normal Cursor Keys 
 
1474
        "Pm = 1" (DECCKM)
 
1475
   h               Enter VT52 mode 
 
1476
   l               Enter VT52 mode 
 
1477
        "Pm = 2" (ANSI/VT52 mode)
 
1478
   h               132 Column Mode (DECCOLM) 
 
1479
   l               80 Column Mode (DECCOLM) 
 
1480
        "Pm = 3"
 
1481
   h               Smooth (Slow) Scroll (DECSCLM) 
 
1482
   l               Jump (Fast) Scroll (DECSCLM) 
 
1483
        "Pm = 4"
 
1484
   h               Reverse Video (DECSCNM) 
 
1485
   l               Normal Video (DECSCNM) 
 
1486
        "Pm = 5"
 
1487
   h               Origin Mode (DECOM) 
 
1488
   l               Normal Cursor Mode (DECOM) 
 
1489
        "Pm = 6"
 
1490
   h               Wraparound Mode (DECAWM) 
 
1491
   l               No Wraparound Mode (DECAWM) 
 
1492
        "Pm = 7"
 
1493
   h               Auto-repeat Keys (DECARM) 
 
1494
   l               No Auto-repeat Keys (DECARM) 
 
1495
        "Pm = 8" *unimplemented*
 
1496
   h               Send Mouse X & Y on button press. 
 
1497
   l               No mouse reporting. 
 
1498
        "Pm = 9" X10 XTerm
 
1499
   h               Visible cursor {cnorm/cvvis} 
 
1500
   l               Invisible cursor {civis} 
 
1501
        "Pm = 25"
 
1502
   h               scrollBar visisble 
 
1503
   l               scrollBar invisisble 
 
1504
        "Pm = 30"
 
1505
   h               Allow XTerm Shift+key sequences 
 
1506
   l               Disallow XTerm Shift+key sequences 
 
1507
        "Pm = 35" (rxvt)
 
1508
        "Pm = 38" *unimplemented*
1531
1509
            Enter Tektronix Mode (DECTEK)
1532
1510
 
1533
 
        "Ps = 40"
1534
 
               h               Allow 80/132 Mode 
1535
 
               l               Disallow 80/132 Mode 
1536
 
 
1537
 
        "Ps = 44" *unimplemented*
1538
 
               h               Turn On Margin Bell 
1539
 
               l               Turn Off Margin Bell 
1540
 
 
1541
 
        "Ps = 45" *unimplemented*
1542
 
               h               Reverse-wraparound Mode 
1543
 
               l               No Reverse-wraparound Mode 
1544
 
 
1545
 
        "Ps = 46" *unimplemented*
1546
 
        "Ps = 47"
1547
 
               h               Use Alternate Screen Buffer 
1548
 
               l               Use Normal Screen Buffer 
1549
 
 
1550
 
 
1551
 
 
1552
 
        "Ps = 66"
1553
 
               h               Application Keypad (DECPAM) == ESC = 
1554
 
               l               Normal Keypad (DECPNM) == ESC > 
1555
 
 
1556
 
        "Ps = 67"
1557
 
               h               Backspace key sends BS (DECBKM) 
1558
 
               l               Backspace key sends DEL 
1559
 
 
1560
 
        "Ps = 1000" (X11 XTerm)
1561
 
               h               Send Mouse X & Y on button press and release. 
1562
 
               l               No mouse reporting. 
1563
 
 
1564
 
        "Ps = 1001" (X11 XTerm) *unimplemented*
1565
 
               h               Use Hilite Mouse Tracking. 
1566
 
               l               No mouse reporting. 
1567
 
 
1568
 
        "Ps = 1010" (rxvt)
1569
 
               h               Don't scroll to bottom on TTY output 
1570
 
               l               Scroll to bottom on TTY output 
1571
 
 
1572
 
        "Ps = 1011" (rxvt)
1573
 
               h               Scroll to bottom when a key is pressed 
1574
 
               l               Don't scroll to bottom when a key is pressed 
1575
 
 
1576
 
        "Ps = 1021" (rxvt)
1577
 
               h               Bold/italic implies high intensity (see option -is) 
1578
 
               l               Font styles have no effect on intensity (Compile styles) 
1579
 
 
1580
 
        "Ps = 1047"
1581
 
               h               Use Alternate Screen Buffer 
1582
 
               l               Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it 
1583
 
 
1584
 
        "Ps = 1048"
1585
 
               h               Save cursor position 
1586
 
               l               Restore cursor position 
1587
 
 
1588
 
        "Ps = 1049"
1589
 
               h               Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it 
1590
 
               l               Use Normal Screen Buffer 
 
1511
   h               Allow 80/132 Mode 
 
1512
   l               Disallow 80/132 Mode 
 
1513
        "Pm = 40"
 
1514
   h               Turn On Margin Bell 
 
1515
   l               Turn Off Margin Bell 
 
1516
        "Pm = 44" *unimplemented*
 
1517
   h               Reverse-wraparound Mode 
 
1518
   l               No Reverse-wraparound Mode 
 
1519
        "Pm = 45" *unimplemented*
 
1520
        "Pm = 46" *unimplemented*
 
1521
   h               Use Alternate Screen Buffer 
 
1522
   l               Use Normal Screen Buffer 
 
1523
        "Pm = 47"
 
1524
 
 
1525
   h               Application Keypad (DECPAM) == ESC = 
 
1526
   l               Normal Keypad (DECPNM) == ESC > 
 
1527
        "Pm = 66"
 
1528
   h               Backspace key sends BS (DECBKM) 
 
1529
   l               Backspace key sends DEL 
 
1530
        "Pm = 67"
 
1531
   h               Send Mouse X & Y on button press and release. 
 
1532
   l               No mouse reporting. 
 
1533
        "Pm = 1000" (X11 XTerm)
 
1534
   h               Use Hilite Mouse Tracking. 
 
1535
   l               No mouse reporting. 
 
1536
        "Pm = 1001" (X11 XTerm) *unimplemented*
 
1537
   h               Don't scroll to bottom on TTY output 
 
1538
   l               Scroll to bottom on TTY output 
 
1539
        "Pm = 1010" (rxvt)
 
1540
   h               Scroll to bottom when a key is pressed 
 
1541
   l               Don't scroll to bottom when a key is pressed 
 
1542
        "Pm = 1011" (rxvt)
 
1543
   h               Bold/italic implies high intensity (see option -is) 
 
1544
   l               Font styles have no effect on intensity (Compile styles) 
 
1545
        "Pm = 1021" (rxvt)
 
1546
   h               Use Alternate Screen Buffer 
 
1547
   l               Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it 
 
1548
        "Pm = 1047"
 
1549
   h               Save cursor position 
 
1550
   l               Restore cursor position 
 
1551
        "Pm = 1048"
 
1552
   h               Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it 
 
1553
   l               Use Normal Screen Buffer 
 
1554
        "Pm = 1049"
1591
1555
 
1592
1556
 
1593
1557
 
1598
1562
        accepted. any octet can be escaped by prefixing it with SYN (0x16,
1599
1563
        ^V).
1600
1564
 
1601
 
           Ps = 0          Change Icon Name and Window Title to Pt 
1602
 
           Ps = 1          Change Icon Name to Pt 
1603
 
           Ps = 2          Change Window Title to Pt 
1604
 
           Ps = 3          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. 
1605
 
           Ps = 4          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 
1606
 
           Ps = 10         Change colour of text foreground to Pt (NB: may change in future) 
1607
 
           Ps = 11         Change colour of text background to Pt (NB: may change in future) 
1608
 
           Ps = 12         Change colour of text cursor foreground to Pt 
1609
 
           Ps = 13         Change colour of mouse foreground to Pt 
1610
 
           Ps = 17         Change colour of highlight characters to Pt 
1611
 
           Ps = 18         Change colour of bold characters to Pt [deprecated, see 706] 
1612
 
           Ps = 19         Change colour of underlined characters to Pt [deprecated, see 707] 
1613
 
           Ps = 20         Change background pixmap parameters (see section XPM) (Compile XPM). 
1614
 
           Ps = 39         Change default foreground colour to Pt. 
1615
 
           Ps = 46         Change Log File to Pt unimplemented 
1616
 
           Ps = 49         Change default background colour to Pt. 
1617
 
           Ps = 50         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 
1618
 
           Ps = 55         Log all scrollback buffer and all of screen to Pt 
1619
 
           Ps = 701        Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). 
1620
 
           Ps = 702        Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST. 
1621
 
           Ps = 704        Change colour of italic characters to Pt 
1622
 
           Ps = 705        Change background pixmap tint colour to Pt (Compile transparency). 
1623
 
           Ps = 706        Change colour of bold characters to Pt 
1624
 
           Ps = 707        Change colour of underlined characters to Pt 
1625
 
           Ps = 710        Set normal fontset to Pt. Same as Ps = 50. 
1626
 
           Ps = 711        Set bold fontset to Pt. Similar to Ps = 50 (Compile styles). 
1627
 
           Ps = 712        Set italic fontset to Pt. Similar to Ps = 50 (Compile styles). 
1628
 
           Ps = 713        Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles). 
1629
 
           Ps = 720        Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 
1630
 
           Ps = 721        Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 
1631
 
           Ps = 777        Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). 
1632
 
 
 
1565
   Ps = 0          Change Icon Name and Window Title to Pt 
 
1566
   Ps = 1          Change Icon Name to Pt 
 
1567
   Ps = 2          Change Window Title to Pt 
 
1568
   Ps = 3          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. 
 
1569
   Ps = 4          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 
 
1570
   Ps = 10         Change colour of text foreground to Pt (NB: may change in future) 
 
1571
   Ps = 11         Change colour of text background to Pt (NB: may change in future) 
 
1572
   Ps = 12         Change colour of text cursor foreground to Pt 
 
1573
   Ps = 13         Change colour of mouse foreground to Pt 
 
1574
   Ps = 17         Change colour of highlight characters to Pt 
 
1575
   Ps = 18         Change colour of bold characters to Pt [deprecated, see 706] 
 
1576
   Ps = 19         Change colour of underlined characters to Pt [deprecated, see 707] 
 
1577
   Ps = 20         Change background pixmap parameters (see section XPM) (Compile XPM). 
 
1578
   Ps = 39         Change default foreground colour to Pt. 
 
1579
   Ps = 46         Change Log File to Pt unimplemented 
 
1580
   Ps = 49         Change default background colour to Pt. 
 
1581
   Ps = 50         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 
 
1582
   Ps = 55         Log all scrollback buffer and all of screen to Pt 
 
1583
   Ps = 701        Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). 
 
1584
   Ps = 702        Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST. 
 
1585
   Ps = 704        Change colour of italic characters to Pt 
 
1586
   Ps = 705        Change background pixmap tint colour to Pt (Compile transparency). 
 
1587
   Ps = 706        Change colour of bold characters to Pt 
 
1588
   Ps = 707        Change colour of underlined characters to Pt 
 
1589
   Ps = 710        Set normal fontset to Pt. Same as Ps = 50. 
 
1590
   Ps = 711        Set bold fontset to Pt. Similar to Ps = 50 (Compile styles). 
 
1591
   Ps = 712        Set italic fontset to Pt. Similar to Ps = 50 (Compile styles). 
 
1592
   Ps = 713        Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles). 
 
1593
   Ps = 720        Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 
 
1594
   Ps = 721        Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). 
 
1595
   Ps = 777        Call the perl extension with the given string, which should be of the form extension:parameters (Compile perl). 
1633
1596
XPM
1634
1597
    For the XPM XTerm escape sequence "ESC ] 20 ; Pt ST" then value of "Pt"
1635
1598
    can be the name of the background pixmap followed by a sequence of
1685
1648
 
1686
1649
    The lower 2 bits of "<b>" indicate the button:
1687
1650
 
 
1651
   0               Button1 pressed 
 
1652
   1               Button2 pressed 
 
1653
   2               Button3 pressed 
 
1654
   3               button released (X11 mouse report) 
1688
1655
    Button = "(<b> - SPACE) & 3"
1689
 
           0               Button1 pressed 
1690
 
           1               Button2 pressed 
1691
 
           2               Button3 pressed 
1692
 
           3               button released (X11 mouse report) 
1693
1656
 
1694
1657
    The upper bits of "<b>" indicate the modifiers when the button was
1695
1658
    pressed and are added together (X11 mouse report only):
1696
1659
 
 
1660
   4               Shift           
 
1661
   8               Meta            
 
1662
   16              Control         
 
1663
   32              Double Click (rxvt extension) 
1697
1664
    State = "(<b> - SPACE) & 60"
1698
 
           4               Shift           
1699
 
           8               Meta            
1700
 
           16              Control         
1701
 
           32              Double Click (rxvt extension) 
1702
 
 
1703
1665
        Col = "<x> - SPACE"
1704
1666
 
1705
1667
        Row = "<y> - SPACE"
1712
1674
    off, toggle Application-Keypad setting. Also note that values of Home,
1713
1675
    End, Delete may have been compiled differently on your system.
1714
1676
 
1715
 
                       Normal          Shift           Control         Ctrl+Shift      
1716
 
       Tab             ^I              ESC [ Z         ^I              ESC [ Z         
1717
 
       BackSpace       ^H              ^?              ^?              ^?              
1718
 
       Find            ESC [ 1 ~       ESC [ 1 $       ESC [ 1 ^       ESC [ 1 @       
1719
 
       Insert          ESC [ 2 ~       paste           ESC [ 2 ^       ESC [ 2 @       
1720
 
       Execute         ESC [ 3 ~       ESC [ 3 $       ESC [ 3 ^       ESC [ 3 @       
1721
 
       Select          ESC [ 4 ~       ESC [ 4 $       ESC [ 4 ^       ESC [ 4 @       
1722
 
       Prior           ESC [ 5 ~       scroll-up       ESC [ 5 ^       ESC [ 5 @       
1723
 
       Next            ESC [ 6 ~       scroll-down     ESC [ 6 ^       ESC [ 6 @       
1724
 
       Home            ESC [ 7 ~       ESC [ 7 $       ESC [ 7 ^       ESC [ 7 @       
1725
 
       End             ESC [ 8 ~       ESC [ 8 $       ESC [ 8 ^       ESC [ 8 @       
1726
 
       Delete          ESC [ 3 ~       ESC [ 3 $       ESC [ 3 ^       ESC [ 3 @       
1727
 
       F1              ESC [ 11 ~      ESC [ 23 ~      ESC [ 11 ^      ESC [ 23 ^      
1728
 
       F2              ESC [ 12 ~      ESC [ 24 ~      ESC [ 12 ^      ESC [ 24 ^      
1729
 
       F3              ESC [ 13 ~      ESC [ 25 ~      ESC [ 13 ^      ESC [ 25 ^      
1730
 
       F4              ESC [ 14 ~      ESC [ 26 ~      ESC [ 14 ^      ESC [ 26 ^      
1731
 
       F5              ESC [ 15 ~      ESC [ 28 ~      ESC [ 15 ^      ESC [ 28 ^      
1732
 
       F6              ESC [ 17 ~      ESC [ 29 ~      ESC [ 17 ^      ESC [ 29 ^      
1733
 
       F7              ESC [ 18 ~      ESC [ 31 ~      ESC [ 18 ^      ESC [ 31 ^      
1734
 
       F8              ESC [ 19 ~      ESC [ 32 ~      ESC [ 19 ^      ESC [ 32 ^      
1735
 
       F9              ESC [ 20 ~      ESC [ 33 ~      ESC [ 20 ^      ESC [ 33 ^      
1736
 
       F10             ESC [ 21 ~      ESC [ 34 ~      ESC [ 21 ^      ESC [ 34 ^      
1737
 
       F11             ESC [ 23 ~      ESC [ 23 $      ESC [ 23 ^      ESC [ 23 @      
1738
 
       F12             ESC [ 24 ~      ESC [ 24 $      ESC [ 24 ^      ESC [ 24 @      
1739
 
       F13             ESC [ 25 ~      ESC [ 25 $      ESC [ 25 ^      ESC [ 25 @      
1740
 
       F14             ESC [ 26 ~      ESC [ 26 $      ESC [ 26 ^      ESC [ 26 @      
1741
 
       F15 (Help)      ESC [ 28 ~      ESC [ 28 $      ESC [ 28 ^      ESC [ 28 @      
1742
 
       F16 (Menu)      ESC [ 29 ~      ESC [ 29 $      ESC [ 29 ^      ESC [ 29 @      
1743
 
       F17             ESC [ 31 ~      ESC [ 31 $      ESC [ 31 ^      ESC [ 31 @      
1744
 
       F18             ESC [ 32 ~      ESC [ 32 $      ESC [ 32 ^      ESC [ 32 @      
1745
 
       F19             ESC [ 33 ~      ESC [ 33 $      ESC [ 33 ^      ESC [ 33 @      
1746
 
       F20             ESC [ 34 ~      ESC [ 34 $      ESC [ 34 ^      ESC [ 34 @      
1747
 
                                                                       Application     
1748
 
       Up              ESC [ A         ESC [ a         ESC O a         ESC O A         
1749
 
       Down            ESC [ B         ESC [ b         ESC O b         ESC O B         
1750
 
       Right           ESC [ C         ESC [ c         ESC O c         ESC O C         
1751
 
       Left            ESC [ D         ESC [ d         ESC O d         ESC O D         
1752
 
       KP_Enter        ^M                                              ESC O M         
1753
 
       KP_F1           ESC O P                                         ESC O P         
1754
 
       KP_F2           ESC O Q                                         ESC O Q         
1755
 
       KP_F3           ESC O R                                         ESC O R         
1756
 
       KP_F4           ESC O S                                         ESC O S         
1757
 
       XK_KP_Multiply  *                                               ESC O j         
1758
 
       XK_KP_Add       +                                               ESC O k         
1759
 
       XK_KP_Separator ,                                               ESC O l         
1760
 
       XK_KP_Subtract  -                                               ESC O m         
1761
 
       XK_KP_Decimal   .                                               ESC O n         
1762
 
       XK_KP_Divide    /                                               ESC O o         
1763
 
       XK_KP_0         0                                               ESC O p         
1764
 
       XK_KP_1         1                                               ESC O q         
1765
 
       XK_KP_2         2                                               ESC O r         
1766
 
       XK_KP_3         3                                               ESC O s         
1767
 
       XK_KP_4         4                                               ESC O t         
1768
 
       XK_KP_5         5                                               ESC O u         
1769
 
       XK_KP_6         6                                               ESC O v         
1770
 
       XK_KP_7         7                                               ESC O w         
1771
 
       XK_KP_8         8                                               ESC O x         
1772
 
       XK_KP_9         9                                               ESC O y         
1773
 
 
 
1677
                   Normal          Shift           Control         Ctrl+Shift      
 
1678
   Tab             ^I              ESC [ Z         ^I              ESC [ Z         
 
1679
   BackSpace       ^H              ^?              ^?              ^?              
 
1680
   Find            ESC [ 1 ~       ESC [ 1 $       ESC [ 1 ^       ESC [ 1 @       
 
1681
   Insert          ESC [ 2 ~       paste           ESC [ 2 ^       ESC [ 2 @       
 
1682
   Execute         ESC [ 3 ~       ESC [ 3 $       ESC [ 3 ^       ESC [ 3 @       
 
1683
   Select          ESC [ 4 ~       ESC [ 4 $       ESC [ 4 ^       ESC [ 4 @       
 
1684
   Prior           ESC [ 5 ~       scroll-up       ESC [ 5 ^       ESC [ 5 @       
 
1685
   Next            ESC [ 6 ~       scroll-down     ESC [ 6 ^       ESC [ 6 @       
 
1686
   Home            ESC [ 7 ~       ESC [ 7 $       ESC [ 7 ^       ESC [ 7 @       
 
1687
   End             ESC [ 8 ~       ESC [ 8 $       ESC [ 8 ^       ESC [ 8 @       
 
1688
   Delete          ESC [ 3 ~       ESC [ 3 $       ESC [ 3 ^       ESC [ 3 @       
 
1689
   F1              ESC [ 11 ~      ESC [ 23 ~      ESC [ 11 ^      ESC [ 23 ^      
 
1690
   F2              ESC [ 12 ~      ESC [ 24 ~      ESC [ 12 ^      ESC [ 24 ^      
 
1691
   F3              ESC [ 13 ~      ESC [ 25 ~      ESC [ 13 ^      ESC [ 25 ^      
 
1692
   F4              ESC [ 14 ~      ESC [ 26 ~      ESC [ 14 ^      ESC [ 26 ^      
 
1693
   F5              ESC [ 15 ~      ESC [ 28 ~      ESC [ 15 ^      ESC [ 28 ^      
 
1694
   F6              ESC [ 17 ~      ESC [ 29 ~      ESC [ 17 ^      ESC [ 29 ^      
 
1695
   F7              ESC [ 18 ~      ESC [ 31 ~      ESC [ 18 ^      ESC [ 31 ^      
 
1696
   F8              ESC [ 19 ~      ESC [ 32 ~      ESC [ 19 ^      ESC [ 32 ^      
 
1697
   F9              ESC [ 20 ~      ESC [ 33 ~      ESC [ 20 ^      ESC [ 33 ^      
 
1698
   F10             ESC [ 21 ~      ESC [ 34 ~      ESC [ 21 ^      ESC [ 34 ^      
 
1699
   F11             ESC [ 23 ~      ESC [ 23 $      ESC [ 23 ^      ESC [ 23 @      
 
1700
   F12             ESC [ 24 ~      ESC [ 24 $      ESC [ 24 ^      ESC [ 24 @      
 
1701
   F13             ESC [ 25 ~      ESC [ 25 $      ESC [ 25 ^      ESC [ 25 @      
 
1702
   F14             ESC [ 26 ~      ESC [ 26 $      ESC [ 26 ^      ESC [ 26 @      
 
1703
   F15 (Help)      ESC [ 28 ~      ESC [ 28 $      ESC [ 28 ^      ESC [ 28 @      
 
1704
   F16 (Menu)      ESC [ 29 ~      ESC [ 29 $      ESC [ 29 ^      ESC [ 29 @      
 
1705
   F17             ESC [ 31 ~      ESC [ 31 $      ESC [ 31 ^      ESC [ 31 @      
 
1706
   F18             ESC [ 32 ~      ESC [ 32 $      ESC [ 32 ^      ESC [ 32 @      
 
1707
   F19             ESC [ 33 ~      ESC [ 33 $      ESC [ 33 ^      ESC [ 33 @      
 
1708
   F20             ESC [ 34 ~      ESC [ 34 $      ESC [ 34 ^      ESC [ 34 @      
 
1709
                                                                   Application     
 
1710
   Up              ESC [ A         ESC [ a         ESC O a         ESC O A         
 
1711
   Down            ESC [ B         ESC [ b         ESC O b         ESC O B         
 
1712
   Right           ESC [ C         ESC [ c         ESC O c         ESC O C         
 
1713
   Left            ESC [ D         ESC [ d         ESC O d         ESC O D         
 
1714
   KP_Enter        ^M                                              ESC O M         
 
1715
   KP_F1           ESC O P                                         ESC O P         
 
1716
   KP_F2           ESC O Q                                         ESC O Q         
 
1717
   KP_F3           ESC O R                                         ESC O R         
 
1718
   KP_F4           ESC O S                                         ESC O S         
 
1719
   XK_KP_Multiply  *                                               ESC O j         
 
1720
   XK_KP_Add       +                                               ESC O k         
 
1721
   XK_KP_Separator ,                                               ESC O l         
 
1722
   XK_KP_Subtract  -                                               ESC O m         
 
1723
   XK_KP_Decimal   .                                               ESC O n         
 
1724
   XK_KP_Divide    /                                               ESC O o         
 
1725
   XK_KP_0         0                                               ESC O p         
 
1726
   XK_KP_1         1                                               ESC O q         
 
1727
   XK_KP_2         2                                               ESC O r         
 
1728
   XK_KP_3         3                                               ESC O s         
 
1729
   XK_KP_4         4                                               ESC O t         
 
1730
   XK_KP_5         5                                               ESC O u         
 
1731
   XK_KP_6         6                                               ESC O v         
 
1732
   XK_KP_7         7                                               ESC O w         
 
1733
   XK_KP_8         8                                               ESC O x         
 
1734
   XK_KP_9         9                                               ESC O y         
1774
1735
CONFIGURE OPTIONS
1775
1736
    General hint: if you get compile errors, then likely your configuration
1776
1737
    hasn't been tested well. Either try with "--enable-everything" or use
1810
1771
        about 700kB), but it doesn't increase memory usage unless you use a
1811
1772
        font requiring one of these encodings.
1812
1773
 
1813
 
           all             all available codeset groups 
1814
 
           zh              common chinese encodings 
1815
 
           zh_ext          rarely used but very big chinese encodigs 
1816
 
           jp              common japanese encodings 
1817
 
           jp_ext          rarely used but big japanese encodings 
1818
 
           kr              korean encodings 
1819
 
 
 
1774
   all             all available codeset groups 
 
1775
   zh              common chinese encodings 
 
1776
   zh_ext          rarely used but very big chinese encodigs 
 
1777
   jp              common japanese encodings 
 
1778
   jp_ext          rarely used but big japanese encodings 
 
1779
   kr              korean encodings 
1820
1780
    --enable-xim (default: on)
1821
1781
        Add support for XIM (X Input Method) protocol. This allows using
1822
1782
        alternative input methods (e.g. kinput2) and will also correctly set
1950
1910
          user-pty (-pty-fd)
1951
1911
          hold on exit (-hold)
1952
1912
          skip builtin block graphics (-sbg)
 
1913
          separate highlightcolor support (-hc)
1953
1914
 
1954
 
        It also enabled some non-essential features otherwise disabled, such
 
1915
        It also enables some non-essential features otherwise disabled, such
1955
1916
        as:
1956
1917
 
1957
1918
          some round-trip time optimisations
2043
2004
    Geoff Wing <gcw@pobox.com>, who in turn used the XTerm documentation and
2044
2005
    other sources.
2045
2006
 
 
2007
POD ERRORS
 
2008
    Hey! The above document had some coding errors, which are explained
 
2009
    below:
 
2010
 
 
2011
    Around line 2952:
 
2012
        =back doesn't take any parameters, but you said =back X<Mouse>
 
2013
 
 
2014
    Around line 3048:
 
2015
        =back doesn't take any parameters, but you said =back X<KeyCodes>
 
2016