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.70 by root, Thu Feb 2 00:31:47 2006 UTC vs.
Revision 1.73 by root, Tue Feb 21 01:00:40 2006 UTC

… …
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 7"
132.TH rxvt 7 "2006-02-02" "7.5" "RXVT-UNICODE" 132.TH rxvt 7 "2006-02-21" "7.6" "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
… …
879Rather than have rxvt-unicode try to accommodate all the various possible 879Rather than have rxvt-unicode try to accommodate all the various possible
880keyboard 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
881required for your particular machine. 881required for your particular machine.
882.Sh "Terminal Configuration" 882.Sh "Terminal Configuration"
883.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:
893.PP
894.Vb 2
895\& URxvt.cutchars: "()*,<>[]{}|'
896\& URxvt.print-pipe: cat >/tmp/xxx
897.Ve
898.PP
899These are just for testing stuff.
900.PP
901.Vb 2
902\& URxvt.imLocale: ja_JP.UTF-8
903\& URxvt.preeditType: OnTheSpot,None
904.Ve
905.PP
906This tells rxvt-unicode to use a special locale when communicating with
907the X Input Method, and also tells it to only use the OnTheSpot pre-edit
908type, which requires the \f(CW\*(C`xim\-onthespot\*(C'\fR perl extension but rewards me
909with correct-looking fonts.
910.PP
911.Vb 6
912\& URxvt.perl-lib: /root/lib/urxvt
913\& URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard
914\& URxvt.selection.pattern-0: ( at .*? line \e\ed+)
915\& URxvt.selection.pattern-1: ^(/[^:]+):\e
916\& URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\e\ed+):?$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
917\& URxvt.selection-autotransform.1: s/^ at (.*?) line (\e\ed+)$/:e \e\eQ$1\e\eE\e\ex0d:$2\e\ex0d/
918.Ve
919.PP
920This is my perl configuration. The first two set the perl library
921directory and also tells urxvt to use a large number of extensions. I
922develop for myself mostly, so I actually use most of the extensions I
923write.
924.PP
925The selection stuff mainly makes the selection perl-error-message aware
926and tells it to convert pelr error mssages into vi-commands to load the
927relevant file and go tot he error line number.
928.PP
929.Vb 2
930\& URxvt.scrollstyle: plain
931\& URxvt.secondaryScroll: true
932.Ve
933.PP
934As the documentation says: plain is the preferred scrollbar for the
935author. The \f(CW\*(C`secondaryScroll\*(C'\fR confgiures urxvt to scroll in full-screen
936apps, like screen, so lines scorlled out of screen end up in urxvt's
937scrollback buffer.
938.PP
939.Vb 7
940\& URxvt.background: #000000
941\& URxvt.foreground: gray90
942\& URxvt.color7: gray90
943\& URxvt.colorBD: #ffffff
944\& URxvt.cursorColor: #e0e080
945\& URxvt.throughColor: #8080f0
946\& URxvt.highlightColor: #f0f0f0
947.Ve
948.PP
949Some colours. Not sure which ones are being used or even non\-defaults, but
950these are in my .Xdefaults. Most notably, they set foreground/background
951to light gray/black, and also make sure that the colour 7 matches the
952default foreground colour.
953.PP
954.Vb 1
955\& URxvt.underlineColor: yellow
956.Ve
957.PP
958Another colour, makes underline lines look different. Sometimes hurts, but
959is mostly a nice effect.
960.PP
961.Vb 4
962\& URxvt.geometry: 154x36
963\& URxvt.loginShell: false
964\& URxvt.meta: ignore
965\& URxvt.utmpInhibit: true
966.Ve
967.PP
968Uh, well, should be mostly self\-explanatory. By specifying some defaults
969manually, I can quickly switch them for testing.
970.PP
971.Vb 1
972\& URxvt.saveLines: 8192
973.Ve
974.PP
975A large scrollback buffer is essential. Really.
976.PP
977.Vb 1
978\& URxvt.mapAlert: true
979.Ve
980.PP
981The only case I use it is for my \s-1IRC\s0 window, which I like to keep
982iconified till people msg me (which beeps).
983.PP
984.Vb 1
985\& URxvt.visualBell: true
986.Ve
987.PP
988The audible bell is often annoying, especially when in a crowd.
989.PP
990.Vb 1
991\& URxvt.insecure: true
992.Ve
993.PP
994Please don't hack my mutt! Ooops...
995.PP
996.Vb 1
997\& URxvt.pastableTabs: false
998.Ve
999.PP
1000I once thought this is a great idea.
1001.PP
1002.Vb 9
1003\& urxvt.font: 9x15bold,\e
1004\& -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\e
1005\& -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \e
1006\& [codeset=JISX0208]xft:Kochi Gothic, \e
1007\& xft:Bitstream Vera Sans Mono:autohint=true, \e
1008\& xft:Code2000:antialias=false
1009\& urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
1010\& urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
1011\& urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true
1012.Ve
1013.PP
1014I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
1015overwhelmed. A special note: the \f(CW\*(C`9x15bold\*(C'\fR mentioend above is actually
1016the version from XFree\-3.3, as XFree\-4 replaced it by a totally different
1017font (different glyphs for \f(CW\*(C`;\*(C'\fR and many other harmless characters),
1018while the second font is actually the \f(CW\*(C`9x15bold\*(C'\fR from XFree4/XOrg. The
1019bold version has less chars than the medium version, so I use it for rare
1020characters, too. Whene ditign sources with vim, I use italic for comments
1021and other stuff, which looks quite good with Bitstream Vera anti\-aliased.
1022.PP
1023Terminus is a quite bad font (many very wrong glyphs), but for most of my
1024purposes, it works, and gives a different look, as my normal (Non\-bold)
1025font is already bold, and I want to see a difference between bold and
1026normal fonts.
1027.PP
1028Please note that I used the \f(CW\*(C`urxvt\*(C'\fR instance name and not the \f(CW\*(C`URxvt\*(C'\fR
1029class name. Thats because I use different configs for different purposes,
1030for example, my \s-1IRC\s0 window is started with \f(CW\*(C`\-name IRC\*(C'\fR, and uses these
1031defaults:
1032.PP
1033.Vb 9
1034\& IRC*title: IRC
1035\& IRC*geometry: 87x12+535+542
1036\& IRC*saveLines: 0
1037\& IRC*mapAlert: true
1038\& IRC*font: suxuseuro
1039\& IRC*boldFont: suxuseuro
1040\& IRC*colorBD: white
1041\& IRC*keysym.M-C-1: command:\e033]710;suxuseuro\e007\e033]711;suxuseuro\e007
1042\& IRC*keysym.M-C-2: command:\e033]710;9x15bold\e007\e033]711;9x15bold\e007
1043.Ve
1044.PP
1045\&\f(CW\*(C`Alt\-Shift\-1\*(C'\fR and \f(CW\*(C`Alt\-Shift\-2\*(C'\fR switch between two different font
1046sizes. \f(CW\*(C`suxuseuro\*(C'\fR allows me to keep an eye (and actually read)
1047stuff while keeping a very small window. If somebody pastes something
1048complicated (e.g. japanese), I temporarily switch to a larger font.
1049.PP
1050The above is all in my \f(CW\*(C`.Xdefaults\*(C'\fR (I don't use \f(CW\*(C`.Xresources\*(C'\fR nor
1051\&\f(CW\*(C`xrdb\*(C'\fR). I also have some resources in a separate \f(CW\*(C`.Xdefaults\-hostname\*(C'\fR
1052file for different hosts, for example, on ym main desktop, I use:
1053.PP
1054.Vb 5
1055\& URxvt.keysym.C-M-q: command:\e033[3;5;5t
1056\& URxvt.keysym.C-M-y: command:\e033[3;5;606t
1057\& URxvt.keysym.C-M-e: command:\e033[3;1605;5t
1058\& URxvt.keysym.C-M-c: command:\e033[3;1605;606t
1059\& URxvt.keysym.C-M-p: perl:test
1060.Ve
1061.PP
1062The first for keysym definitions allow me to quickly bring some windows
1063in the layout I like most. Ion users might start laughing but will stop
1064immediately when I tell them that I use my own Fvwm2 module for much the
1065same effect as Ion provides, and I only very rarely use the above key
1066combinations :\->
1067.PP
884\fIWhy doesn't rxvt-unicode read my resources?\fR 1068\fIWhy doesn't rxvt-unicode read my resources?\fR
885.IX Subsection "Why doesn't rxvt-unicode read my resources?" 1069.IX Subsection "Why doesn't rxvt-unicode read my resources?"
886.PP 1070.PP
887Well, why, indeed? It does, in a way very similar to other X 1071Well, why, indeed? It does, in a way very similar to other X
888applications. Most importantly, this means that if you or your \s-1OS\s0 loads 1072applications. Most importantly, this means that if you or your \s-1OS\s0 loads
… …
1138.PP 1322.PP
1139You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except 1323You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except
1140for some locales where character width differs between program\- and 1324for some locales where character width differs between program\- and
1141rxvt\-unicode\-locales. 1325rxvt\-unicode\-locales.
1142.PP 1326.PP
1327\fII have problems getting my input method working.\fR
1328.IX Subsection "I have problems getting my input method working."
1329.PP
1330Try a search engine, as this is slightly different for every input method server.
1331.PP
1332Here is a checklist:
1333.IP "\- Make sure your locale \fIand\fR the imLocale are supported on your \s-1OS\s0." 4
1334.IX Item "- Make sure your locale and the imLocale are supported on your OS."
1335Try \f(CW\*(C`locale \-a\*(C'\fR or check the documentation for your \s-1OS\s0.
1336.IP "\- Make sure your locale or imLocale matches a locale supported by your \s-1XIM\s0." 4
1337.IX Item "- Make sure your locale or imLocale matches a locale supported by your XIM."
1338For example, \fBkinput2\fR does not support \s-1UTF\-8\s0 locales, you should use
1339\&\f(CW\*(C`ja_JP.EUC\-JP\*(C'\fR or equivalent.
1340.IP "\- Make sure your \s-1XIM\s0 server is actually running." 4
1341.IX Item "- Make sure your XIM server is actually running."
1342.PD 0
1343.ie n .IP "\- Make sure the ""XMODIFIERS""\fR environment variable is set correctly when \fIstarting rxvt\-unicode." 4
1344.el .IP "\- Make sure the \f(CWXMODIFIERS\fR environment variable is set correctly when \fIstarting\fR rxvt\-unicode." 4
1345.IX Item "- Make sure the XMODIFIERS environment variable is set correctly when starting rxvt-unicode."
1346.PD
1347When you want to use e.g. \fBkinput2\fR, it must be set to
1348\&\f(CW\*(C`@im=kinput2\*(C'\fR. For \fBscim\fR, use \f(CW\*(C`@im=SCIM\*(C'\fR. Youc an see what input
1349method servers are running with this command:
1350.Sp
1351.Vb 1
1352\& xprop -root XIM_SERVERS
1353.Ve
1354.IP "*" 4
1355.PP
1143\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR 1356\fIMy input method wants <some encoding> but I want \s-1UTF\-8\s0, what can I do?\fR
1144.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?" 1357.IX Subsection "My input method wants <some encoding> but I want UTF-8, what can I do?"
1145.PP 1358.PP
1146You can specify separate locales for the input method and the rest of the 1359You can specify separate locales for the input method and the rest of the
1147terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR: 1360terminal, using the resource \f(CW\*(C`imlocale\*(C'\fR:
… …
1149.Vb 1 1362.Vb 1
1150\& URxvt.imlocale: ja_JP.EUC-JP 1363\& URxvt.imlocale: ja_JP.EUC-JP
1151.Ve 1364.Ve
1152.PP 1365.PP
1153Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still 1366Now you can start your terminal with \f(CW\*(C`LC_CTYPE=ja_JP.UTF\-8\*(C'\fR and still
1154use your input method. Please note, however, that you will not be able to 1367use your input method. Please note, however, that, depending on your Xlib
1155input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a normal way then, as your input 1368version, you may not be able to input characters outside \f(CW\*(C`EUC\-JP\*(C'\fR in a
1156method limits you. 1369normal way then, as your input method limits you.
1157.PP 1370.PP
1158\fIRxvt-unicode crashes when the X Input Method changes or exits.\fR 1371\fIRxvt-unicode crashes when the X Input Method changes or exits.\fR
1159.IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits." 1372.IX Subsection "Rxvt-unicode crashes when the X Input Method changes or exits."
1160.PP 1373.PP
1161Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by 1374Unfortunately, this is unavoidable, as the \s-1XIM\s0 protocol is racy by
… …
2441.IX Item "--disable-new-selection" 2654.IX Item "--disable-new-selection"
2442Remove support for mouse selection style like that of xterm. 2655Remove support for mouse selection style like that of xterm.
2443.IP "\-\-enable\-dmalloc (default: off)" 4 2656.IP "\-\-enable\-dmalloc (default: off)" 4
2444.IX Item "--enable-dmalloc (default: off)" 2657.IX Item "--enable-dmalloc (default: off)"
2445Use Gray Watson's malloc \- which is good for debugging See 2658Use Gray Watson's malloc \- which is good for debugging See
2446http://www.letters.com/dmalloc/ for details If you use either this or the 2659<http://www.letters.com/dmalloc/> for details If you use either this or the
2447next option, you may need to edit src/Makefile after compiling to point 2660next option, you may need to edit src/Makefile after compiling to point
2448\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. 2661\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.
2449.Sp 2662.Sp
2450You can only use either this option and the following (should 2663You can only use either this option and the following (should
2451you use either) . 2664you use either) .

Diff Legend

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