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

Comparing rxvt-unicode/doc/rxvt.7.html (file contents):
Revision 1.69 by root, Thu Feb 2 15:22:19 2006 UTC vs.
Revision 1.70 by root, Tue Feb 21 01:00:40 2006 UTC

… …
69 </ul> 69 </ul>
70 70
71 <li><a href="#terminal_configuration">Terminal Configuration</a></li> 71 <li><a href="#terminal_configuration">Terminal Configuration</a></li>
72 <ul> 72 <ul>
73 73
74 <li><a href="#can_i_see_a_typical_configuration">Can I see a typical configuration?</a></li>
74 <li><a href="#why_doesn_t_rxvtunicode_read_my_resources">Why doesn't rxvt-unicode read my resources?</a></li> 75 <li><a href="#why_doesn_t_rxvtunicode_read_my_resources">Why doesn't rxvt-unicode read my resources?</a></li>
75 <li><a href="#when_i_login_to_another_system_it_tells_me_about_missing_terminfo_data">When I log-in to another system it tells me about missing terminfo data?</a></li> 76 <li><a href="#when_i_login_to_another_system_it_tells_me_about_missing_terminfo_data">When I log-in to another system it tells me about missing terminfo data?</a></li>
76 <li><a href="#tic_outputs_some_error_when_compiling_the_terminfo_entry_"><code>tic</code> outputs some error when compiling the terminfo entry.</a></li> 77 <li><a href="#tic_outputs_some_error_when_compiling_the_terminfo_entry_"><code>tic</code> outputs some error when compiling the terminfo entry.</a></li>
77 <li><a href="#bash_s_readline_does_not_work_correctly_under_urxvt_"><code>bash</code>'s readline does not work correctly under urxvt.</a></li> 78 <li><a href="#bash_s_readline_does_not_work_correctly_under_urxvt_"><code>bash</code>'s readline does not work correctly under urxvt.</a></li>
78 <li><a href="#i_need_a_termcap_file_entry_">I need a termcap file entry.</a></li> 79 <li><a href="#i_need_a_termcap_file_entry_">I need a termcap file entry.</a></li>
… …
731keyboard mappings, it is better to use `xmodmap' to remap the keys as 732keyboard mappings, it is better to use `xmodmap' to remap the keys as
732required for your particular machine.</p> 733required for your particular machine.</p>
733<p> 734<p>
734</p> 735</p>
735<h2><a name="terminal_configuration">Terminal Configuration</a></h2> 736<h2><a name="terminal_configuration">Terminal Configuration</a></h2>
737<p>
738</p>
739<h3><a name="can_i_see_a_typical_configuration">Can I see a typical configuration?</a></h3>
740<p>The default configuration tries to be xterm-like, which I don't like that
741much, but it's least surprise to regular users.</p>
742<p>As a rxvt or rxvt-unicode user, you are practically supposed to invest
743time into customising your terminal. To get you started, here is the
744author's .Xdefaults entries, with comments on what they do:</p>
745<pre>
746 URxvt.cutchars: &quot;()*,&lt;&gt;[]{}|'
747 URxvt.print-pipe: cat &gt;/tmp/xxx</pre>
748<p>These are just for testing stuff.</p>
749<pre>
750 URxvt.imLocale: ja_JP.UTF-8
751 URxvt.preeditType: OnTheSpot,None</pre>
752<p>This tells rxvt-unicode to use a special locale when communicating with
753the X Input Method, and also tells it to only use the OnTheSpot pre-edit
754type, which requires the <code>xim-onthespot</code> perl extension but rewards me
755with correct-looking fonts.</p>
756<pre>
757 URxvt.perl-lib: /root/lib/urxvt
758 URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard
759 URxvt.selection.pattern-0: ( at .*? line \\d+)
760 URxvt.selection.pattern-1: ^(/[^:]+):\
761 URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/
762 URxvt.selection-autotransform.1: s/^ at (.*?) line (\\d+)$/:e \\Q$1\\E\\x0d:$2\\x0d/</pre>
763<p>This is my perl configuration. The first two set the perl library
764directory and also tells urxvt to use a large number of extensions. I
765develop for myself mostly, so I actually use most of the extensions I
766write.</p>
767<p>The selection stuff mainly makes the selection perl-error-message aware
768and tells it to convert pelr error mssages into vi-commands to load the
769relevant file and go tot he error line number.</p>
770<pre>
771 URxvt.scrollstyle: plain
772 URxvt.secondaryScroll: true</pre>
773<p>As the documentation says: plain is the preferred scrollbar for the
774author. The <code>secondaryScroll</code> confgiures urxvt to scroll in full-screen
775apps, like screen, so lines scorlled out of screen end up in urxvt's
776scrollback buffer.</p>
777<pre>
778 URxvt.background: #000000
779 URxvt.foreground: gray90
780 URxvt.color7: gray90
781 URxvt.colorBD: #ffffff
782 URxvt.cursorColor: #e0e080
783 URxvt.throughColor: #8080f0
784 URxvt.highlightColor: #f0f0f0</pre>
785<p>Some colours. Not sure which ones are being used or even non-defaults, but
786these are in my .Xdefaults. Most notably, they set foreground/background
787to light gray/black, and also make sure that the colour 7 matches the
788default foreground colour.</p>
789<pre>
790 URxvt.underlineColor: yellow</pre>
791<p>Another colour, makes underline lines look different. Sometimes hurts, but
792is mostly a nice effect.</p>
793<pre>
794 URxvt.geometry: 154x36
795 URxvt.loginShell: false
796 URxvt.meta: ignore
797 URxvt.utmpInhibit: true</pre>
798<p>Uh, well, should be mostly self-explanatory. By specifying some defaults
799manually, I can quickly switch them for testing.</p>
800<pre>
801 URxvt.saveLines: 8192</pre>
802<p>A large scrollback buffer is essential. Really.</p>
803<pre>
804 URxvt.mapAlert: true</pre>
805<p>The only case I use it is for my IRC window, which I like to keep
806iconified till people msg me (which beeps).</p>
807<pre>
808 URxvt.visualBell: true</pre>
809<p>The audible bell is often annoying, especially when in a crowd.</p>
810<pre>
811 URxvt.insecure: true</pre>
812<p>Please don't hack my mutt! Ooops...</p>
813<pre>
814 URxvt.pastableTabs: false</pre>
815<p>I once thought this is a great idea.</p>
816<pre>
817 urxvt.font: 9x15bold,\
818 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
819 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
820 [codeset=JISX0208]xft:Kochi Gothic, \
821 xft:Bitstream Vera Sans Mono:autohint=true, \
822 xft:Code2000:antialias=false
823 urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
824 urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
825 urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true</pre>
826<p>I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
827overwhelmed. A special note: the <code>9x15bold</code> mentioend above is actually
828the version from XFree-3.3, as XFree-4 replaced it by a totally different
829font (different glyphs for <code>;</code> and many other harmless characters),
830while the second font is actually the <code>9x15bold</code> from XFree4/XOrg. The
831bold version has less chars than the medium version, so I use it for rare
832characters, too. Whene ditign sources with vim, I use italic for comments
833and other stuff, which looks quite good with Bitstream Vera anti-aliased.</p>
834<p>Terminus is a quite bad font (many very wrong glyphs), but for most of my
835purposes, it works, and gives a different look, as my normal (Non-bold)
836font is already bold, and I want to see a difference between bold and
837normal fonts.</p>
838<p>Please note that I used the <code>urxvt</code> instance name and not the <code>URxvt</code>
839class name. Thats because I use different configs for different purposes,
840for example, my IRC window is started with <code>-name IRC</code>, and uses these
841defaults:</p>
842<pre>
843 IRC*title: IRC
844 IRC*geometry: 87x12+535+542
845 IRC*saveLines: 0
846 IRC*mapAlert: true
847 IRC*font: suxuseuro
848 IRC*boldFont: suxuseuro
849 IRC*colorBD: white
850 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
851 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007</pre>
852<p><code>Alt-Shift-1</code> and <code>Alt-Shift-2</code> switch between two different font
853sizes. <code>suxuseuro</code> allows me to keep an eye (and actually read)
854stuff while keeping a very small window. If somebody pastes something
855complicated (e.g. japanese), I temporarily switch to a larger font.</p>
856<p>The above is all in my <code>.Xdefaults</code> (I don't use <code>.Xresources</code> nor
857<code>xrdb</code>). I also have some resources in a separate <code>.Xdefaults-hostname</code>
858file for different hosts, for example, on ym main desktop, I use:</p>
859<pre>
860 URxvt.keysym.C-M-q: command:\033[3;5;5t
861 URxvt.keysym.C-M-y: command:\033[3;5;606t
862 URxvt.keysym.C-M-e: command:\033[3;1605;5t
863 URxvt.keysym.C-M-c: command:\033[3;1605;606t
864 URxvt.keysym.C-M-p: perl:test</pre>
865<p>The first for keysym definitions allow me to quickly bring some windows
866in the layout I like most. Ion users might start laughing but will stop
867immediately when I tell them that I use my own Fvwm2 module for much the
868same effect as Ion provides, and I only very rarely use the above key
869combinations :-&gt;</p>
736<p> 870<p>
737</p> 871</p>
738<h3><a name="why_doesn_t_rxvtunicode_read_my_resources">Why doesn't rxvt-unicode read my resources?</a></h3> 872<h3><a name="why_doesn_t_rxvtunicode_read_my_resources">Why doesn't rxvt-unicode read my resources?</a></h3>
739<p>Well, why, indeed? It does, in a way very similar to other X 873<p>Well, why, indeed? It does, in a way very similar to other X
740applications. Most importantly, this means that if you or your OS loads 874applications. Most importantly, this means that if you or your OS loads

Diff Legend

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