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

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.69 by root, Tue Jan 31 21:10:44 2006 UTC vs.
Revision 1.80 by root, Thu Nov 2 17:37:47 2006 UTC

1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 1.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
2.\" 2.\"
3.\" Standard preamble: 3.\" Standard preamble:
4.\" ======================================================================== 4.\" ========================================================================
5.de Sh \" Subsection heading 5.de Sh \" Subsection heading
6.br 6.br
… …
126. ds Ae AE 126. ds Ae AE
127.\} 127.\}
128.rm #[ #] #H #V #F C 128.rm #[ #] #H #V #F C
129.\" ======================================================================== 129.\" ========================================================================
130.\" 130.\"
131.IX Title "rxvt 7" 131.IX Title "@@RXVT_NAME@@ 7"
132.TH rxvt 7 "2006-01-31" "7.5" "RXVT-UNICODE" 132.TH @@RXVT_NAME@@ 7 "2006-11-02" "8.0" "RXVT-UNICODE"
133.SH "NAME" 133.SH "NAME"
134RXVT REFERENCE \- FAQ, command sequences and other background information 134RXVT REFERENCE \- FAQ, command sequences and other background information
135.SH "SYNOPSIS" 135.SH "SYNOPSIS"
136.IX Header "SYNOPSIS" 136.IX Header "SYNOPSIS"
137.Vb 2 137.Vb 2
… …
152.IX Header "DESCRIPTION" 152.IX Header "DESCRIPTION"
153This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting 153This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting
154all escape sequences, and other background information. 154all escape sequences, and other background information.
155.PP 155.PP
156The newest version of this document is also available on the World Wide Web at 156The newest version of this document is also available on the World Wide Web at
157<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>. 157<http://cvs.schmorp.de/browse/rxvt\-unicode/doc/rxvt.7.html>.
158.SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" 158.SH "RXVT\-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS"
159.IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS" 159.IX Header "RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS"
160.Sh "Meta, Features & Commandline Issues" 160.Sh "Meta, Features & Commandline Issues"
161.IX Subsection "Meta, Features & Commandline Issues" 161.IX Subsection "Meta, Features & Commandline Issues"
162\fIMy question isn't answered here, can I ask a human?\fR 162\fIMy question isn't answered here, can I ask a human?\fR
… …
215.IX Subsection "How can I start @@URXVT_NAME@@d in a race-free way?" 215.IX Subsection "How can I start @@URXVT_NAME@@d in a race-free way?"
216.PP 216.PP
217Try \f(CW\*(C`@@URXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@URXVT_NAME@@d to open the 217Try \f(CW\*(C`@@URXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@URXVT_NAME@@d to open the
218display, create the listening socket and then fork. 218display, create the listening socket and then fork.
219.PP 219.PP
220\fIHow can I start @@URXVT_NAME@@d automatically when I run URXVT_NAME@@c?\fR
221.IX Subsection "How can I start @@URXVT_NAME@@d automatically when I run URXVT_NAME@@c?"
222.PP
223If you want to start @@URXVT_NAME@@d automatically whenever you run
224@@URXVT_NAME@@c and the daemon isn't running yet, use this script:
225.PP
226.Vb 6
227\& #!/bin/sh
228\& @@URXVT_NAME@@c "$@"
229\& if [ $? -eq 2 ]; then
230\& @@URXVT_NAME@@d -q -o -f
231\& @@URXVT_NAME@@c "$@"
232\& fi
233.Ve
234.PP
235This tries to create a new terminal, and if fails with exit status 2,
236meaning it couldn't connect to the daemon, it will start the daemon and
237re-run the command. Subsequent invocations of the script will re-use the
238existing daemon.
239.PP
220\fIHow do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR 240\fIHow do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.\fR
221.IX Subsection "How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc." 241.IX Subsection "How do I distinguish whether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc."
222.PP 242.PP
223The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R", 243The original rxvt and rxvt-unicode always export the variable \*(L"\s-1COLORTERM\s0\*(R",
224so you can check and see if that is set. Note that several programs, \s-1JED\s0, 244so you can check and see if that is set. Note that several programs, \s-1JED\s0,
225slrn, Midnight Commander automatically check this variable to decide 245slrn, Midnight Commander automatically check this variable to decide
226whether or not to use color. 246whether or not to use color.
… …
277\& 188985 9048 66616 18222 1788 urxvt --disable-everything 297\& 188985 9048 66616 18222 1788 urxvt --disable-everything
278.Ve 298.Ve
279.PP 299.PP
280When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft 300When you \f(CW\*(C`\-\-enable\-everything\*(C'\fR (which \fIis\fR unfair, as this involves xft
281and full locale/XIM support which are quite bloaty inside libX11 and my 301and full locale/XIM support which are quite bloaty inside libX11 and my
282libc), the two diverge, but not unreasnobaly so. 302libc), the two diverge, but not unreasonably so.
283.PP 303.PP
284.Vb 3 304.Vb 3
285\& text data bss drs rss filename 305\& text data bss drs rss filename
286\& 163431 2152 24 20123 2060 rxvt --enable-everything 306\& 163431 2152 24 20123 2060 rxvt --enable-everything
287\& 1035683 49680 66648 29096 3680 urxvt --enable-everything 307\& 1035683 49680 66648 29096 3680 urxvt --enable-everything
… …
386\& @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 406\& @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
387.Ve 407.Ve
388.PP 408.PP
389This requires \s-1XFT\s0 support, and the support of your X\-server. If that 409This requires \s-1XFT\s0 support, and the support of your X\-server. If that
390doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't 410doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't
391there yet, no matter what they claim. Rxvt-Unicode contains the neccessary 411there yet, no matter what they claim. Rxvt-Unicode contains the necessary
392bugfixes and workarounds for Xft and Xlib to make it work, but that 412bugfixes and workarounds for Xft and Xlib to make it work, but that
393doesn't mean that your \s-1WM\s0 has the required kludges in place. 413doesn't mean that your \s-1WM\s0 has the required kludges in place.
394.PP 414.PP
3954. Use xcompmgr and let it do the job: 4154. Use xcompmgr and let it do the job:
396.PP 416.PP
… …
416however: Xft fonts often draw glyphs larger than their acclaimed bounding 436however: Xft fonts often draw glyphs larger than their acclaimed bounding
417box, and rxvt-unicode has no way of detecting this (the correct way is to 437box, and rxvt-unicode has no way of detecting this (the correct way is to
418ask for the character bounding box, which unfortunately is wrong in these 438ask for the character bounding box, which unfortunately is wrong in these
419cases). 439cases).
420.PP 440.PP
421It's not clear (to me at least), wether this is a bug in Xft, freetype, 441It's not clear (to me at least), whether this is a bug in Xft, freetype,
422or the respective font. If you encounter this problem you might try using 442or the respective font. If you encounter this problem you might try using
423the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you 443the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you
424might be forced to use a different font. 444might be forced to use a different font.
425.PP 445.PP
426All of this is not a problem when using X11 core fonts, as their bounding 446All of this is not a problem when using X11 core fonts, as their bounding
… …
456.PP 476.PP
457Yes, using an escape sequence. Try something like this, which has the same 477Yes, using an escape sequence. Try something like this, which has the same
458effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately: 478effect as using the \f(CW\*(C`\-fn\*(C'\fR switch, and takes effect immediately:
459.PP 479.PP
460.Vb 1 480.Vb 1
461\& printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic" 481\& printf '\e33]50;%s\e007' "9x15bold,xft:Kochi Gothic"
462.Ve 482.Ve
463.PP 483.PP
464This is useful if you e.g. work primarily with japanese (and prefer a 484This is useful if you e.g. work primarily with japanese (and prefer a
465japanese font), but you have to switch to chinese temporarily, where 485japanese font), but you have to switch to chinese temporarily, where
466japanese fonts would only be in your way. 486japanese fonts would only be in your way.
… …
470\fIWhy do italic characters look as if clipped?\fR 490\fIWhy do italic characters look as if clipped?\fR
471.IX Subsection "Why do italic characters look as if clipped?" 491.IX Subsection "Why do italic characters look as if clipped?"
472.PP 492.PP
473Many fonts have difficulties with italic characters and hinting. For 493Many fonts have difficulties with italic characters and hinting. For
474example, the otherwise very nicely hinted font \f(CW\*(C`xft:Bitstream Vera Sans 494example, the otherwise very nicely hinted font \f(CW\*(C`xft:Bitstream Vera Sans
475Mono\*(C'\fR completely fails in it's italic face. A workaround might be to 495Mono\*(C'\fR completely fails in its italic face. A workaround might be to
476enable freetype autohinting, i.e. like this: 496enable freetype autohinting, i.e. like this:
477.PP 497.PP
478.Vb 2 498.Vb 2
479\& URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true 499\& URxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
480\& URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true 500\& URxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
… …
490.PP 510.PP
491\fIRxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?\fR 511\fIRxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?\fR
492.IX Subsection "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?" 512.IX Subsection "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?"
493.PP 513.PP
494Rxvt-unicode will use whatever you specify as a font. If it needs to 514Rxvt-unicode will use whatever you specify as a font. If it needs to
495fall back to it's default font search list it will prefer X11 core 515fall back to its default font search list it will prefer X11 core
496fonts, because they are small and fast, and then use Xft fonts. It has 516fonts, because they are small and fast, and then use Xft fonts. It has
497antialiasing disabled for most of them, because the author thinks they 517antialiasing disabled for most of them, because the author thinks they
498look best that way. 518look best that way.
499.PP 519.PP
500If you want antialiasing, you have to specify the fonts manually. 520If you want antialiasing, you have to specify the fonts manually.
… …
695circumstances, it will move your cursor around when you click into the 715circumstances, it will move your cursor around when you click into the
696line that contains it. It tries hard not to do this at the wrong moment, 716line that contains it. It tries hard not to do this at the wrong moment,
697but when running a program that doesn't parse cursor movements or in some 717but when running a program that doesn't parse cursor movements or in some
698cases during rlogin sessions, it fails to detect this properly. 718cases during rlogin sessions, it fails to detect this properly.
699.PP 719.PP
700You can permamently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR 720You can permanently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR
701extension: 721extension:
702.PP 722.PP
703.Vb 1 723.Vb 1
704\& URxvt.perl-ext-common: default,-readline 724\& URxvt.perl-ext-common: default,-readline
705.Ve 725.Ve
… …
707\fIMy numerical keypad acts weird and generates differing output?\fR 727\fIMy numerical keypad acts weird and generates differing output?\fR
708.IX Subsection "My numerical keypad acts weird and generates differing output?" 728.IX Subsection "My numerical keypad acts weird and generates differing output?"
709.PP 729.PP
710Some Debian GNUL/Linux users seem to have this problem, although no 730Some Debian GNUL/Linux users seem to have this problem, although no
711specific details were reported so far. It is possible that this is caused 731specific details were reported so far. It is possible that this is caused
712by the wrong \f(CW\*(C`TERM\*(C'\fR setting, although the details of wether and how 732by the wrong \f(CW\*(C`TERM\*(C'\fR setting, although the details of whether and how
713this can happen are unknown, as \f(CW\*(C`TERM=rxvt\*(C'\fR should offer a compatible 733this can happen are unknown, as \f(CW\*(C`TERM=rxvt\*(C'\fR should offer a compatible
714keymap. See the answer to the previous question, and please report if that 734keymap. See the answer to the previous question, and please report if that
715helped. 735helped.
716.PP 736.PP
717\fIMy Compose (Multi_key) key is no longer working.\fR 737\fIMy Compose (Multi_key) key is no longer working.\fR
… …
747.PP 767.PP
748\fIWhat's with the strange Backspace/Delete key behaviour?\fR 768\fIWhat's with the strange Backspace/Delete key behaviour?\fR
749.IX Subsection "What's with the strange Backspace/Delete key behaviour?" 769.IX Subsection "What's with the strange Backspace/Delete key behaviour?"
750.PP 770.PP
751Assuming that the physical Backspace key corresponds to the 771Assuming that the physical Backspace key corresponds to the
752BackSpace keysym (not likely for Linux ... see the following 772Backspace keysym (not likely for Linux ... see the following
753question) there are two standard values that can be used for 773question) there are two standard values that can be used for
754Backspace: \f(CW\*(C`^H\*(C'\fR and \f(CW\*(C`^?\*(C'\fR. 774Backspace: \f(CW\*(C`^H\*(C'\fR and \f(CW\*(C`^?\*(C'\fR.
755.PP 775.PP
756Historically, either value is correct, but rxvt-unicode adopts the debian 776Historically, either value is correct, but rxvt-unicode adopts the debian
757policy of using \f(CW\*(C`^?\*(C'\fR when unsure, because it's the one only only correct 777policy of using \f(CW\*(C`^?\*(C'\fR when unsure, because it's the one only only correct
… …
859Rather than have rxvt-unicode try to accommodate all the various possible 879Rather than have rxvt-unicode try to accommodate all the various possible
860keyboard mappings, it is better to use `xmodmap' to remap the keys as 880keyboard mappings, it is better to use `xmodmap' to remap the keys as
861required for your particular machine. 881required for your particular machine.
862.Sh "Terminal Configuration" 882.Sh "Terminal Configuration"
863.IX Subsection "Terminal Configuration" 883.IX Subsection "Terminal Configuration"
884\fICan I see a typical configuration?\fR
885.IX Subsection "Can I see a typical configuration?"
886.PP
887The default configuration tries to be xterm\-like, which I don't like that
888much, but it's least surprise to regular users.
889.PP
890As a rxvt or rxvt-unicode user, you are practically supposed to invest
891time into customising your terminal. To get you started, here is the
892author's .Xdefaults entries, with comments on what they do. It's certainly
893not \fItypical\fR, but what's typical...
894.PP
895.Vb 2
896\& URxvt.cutchars: "()*,<>[]{}|'
897\& URxvt.print-pipe: cat >/tmp/xxx
898.Ve
899.PP
900These are just for testing stuff.
901.PP
902.Vb 2
903\& URxvt.imLocale: ja_JP.UTF-8
904\& URxvt.preeditType: OnTheSpot,None
905.Ve
906.PP
907This tells rxvt-unicode to use a special locale when communicating with
908the X Input Method, and also tells it to only use the OnTheSpot pre-edit
909type, which requires the \f(CW\*(C`xim\-onthespot\*(C'\fR perl extension but rewards me
910with correct-looking fonts.
911.PP
912.Vb 6
913\& URxvt.perl-lib: /root/lib/urxvt
914\& URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard
915\& URxvt.selection.pattern-0: ( at .*? line \e\ed+)
916\& URxvt.selection.pattern-1: ^(/[^:]+):\e
917\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
918\& URxvt.selection-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
919.Ve
920.PP
921This is my perl configuration. The first two set the perl library
922directory and also tells urxvt to use a large number of extensions. I
923develop for myself mostly, so I actually use most of the extensions I
924write.
925.PP
926The selection stuff mainly makes the selection perl-error-message aware
927and tells it to convert perl error messages into vi-commands to load the
928relevant file and go tot he error line number.
929.PP
930.Vb 2
931\& URxvt.scrollstyle: plain
932\& URxvt.secondaryScroll: true
933.Ve
934.PP
935As the documentation says: plain is the preferred scrollbar for the
936author. The \f(CW\*(C`secondaryScroll\*(C'\fR configures urxvt to scroll in full-screen
937apps, like screen, so lines scrolled out of screen end up in urxvt's
938scrollback buffer.
939.PP
940.Vb 7
941\& URxvt.background: #000000
942\& URxvt.foreground: gray90
943\& URxvt.color7: gray90
944\& URxvt.colorBD: #ffffff
945\& URxvt.cursorColor: #e0e080
946\& URxvt.throughColor: #8080f0
947\& URxvt.highlightColor: #f0f0f0
948.Ve
949.PP
950Some colours. Not sure which ones are being used or even non\-defaults, but
951these are in my .Xdefaults. Most notably, they set foreground/background
952to light gray/black, and also make sure that the colour 7 matches the
953default foreground colour.
954.PP
955.Vb 1
956\& URxvt.underlineColor: yellow
957.Ve
958.PP
959Another colour, makes underline lines look different. Sometimes hurts, but
960is mostly a nice effect.
961.PP
962.Vb 4
963\& URxvt.geometry: 154x36
964\& URxvt.loginShell: false
965\& URxvt.meta: ignore
966\& URxvt.utmpInhibit: true
967.Ve
968.PP
969Uh, well, should be mostly self\-explanatory. By specifying some defaults
970manually, I can quickly switch them for testing.
971.PP
972.Vb 1
973\& URxvt.saveLines: 8192
974.Ve
975.PP
976A large scrollback buffer is essential. Really.
977.PP
978.Vb 1
979\& URxvt.mapAlert: true
980.Ve
981.PP
982The only case I use it is for my \s-1IRC\s0 window, which I like to keep
983iconified till people msg me (which beeps).
984.PP
985.Vb 1
986\& URxvt.visualBell: true
987.Ve
988.PP
989The audible bell is often annoying, especially when in a crowd.
990.PP
991.Vb 1
992\& URxvt.insecure: true
993.Ve
994.PP
995Please don't hack my mutt! Ooops...
996.PP
997.Vb 1
998\& URxvt.pastableTabs: false
999.Ve
1000.PP
1001I once thought this is a great idea.
1002.PP
1003.Vb 9
1004\& urxvt.font: 9x15bold,\e
1005\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e
1006\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e
1007\& [codeset=JISX0208]xft:Kochi Gothic, \e
1008\& xft:Bitstream Vera Sans Mono:autohint=true, \e
1009\& xft:Code2000:antialias=false
1010\& urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
1011\& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
1012\& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
1013.Ve
1014.PP
1015I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
1016overwhelmed. A special note: the \f(CW\*(C`9x15bold\*(C'\fR mentioned above is actually
1017the version from XFree\-3.3, as XFree\-4 replaced it by a totally different
1018font (different glyphs for \f(CW\*(C`;\*(C'\fR and many other harmless characters),
1019while the second font is actually the \f(CW\*(C`9x15bold\*(C'\fR from XFree4/XOrg. The
1020bold version has less chars than the medium version, so I use it for rare
1021characters, too. When editing sources with vim, I use italic for comments
1022and other stuff, which looks quite good with Bitstream Vera anti\-aliased.
1023.PP
1024Terminus is a quite bad font (many very wrong glyphs), but for most of my
1025purposes, it works, and gives a different look, as my normal (Non\-bold)
1026font is already bold, and I want to see a difference between bold and
1027normal fonts.
1028.PP
1029Please note that I used the \f(CW\*(C`urxvt\*(C'\fR instance name and not the \f(CW\*(C`URxvt\*(C'\fR
1030class name. Thats because I use different configs for different purposes,
1031for example, my \s-1IRC\s0 window is started with \f(CW\*(C`\-name IRC\*(C'\fR, and uses these
1032defaults:
1033.PP
1034.Vb 9
1035\& IRC*title: IRC
1036\& IRC*geometry: 87x12+535+542
1037\& IRC*saveLines: 0
1038\& IRC*mapAlert: true
1039\& IRC*font: suxuseuro
1040\& IRC*boldFont: suxuseuro
1041\& IRC*colorBD: white
1042\& IRC*keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
1043\& IRC*keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
1044.Ve
1045.PP
1046\&\f(CW\*(C`Alt\-Shift\-1\*(C'\fR and \f(CW\*(C`Alt\-Shift\-2\*(C'\fR switch between two different font
1047sizes. \f(CW\*(C`suxuseuro\*(C'\fR allows me to keep an eye (and actually read)
1048stuff while keeping a very small window. If somebody pastes something
1049complicated (e.g. japanese), I temporarily switch to a larger font.
1050.PP
1051The above is all in my \f(CW\*(C`.Xdefaults\*(C'\fR (I don't use \f(CW\*(C`.Xresources\*(C'\fR nor
1052\&\f(CW\*(C`xrdb\*(C'\fR). I also have some resources in a separate \f(CW\*(C`.Xdefaults\-hostname\*(C'\fR
1053file for different hosts, for example, on ym main desktop, I use:
1054.PP
1055.Vb 5
1056\& URxvt.keysym.C-M-q: command:\e033[3;5;5t
1057\& URxvt.keysym.C-M-y: command:\e033[3;5;606t
1058\& URxvt.keysym.C-M-e: command:\e033[3;1605;5t
1059\& URxvt.keysym.C-M-c: command:\e033[3;1605;606t
1060\& URxvt.keysym.C-M-p: perl:test
1061.Ve
1062.PP
1063The first for keysym definitions allow me to quickly bring some windows
1064in the layout I like most. Ion users might start laughing but will stop
1065immediately when I tell them that I use my own Fvwm2 module for much the
1066same effect as Ion provides, and I only very rarely use the above key
1067combinations :\->
1068.PP
864\fIWhy doesn't rxvt-unicode read my resources?\fR 1069\fIWhy doesn't rxvt-unicode read my resources?\fR
865.IX Subsection "Why doesn't rxvt-unicode read my resources?" 1070.IX Subsection "Why doesn't rxvt-unicode read my resources?"
866.PP 1071.PP
867Well, why, indeed? It does, in a way very similar to other X 1072Well, why, indeed? It does, in a way very similar to other X
868applications. Most importantly, this means that if you or your \s-1OS\s0 loads 1073applications. Most importantly, this means that if you or your \s-1OS\s0 loads
… …
879.Vb 1 1084.Vb 1
880\& URxvt.resource: value 1085\& URxvt.resource: value
881.Ve 1086.Ve
882.PP 1087.PP
883If you want to use another form (there are lots of different ways of 1088If you want to use another form (there are lots of different ways of
884specifying resources), make sure you understand wether and why it 1089specifying resources), make sure you understand whether and why it
885works. If unsure, use the form above. 1090works. If unsure, use the form above.
886.PP 1091.PP
887\fIWhen I log-in to another system it tells me about missing terminfo data?\fR 1092\fIWhen I log-in to another system it tells me about missing terminfo data?\fR
888.IX Subsection "When I log-in to another system it tells me about missing terminfo data?" 1093.IX Subsection "When I log-in to another system it tells me about missing terminfo data?"
889.PP 1094.PP
890The terminal description used by rxvt-unicode is not as widely available 1095The terminal description used by rxvt-unicode is not as widely available
891as that for xterm, or even rxvt (for which the same problem often arises). 1096as that for xterm, or even rxvt (for which the same problem often arises).
892.PP 1097.PP
893The correct solution for this problem is to install the terminfo, this can 1098The correct solution for this problem is to install the terminfo, this can
894be done like this (with ncurses' infocmp): 1099be done like this (with ncurses' infocmp and works as user and admin):
895.PP 1100.PP
896.Vb 2 1101.Vb 2
897\& REMOTE=remotesystem.domain 1102\& REMOTE=remotesystem.domain
898\& infocmp rxvt-unicode | ssh $REMOTE "cat >/tmp/ti && tic /tmp/ti" 1103\& infocmp rxvt-unicode | ssh $REMOTE "mkdir -p .terminfo && cat >/tmp/ti && tic /tmp/ti"
899.Ve 1104.Ve
900.PP 1105.PP
901\&... or by installing rxvt-unicode normally on the remote system, 1106\&... or by installing rxvt-unicode normally on the remote system,
1107.PP
1108One some systems you might need to set \f(CW$TERMINFO\fR to the full path of
1109\&\fI$HOME/.terminfo\fR for this to work.
902.PP 1110.PP
903If you cannot or do not want to do this, then you can simply set 1111If you cannot or do not want to do this, then you can simply set
904\&\f(CW\*(C`TERM=rxvt\*(C'\fR or even \f(CW\*(C`TERM=xterm\*(C'\fR, and live with the small number of 1112\&\f(CW\*(C`TERM=rxvt\*(C'\fR or even \f(CW\*(C`TERM=xterm\*(C'\fR, and live with the small number of
905problems arising, which includes wrong keymapping, less and different 1113problems arising, which includes wrong keymapping, less and different
906colours and some refresh errors in fullscreen applications. It's a nice 1114colours and some refresh errors in fullscreen applications. It's a nice
… …
934One reason you might want this is that some distributions or operating 1142One reason you might want this is that some distributions or operating
935systems still compile some programs using the long-obsoleted termcap 1143systems still compile some programs using the long-obsoleted termcap
936library (Fedora Core's bash is one example) and rely on a termcap entry 1144library (Fedora Core's bash is one example) and rely on a termcap entry
937for \f(CW\*(C`rxvt\-unicode\*(C'\fR. 1145for \f(CW\*(C`rxvt\-unicode\*(C'\fR.
938.PP 1146.PP
939You could use rxvt's termcap entry with resonable results in many cases. 1147You could use rxvt's termcap entry with reasonable results in many cases.
940You can also create a termcap entry by using terminfo's infocmp program 1148You can also create a termcap entry by using terminfo's infocmp program
941like this: 1149like this:
942.PP 1150.PP
943.Vb 1 1151.Vb 1
944\& infocmp -C rxvt-unicode 1152\& infocmp -C rxvt-unicode
… …
971.PP 1179.PP
972\fIWhy does \f(CI\*(C`ls\*(C'\fI no longer have coloured output?\fR 1180\fIWhy does \f(CI\*(C`ls\*(C'\fI no longer have coloured output?\fR
973.IX Subsection "Why does ls no longer have coloured output?" 1181.IX Subsection "Why does ls no longer have coloured output?"
974.PP 1182.PP
975The \f(CW\*(C`ls\*(C'\fR in the \s-1GNU\s0 coreutils unfortunately doesn't use terminfo to 1183The \f(CW\*(C`ls\*(C'\fR in the \s-1GNU\s0 coreutils unfortunately doesn't use terminfo to
976decide wether a terminal has colour, but uses it's own configuration 1184decide whether a terminal has colour, but uses its own configuration
977file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in it's default file (among 1185file. Needless to say, \f(CW\*(C`rxvt\-unicode\*(C'\fR is not in its default file (among
978with most other terminals supporting colour). Either add: 1186with most other terminals supporting colour). Either add:
979.PP 1187.PP
980.Vb 1 1188.Vb 1
981\& TERM rxvt-unicode 1189\& TERM rxvt-unicode
982.Ve 1190.Ve
… …
1031.PP 1239.PP
1032The best thing is to fix your startup environment, as you will likely run 1240The best thing is to fix your startup environment, as you will likely run
1033into other problems. If nothing works you can try this in your .profile. 1241into other problems. If nothing works you can try this in your .profile.
1034.PP 1242.PP
1035.Vb 1 1243.Vb 1
1036\& printf '\ee]701;%s\e007' "$LC_CTYPE" 1244\& printf '\e33]701;%s\e007' "$LC_CTYPE"
1037.Ve 1245.Ve
1038.PP 1246.PP
1039If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not 1247If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not
1040supported on your systems. Some systems have a \f(CW\*(C`locale\*(C'\fR command which 1248supported on your systems. Some systems have a \f(CW\*(C`locale\*(C'\fR command which
1041displays this (also, \f(CW\*(C`perl \-e0\*(C'\fR can be used to check locale settings, as 1249displays this (also, \f(CW\*(C`perl \-e0\*(C'\fR can be used to check locale settings, as
… …
1067The reasons is that there exists a perfectly fine mechanism for selecting 1275The reasons is that there exists a perfectly fine mechanism for selecting
1068the encoding, doing I/O and (most important) communicating this to all 1276the encoding, doing I/O and (most important) communicating this to all
1069applications so everybody agrees on character properties such as width 1277applications so everybody agrees on character properties such as width
1070and code number. This mechanism is the \fIlocale\fR. Applications not using 1278and code number. This mechanism is the \fIlocale\fR. Applications not using
1071that info will have problems (for example, \f(CW\*(C`xterm\*(C'\fR gets the width of 1279that info will have problems (for example, \f(CW\*(C`xterm\*(C'\fR gets the width of
1072characters wrong as it uses it's own, locale-independent table under all 1280characters wrong as it uses its own, locale-independent table under all
1073locales). 1281locales).
1074.PP 1282.PP
1075Rxvt-unicode uses the \f(CW\*(C`LC_CTYPE\*(C'\fR locale category to select encoding. All 1283Rxvt-unicode uses the \f(CW\*(C`LC_CTYPE\*(C'\fR locale category to select encoding. All
1076programs doing the same (that is, most) will automatically agree in the 1284programs doing the same (that is, most) will automatically agree in the
1077interpretation of characters. 1285interpretation of characters.
… …
1098.PP 1306.PP
1099Yes, using an escape sequence. Try something like this, which sets 1307Yes, using an escape sequence. Try something like this, which sets
1100rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR. 1308rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR.
1101.PP 1309.PP
1102.Vb 1 1310.Vb 1
1103\& printf '\ee]701;%s\e007' ja_JP.SJIS 1311\& printf '\e33]701;%s\e007' ja_JP.SJIS
1104.Ve 1312.Ve
1105.PP 1313.PP
1106See also the previous answer. 1314See also the previous answer.
1107.PP 1315.PP
1108Sometimes this capability is rather handy when you want to work in 1316Sometimes this capability is rather handy when you want to work in
1109one locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support it 1317one locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support it
1110(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which 1318(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which
1111first switches to a locale supported by xjdic and back later: 1319first switches to a locale supported by xjdic and back later:
1112.PP 1320.PP
1113.Vb 3 1321.Vb 3
1114\& printf '\ee]701;%s\e007' ja_JP.SJIS 1322\& printf '\e33]701;%s\e007' ja_JP.SJIS
1115\& xjdic -js 1323\& xjdic -js
1116\& printf '\ee]701;%s\e007' de_DE.UTF-8 1324\& printf '\e33]701;%s\e007' de_DE.UTF-8
1117.Ve 1325.Ve
1118.PP 1326.PP
1119You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except 1327You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except
1120for some locales where character width differs between program\- and 1328for some locales where character width differs between program\- and
1121rxvt\-unicode\-locales. 1329rxvt\-unicode\-locales.
1122.PP 1330.PP
1331\fII have problems getting my input method working.\fR
1332.IX Subsection "I have problems getting my input method working."
1333.PP
1334Try a search engine, as this is slightly different for every input method server.
1335.PP
1336Here is a checklist:
1337.IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS\s0." 4
1338.IX Item "- Make sure your locale and the imLocale are supported on your OS."
1339Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS\s0.
1340.IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM\s0." 4
1341.IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM."
1342For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use
1343\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent.
1344.IP "\- Make sure your \s-1XIM\s0 server is actually running." 4
1345.IX Item "- Make sure your XIM server is actually running."
1346.PD 0
1347.ie n .IP "\- Make sure the ""XMODIFIERS""\fR environment variable is set correctly when \fIstarting rxvt\-unicode." 4
1348.el .IP "\- Make sure the \f(CWXMODIFIERS\fR environment variable is set correctly when \fIstarting\fR rxvt\-unicode." 4
1349.IX Item "- Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode."
1350.PD
1351When you want to use e.g. \fBkinput2\fR, it must be set to
1352\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. You can see what input
1353method servers are running with this command:
1354.Sp
1355.Vb 1
1356\& xprop -root XIM_SERVERS
1357.Ve
1358.IP "*" 4
1359.PP
1123\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR 1360\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR
1124.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?" 1361.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
1125.PP 1362.PP
1126You can specify separate locales for the input method and the rest of the 1363You can specify separate locales for the input method and the rest of the
1127terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: 1364terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
… …
1129.Vb 1 1366.Vb 1
1130\& URxvt.imlocale: ja_JP.EUC-JP 1367\& URxvt.imlocale: ja_JP.EUC-JP
1131.Ve 1368.Ve
1132.PP 1369.PP
1133Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still 1370Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still
1134use your input method. Please note, however, that you will not be able to 1371use your input method. Please note, however, that, depending on your Xlib
1135input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input 1372version, you may not be able to input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a
1136method limits you. 1373normal way then, as your input method limits you.
1137.PP 1374.PP
1138\fIRxvt-unicode crashes when the X Input Method changes or exits.\fR 1375\fIRxvt-unicode crashes when the X Input Method changes or exits.\fR
1139.IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits." 1376.IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits."
1140.PP 1377.PP
1141Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by 1378Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by
… …
1168\fII am maintaining rxvt-unicode for distribution/OS \s-1XXX\s0, any recommendation?\fR 1405\fII am maintaining rxvt-unicode for distribution/OS \s-1XXX\s0, any recommendation?\fR
1169.IX Subsection "I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?" 1406.IX Subsection "I am maintaining rxvt-unicode for distribution/OS XXX, any recommendation?"
1170.PP 1407.PP
1171You should build one binary with the default options. \fIconfigure\fR 1408You should build one binary with the default options. \fIconfigure\fR
1172now enables most useful options, and the trend goes to making them 1409now enables most useful options, and the trend goes to making them
1173runtime\-switchable, too, so there is usually no drawback to enbaling them, 1410runtime\-switchable, too, so there is usually no drawback to enabling them,
1174except higher disk and possibly memory usage. The perl interpreter should 1411except higher disk and possibly memory usage. The perl interpreter should
1175be enabled, as important functionality (menus, selection, likely more in 1412be enabled, as important functionality (menus, selection, likely more in
1176the future) depends on it. 1413the future) depends on it.
1177.PP 1414.PP
1178You should not overwrite the \f(CW\*(C`perl\-ext\-common\*(C'\fR snd \f(CW\*(C`perl\-ext\*(C'\fR resources 1415You should not overwrite the \f(CW\*(C`perl\-ext\-common\*(C'\fR snd \f(CW\*(C`perl\-ext\*(C'\fR resources
… …
1218\fII am on FreeBSD and rxvt-unicode does not seem to work at all.\fR 1455\fII am on FreeBSD and rxvt-unicode does not seem to work at all.\fR
1219.IX Subsection "I am on FreeBSD and rxvt-unicode does not seem to work at all." 1456.IX Subsection "I am on FreeBSD and rxvt-unicode does not seem to work at all."
1220.PP 1457.PP
1221Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined 1458Rxvt-unicode requires the symbol \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR to be defined
1222in your compile environment, or an implementation that implements it, 1459in your compile environment, or an implementation that implements it,
1223wether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that 1460whether it defines the symbol or not. \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR requires that
1224\&\fBwchar_t\fR is represented as unicode. 1461\&\fBwchar_t\fR is represented as unicode.
1225.PP 1462.PP
1226As you might have guessed, FreeBSD does neither define this symobl nor 1463As you might have guessed, FreeBSD does neither define this symbol nor
1227does it support it. Instead, it uses it's own internal representation of 1464does it support it. Instead, it uses its own internal representation of
1228\&\fBwchar_t\fR. This is, of course, completely fine with respect to standards. 1465\&\fBwchar_t\fR. This is, of course, completely fine with respect to standards.
1229.PP 1466.PP
1230However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and 1467However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and
1231\&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR. 1468\&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR.
1232.PP 1469.PP
… …
1745.ie n .IP "\fB\fB""ESC [ ? Pm t""\fB\fR" 4 1982.ie n .IP "\fB\fB""ESC [ ? Pm t""\fB\fR" 4
1746.el .IP "\fB\f(CBESC [ ? Pm t\fB\fR" 4 1983.el .IP "\fB\f(CBESC [ ? Pm t\fB\fR" 4
1747.IX Item "ESC [ ? Pm t" 1984.IX Item "ESC [ ? Pm t"
1748Toggle \s-1DEC\s0 Private Mode Values (rxvt extension). \fIwhere\fR 1985Toggle \s-1DEC\s0 Private Mode Values (rxvt extension). \fIwhere\fR
1749.RS 4 1986.RS 4
1750.ie n .IP "\fB\fB""Ps = 1""\fB\fR (\s-1DECCKM\s0)" 4 1987.ie n .IP "\fB\fB""Pm = 1""\fB\fR (\s-1DECCKM\s0)" 4
1751.el .IP "\fB\f(CBPs = 1\fB\fR (\s-1DECCKM\s0)" 4 1988.el .IP "\fB\f(CBPm = 1\fB\fR (\s-1DECCKM\s0)" 4
1752.IX Item "Ps = 1 (DECCKM)" 1989.IX Item "Pm = 1 (DECCKM)"
1753.TS 1990.TS
1754l l . 1991l l .
1755h Application Cursor Keys 1992h Application Cursor Keys
1756l Normal Cursor Keys 1993l Normal Cursor Keys
1757.TE 1994.TE
1758 1995
1759.PD 0 1996.PD 0
1760.ie n .IP "\fB\fB""Ps = 2""\fB\fR (\s-1ANSI/VT52\s0 mode)" 4 1997.ie n .IP "\fB\fB""Pm = 2""\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
1761.el .IP "\fB\f(CBPs = 2\fB\fR (\s-1ANSI/VT52\s0 mode)" 4 1998.el .IP "\fB\f(CBPm = 2\fB\fR (\s-1ANSI/VT52\s0 mode)" 4
1762.IX Item "Ps = 2 (ANSI/VT52 mode)" 1999.IX Item "Pm = 2 (ANSI/VT52 mode)"
1763.TS 2000.TS
1764l l . 2001l l .
1765h Enter VT52 mode 2002h Enter VT52 mode
1766l Enter VT52 mode 2003l Enter VT52 mode
1767.TE 2004.TE
1768 2005
1769.ie n .IP "\fB\fB""Ps = 3""\fB\fR" 4 2006.ie n .IP "\fB\fB""Pm = 3""\fB\fR" 4
1770.el .IP "\fB\f(CBPs = 3\fB\fR" 4 2007.el .IP "\fB\f(CBPm = 3\fB\fR" 4
1771.IX Item "Ps = 3" 2008.IX Item "Pm = 3"
1772.TS 2009.TS
1773l l . 2010l l .
1774h 132 Column Mode (DECCOLM) 2011h 132 Column Mode (DECCOLM)
1775l 80 Column Mode (DECCOLM) 2012l 80 Column Mode (DECCOLM)
1776.TE 2013.TE
1777 2014
1778.ie n .IP "\fB\fB""Ps = 4""\fB\fR" 4 2015.ie n .IP "\fB\fB""Pm = 4""\fB\fR" 4
1779.el .IP "\fB\f(CBPs = 4\fB\fR" 4 2016.el .IP "\fB\f(CBPm = 4\fB\fR" 4
1780.IX Item "Ps = 4" 2017.IX Item "Pm = 4"
1781.TS 2018.TS
1782l l . 2019l l .
1783h Smooth (Slow) Scroll (DECSCLM) 2020h Smooth (Slow) Scroll (DECSCLM)
1784l Jump (Fast) Scroll (DECSCLM) 2021l Jump (Fast) Scroll (DECSCLM)
1785.TE 2022.TE
1786 2023
1787.ie n .IP "\fB\fB""Ps = 5""\fB\fR" 4 2024.ie n .IP "\fB\fB""Pm = 5""\fB\fR" 4
1788.el .IP "\fB\f(CBPs = 5\fB\fR" 4 2025.el .IP "\fB\f(CBPm = 5\fB\fR" 4
1789.IX Item "Ps = 5" 2026.IX Item "Pm = 5"
1790.TS 2027.TS
1791l l . 2028l l .
1792h Reverse Video (DECSCNM) 2029h Reverse Video (DECSCNM)
1793l Normal Video (DECSCNM) 2030l Normal Video (DECSCNM)
1794.TE 2031.TE
1795 2032
1796.ie n .IP "\fB\fB""Ps = 6""\fB\fR" 4 2033.ie n .IP "\fB\fB""Pm = 6""\fB\fR" 4
1797.el .IP "\fB\f(CBPs = 6\fB\fR" 4 2034.el .IP "\fB\f(CBPm = 6\fB\fR" 4
1798.IX Item "Ps = 6" 2035.IX Item "Pm = 6"
1799.TS 2036.TS
1800l l . 2037l l .
1801h Origin Mode (DECOM) 2038h Origin Mode (DECOM)
1802l Normal Cursor Mode (DECOM) 2039l Normal Cursor Mode (DECOM)
1803.TE 2040.TE
1804 2041
1805.ie n .IP "\fB\fB""Ps = 7""\fB\fR" 4 2042.ie n .IP "\fB\fB""Pm = 7""\fB\fR" 4
1806.el .IP "\fB\f(CBPs = 7\fB\fR" 4 2043.el .IP "\fB\f(CBPm = 7\fB\fR" 4
1807.IX Item "Ps = 7" 2044.IX Item "Pm = 7"
1808.TS 2045.TS
1809l l . 2046l l .
1810h Wraparound Mode (DECAWM) 2047h Wraparound Mode (DECAWM)
1811l No Wraparound Mode (DECAWM) 2048l No Wraparound Mode (DECAWM)
1812.TE 2049.TE
1813 2050
1814.ie n .IP "\fB\fB""Ps = 8""\fB\fR \fIunimplemented\fR" 4 2051.ie n .IP "\fB\fB""Pm = 8""\fB\fR \fIunimplemented\fR" 4
1815.el .IP "\fB\f(CBPs = 8\fB\fR \fIunimplemented\fR" 4 2052.el .IP "\fB\f(CBPm = 8\fB\fR \fIunimplemented\fR" 4
1816.IX Item "Ps = 8 unimplemented" 2053.IX Item "Pm = 8 unimplemented"
1817.TS 2054.TS
1818l l . 2055l l .
1819h Auto-repeat Keys (DECARM) 2056h Auto-repeat Keys (DECARM)
1820l No Auto-repeat Keys (DECARM) 2057l No Auto-repeat Keys (DECARM)
1821.TE 2058.TE
1822 2059
1823.ie n .IP "\fB\fB""Ps = 9""\fB\fR X10 XTerm" 4 2060.ie n .IP "\fB\fB""Pm = 9""\fB\fR X10 XTerm" 4
1824.el .IP "\fB\f(CBPs = 9\fB\fR X10 XTerm" 4 2061.el .IP "\fB\f(CBPm = 9\fB\fR X10 XTerm" 4
1825.IX Item "Ps = 9 X10 XTerm" 2062.IX Item "Pm = 9 X10 XTerm"
1826.TS 2063.TS
1827l l . 2064l l .
1828h Send Mouse X & Y on button press. 2065h Send Mouse X & Y on button press.
1829l No mouse reporting. 2066l No mouse reporting.
1830.TE 2067.TE
1831 2068
1832.ie n .IP "\fB\fB""Ps = 25""\fB\fR" 4 2069.ie n .IP "\fB\fB""Pm = 25""\fB\fR" 4
1833.el .IP "\fB\f(CBPs = 25\fB\fR" 4 2070.el .IP "\fB\f(CBPm = 25\fB\fR" 4
1834.IX Item "Ps = 25" 2071.IX Item "Pm = 25"
1835.TS 2072.TS
1836l l . 2073l l .
1837h Visible cursor {cnorm/cvvis} 2074h Visible cursor {cnorm/cvvis}
1838l Invisible cursor {civis} 2075l Invisible cursor {civis}
1839.TE 2076.TE
1840 2077
1841.ie n .IP "\fB\fB""Ps = 30""\fB\fR" 4 2078.ie n .IP "\fB\fB""Pm = 30""\fB\fR" 4
1842.el .IP "\fB\f(CBPs = 30\fB\fR" 4 2079.el .IP "\fB\f(CBPm = 30\fB\fR" 4
1843.IX Item "Ps = 30" 2080.IX Item "Pm = 30"
1844.TS 2081.TS
1845l l . 2082l l .
1846h scrollBar visisble 2083h scrollBar visisble
1847l scrollBar invisisble 2084l scrollBar invisisble
1848.TE 2085.TE
1849 2086
1850.ie n .IP "\fB\fB""Ps = 35""\fB\fR (\fBrxvt\fR)" 4 2087.ie n .IP "\fB\fB""Pm = 35""\fB\fR (\fBrxvt\fR)" 4
1851.el .IP "\fB\f(CBPs = 35\fB\fR (\fBrxvt\fR)" 4 2088.el .IP "\fB\f(CBPm = 35\fB\fR (\fBrxvt\fR)" 4
1852.IX Item "Ps = 35 (rxvt)" 2089.IX Item "Pm = 35 (rxvt)"
1853.TS 2090.TS
1854l l . 2091l l .
1855h Allow XTerm Shift+key sequences 2092h Allow XTerm Shift+key sequences
1856l Disallow XTerm Shift+key sequences 2093l Disallow XTerm Shift+key sequences
1857.TE 2094.TE
1858 2095
1859.ie n .IP "\fB\fB""Ps = 38""\fB\fR \fIunimplemented\fR" 4 2096.ie n .IP "\fB\fB""Pm = 38""\fB\fR \fIunimplemented\fR" 4
1860.el .IP "\fB\f(CBPs = 38\fB\fR \fIunimplemented\fR" 4 2097.el .IP "\fB\f(CBPm = 38\fB\fR \fIunimplemented\fR" 4
1861.IX Item "Ps = 38 unimplemented" 2098.IX Item "Pm = 38 unimplemented"
1862.PD 2099.PD
1863Enter Tektronix Mode (\s-1DECTEK\s0) 2100Enter Tektronix Mode (\s-1DECTEK\s0)
1864.ie n .IP "\fB\fB""Ps = 40""\fB\fR" 4 2101.ie n .IP "\fB\fB""Pm = 40""\fB\fR" 4
1865.el .IP "\fB\f(CBPs = 40\fB\fR" 4 2102.el .IP "\fB\f(CBPm = 40\fB\fR" 4
1866.IX Item "Ps = 40" 2103.IX Item "Pm = 40"
1867.TS 2104.TS
1868l l . 2105l l .
1869h Allow 80/132 Mode 2106h Allow 80/132 Mode
1870l Disallow 80/132 Mode 2107l Disallow 80/132 Mode
1871.TE 2108.TE
1872 2109
1873.PD 0 2110.PD 0
1874.ie n .IP "\fB\fB""Ps = 44""\fB\fR \fIunimplemented\fR" 4 2111.ie n .IP "\fB\fB""Pm = 44""\fB\fR \fIunimplemented\fR" 4
1875.el .IP "\fB\f(CBPs = 44\fB\fR \fIunimplemented\fR" 4 2112.el .IP "\fB\f(CBPm = 44\fB\fR \fIunimplemented\fR" 4
1876.IX Item "Ps = 44 unimplemented" 2113.IX Item "Pm = 44 unimplemented"
1877.TS 2114.TS
1878l l . 2115l l .
1879h Turn On Margin Bell 2116h Turn On Margin Bell
1880l Turn Off Margin Bell 2117l Turn Off Margin Bell
1881.TE 2118.TE
1882 2119
1883.ie n .IP "\fB\fB""Ps = 45""\fB\fR \fIunimplemented\fR" 4 2120.ie n .IP "\fB\fB""Pm = 45""\fB\fR \fIunimplemented\fR" 4
1884.el .IP "\fB\f(CBPs = 45\fB\fR \fIunimplemented\fR" 4 2121.el .IP "\fB\f(CBPm = 45\fB\fR \fIunimplemented\fR" 4
1885.IX Item "Ps = 45 unimplemented" 2122.IX Item "Pm = 45 unimplemented"
1886.TS 2123.TS
1887l l . 2124l l .
1888h Reverse-wraparound Mode 2125h Reverse-wraparound Mode
1889l No Reverse-wraparound Mode 2126l No Reverse-wraparound Mode
1890.TE 2127.TE
1891 2128
1892.ie n .IP "\fB\fB""Ps = 46""\fB\fR \fIunimplemented\fR" 4 2129.ie n .IP "\fB\fB""Pm = 46""\fB\fR \fIunimplemented\fR" 4
1893.el .IP "\fB\f(CBPs = 46\fB\fR \fIunimplemented\fR" 4 2130.el .IP "\fB\f(CBPm = 46\fB\fR \fIunimplemented\fR" 4
1894.IX Item "Ps = 46 unimplemented" 2131.IX Item "Pm = 46 unimplemented"
1895.ie n .IP "\fB\fB""Ps = 47""\fB\fR" 4 2132.ie n .IP "\fB\fB""Pm = 47""\fB\fR" 4
1896.el .IP "\fB\f(CBPs = 47\fB\fR" 4 2133.el .IP "\fB\f(CBPm = 47\fB\fR" 4
1897.IX Item "Ps = 47" 2134.IX Item "Pm = 47"
1898.TS 2135.TS
1899l l . 2136l l .
1900h Use Alternate Screen Buffer 2137h Use Alternate Screen Buffer
1901l Use Normal Screen Buffer 2138l Use Normal Screen Buffer
1902.TE 2139.TE
1903 2140
1904.PD 2141.PD
1905 2142
1906.IX Xref "Priv66" 2143.IX Xref "Priv66"
1907.ie n .IP "\fB\fB""Ps = 66""\fB\fR" 4 2144.ie n .IP "\fB\fB""Pm = 66""\fB\fR" 4
1908.el .IP "\fB\f(CBPs = 66\fB\fR" 4 2145.el .IP "\fB\f(CBPm = 66\fB\fR" 4
1909.IX Item "Ps = 66" 2146.IX Item "Pm = 66"
1910.TS 2147.TS
1911l l . 2148l l .
1912h Application Keypad (DECPAM) == ESC = 2149h Application Keypad (DECPAM) == ESC =
1913l Normal Keypad (DECPNM) == ESC > 2150l Normal Keypad (DECPNM) == ESC >
1914.TE 2151.TE
1915 2152
1916.PD 0 2153.PD 0
1917.ie n .IP "\fB\fB""Ps = 67""\fB\fR" 4 2154.ie n .IP "\fB\fB""Pm = 67""\fB\fR" 4
1918.el .IP "\fB\f(CBPs = 67\fB\fR" 4 2155.el .IP "\fB\f(CBPm = 67\fB\fR" 4
1919.IX Item "Ps = 67" 2156.IX Item "Pm = 67"
1920.TS 2157.TS
1921l l . 2158l l .
1922h Backspace key sends BS (DECBKM) 2159h Backspace key sends BS (DECBKM)
1923l Backspace key sends DEL 2160l Backspace key sends DEL
1924.TE 2161.TE
1925 2162
1926.ie n .IP "\fB\fB""Ps = 1000""\fB\fR (X11 XTerm)" 4 2163.ie n .IP "\fB\fB""Pm = 1000""\fB\fR (X11 XTerm)" 4
1927.el .IP "\fB\f(CBPs = 1000\fB\fR (X11 XTerm)" 4 2164.el .IP "\fB\f(CBPm = 1000\fB\fR (X11 XTerm)" 4
1928.IX Item "Ps = 1000 (X11 XTerm)" 2165.IX Item "Pm = 1000 (X11 XTerm)"
1929.TS 2166.TS
1930l l . 2167l l .
1931h Send Mouse X & Y on button press and release. 2168h Send Mouse X & Y on button press and release.
1932l No mouse reporting. 2169l No mouse reporting.
1933.TE 2170.TE
1934 2171
1935.ie n .IP "\fB\fB""Ps = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4 2172.ie n .IP "\fB\fB""Pm = 1001""\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
1936.el .IP "\fB\f(CBPs = 1001\fB\fR (X11 XTerm) \fIunimplemented\fR" 4 2173.el .IP "\fB\f(CBPm = 1001\fB\fR (X11 XTerm) \fIunimplemented\fR" 4
1937.IX Item "Ps = 1001 (X11 XTerm) unimplemented" 2174.IX Item "Pm = 1001 (X11 XTerm) unimplemented"
1938.TS 2175.TS
1939l l . 2176l l .
1940h Use Hilite Mouse Tracking. 2177h Use Hilite Mouse Tracking.
1941l No mouse reporting. 2178l No mouse reporting.
1942.TE 2179.TE
1943 2180
1944.ie n .IP "\fB\fB""Ps = 1010""\fB\fR (\fBrxvt\fR)" 4 2181.ie n .IP "\fB\fB""Pm = 1010""\fB\fR (\fBrxvt\fR)" 4
1945.el .IP "\fB\f(CBPs = 1010\fB\fR (\fBrxvt\fR)" 4 2182.el .IP "\fB\f(CBPm = 1010\fB\fR (\fBrxvt\fR)" 4
1946.IX Item "Ps = 1010 (rxvt)" 2183.IX Item "Pm = 1010 (rxvt)"
1947.TS 2184.TS
1948l l . 2185l l .
1949h Don't scroll to bottom on TTY output 2186h Don't scroll to bottom on TTY output
1950l Scroll to bottom on TTY output 2187l Scroll to bottom on TTY output
1951.TE 2188.TE
1952 2189
1953.ie n .IP "\fB\fB""Ps = 1011""\fB\fR (\fBrxvt\fR)" 4 2190.ie n .IP "\fB\fB""Pm = 1011""\fB\fR (\fBrxvt\fR)" 4
1954.el .IP "\fB\f(CBPs = 1011\fB\fR (\fBrxvt\fR)" 4 2191.el .IP "\fB\f(CBPm = 1011\fB\fR (\fBrxvt\fR)" 4
1955.IX Item "Ps = 1011 (rxvt)" 2192.IX Item "Pm = 1011 (rxvt)"
1956.TS 2193.TS
1957l l . 2194l l .
1958h Scroll to bottom when a key is pressed 2195h Scroll to bottom when a key is pressed
1959l Don't scroll to bottom when a key is pressed 2196l Don't scroll to bottom when a key is pressed
1960.TE 2197.TE
1961 2198
1962.ie n .IP "\fB\fB""Ps = 1021""\fB\fR (\fBrxvt\fR)" 4 2199.ie n .IP "\fB\fB""Pm = 1021""\fB\fR (\fBrxvt\fR)" 4
1963.el .IP "\fB\f(CBPs = 1021\fB\fR (\fBrxvt\fR)" 4 2200.el .IP "\fB\f(CBPm = 1021\fB\fR (\fBrxvt\fR)" 4
1964.IX Item "Ps = 1021 (rxvt)" 2201.IX Item "Pm = 1021 (rxvt)"
1965.TS 2202.TS
1966l l . 2203l l .
1967h Bold/italic implies high intensity (see option -is) 2204h Bold/italic implies high intensity (see option -is)
1968l Font styles have no effect on intensity (Compile styles) 2205l Font styles have no effect on intensity (Compile styles)
1969.TE 2206.TE
1970 2207
1971.ie n .IP "\fB\fB""Ps = 1047""\fB\fR" 4 2208.ie n .IP "\fB\fB""Pm = 1047""\fB\fR" 4
1972.el .IP "\fB\f(CBPs = 1047\fB\fR" 4 2209.el .IP "\fB\f(CBPm = 1047\fB\fR" 4
1973.IX Item "Ps = 1047" 2210.IX Item "Pm = 1047"
1974.TS 2211.TS
1975l l . 2212l l .
1976h Use Alternate Screen Buffer 2213h Use Alternate Screen Buffer
1977l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it 2214l Use Normal Screen Buffer - clear Alternate Screen Buffer if returning from it
1978.TE 2215.TE
1979 2216
1980.ie n .IP "\fB\fB""Ps = 1048""\fB\fR" 4 2217.ie n .IP "\fB\fB""Pm = 1048""\fB\fR" 4
1981.el .IP "\fB\f(CBPs = 1048\fB\fR" 4 2218.el .IP "\fB\f(CBPm = 1048\fB\fR" 4
1982.IX Item "Ps = 1048" 2219.IX Item "Pm = 1048"
1983.TS 2220.TS
1984l l . 2221l l .
1985h Save cursor position 2222h Save cursor position
1986l Restore cursor position 2223l Restore cursor position
1987.TE 2224.TE
1988 2225
1989.ie n .IP "\fB\fB""Ps = 1049""\fB\fR" 4 2226.ie n .IP "\fB\fB""Pm = 1049""\fB\fR" 4
1990.el .IP "\fB\f(CBPs = 1049\fB\fR" 4 2227.el .IP "\fB\f(CBPm = 1049\fB\fR" 4
1991.IX Item "Ps = 1049" 2228.IX Item "Pm = 1049"
1992.TS 2229.TS
1993l l . 2230l l .
1994h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it 2231h Use Alternate Screen Buffer - clear Alternate Screen Buffer if switching to it
1995l Use Normal Screen Buffer 2232l Use Normal Screen Buffer
1996.TE 2233.TE
… …
2364disable this. 2601disable this.
2365.Sp 2602.Sp
2366A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly 2603A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2367in combination with other switches) is: 2604in combination with other switches) is:
2368.Sp 2605.Sp
2369.Vb 15 2606.Vb 16
2370\& MWM-hints 2607\& MWM-hints
2371\& EWMH-hints (pid, utf8 names) and protocols (ping) 2608\& EWMH-hints (pid, utf8 names) and protocols (ping)
2372\& seperate underline colour (-underlineColor) 2609\& seperate underline colour (-underlineColor)
2373\& settable border widths and borderless switch (-w, -b, -bl) 2610\& settable border widths and borderless switch (-w, -b, -bl)
2374\& visual depth selection (-depth) 2611\& visual depth selection (-depth)
… …
2380\& cursor blinking and underline cursor (-cb, -uc) 2617\& cursor blinking and underline cursor (-cb, -uc)
2381\& XEmbed support (-embed) 2618\& XEmbed support (-embed)
2382\& user-pty (-pty-fd) 2619\& user-pty (-pty-fd)
2383\& hold on exit (-hold) 2620\& hold on exit (-hold)
2384\& skip builtin block graphics (-sbg) 2621\& skip builtin block graphics (-sbg)
2622\& separate highlightcolor support (-hc)
2385.Ve 2623.Ve
2386.Sp 2624.Sp
2387It also enabled some non-essential features otherwise disabled, such as: 2625It also enables some non-essential features otherwise disabled, such as:
2388.Sp 2626.Sp
2389.Vb 11 2627.Vb 11
2390\& some round-trip time optimisations 2628\& some round-trip time optimisations
2391\& nearest color allocation on pseudocolor screens 2629\& nearest color allocation on pseudocolor screens
2392\& UTF8_STRING supporr for selection 2630\& UTF8_STRING supporr for selection
… …
2421.IX Item "--disable-new-selection" 2659.IX Item "--disable-new-selection"
2422Remove support for mouse selection style like that of xterm. 2660Remove support for mouse selection style like that of xterm.
2423.IP "\-\-enable\-dmalloc (default: off)" 4 2661.IP "\-\-enable\-dmalloc (default: off)" 4
2424.IX Item "--enable-dmalloc (default: off)" 2662.IX Item "--enable-dmalloc (default: off)"
2425Use Gray Watson's malloc \- which is good for debugging See 2663Use Gray Watson's malloc \- which is good for debugging See
2426http://www.letters.com/dmalloc/ for details If you use either this or the 2664<http://www.letters.com/dmalloc/> for details If you use either this or the
2427next option, you may need to edit src/Makefile after compiling to point 2665next option, you may need to edit src/Makefile after compiling to point
2428\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. 2666\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.
2429.Sp 2667.Sp
2430You can only use either this option and the following (should 2668You can only use either this option and the following (should
2431you use either) . 2669you use either) .

Diff Legend

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