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.74 by root, Tue Feb 21 11:34:05 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.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
… …
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

Diff Legend

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