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.90 by root, Mon Jan 23 01:46:55 2006 UTC vs.
Revision 1.95 by root, Mon Jan 30 22:49:30 2006 UTC

… …
63extensions. Some extensions can also be configured, for example, 63extensions. Some extensions can also be configured, for example,
64scrollback search mode is triggered by B<M-s>. You can move it to any 64scrollback search mode is triggered by B<M-s>. You can move it to any
65other combination either by setting the B<searchable-scrollback> resource: 65other combination either by setting the B<searchable-scrollback> resource:
66 66
67 URxvt.searchable-scrollback: CM-s 67 URxvt.searchable-scrollback: CM-s
68
69=item Why doesn't rxvt-unicode read my resources?
70
71Well, why, indeed? It does, in a way very similar to other X
72applications. Most importantly, this means that if you or your OS loads
73resources into the X display (the right way to do it), rxvt-unicode will
74ignore any resource files in your home directory. It will only read
75F<$HOME/.Xdefaults> when no resources are attached to the display.
76
77If you have or use an F<$HOME/.Xresources> file, chances are that
78resources are loaded into your X-server. In this case, you have to
79re-login after every change (or run F<xrdb -merge $HOME/.Xresources>).
80
81Also consider the form resources have to use:
82
83 URxvt.resource: value
84
85If you want to use another form (there are lots of different ways of
86specifying resources), make sure you understand wether and why it
87works. If unsure, use the form above.
88
89=item I can't get transparency working, what am I doing wrong?
90
91First of all, transparency isn't officially supported in rxvt-unicode, so
92you are mostly on your own. Do not bug the author about it (but you may
93bug everybody else). Also, if you can't get it working consider it a rite
94of passage, and you failed.
95
96Here are three ways to get transparency. B<Do> read the manpage and option
97descriptions for the programs mentioned and rxvt-unicode. Really, do it!
98
991. Use inheritPixmap:
100
101 Esetroot wallpaper.jpg
102 @@RXVT_NAME@@ -ip -tint red -sh 40
103
104That works. If you think it doesn't, you lack transparency and tinting
105support, or you are unable to read.
106
1072. Use a simple pixmap and emulate pseudo-transparency. This enables you
108to use effects other than tinting and shading: Just shade/tint/whatever
109your picture with gimp:
110
111 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
112 @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
113
114That works. If you think it doesn't, you lack XPM and Perl support, or you
115are unable to read.
116
1173. Use an ARGB visual:
118
119 @@RXVT_NAME@@ -depth 432 -fg grey90 -bg rgba:0000/0000/0000/c000
120
121This requires XFT support, and support form your X-server. If that doesn't
122work for you, blame Xorg and Keith Packard. ARGB visuals aren't there yet,
123no matter what they claim. Rxvt-Unicode contains the neccessary bugfixes
124and workarounds for Xft and Xlib to make it work.
68 125
69=item Isn't rxvt supposed to be small? Don't all those features bloat? 126=item Isn't rxvt supposed to be small? Don't all those features bloat?
70 127
71I often get asked about this, and I think, no, they didn't cause extra 128I often get asked about this, and I think, no, they didn't cause extra
72bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 129bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
… …
142No large bloated libraries (of course, none were linked in statically), 199No large bloated libraries (of course, none were linked in statically),
143except maybe libX11 :) 200except maybe libX11 :)
144 201
145=item Does it support tabs, can I have a tabbed rxvt-unicode? 202=item Does it support tabs, can I have a tabbed rxvt-unicode?
146 203
147rxvt-unicode does not directly support tabs. It will work fine with 204Beginning with version 7.3, there is a perl extension that implements a
148tabbing functionality of many window managers or similar tabbing programs, 205simple tabbed terminal. It is installed by default, so any of these should
149and its embedding-features allow it to be embedded into other programs, 206give you tabs:
150as witnessed by F<doc/rxvt-tabbed> or the upcoming C<Gtk2::URxvt> perl 207
151module, which features a tabbed urxvt (murxvt) terminal as an example 208 @@RXVT_NAME@@ -pe tabbed
152embedding application. 209
210 URxvt.perl-ext-common: default,tabbed
211
212It will also work fine with tabbing functionality of many window managers
213or similar tabbing programs, and its embedding-features allow it to be
214embedded into other programs, as witnessed by F<doc/rxvt-tabbed> or
215the upcoming C<Gtk2::URxvt> perl module, which features a tabbed urxvt
216(murxvt) terminal as an example embedding application.
153 217
154=item How do I know which rxvt-unicode version I'm using? 218=item How do I know which rxvt-unicode version I'm using?
155 219
156The version number is displayed with the usage (-h). Also the escape 220The version number is displayed with the usage (-h). Also the escape
157sequence C<ESC [ 8 n> sets the window title to the version number. When 221sequence C<ESC [ 8 n> sets the window title to the version number. When
… …
1675 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented> 1739 B<< C<Ps = 46> >> Change Log File to B<< C<Pt> >> I<unimplemented>
1676 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>. 1740 B<< C<Ps = 49> >> Change default background colour to B<< C<Pt> >>.
1677 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >> 1741 B<< C<Ps = 50> >> Set fontset to B<< C<Pt> >>, with the following special values of B<< C<Pt> >> (B<rxvt>) B<< C<#+n> >> change up B<< C<n> >> B<< C<#-n> >> change down B<< C<n> >> if B<< C<n> >> is missing of 0, a value of 1 is used I<empty> change to font0 B<< C<n> >> change to font B<< C<n> >>
1678 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >> 1742 B<< C<Ps = 55> >> Log all scrollback buffer and all of screen to B<< C<Pt> >>
1679 B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills). 1743 B<< C<Ps = 701> >> Change current locale to B<< C<Pt> >>, or, if B<< C<Pt> >> is B<< C<?> >>, return the current locale (Compile frills).
1744 B<< C<Ps = 702> >> Request version if B<< C<Pt> >> is B<< C<?> >>, returning C<rxvt-unicode>, the resource name, the major and minor version numbers, e.g. C<ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST>.
1680 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >> 1745 B<< C<Ps = 704> >> Change colour of italic characters to B<< C<Pt> >>
1681 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency). 1746 B<< C<Ps = 705> >> Change background pixmap tint colour to B<< C<Pt> >> (Compile transparency).
1682 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >> 1747 B<< C<Ps = 706> >> Change colour of bold characters to B<< C<Pt> >>
1683 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >> 1748 B<< C<Ps = 707> >> Change colour of underlined characters to B<< C<Pt> >>
1684 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>. 1749 B<< C<Ps = 710> >> Set normal fontset to B<< C<Pt> >>. Same as C<Ps = 50>.
… …
2082 2147
2083 MWM-hints 2148 MWM-hints
2084 EWMH-hints (pid, utf8 names) and protocols (ping) 2149 EWMH-hints (pid, utf8 names) and protocols (ping)
2085 seperate underline colour (-underlineColor) 2150 seperate underline colour (-underlineColor)
2086 settable border widths and borderless switch (-w, -b, -bl) 2151 settable border widths and borderless switch (-w, -b, -bl)
2152 visual depth selection (-depth)
2087 settable extra linespacing /-lsp) 2153 settable extra linespacing /-lsp)
2088 iso-14755-2 and -3, and visual feedback 2154 iso-14755-2 and -3, and visual feedback
2089 backindex and forwardindex escape sequence
2090 window op and some xterm/OSC escape sequences
2091 tripleclickwords (-tcw) 2155 tripleclickwords (-tcw)
2092 settable insecure mode (-insecure) 2156 settable insecure mode (-insecure)
2093 keysym remapping support 2157 keysym remapping support
2094 cursor blinking and underline cursor (-cb, -uc) 2158 cursor blinking and underline cursor (-cb, -uc)
2095 XEmbed support (-embed) 2159 XEmbed support (-embed)
2096 user-pty (-pty-fd) 2160 user-pty (-pty-fd)
2097 hold on exit (-hold) 2161 hold on exit (-hold)
2098 skip builtin block graphics (-sbg) 2162 skip builtin block graphics (-sbg)
2163
2164It also enabled some non-essential features otherwise disabled, such as:
2165
2166 some round-trip time optimisations
2167 nearest color allocation on pseudocolor screens
2168 UTF8_STRING supporr for selection
2099 sgr modes 90..97 and 100..107 2169 sgr modes 90..97 and 100..107
2170 backindex and forwardindex escape sequences
2171 view change/zero scorllback esacpe sequences
2172 locale switching escape sequence
2173 window op and some xterm/OSC escape sequences
2174 rectangular selections
2175 trailing space removal for selections
2176 verbose X error handling
2100 2177
2101=item --enable-iso14755 (default: on) 2178=item --enable-iso14755 (default: on)
2102 2179
2103Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or 2180Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or
2104F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by 2181F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by

Diff Legend

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