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.60 by root, Tue Jan 31 20:50:48 2006 UTC vs.
Revision 1.61 by root, Tue Jan 31 20:57:29 2006 UTC

23 23
24 <li><a href="#my_question_isn_t_answered_here__can_i_ask_a_human">My question isn't answered here, can I ask a human?</a></li> 24 <li><a href="#my_question_isn_t_answered_here__can_i_ask_a_human">My question isn't answered here, can I ask a human?</a></li>
25 <li><a href="#does_it_support_tabs__can_i_have_a_tabbed_rxvtunicode">Does it support tabs, can I have a tabbed rxvt-unicode?</a></li> 25 <li><a href="#does_it_support_tabs__can_i_have_a_tabbed_rxvtunicode">Does it support tabs, can I have a tabbed rxvt-unicode?</a></li>
26 <li><a href="#how_do_i_know_which_rxvtunicode_version_i_m_using">How do I know which rxvt-unicode version I'm using?</a></li> 26 <li><a href="#how_do_i_know_which_rxvtunicode_version_i_m_using">How do I know which rxvt-unicode version I'm using?</a></li>
27 <li><a href="#rxvtunicode_uses_gobs_of_memory__how_can_i_reduce_that">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></li> 27 <li><a href="#rxvtunicode_uses_gobs_of_memory__how_can_i_reduce_that">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></li>
28 <li><a href="#how_can_i_start_rxvtd_in_a_racefree_way">How can I start rxvtd in a race-free way?</a></li> 28 <li><a href="#how_can_i_start_urxvtd_in_a_racefree_way">How can I start urxvtd in a race-free way?</a></li>
29 <li><a href="#how_do_i_distinguish_wether_i_m_running_rxvtunicode_or_a_regular_xterm_i_need_this_to_decide_about_setting_colors_etc_">How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</a></li> 29 <li><a href="#how_do_i_distinguish_wether_i_m_running_rxvtunicode_or_a_regular_xterm_i_need_this_to_decide_about_setting_colors_etc_">How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</a></li>
30 <li><a href="#how_do_i_set_the_correct__full_ip_address_for_the_display_variable">How do I set the correct, full IP address for the DISPLAY variable?</a></li> 30 <li><a href="#how_do_i_set_the_correct__full_ip_address_for_the_display_variable">How do I set the correct, full IP address for the DISPLAY variable?</a></li>
31 <li><a href="#how_do_i_compile_the_manual_pages_on_my_own">How do I compile the manual pages on my own?</a></li> 31 <li><a href="#how_do_i_compile_the_manual_pages_on_my_own">How do I compile the manual pages on my own?</a></li>
32 <li><a href="#isn_t_rxvtunicode_supposed_to_be_small_don_t_all_those_features_bloat">Isn't rxvt-unicode supposed to be small? Don't all those features bloat?</a></li> 32 <li><a href="#isn_t_rxvtunicode_supposed_to_be_small_don_t_all_those_features_bloat">Isn't rxvt-unicode supposed to be small? Don't all those features bloat?</a></li>
33 <li><a href="#why_c____isn_t_that_unportable_bloated_uncool">Why C++, isn't that unportable/bloated/uncool?</a></li> 33 <li><a href="#why_c____isn_t_that_unportable_bloated_uncool">Why C++, isn't that unportable/bloated/uncool?</a></li>
70 <ul> 70 <ul>
71 71
72 <li><a href="#why_doesn_t_rxvtunicode_read_my_resources">Why doesn't rxvt-unicode read my resources?</a></li> 72 <li><a href="#why_doesn_t_rxvtunicode_read_my_resources">Why doesn't rxvt-unicode read my resources?</a></li>
73 <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> 73 <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>
74 <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> 74 <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>
75 <li><a href="#bash_s_readline_does_not_work_correctly_under_rxvt_"><code>bash</code>'s readline does not work correctly under rxvt.</a></li> 75 <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>
76 <li><a href="#i_need_a_termcap_file_entry_">I need a termcap file entry.</a></li> 76 <li><a href="#i_need_a_termcap_file_entry_">I need a termcap file entry.</a></li>
77 <li><a href="#why_does_ls_no_longer_have_coloured_output">Why does <code>ls</code> no longer have coloured output?</a></li> 77 <li><a href="#why_does_ls_no_longer_have_coloured_output">Why does <code>ls</code> no longer have coloured output?</a></li>
78 <li><a href="#why_doesn_t_vim_emacs_etc__use_the_88_colour_mode">Why doesn't vim/emacs etc. use the 88 colour mode?</a></li> 78 <li><a href="#why_doesn_t_vim_emacs_etc__use_the_88_colour_mode">Why doesn't vim/emacs etc. use the 88 colour mode?</a></li>
79 <li><a href="#why_doesn_t_vim_emacs_etc__make_use_of_italic">Why doesn't vim/emacs etc. make use of italic?</a></li> 79 <li><a href="#why_doesn_t_vim_emacs_etc__make_use_of_italic">Why doesn't vim/emacs etc. make use of italic?</a></li>
80 <li><a href="#why_are_the_secondary_screenrelated_options_not_working_properly">Why are the secondary screen-related options not working properly?</a></li> 80 <li><a href="#why_are_the_secondary_screenrelated_options_not_working_properly">Why are the secondary screen-related options not working properly?</a></li>
166<h3><a name="does_it_support_tabs__can_i_have_a_tabbed_rxvtunicode">Does it support tabs, can I have a tabbed rxvt-unicode?</a></h3> 166<h3><a name="does_it_support_tabs__can_i_have_a_tabbed_rxvtunicode">Does it support tabs, can I have a tabbed rxvt-unicode?</a></h3>
167<p>Beginning with version 7.3, there is a perl extension that implements a 167<p>Beginning with version 7.3, there is a perl extension that implements a
168simple tabbed terminal. It is installed by default, so any of these should 168simple tabbed terminal. It is installed by default, so any of these should
169give you tabs:</p> 169give you tabs:</p>
170<pre> 170<pre>
171 rxvt -pe tabbed</pre> 171 urxvt -pe tabbed</pre>
172<pre> 172<pre>
173 URxvt.perl-ext-common: default,tabbed</pre> 173 URxvt.perl-ext-common: default,tabbed</pre>
174<p>It will also work fine with tabbing functionality of many window managers 174<p>It will also work fine with tabbing functionality of many window managers
175or similar tabbing programs, and its embedding-features allow it to be 175or similar tabbing programs, and its embedding-features allow it to be
176embedded into other programs, as witnessed by <em>doc/rxvt-tabbed</em> or 176embedded into other programs, as witnessed by <em>doc/rxvt-tabbed</em> or
179<p> 179<p>
180</p> 180</p>
181<h3><a name="how_do_i_know_which_rxvtunicode_version_i_m_using">How do I know which rxvt-unicode version I'm using?</a></h3> 181<h3><a name="how_do_i_know_which_rxvtunicode_version_i_m_using">How do I know which rxvt-unicode version I'm using?</a></h3>
182<p>The version number is displayed with the usage (-h). Also the escape 182<p>The version number is displayed with the usage (-h). Also the escape
183sequence <code>ESC [ 8 n</code> sets the window title to the version number. When 183sequence <code>ESC [ 8 n</code> sets the window title to the version number. When
184using the rxvtc client, the version displayed is that of the 184using the urxvtc client, the version displayed is that of the
185daemon.</p> 185daemon.</p>
186<p> 186<p>
187</p> 187</p>
188<h3><a name="rxvtunicode_uses_gobs_of_memory__how_can_i_reduce_that">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></h3> 188<h3><a name="rxvtunicode_uses_gobs_of_memory__how_can_i_reduce_that">Rxvt-unicode uses gobs of memory, how can I reduce that?</a></h3>
189<p>Rxvt-unicode tries to obey the rule of not charging you for something you 189<p>Rxvt-unicode tries to obey the rule of not charging you for something you
197kilobyte per line. A scrollback buffer of 10000 lines will then (if full) 197kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
198use 10 Megabytes of memory. With <code>--enable-unicode3</code> it gets worse, as 198use 10 Megabytes of memory. With <code>--enable-unicode3</code> it gets worse, as
199rxvt-unicode then uses 8 bytes per screen cell.</p> 199rxvt-unicode then uses 8 bytes per screen cell.</p>
200<p> 200<p>
201</p> 201</p>
202<h3><a name="how_can_i_start_rxvtd_in_a_racefree_way">How can I start rxvtd in a race-free way?</a></h3> 202<h3><a name="how_can_i_start_urxvtd_in_a_racefree_way">How can I start urxvtd in a race-free way?</a></h3>
203<p>Try <code>rxvtd -f -o</code>, which tells rxvtd to open the 203<p>Try <code>urxvtd -f -o</code>, which tells urxvtd to open the
204display, create the listening socket and then fork.</p> 204display, create the listening socket and then fork.</p>
205<p> 205<p>
206</p> 206</p>
207<h3><a name="how_do_i_distinguish_wether_i_m_running_rxvtunicode_or_a_regular_xterm_i_need_this_to_decide_about_setting_colors_etc_">How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</a></h3> 207<h3><a name="how_do_i_distinguish_wether_i_m_running_rxvtunicode_or_a_regular_xterm_i_need_this_to_decide_about_setting_colors_etc_">How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.</a></h3>
208<p>rxvt and rxvt-unicode always export the variable ``COLORTERM'', so you can 208<p>rxvt and rxvt-unicode always export the variable ``COLORTERM'', so you can
320<p>Here are four ways to get transparency. <strong>Do</strong> read the manpage and option 320<p>Here are four ways to get transparency. <strong>Do</strong> read the manpage and option
321descriptions for the programs mentioned and rxvt-unicode. Really, do it!</p> 321descriptions for the programs mentioned and rxvt-unicode. Really, do it!</p>
322<p>1. Use inheritPixmap:</p> 322<p>1. Use inheritPixmap:</p>
323<pre> 323<pre>
324 Esetroot wallpaper.jpg 324 Esetroot wallpaper.jpg
325 rxvt -ip -tint red -sh 40</pre> 325 urxvt -ip -tint red -sh 40</pre>
326<p>That works. If you think it doesn't, you lack transparency and tinting 326<p>That works. If you think it doesn't, you lack transparency and tinting
327support, or you are unable to read.</p> 327support, or you are unable to read.</p>
328<p>2. Use a simple pixmap and emulate pseudo-transparency. This enables you 328<p>2. Use a simple pixmap and emulate pseudo-transparency. This enables you
329to use effects other than tinting and shading: Just shade/tint/whatever 329to use effects other than tinting and shading: Just shade/tint/whatever
330your picture with gimp or any other tool:</p> 330your picture with gimp or any other tool:</p>
331<pre> 331<pre>
332 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 332 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
333 rxvt -pixmap background.xpm -pe automove-background</pre> 333 urxvt -pixmap background.xpm -pe automove-background</pre>
334<p>That works. If you think it doesn't, you lack XPM and Perl support, or you 334<p>That works. If you think it doesn't, you lack XPM and Perl support, or you
335are unable to read.</p> 335are unable to read.</p>
336<p>3. Use an ARGB visual:</p> 336<p>3. Use an ARGB visual:</p>
337<pre> 337<pre>
338 rxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc</pre> 338 urxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc</pre>
339<p>This requires XFT support, and the support of your X-server. If that 339<p>This requires XFT support, and the support of your X-server. If that
340doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't 340doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
341there yet, no matter what they claim. Rxvt-Unicode contains the neccessary 341there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
342bugfixes and workarounds for Xft and Xlib to make it work, but that 342bugfixes and workarounds for Xft and Xlib to make it work, but that
343doesn't mean that your WM has the required kludges in place.</p> 343doesn't mean that your WM has the required kludges in place.</p>
531 531
532In that case, select a font of your taste and add it to the font list, 532In that case, select a font of your taste and add it to the font list,
533e.g.:</pre> 533e.g.:</pre>
534<pre> 534<pre>
535 535
536 rxvt -fn basefont,font2,font3...</pre> 536 urxvt -fn basefont,font2,font3...</pre>
537<pre> 537<pre>
538 538
539When rxvt-unicode sees a character, it will first look at the base 539When rxvt-unicode sees a character, it will first look at the base
540font. If the base font does not contain the character, it will go to the 540font. If the base font does not contain the character, it will go to the
541next font, and so on. Specifying your own fonts will also speed up this 541next font, and so on. Specifying your own fonts will also speed up this
568<p>You can disable the perl extension completely by setting the 568<p>You can disable the perl extension completely by setting the
569<strong>perl-ext-common</strong> resource to the empty string, which also keeps 569<strong>perl-ext-common</strong> resource to the empty string, which also keeps
570rxvt-unicode from initialising perl, saving memory.</p> 570rxvt-unicode from initialising perl, saving memory.</p>
571<p>If you only want to disable specific features, you first have to 571<p>If you only want to disable specific features, you first have to
572identify which perl extension is responsible. For this, read the section 572identify which perl extension is responsible. For this, read the section
573<strong>PREPACKAGED EXTENSIONS</strong> in the <code>rxvtperl(3)</code> manpage. For 573<strong>PREPACKAGED EXTENSIONS</strong> in the <code>urxvtperl(3)</code> manpage. For
574example, to disable the <strong>selection-popup</strong> and <strong>option-popup</strong>, specify 574example, to disable the <strong>selection-popup</strong> and <strong>option-popup</strong>, specify
575this <strong>perl-ext-common</strong> resource:</p> 575this <strong>perl-ext-common</strong> resource:</p>
576<pre> 576<pre>
577 URxvt.perl-ext-common: default,-selection-popup,-option-popup</pre> 577 URxvt.perl-ext-common: default,-selection-popup,-option-popup</pre>
578<p>This will keep the default extensions, but disable the two popup 578<p>This will keep the default extensions, but disable the two popup
650be used (which may not be the same as your stty setting).</p> 650be used (which may not be the same as your stty setting).</p>
651<p>For starting a new rxvt-unicode:</p> 651<p>For starting a new rxvt-unicode:</p>
652<pre> 652<pre>
653 # use Backspace = ^H 653 # use Backspace = ^H
654 $ stty erase ^H 654 $ stty erase ^H
655 $ rxvt</pre> 655 $ urxvt</pre>
656<pre> 656<pre>
657 # use Backspace = ^? 657 # use Backspace = ^?
658 $ stty erase ^? 658 $ stty erase ^?
659 $ rxvt</pre> 659 $ urxvt</pre>
660<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code>.</p> 660<p>Toggle with <code>ESC [ 36 h</code> / <code>ESC [ 36 l</code>.</p>
661<p>For an existing rxvt-unicode:</p> 661<p>For an existing rxvt-unicode:</p>
662<pre> 662<pre>
663 # use Backspace = ^H 663 # use Backspace = ^H
664 $ stty erase ^H 664 $ stty erase ^H
683</p> 683</p>
684<h3><a name="i_don_t_like_the_keybindings__how_do_i_change_them">I don't like the key-bindings. How do I change them?</a></h3> 684<h3><a name="i_don_t_like_the_keybindings__how_do_i_change_them">I don't like the key-bindings. How do I change them?</a></h3>
685<p>There are some compile-time selections available via configure. Unless 685<p>There are some compile-time selections available via configure. Unless
686you have run ``configure'' with the <a href="#item__2d_2ddisable_2dresources"><code>--disable-resources</code></a> option you can 686you have run ``configure'' with the <a href="#item__2d_2ddisable_2dresources"><code>--disable-resources</code></a> option you can
687use the `keysym' resource to alter the keystrings associated with keysyms.</p> 687use the `keysym' resource to alter the keystrings associated with keysyms.</p>
688<p>Here's an example for a URxvt session started using <code>rxvt -name URxvt</code></p> 688<p>Here's an example for a URxvt session started using <code>urxvt -name URxvt</code></p>
689<pre> 689<pre>
690 URxvt.keysym.Home: \033[1~ 690 URxvt.keysym.Home: \033[1~
691 URxvt.keysym.End: \033[4~ 691 URxvt.keysym.End: \033[4~
692 URxvt.keysym.C-apostrophe: \033&lt;C-'&gt; 692 URxvt.keysym.C-apostrophe: \033&lt;C-'&gt;
693 URxvt.keysym.C-slash: \033&lt;C-/&gt; 693 URxvt.keysym.C-slash: \033&lt;C-/&gt;
769<h3><a name="tic_outputs_some_error_when_compiling_the_terminfo_entry_"><code>tic</code> outputs some error when compiling the terminfo entry.</a></h3> 769<h3><a name="tic_outputs_some_error_when_compiling_the_terminfo_entry_"><code>tic</code> outputs some error when compiling the terminfo entry.</a></h3>
770<p>Most likely it's the empty definition for <code>enacs=</code>. Just replace it by 770<p>Most likely it's the empty definition for <code>enacs=</code>. Just replace it by
771<code>enacs=\E[0@</code> and try again.</p> 771<code>enacs=\E[0@</code> and try again.</p>
772<p> 772<p>
773</p> 773</p>
774<h3><a name="bash_s_readline_does_not_work_correctly_under_rxvt_"><code>bash</code>'s readline does not work correctly under rxvt.</a></h3> 774<h3><a name="bash_s_readline_does_not_work_correctly_under_urxvt_"><code>bash</code>'s readline does not work correctly under urxvt.</a></h3>
775<p>See next entry.</p> 775<p>See next entry.</p>
776<p> 776<p>
777</p> 777</p>
778<h3><a name="i_need_a_termcap_file_entry_">I need a termcap file entry.</a></h3> 778<h3><a name="i_need_a_termcap_file_entry_">I need a termcap file entry.</a></h3>
779<p>One reason you might want this is that some distributions or operating 779<p>One reason you might want this is that some distributions or operating

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines