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.72 by root, Wed Feb 22 10:42:49 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>
… …
413</p> 414</p>
414<h3><a name="can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></h3> 415<h3><a name="can_i_switch_the_fonts_at_runtime">Can I switch the fonts at runtime?</a></h3>
415<p>Yes, using an escape sequence. Try something like this, which has the same 416<p>Yes, using an escape sequence. Try something like this, which has the same
416effect as using the <code>-fn</code> switch, and takes effect immediately:</p> 417effect as using the <code>-fn</code> switch, and takes effect immediately:</p>
417<pre> 418<pre>
418 printf '\e]50;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre> 419 printf '\33]50;%s\007' &quot;9x15bold,xft:Kochi Gothic&quot;</pre>
419<p>This is useful if you e.g. work primarily with japanese (and prefer a 420<p>This is useful if you e.g. work primarily with japanese (and prefer a
420japanese font), but you have to switch to chinese temporarily, where 421japanese font), but you have to switch to chinese temporarily, where
421japanese fonts would only be in your way.</p> 422japanese fonts would only be in your way.</p>
422<p>You can think of this as a kind of manual ISO-2022 switching.</p> 423<p>You can think of this as a kind of manual ISO-2022 switching.</p>
423<p> 424<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>
736<p> 737<p>
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. It's certainly
745not <em>typical</em>, but what's typical...</p>
746<pre>
747 URxvt.cutchars: &quot;()*,&lt;&gt;[]{}|'
748 URxvt.print-pipe: cat &gt;/tmp/xxx</pre>
749<p>These are just for testing stuff.</p>
750<pre>
751 URxvt.imLocale: ja_JP.UTF-8
752 URxvt.preeditType: OnTheSpot,None</pre>
753<p>This tells rxvt-unicode to use a special locale when communicating with
754the X Input Method, and also tells it to only use the OnTheSpot pre-edit
755type, which requires the <code>xim-onthespot</code> perl extension but rewards me
756with correct-looking fonts.</p>
757<pre>
758 URxvt.perl-lib: /root/lib/urxvt
759 URxvt.perl-ext-common: default,selection-autotransform,selection-pastebin,xim-onthespot,remote-clipboard
760 URxvt.selection.pattern-0: ( at .*? line \\d+)
761 URxvt.selection.pattern-1: ^(/[^:]+):\
762 URxvt.selection-autotransform.0: s/^([^:[:space:]]+):(\\d+):?$/:e \\Q$1\\E\\x0d:$2\\x0d/
763 URxvt.selection-autotransform.1: s/^ at (.*?) line (\\d+)$/:e \\Q$1\\E\\x0d:$2\\x0d/</pre>
764<p>This is my perl configuration. The first two set the perl library
765directory and also tells urxvt to use a large number of extensions. I
766develop for myself mostly, so I actually use most of the extensions I
767write.</p>
768<p>The selection stuff mainly makes the selection perl-error-message aware
769and tells it to convert pelr error mssages into vi-commands to load the
770relevant file and go tot he error line number.</p>
771<pre>
772 URxvt.scrollstyle: plain
773 URxvt.secondaryScroll: true</pre>
774<p>As the documentation says: plain is the preferred scrollbar for the
775author. The <code>secondaryScroll</code> confgiures urxvt to scroll in full-screen
776apps, like screen, so lines scorlled out of screen end up in urxvt's
777scrollback buffer.</p>
778<pre>
779 URxvt.background: #000000
780 URxvt.foreground: gray90
781 URxvt.color7: gray90
782 URxvt.colorBD: #ffffff
783 URxvt.cursorColor: #e0e080
784 URxvt.throughColor: #8080f0
785 URxvt.highlightColor: #f0f0f0</pre>
786<p>Some colours. Not sure which ones are being used or even non-defaults, but
787these are in my .Xdefaults. Most notably, they set foreground/background
788to light gray/black, and also make sure that the colour 7 matches the
789default foreground colour.</p>
790<pre>
791 URxvt.underlineColor: yellow</pre>
792<p>Another colour, makes underline lines look different. Sometimes hurts, but
793is mostly a nice effect.</p>
794<pre>
795 URxvt.geometry: 154x36
796 URxvt.loginShell: false
797 URxvt.meta: ignore
798 URxvt.utmpInhibit: true</pre>
799<p>Uh, well, should be mostly self-explanatory. By specifying some defaults
800manually, I can quickly switch them for testing.</p>
801<pre>
802 URxvt.saveLines: 8192</pre>
803<p>A large scrollback buffer is essential. Really.</p>
804<pre>
805 URxvt.mapAlert: true</pre>
806<p>The only case I use it is for my IRC window, which I like to keep
807iconified till people msg me (which beeps).</p>
808<pre>
809 URxvt.visualBell: true</pre>
810<p>The audible bell is often annoying, especially when in a crowd.</p>
811<pre>
812 URxvt.insecure: true</pre>
813<p>Please don't hack my mutt! Ooops...</p>
814<pre>
815 URxvt.pastableTabs: false</pre>
816<p>I once thought this is a great idea.</p>
817<pre>
818 urxvt.font: 9x15bold,\
819 -misc-fixed-bold-r-normal--15-140-75-75-c-90-iso10646-1,\
820 -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1, \
821 [codeset=JISX0208]xft:Kochi Gothic, \
822 xft:Bitstream Vera Sans Mono:autohint=true, \
823 xft:Code2000:antialias=false
824 urxvt.boldFont: -xos4-terminus-bold-r-normal--14-140-72-72-c-80-iso8859-15
825 urxvt.italicFont: xft:Bitstream Vera Sans Mono:italic:autohint=true
826 urxvt.boldItalicFont: xft:Bitstream Vera Sans Mono:bold:italic:autohint=true</pre>
827<p>I wrote rxvt-unicode to be able to specify fonts exactly. So don't be
828overwhelmed. A special note: the <code>9x15bold</code> mentioend above is actually
829the version from XFree-3.3, as XFree-4 replaced it by a totally different
830font (different glyphs for <code>;</code> and many other harmless characters),
831while the second font is actually the <code>9x15bold</code> from XFree4/XOrg. The
832bold version has less chars than the medium version, so I use it for rare
833characters, too. Whene ditign sources with vim, I use italic for comments
834and other stuff, which looks quite good with Bitstream Vera anti-aliased.</p>
835<p>Terminus is a quite bad font (many very wrong glyphs), but for most of my
836purposes, it works, and gives a different look, as my normal (Non-bold)
837font is already bold, and I want to see a difference between bold and
838normal fonts.</p>
839<p>Please note that I used the <code>urxvt</code> instance name and not the <code>URxvt</code>
840class name. Thats because I use different configs for different purposes,
841for example, my IRC window is started with <code>-name IRC</code>, and uses these
842defaults:</p>
843<pre>
844 IRC*title: IRC
845 IRC*geometry: 87x12+535+542
846 IRC*saveLines: 0
847 IRC*mapAlert: true
848 IRC*font: suxuseuro
849 IRC*boldFont: suxuseuro
850 IRC*colorBD: white
851 IRC*keysym.M-C-1: command:\033]710;suxuseuro\007\033]711;suxuseuro\007
852 IRC*keysym.M-C-2: command:\033]710;9x15bold\007\033]711;9x15bold\007</pre>
853<p><code>Alt-Shift-1</code> and <code>Alt-Shift-2</code> switch between two different font
854sizes. <code>suxuseuro</code> allows me to keep an eye (and actually read)
855stuff while keeping a very small window. If somebody pastes something
856complicated (e.g. japanese), I temporarily switch to a larger font.</p>
857<p>The above is all in my <code>.Xdefaults</code> (I don't use <code>.Xresources</code> nor
858<code>xrdb</code>). I also have some resources in a separate <code>.Xdefaults-hostname</code>
859file for different hosts, for example, on ym main desktop, I use:</p>
860<pre>
861 URxvt.keysym.C-M-q: command:\033[3;5;5t
862 URxvt.keysym.C-M-y: command:\033[3;5;606t
863 URxvt.keysym.C-M-e: command:\033[3;1605;5t
864 URxvt.keysym.C-M-c: command:\033[3;1605;606t
865 URxvt.keysym.C-M-p: perl:test</pre>
866<p>The first for keysym definitions allow me to quickly bring some windows
867in the layout I like most. Ion users might start laughing but will stop
868immediately when I tell them that I use my own Fvwm2 module for much the
869same effect as Ion provides, and I only very rarely use the above key
870combinations :-&gt;</p>
871<p>
872</p>
738<h3><a name="why_doesn_t_rxvtunicode_read_my_resources">Why doesn't rxvt-unicode read my resources?</a></h3> 873<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 874<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 875applications. Most importantly, this means that if you or your OS loads
741resources into the X display (the right way to do it), rxvt-unicode will 876resources into the X display (the right way to do it), rxvt-unicode will
742ignore any resource files in your home directory. It will only read 877ignore any resource files in your home directory. It will only read
… …
866login script running within the rxvt-unicode window changes the locale to 1001login script running within the rxvt-unicode window changes the locale to
867something else, e.g. <code>en_GB.UTF-8</code>. Needless to say, this is not going to work.</p> 1002something else, e.g. <code>en_GB.UTF-8</code>. Needless to say, this is not going to work.</p>
868<p>The best thing is to fix your startup environment, as you will likely run 1003<p>The best thing is to fix your startup environment, as you will likely run
869into other problems. If nothing works you can try this in your .profile.</p> 1004into other problems. If nothing works you can try this in your .profile.</p>
870<pre> 1005<pre>
871 printf '\e]701;%s\007' &quot;$LC_CTYPE&quot;</pre> 1006 printf '\33]701;%s\007' &quot;$LC_CTYPE&quot;</pre>
872<p>If this doesn't work, then maybe you use a <code>LC_CTYPE</code> specification not 1007<p>If this doesn't work, then maybe you use a <code>LC_CTYPE</code> specification not
873supported on your systems. Some systems have a <code>locale</code> command which 1008supported on your systems. Some systems have a <code>locale</code> command which
874displays this (also, <code>perl -e0</code> can be used to check locale settings, as 1009displays this (also, <code>perl -e0</code> can be used to check locale settings, as
875it will complain loudly if it cannot set the locale). If it displays something 1010it will complain loudly if it cannot set the locale). If it displays something
876like:</p> 1011like:</p>
… …
917</p> 1052</p>
918<h3><a name="can_i_switch_locales_at_runtime">Can I switch locales at runtime?</a></h3> 1053<h3><a name="can_i_switch_locales_at_runtime">Can I switch locales at runtime?</a></h3>
919<p>Yes, using an escape sequence. Try something like this, which sets 1054<p>Yes, using an escape sequence. Try something like this, which sets
920rxvt-unicode's idea of <code>LC_CTYPE</code>.</p> 1055rxvt-unicode's idea of <code>LC_CTYPE</code>.</p>
921<pre> 1056<pre>
922 printf '\e]701;%s\007' ja_JP.SJIS</pre> 1057 printf '\33]701;%s\007' ja_JP.SJIS</pre>
923<p>See also the previous answer.</p> 1058<p>See also the previous answer.</p>
924<p>Sometimes this capability is rather handy when you want to work in 1059<p>Sometimes this capability is rather handy when you want to work in
925one locale (e.g. <code>de_DE.UTF-8</code>) but some programs don't support it 1060one locale (e.g. <code>de_DE.UTF-8</code>) but some programs don't support it
926(e.g. UTF-8). For example, I use this script to start <code>xjdic</code>, which 1061(e.g. UTF-8). For example, I use this script to start <code>xjdic</code>, which
927first switches to a locale supported by xjdic and back later:</p> 1062first switches to a locale supported by xjdic and back later:</p>
928<pre> 1063<pre>
929 printf '\e]701;%s\007' ja_JP.SJIS 1064 printf '\33]701;%s\007' ja_JP.SJIS
930 xjdic -js 1065 xjdic -js
931 printf '\e]701;%s\007' de_DE.UTF-8</pre> 1066 printf '\33]701;%s\007' de_DE.UTF-8</pre>
932<p>You can also use xterm's <code>luit</code> program, which usually works fine, except 1067<p>You can also use xterm's <code>luit</code> program, which usually works fine, except
933for some locales where character width differs between program- and 1068for some locales where character width differs between program- and
934rxvt-unicode-locales.</p> 1069rxvt-unicode-locales.</p>
935<p> 1070<p>
936</p> 1071</p>

Diff Legend

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