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.71 by root, Thu Feb 2 15:22:19 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
… …
2470.IX Item "--disable-new-selection" 2654.IX Item "--disable-new-selection"
2471Remove support for mouse selection style like that of xterm. 2655Remove support for mouse selection style like that of xterm.
2472.IP "\-\-enable\-dmalloc (default: off)" 4 2656.IP "\-\-enable\-dmalloc (default: off)" 4
2473.IX Item "--enable-dmalloc (default: off)" 2657.IX Item "--enable-dmalloc (default: off)"
2474Use Gray Watson's malloc \- which is good for debugging See 2658Use Gray Watson's malloc \- which is good for debugging See
2475http://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
2476next 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
2477\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. 2661\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.
2478.Sp 2662.Sp
2479You can only use either this option and the following (should 2663You can only use either this option and the following (should
2480you use either) . 2664you use either) .

Diff Legend

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