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

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.102 by root, Tue Jan 31 20:50:48 2006 UTC vs.
Revision 1.107 by root, Tue Jan 31 21:04:14 2006 UTC

… …
19all escape sequences, and other background information. 19all escape sequences, and other background information.
20 20
21The newest version of this document is also available on the World Wide Web at 21The newest version of this document is also available on the World Wide Web at
22L<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>. 22L<http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html>.
23 23
24=head1 FREQUENTLY ASKED QUESTIONS 24=head1 RXVT-UNICODE/URXVT FREQUENTLY ASKED QUESTIONS
25 25
26 26
27=head2 Meta, Features & Commandline Issues 27=head2 Meta, Features & Commandline Issues
28 28
29=head3 My question isn't answered here, can I ask a human? 29=head3 My question isn't answered here, can I ask a human?
… …
36 36
37Beginning with version 7.3, there is a perl extension that implements a 37Beginning with version 7.3, there is a perl extension that implements a
38simple tabbed terminal. It is installed by default, so any of these should 38simple tabbed terminal. It is installed by default, so any of these should
39give you tabs: 39give you tabs:
40 40
41 @@RXVT_NAME@@ -pe tabbed 41 @@URXVT_NAME@@ -pe tabbed
42 42
43 URxvt.perl-ext-common: default,tabbed 43 URxvt.perl-ext-common: default,tabbed
44 44
45It will also work fine with tabbing functionality of many window managers 45It will also work fine with tabbing functionality of many window managers
46or similar tabbing programs, and its embedding-features allow it to be 46or similar tabbing programs, and its embedding-features allow it to be
… …
50 50
51=head3 How do I know which rxvt-unicode version I'm using? 51=head3 How do I know which rxvt-unicode version I'm using?
52 52
53The version number is displayed with the usage (-h). Also the escape 53The version number is displayed with the usage (-h). Also the escape
54sequence C<ESC [ 8 n> sets the window title to the version number. When 54sequence C<ESC [ 8 n> sets the window title to the version number. When
55using the @@RXVT_NAME@@c client, the version displayed is that of the 55using the @@URXVT_NAME@@c client, the version displayed is that of the
56daemon. 56daemon.
57 57
58=head3 Rxvt-unicode uses gobs of memory, how can I reduce that? 58=head3 Rxvt-unicode uses gobs of memory, how can I reduce that?
59 59
60Rxvt-unicode tries to obey the rule of not charging you for something you 60Rxvt-unicode tries to obey the rule of not charging you for something you
… …
686 bytes per screen cell. For a 160x?? window this amounts to almost a 686 bytes per screen cell. For a 160x?? window this amounts to almost a
69kilobyte per line. A scrollback buffer of 10000 lines will then (if full) 69kilobyte per line. A scrollback buffer of 10000 lines will then (if full)
70use 10 Megabytes of memory. With C<--enable-unicode3> it gets worse, as 70use 10 Megabytes of memory. With C<--enable-unicode3> it gets worse, as
71rxvt-unicode then uses 8 bytes per screen cell. 71rxvt-unicode then uses 8 bytes per screen cell.
72 72
73=head3 How can I start @@RXVT_NAME@@d in a race-free way? 73=head3 How can I start @@URXVT_NAME@@d in a race-free way?
74 74
75Try C<@@RXVT_NAME@@d -f -o>, which tells @@RXVT_NAME@@d to open the 75Try C<@@URXVT_NAME@@d -f -o>, which tells @@URXVT_NAME@@d to open the
76display, create the listening socket and then fork. 76display, create the listening socket and then fork.
77 77
78=head3 How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc. 78=head3 How do I distinguish wether I'm running rxvt-unicode or a regular xterm? I need this to decide about setting colors etc.
79 79
80rxvt and rxvt-unicode always export the variable "COLORTERM", so you can 80The original rxvt and rxvt-unicode always export the variable "COLORTERM",
81check and see if that is set. Note that several programs, JED, slrn, 81so you can check and see if that is set. Note that several programs, JED,
82Midnight Commander automatically check this variable to decide whether or 82slrn, Midnight Commander automatically check this variable to decide
83not to use color. 83whether or not to use color.
84 84
85=head3 How do I set the correct, full IP address for the DISPLAY variable? 85=head3 How do I set the correct, full IP address for the DISPLAY variable?
86 86
87If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled 87If you've compiled rxvt-unicode with DISPLAY_IS_IP and have enabled
88insecure mode then it is possible to use the following shell script 88insecure mode then it is possible to use the following shell script
… …
125 125
126 text data bss drs rss filename 126 text data bss drs rss filename
127 98398 1664 24 15695 1824 rxvt --disable-everything 127 98398 1664 24 15695 1824 rxvt --disable-everything
128 188985 9048 66616 18222 1788 urxvt --disable-everything 128 188985 9048 66616 18222 1788 urxvt --disable-everything
129 129
130When you C<--enable-everything> (which _is_ unfair, as this involves xft 130When you C<--enable-everything> (which I<is> unfair, as this involves xft
131and full locale/XIM support which are quite bloaty inside libX11 and my 131and full locale/XIM support which are quite bloaty inside libX11 and my
132libc), the two diverge, but not unreasnobaly so. 132libc), the two diverge, but not unreasnobaly so.
133 133
134 text data bss drs rss filename 134 text data bss drs rss filename
135 163431 2152 24 20123 2060 rxvt --enable-everything 135 163431 2152 24 20123 2060 rxvt --enable-everything
… …
203descriptions for the programs mentioned and rxvt-unicode. Really, do it! 203descriptions for the programs mentioned and rxvt-unicode. Really, do it!
204 204
2051. Use inheritPixmap: 2051. Use inheritPixmap:
206 206
207 Esetroot wallpaper.jpg 207 Esetroot wallpaper.jpg
208 @@RXVT_NAME@@ -ip -tint red -sh 40 208 @@URXVT_NAME@@ -ip -tint red -sh 40
209 209
210That works. If you think it doesn't, you lack transparency and tinting 210That works. If you think it doesn't, you lack transparency and tinting
211support, or you are unable to read. 211support, or you are unable to read.
212 212
2132. Use a simple pixmap and emulate pseudo-transparency. This enables you 2132. Use a simple pixmap and emulate pseudo-transparency. This enables you
214to use effects other than tinting and shading: Just shade/tint/whatever 214to use effects other than tinting and shading: Just shade/tint/whatever
215your picture with gimp or any other tool: 215your picture with gimp or any other tool:
216 216
217 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm 217 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
218 @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background 218 @@URXVT_NAME@@ -pixmap background.xpm -pe automove-background
219 219
220That works. If you think it doesn't, you lack XPM and Perl support, or you 220That works. If you think it doesn't, you lack XPM and Perl support, or you
221are unable to read. 221are unable to read.
222 222
2233. Use an ARGB visual: 2233. Use an ARGB visual:
224 224
225 @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc 225 @@URXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
226 226
227This requires XFT support, and the support of your X-server. If that 227This requires XFT support, and the support of your X-server. If that
228doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't 228doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
229there yet, no matter what they claim. Rxvt-Unicode contains the neccessary 229there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
230bugfixes and workarounds for Xft and Xlib to make it work, but that 230bugfixes and workarounds for Xft and Xlib to make it work, but that
… …
388 URxvt.color12: #0000FF 388 URxvt.color12: #0000FF
389 URxvt.color13: #FF00FF 389 URxvt.color13: #FF00FF
390 URxvt.color14: #00FFFF 390 URxvt.color14: #00FFFF
391 URxvt.color15: #FFFFFF 391 URxvt.color15: #FFFFFF
392 392
393And here is a more complete set of non-standard colors described (not by 393And here is a more complete set of non-standard colors.
394me) as "pretty girly".
395 394
396 URxvt.cursorColor: #dc74d1 395 URxvt.cursorColor: #dc74d1
397 URxvt.pointerColor: #dc74d1 396 URxvt.pointerColor: #dc74d1
398 URxvt.background: #0e0e0e 397 URxvt.background: #0e0e0e
399 URxvt.foreground: #4ad5e1 398 URxvt.foreground: #4ad5e1
… …
409 URxvt.color13: #9e88f0 408 URxvt.color13: #9e88f0
410 URxvt.color6: #73f7ff 409 URxvt.color6: #73f7ff
411 URxvt.color14: #73f7ff 410 URxvt.color14: #73f7ff
412 URxvt.color7: #e1dddd 411 URxvt.color7: #e1dddd
413 URxvt.color15: #e1dddd 412 URxvt.color15: #e1dddd
413
414(They were described (not by me) as "pretty girly").
414 415
415=head3 Why do some characters look so much different than others? 416=head3 Why do some characters look so much different than others?
416 417
417See next entry. 418See next entry.
418 419
… …
431the font that the characters it claims to contain indeed look correct. 432the font that the characters it claims to contain indeed look correct.
432 433
433In that case, select a font of your taste and add it to the font list, 434In that case, select a font of your taste and add it to the font list,
434e.g.: 435e.g.:
435 436
436 @@RXVT_NAME@@ -fn basefont,font2,font3... 437 @@URXVT_NAME@@ -fn basefont,font2,font3...
437 438
438When rxvt-unicode sees a character, it will first look at the base 439When rxvt-unicode sees a character, it will first look at the base
439font. If the base font does not contain the character, it will go to the 440font. If the base font does not contain the character, it will go to the
440next font, and so on. Specifying your own fonts will also speed up this 441next font, and so on. Specifying your own fonts will also speed up this
441search and use less resources within rxvt-unicode and the X-server. 442search and use less resources within rxvt-unicode and the X-server.
… …
470B<perl-ext-common> resource to the empty string, which also keeps 471B<perl-ext-common> resource to the empty string, which also keeps
471rxvt-unicode from initialising perl, saving memory. 472rxvt-unicode from initialising perl, saving memory.
472 473
473If you only want to disable specific features, you first have to 474If you only want to disable specific features, you first have to
474identify which perl extension is responsible. For this, read the section 475identify which perl extension is responsible. For this, read the section
475B<PREPACKAGED EXTENSIONS> in the @@RXVT_NAME@@perl(3) manpage. For 476B<PREPACKAGED EXTENSIONS> in the @@URXVT_NAME@@perl(3) manpage. For
476example, to disable the B<selection-popup> and B<option-popup>, specify 477example, to disable the B<selection-popup> and B<option-popup>, specify
477this B<perl-ext-common> resource: 478this B<perl-ext-common> resource:
478 479
479 URxvt.perl-ext-common: default,-selection-popup,-option-popup 480 URxvt.perl-ext-common: default,-selection-popup,-option-popup
480 481
… …
558 559
559For starting a new rxvt-unicode: 560For starting a new rxvt-unicode:
560 561
561 # use Backspace = ^H 562 # use Backspace = ^H
562 $ stty erase ^H 563 $ stty erase ^H
563 $ @@RXVT_NAME@@ 564 $ @@URXVT_NAME@@
564 565
565 # use Backspace = ^? 566 # use Backspace = ^?
566 $ stty erase ^? 567 $ stty erase ^?
567 $ @@RXVT_NAME@@ 568 $ @@URXVT_NAME@@
568 569
569Toggle with C<ESC [ 36 h> / C<ESC [ 36 l>. 570Toggle with C<ESC [ 36 h> / C<ESC [ 36 l>.
570 571
571For an existing rxvt-unicode: 572For an existing rxvt-unicode:
572 573
… …
599 600
600There are some compile-time selections available via configure. Unless 601There are some compile-time selections available via configure. Unless
601you have run "configure" with the C<--disable-resources> option you can 602you have run "configure" with the C<--disable-resources> option you can
602use the `keysym' resource to alter the keystrings associated with keysyms. 603use the `keysym' resource to alter the keystrings associated with keysyms.
603 604
604Here's an example for a URxvt session started using C<@@RXVT_NAME@@ -name URxvt> 605Here's an example for a URxvt session started using C<@@URXVT_NAME@@ -name URxvt>
605 606
606 URxvt.keysym.Home: \033[1~ 607 URxvt.keysym.Home: \033[1~
607 URxvt.keysym.End: \033[4~ 608 URxvt.keysym.End: \033[4~
608 URxvt.keysym.C-apostrophe: \033<C-'> 609 URxvt.keysym.C-apostrophe: \033<C-'>
609 URxvt.keysym.C-slash: \033<C-/> 610 URxvt.keysym.C-slash: \033<C-/>
… …
687resource to set it: 688resource to set it:
688 689
689 URxvt.termName: rxvt 690 URxvt.termName: rxvt
690 691
691If you don't plan to use B<rxvt> (quite common...) you could also replace 692If you don't plan to use B<rxvt> (quite common...) you could also replace
692the rxvt terminfo file with the rxvt-unicode one. 693the rxvt terminfo file with the rxvt-unicode one and use C<TERM=rxvt>.
693 694
694=head3 C<tic> outputs some error when compiling the terminfo entry. 695=head3 C<tic> outputs some error when compiling the terminfo entry.
695 696
696Most likely it's the empty definition for C<enacs=>. Just replace it by 697Most likely it's the empty definition for C<enacs=>. Just replace it by
697C<enacs=\E[0@> and try again. 698C<enacs=\E[0@> and try again.
698 699
699=head3 C<bash>'s readline does not work correctly under @@RXVT_NAME@@. 700=head3 C<bash>'s readline does not work correctly under @@URXVT_NAME@@.
700 701
701See next entry. 702See next entry.
702 703
703=head3 I need a termcap file entry. 704=head3 I need a termcap file entry.
704 705
… …
1003 1004
1004At the time of this writing, cygwin didn't seem to support any multi-byte 1005At the time of this writing, cygwin didn't seem to support any multi-byte
1005encodings (you might try C<LC_CTYPE=C-UTF-8>), so you are likely limited 1006encodings (you might try C<LC_CTYPE=C-UTF-8>), so you are likely limited
1006to 8-bit encodings. 1007to 8-bit encodings.
1007 1008
1008=head1 RXVT TECHNICAL REFERENCE 1009=head1 RXVT-UNICODE TECHNICAL REFERENCE
1009 1010
1010=head1 DESCRIPTION 1011=head1 DESCRIPTION
1011 1012
1012The rest of this document describes various technical aspects of 1013The rest of this document describes various technical aspects of
1013B<rxvt-unicode>. First the description of supported command sequences, 1014B<rxvt-unicode>. First the description of supported command sequences,
… …
1911=begin table 1912=begin table
1912 1913
1913 4 Shift 1914 4 Shift
1914 8 Meta 1915 8 Meta
1915 16 Control 1916 16 Control
1916 32 Double Click I<(Rxvt extension)> 1917 32 Double Click I<(rxvt extension)>
1917 1918
1918=end table 1919=end table
1919 1920
1920Col = B<< C<< <x> - SPACE >> >> 1921Col = B<< C<< <x> - SPACE >> >>
1921 1922

Diff Legend

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