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.72 by root, Thu Feb 2 18:04:45 2006 UTC vs.
Revision 1.75 by root, Wed Feb 22 10:42:49 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-22" "7.7" "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
… …
476.PP 476.PP
477Yes, 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
478effect 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:
479.PP 479.PP
480.Vb 1 480.Vb 1
481\& printf '\ee]50;%s\e007' "9x15bold,xft:Kochi Gothic" 481\& printf '\e33]50;%s\e007' "9x15bold,xft:Kochi Gothic"
482.Ve 482.Ve
483.PP 483.PP
484This 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
485japanese font), but you have to switch to chinese temporarily, where 485japanese font), but you have to switch to chinese temporarily, where
486japanese fonts would only be in your way. 486japanese fonts would only be in your way.
… …
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. 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 pelr error mssages 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 confgiures urxvt to scroll in full-screen
937apps, like screen, so lines scorlled 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 mentioend 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. Whene ditign 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
884\fIWhy doesn't rxvt-unicode read my resources?\fR 1069\fIWhy doesn't rxvt-unicode read my resources?\fR
885.IX Subsection "Why doesn't rxvt-unicode read my resources?" 1070.IX Subsection "Why doesn't rxvt-unicode read my resources?"
886.PP 1071.PP
887Well, 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
888applications. 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
… …
1051.PP 1236.PP
1052The best thing is to fix your startup environment, as you will likely run 1237The best thing is to fix your startup environment, as you will likely run
1053into other problems. If nothing works you can try this in your .profile. 1238into other problems. If nothing works you can try this in your .profile.
1054.PP 1239.PP
1055.Vb 1 1240.Vb 1
1056\& printf '\ee]701;%s\e007' "$LC_CTYPE" 1241\& printf '\e33]701;%s\e007' "$LC_CTYPE"
1057.Ve 1242.Ve
1058.PP 1243.PP
1059If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not 1244If this doesn't work, then maybe you use a \f(CW\*(C`LC_CTYPE\*(C'\fR specification not
1060supported on your systems. Some systems have a \f(CW\*(C`locale\*(C'\fR command which 1245supported on your systems. Some systems have a \f(CW\*(C`locale\*(C'\fR command which
1061displays this (also, \f(CW\*(C`perl \-e0\*(C'\fR can be used to check locale settings, as 1246displays this (also, \f(CW\*(C`perl \-e0\*(C'\fR can be used to check locale settings, as
… …
1118.PP 1303.PP
1119Yes, using an escape sequence. Try something like this, which sets 1304Yes, using an escape sequence. Try something like this, which sets
1120rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR. 1305rxvt\-unicode's idea of \f(CW\*(C`LC_CTYPE\*(C'\fR.
1121.PP 1306.PP
1122.Vb 1 1307.Vb 1
1123\& printf '\ee]701;%s\e007' ja_JP.SJIS 1308\& printf '\e33]701;%s\e007' ja_JP.SJIS
1124.Ve 1309.Ve
1125.PP 1310.PP
1126See also the previous answer. 1311See also the previous answer.
1127.PP 1312.PP
1128Sometimes this capability is rather handy when you want to work in 1313Sometimes this capability is rather handy when you want to work in
1129one locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support it 1314one locale (e.g. \f(CW\*(C`de_DE.UTF\-8\*(C'\fR) but some programs don't support it
1130(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which 1315(e.g. \s-1UTF\-8\s0). For example, I use this script to start \f(CW\*(C`xjdic\*(C'\fR, which
1131first switches to a locale supported by xjdic and back later: 1316first switches to a locale supported by xjdic and back later:
1132.PP 1317.PP
1133.Vb 3 1318.Vb 3
1134\& printf '\ee]701;%s\e007' ja_JP.SJIS 1319\& printf '\e33]701;%s\e007' ja_JP.SJIS
1135\& xjdic -js 1320\& xjdic -js
1136\& printf '\ee]701;%s\e007' de_DE.UTF-8 1321\& printf '\e33]701;%s\e007' de_DE.UTF-8
1137.Ve 1322.Ve
1138.PP 1323.PP
1139You can also use xterm's \f(CW\*(C`luit\*(C'\fR program, which usually works fine, except 1324You 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 1325for some locales where character width differs between program\- and
1141rxvt\-unicode\-locales. 1326rxvt\-unicode\-locales.

Diff Legend

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