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.51 by root, Wed Jan 25 21:48:47 2006 UTC vs.
Revision 1.54 by root, Tue Jan 31 00:25:16 2006 UTC

… …
54</p> 54</p>
55<hr /> 55<hr />
56<h1><a name="description">DESCRIPTION</a></h1> 56<h1><a name="description">DESCRIPTION</a></h1>
57<p>This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting 57<p>This document contains the FAQ, the RXVT TECHNICAL REFERENCE documenting
58all escape sequences, and other background information.</p> 58all escape sequences, and other background information.</p>
59<p>The newest version of this document is 59<p>The newest version of this document is also available on the World Wide Web at
60also available on the World Wide Web at
61<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p> 60<a href="http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html">http://cvs.schmorp.de/browse/*checkout*/rxvt-unicode/doc/rxvt.7.html</a>.</p>
62<p> 61<p>
63</p> 62</p>
64<hr /> 63<hr />
65<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1> 64<h1><a name="frequently_asked_questions">FREQUENTLY ASKED QUESTIONS</a></h1>
… …
119<dd> 118<dd>
120<pre> 119<pre>
121 URxvt.searchable-scrollback: CM-s</pre> 120 URxvt.searchable-scrollback: CM-s</pre>
122</dd> 121</dd>
123<p></p> 122<p></p>
123<dt><strong><a name="item_why_doesn_27t_rxvt_2dunicode_read_my_resources_3f">Why doesn't rxvt-unicode read my resources?</a></strong><br />
124</dt>
125<dd>
126Well, why, indeed? It does, in a way very similar to other X
127applications. Most importantly, this means that if you or your OS loads
128resources into the X display (the right way to do it), rxvt-unicode will
129ignore any resource files in your home directory. It will only read
130<em>$HOME/.Xdefaults</em> when no resources are attached to the display.
131</dd>
132<dd>
133<p>If you have or use an <em>$HOME/.Xresources</em> file, chances are that
134resources are loaded into your X-server. In this case, you have to
135re-login after every change (or run <em>xrdb -merge $HOME/.Xresources</em>).</p>
136</dd>
137<dd>
138<p>Also consider the form resources have to use:</p>
139</dd>
140<dd>
141<pre>
142 URxvt.resource: value</pre>
143</dd>
144<dd>
145<p>If you want to use another form (there are lots of different ways of
146specifying resources), make sure you understand wether and why it
147works. If unsure, use the form above.</p>
148</dd>
149<p></p>
150<dt><strong><a name="item_i_can_27t_get_transparency_working_2c_what_am_i_do">I can't get transparency working, what am I doing wrong?</a></strong><br />
151</dt>
152<dd>
153First of all, transparency isn't officially supported in rxvt-unicode, so
154you are mostly on your own. Do not bug the author about it (but you may
155bug everybody else). Also, if you can't get it working consider it a rite
156of passage: ... and you failed.
157</dd>
158<dd>
159<p>Here are four ways to get transparency. <strong>Do</strong> read the manpage and option
160descriptions for the programs mentioned and rxvt-unicode. Really, do it!</p>
161</dd>
162<dd>
163<p>1. Use inheritPixmap:</p>
164</dd>
165<dd>
166<pre>
167 Esetroot wallpaper.jpg
168 rxvt -ip -tint red -sh 40</pre>
169</dd>
170<dd>
171<p>That works. If you think it doesn't, you lack transparency and tinting
172support, or you are unable to read.</p>
173</dd>
174<dd>
175<p>2. Use a simple pixmap and emulate pseudo-transparency. This enables you
176to use effects other than tinting and shading: Just shade/tint/whatever
177your picture with gimp:</p>
178</dd>
179<dd>
180<pre>
181 convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
182 rxvt -pixmap background.xpm -pe automove-background</pre>
183</dd>
184<dd>
185<p>That works. If you think it doesn't, you lack XPM and Perl support, or you
186are unable to read.</p>
187</dd>
188<dd>
189<p>3. Use an ARGB visual:</p>
190</dd>
191<dd>
192<pre>
193 rxvt -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc</pre>
194</dd>
195<dd>
196<p>This requires XFT support, and the support of your X-server. If that
197doesn't work for you, blame Xorg and Keith Packard. ARGB visuals aren't
198there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
199bugfixes and workarounds for Xft and Xlib to make it work, but that
200doesn't mean that your WM has the required kludges in place.</p>
201</dd>
202<dd>
203<p>4. Use xcompmgr and let it do the job:</p>
204</dd>
205<dd>
206<pre>
207 xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \
208 -set _NET_WM_WINDOW_OPACITY 0xc0000000</pre>
209</dd>
210<dd>
211<p>Then click on a window you want to make transparent. Replace <code>0xc0000000</code>
212by other values to change the degree of opacity. If it doesn't work and
213your server crashes, you got to keep the pieces.</p>
214</dd>
215<p></p>
124<dt><strong><a name="item_isn_27t_rxvt_supposed_to_be_small_3f_don_27t_all_t">Isn't rxvt supposed to be small? Don't all those features bloat?</a></strong><br /> 216<dt><strong><a name="item_isn_27t_rxvt_supposed_to_be_small_3f_don_27t_all_t">Isn't rxvt supposed to be small? Don't all those features bloat?</a></strong><br />
125</dt> 217</dt>
126<dd> 218<dd>
127I often get asked about this, and I think, no, they didn't cause extra 219I often get asked about this, and I think, no, they didn't cause extra
128bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 220bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
… …
218</dd> 310</dd>
219<p></p> 311<p></p>
220<dt><strong><a name="item_does_it_support_tabs_2c_can_i_have_a_tabbed_rxvt_2">Does it support tabs, can I have a tabbed rxvt-unicode?</a></strong><br /> 312<dt><strong><a name="item_does_it_support_tabs_2c_can_i_have_a_tabbed_rxvt_2">Does it support tabs, can I have a tabbed rxvt-unicode?</a></strong><br />
221</dt> 313</dt>
222<dd> 314<dd>
223rxvt-unicode does not directly support tabs. It will work fine with 315Beginning with version 7.3, there is a perl extension that implements a
224tabbing functionality of many window managers or similar tabbing programs, 316simple tabbed terminal. It is installed by default, so any of these should
225and its embedding-features allow it to be embedded into other programs, 317give you tabs:
226as witnessed by <em>doc/rxvt-tabbed</em> or the upcoming <code>Gtk2::URxvt</code> perl 318</dd>
227module, which features a tabbed urxvt (murxvt) terminal as an example 319<dd>
228embedding application. 320<pre>
321 rxvt -pe tabbed</pre>
322</dd>
323<dd>
324<pre>
325 URxvt.perl-ext-common: default,tabbed</pre>
326</dd>
327<dd>
328<p>It will also work fine with tabbing functionality of many window managers
329or similar tabbing programs, and its embedding-features allow it to be
330embedded into other programs, as witnessed by <em>doc/rxvt-tabbed</em> or
331the upcoming <code>Gtk2::URxvt</code> perl module, which features a tabbed urxvt
332(murxvt) terminal as an example embedding application.</p>
229</dd> 333</dd>
230<p></p> 334<p></p>
231<dt><strong><a name="item_how_do_i_know_which_rxvt_2dunicode_version_i_27m_u">How do I know which rxvt-unicode version I'm using?</a></strong><br /> 335<dt><strong><a name="item_how_do_i_know_which_rxvt_2dunicode_version_i_27m_u">How do I know which rxvt-unicode version I'm using?</a></strong><br />
232</dt> 336</dt>
233<dd> 337<dd>
… …
1955<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr> 2059<tr><td>Ps = 46</td><td>Change Log File to Pt unimplemented</td></tr>
1956<tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr> 2060<tr><td>Ps = 49</td><td>Change default background colour to Pt.</td></tr>
1957<tr><td>Ps = 50</td><td>Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n</td></tr> 2061<tr><td>Ps = 50</td><td>Set fontset to Pt, with the following special values of Pt (rxvt) #+n change up n #-n change down n if n is missing of 0, a value of 1 is used empty change to font0 n change to font n</td></tr>
1958<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr> 2062<tr><td>Ps = 55</td><td>Log all scrollback buffer and all of screen to Pt</td></tr>
1959<tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).</td></tr> 2063<tr><td>Ps = 701</td><td>Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).</td></tr>
2064<tr><td>Ps = 702</td><td>Request version if Pt is ?, returning rxvt-unicode, the resource name, the major and minor version numbers, e.g. ESC ] 702 ; rxvt-unicode ; urxvt ; 7 ; 4 ST.</td></tr>
1960<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr> 2065<tr><td>Ps = 704</td><td>Change colour of italic characters to Pt</td></tr>
1961<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr> 2066<tr><td>Ps = 705</td><td>Change background pixmap tint colour to Pt (Compile transparency).</td></tr>
1962<tr><td>Ps = 706</td><td>Change colour of bold characters to Pt</td></tr> 2067<tr><td>Ps = 706</td><td>Change colour of bold characters to Pt</td></tr>
1963<tr><td>Ps = 707</td><td>Change colour of underlined characters to Pt</td></tr> 2068<tr><td>Ps = 707</td><td>Change colour of underlined characters to Pt</td></tr>
1964<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr> 2069<tr><td>Ps = 710</td><td>Set normal fontset to Pt. Same as Ps = 50.</td></tr>
… …
2411<pre> 2516<pre>
2412 MWM-hints 2517 MWM-hints
2413 EWMH-hints (pid, utf8 names) and protocols (ping) 2518 EWMH-hints (pid, utf8 names) and protocols (ping)
2414 seperate underline colour (-underlineColor) 2519 seperate underline colour (-underlineColor)
2415 settable border widths and borderless switch (-w, -b, -bl) 2520 settable border widths and borderless switch (-w, -b, -bl)
2416 visual selection (-depth) 2521 visual depth selection (-depth)
2417 settable extra linespacing /-lsp) 2522 settable extra linespacing /-lsp)
2418 iso-14755-2 and -3, and visual feedback 2523 iso-14755-2 and -3, and visual feedback
2419 backindex and forwardindex escape sequence
2420 window op and some xterm/OSC escape sequences
2421 tripleclickwords (-tcw) 2524 tripleclickwords (-tcw)
2422 settable insecure mode (-insecure) 2525 settable insecure mode (-insecure)
2423 keysym remapping support 2526 keysym remapping support
2424 cursor blinking and underline cursor (-cb, -uc) 2527 cursor blinking and underline cursor (-cb, -uc)
2425 XEmbed support (-embed) 2528 XEmbed support (-embed)
2426 user-pty (-pty-fd) 2529 user-pty (-pty-fd)
2427 hold on exit (-hold) 2530 hold on exit (-hold)
2428 skip builtin block graphics (-sbg) 2531 skip builtin block graphics (-sbg)</pre>
2532</dd>
2533<dd>
2534<p>It also enabled some non-essential features otherwise disabled, such as:</p>
2535</dd>
2536<dd>
2537<pre>
2538 some round-trip time optimisations
2539 nearest color allocation on pseudocolor screens
2540 UTF8_STRING supporr for selection
2429 sgr modes 90..97 and 100..107</pre> 2541 sgr modes 90..97 and 100..107
2542 backindex and forwardindex escape sequences
2543 view change/zero scorllback esacpe sequences
2544 locale switching escape sequence
2545 window op and some xterm/OSC escape sequences
2546 rectangular selections
2547 trailing space removal for selections
2548 verbose X error handling</pre>
2430</dd> 2549</dd>
2431<p></p> 2550<p></p>
2432<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br /> 2551<dt><strong><a name="item_iso14755">--enable-iso14755 (default: on)</a></strong><br />
2433</dt> 2552</dt>
2434<dd> 2553<dd>

Diff Legend

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