… | |
… | |
127 | .\} |
127 | .\} |
128 | .rm #[ #] #H #V #F C |
128 | .rm #[ #] #H #V #F C |
129 | .\" ======================================================================== |
129 | .\" ======================================================================== |
130 | .\" |
130 | .\" |
131 | .IX Title "rxvt 7" |
131 | .IX Title "rxvt 7" |
132 | .TH rxvt 7 "2006-01-25" "7.2" "RXVT-UNICODE" |
132 | .TH rxvt 7 "2006-01-30" "7.4" "RXVT-UNICODE" |
133 | .SH "NAME" |
133 | .SH "NAME" |
134 | RXVT REFERENCE \- FAQ, command sequences and other background information |
134 | RXVT REFERENCE \- FAQ, command sequences and other background information |
135 | .SH "SYNOPSIS" |
135 | .SH "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
136 | .IX Header "SYNOPSIS" |
137 | .Vb 2 |
137 | .Vb 2 |
… | |
… | |
200 | other combination either by setting the \fBsearchable-scrollback\fR resource: |
200 | other combination either by setting the \fBsearchable-scrollback\fR resource: |
201 | .Sp |
201 | .Sp |
202 | .Vb 1 |
202 | .Vb 1 |
203 | \& URxvt.searchable-scrollback: CM-s |
203 | \& URxvt.searchable-scrollback: CM-s |
204 | .Ve |
204 | .Ve |
|
|
205 | .IP "Why doesn't rxvt-unicode read my resources?" 4 |
|
|
206 | .IX Item "Why doesn't rxvt-unicode read my resources?" |
|
|
207 | Well, why, indeed? It does, in a way very similar to other X |
|
|
208 | applications. Most importantly, this means that if you or your \s-1OS\s0 loads |
|
|
209 | resources into the X display (the right way to do it), rxvt-unicode will |
|
|
210 | ignore any resource files in your home directory. It will only read |
|
|
211 | \&\fI$HOME/.Xdefaults\fR when no resources are attached to the display. |
|
|
212 | .Sp |
|
|
213 | If you have or use an \fI$HOME/.Xresources\fR file, chances are that |
|
|
214 | resources are loaded into your X\-server. In this case, you have to |
|
|
215 | re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR). |
|
|
216 | .Sp |
|
|
217 | Also consider the form resources have to use: |
|
|
218 | .Sp |
|
|
219 | .Vb 1 |
|
|
220 | \& URxvt.resource: value |
|
|
221 | .Ve |
|
|
222 | .Sp |
|
|
223 | If you want to use another form (there are lots of different ways of |
|
|
224 | specifying resources), make sure you understand wether and why it |
|
|
225 | works. If unsure, use the form above. |
|
|
226 | .IP "I can't get transparency working, what am I doing wrong?" 4 |
|
|
227 | .IX Item "I can't get transparency working, what am I doing wrong?" |
|
|
228 | First of all, transparency isn't officially supported in rxvt\-unicode, so |
|
|
229 | you are mostly on your own. Do not bug the author about it (but you may |
|
|
230 | bug everybody else). Also, if you can't get it working consider it a rite |
|
|
231 | of passage, and you failed. |
|
|
232 | .Sp |
|
|
233 | Here are three ways to get transparency. \fBDo\fR read the manpage and option |
|
|
234 | descriptions for the programs mentioned and rxvt\-unicode. Really, do it! |
|
|
235 | .Sp |
|
|
236 | 1. Use inheritPixmap: |
|
|
237 | .Sp |
|
|
238 | .Vb 2 |
|
|
239 | \& Esetroot wallpaper.jpg |
|
|
240 | \& @@RXVT_NAME@@ -ip -tint red -sh 40 |
|
|
241 | .Ve |
|
|
242 | .Sp |
|
|
243 | That works. If you think it doesn't, you lack transparency and tinting |
|
|
244 | support, or you are unable to read. |
|
|
245 | .Sp |
|
|
246 | 2. Use a simple pixmap and emulate pseudo\-transparency. This enables you |
|
|
247 | to use effects other than tinting and shading: Just shade/tint/whatever |
|
|
248 | your picture with gimp: |
|
|
249 | .Sp |
|
|
250 | .Vb 2 |
|
|
251 | \& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm |
|
|
252 | \& @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background |
|
|
253 | .Ve |
|
|
254 | .Sp |
|
|
255 | That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you |
|
|
256 | are unable to read. |
|
|
257 | .Sp |
|
|
258 | 3. Use an \s-1ARGB\s0 visual: |
|
|
259 | .Sp |
|
|
260 | .Vb 1 |
|
|
261 | \& @@RXVT_NAME@@ -depth 432 -fg grey90 -bg rgba:0000/0000/0000/c000 |
|
|
262 | .Ve |
|
|
263 | .Sp |
|
|
264 | This requires \s-1XFT\s0 support, and support form your X\-server. If that doesn't |
|
|
265 | work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't there yet, |
|
|
266 | no matter what they claim. Rxvt-Unicode contains the neccessary bugfixes |
|
|
267 | and workarounds for Xft and Xlib to make it work. |
205 | .IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4 |
268 | .IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4 |
206 | .IX Item "Isn't rxvt supposed to be small? Don't all those features bloat?" |
269 | .IX Item "Isn't rxvt supposed to be small? Don't all those features bloat?" |
207 | I often get asked about this, and I think, no, they didn't cause extra |
270 | I often get asked about this, and I think, no, they didn't cause extra |
208 | bloat. If you compare a minimal rxvt and a minimal urxvt, you can see |
271 | bloat. If you compare a minimal rxvt and a minimal urxvt, you can see |
209 | that the urxvt binary is larger (due to some encoding tables always being |
272 | that the urxvt binary is larger (due to some encoding tables always being |
… | |
… | |
284 | .Sp |
347 | .Sp |
285 | No large bloated libraries (of course, none were linked in statically), |
348 | No large bloated libraries (of course, none were linked in statically), |
286 | except maybe libX11 :) |
349 | except maybe libX11 :) |
287 | .IP "Does it support tabs, can I have a tabbed rxvt\-unicode?" 4 |
350 | .IP "Does it support tabs, can I have a tabbed rxvt\-unicode?" 4 |
288 | .IX Item "Does it support tabs, can I have a tabbed rxvt-unicode?" |
351 | .IX Item "Does it support tabs, can I have a tabbed rxvt-unicode?" |
289 | rxvt-unicode does not directly support tabs. It will work fine with |
352 | Beginning with version 7.3, there is a perl extension that implements a |
290 | tabbing functionality of many window managers or similar tabbing programs, |
353 | simple tabbed terminal. It is installed by default, so any of these should |
291 | and its embedding-features allow it to be embedded into other programs, |
354 | give you tabs: |
292 | as witnessed by \fIdoc/rxvt\-tabbed\fR or the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl |
355 | .Sp |
293 | module, which features a tabbed urxvt (murxvt) terminal as an example |
356 | .Vb 1 |
294 | embedding application. |
357 | \& @@RXVT_NAME@@ -pe tabbed |
|
|
358 | .Ve |
|
|
359 | .Sp |
|
|
360 | .Vb 1 |
|
|
361 | \& URxvt.perl-ext-common: default,tabbed |
|
|
362 | .Ve |
|
|
363 | .Sp |
|
|
364 | It will also work fine with tabbing functionality of many window managers |
|
|
365 | or similar tabbing programs, and its embedding-features allow it to be |
|
|
366 | embedded into other programs, as witnessed by \fIdoc/rxvt\-tabbed\fR or |
|
|
367 | the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl module, which features a tabbed urxvt |
|
|
368 | (murxvt) terminal as an example embedding application. |
295 | .IP "How do I know which rxvt-unicode version I'm using?" 4 |
369 | .IP "How do I know which rxvt-unicode version I'm using?" 4 |
296 | .IX Item "How do I know which rxvt-unicode version I'm using?" |
370 | .IX Item "How do I know which rxvt-unicode version I'm using?" |
297 | The version number is displayed with the usage (\-h). Also the escape |
371 | The version number is displayed with the usage (\-h). Also the escape |
298 | sequence \f(CW\*(C`ESC [ 8 n\*(C'\fR sets the window title to the version number. When |
372 | sequence \f(CW\*(C`ESC [ 8 n\*(C'\fR sets the window title to the version number. When |
299 | using the @@RXVT_NAME@@c client, the version displayed is that of the |
373 | using the @@RXVT_NAME@@c client, the version displayed is that of the |
… | |
… | |
1816 | Ps = 46 Change Log File to Pt unimplemented |
1890 | Ps = 46 Change Log File to Pt unimplemented |
1817 | Ps = 49 Change default background colour to Pt. |
1891 | Ps = 49 Change default background colour to Pt. |
1818 | Ps = 50 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 |
1892 | Ps = 50 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 |
1819 | Ps = 55 Log all scrollback buffer and all of screen to Pt |
1893 | Ps = 55 Log all scrollback buffer and all of screen to Pt |
1820 | Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). |
1894 | Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). |
|
|
1895 | Ps = 702 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. |
1821 | Ps = 704 Change colour of italic characters to Pt |
1896 | Ps = 704 Change colour of italic characters to Pt |
1822 | Ps = 705 Change background pixmap tint colour to Pt (Compile transparency). |
1897 | Ps = 705 Change background pixmap tint colour to Pt (Compile transparency). |
1823 | Ps = 706 Change colour of bold characters to Pt |
1898 | Ps = 706 Change colour of bold characters to Pt |
1824 | Ps = 707 Change colour of underlined characters to Pt |
1899 | Ps = 707 Change colour of underlined characters to Pt |
1825 | Ps = 710 Set normal fontset to Pt. Same as Ps = 50. |
1900 | Ps = 710 Set normal fontset to Pt. Same as Ps = 50. |
… | |
… | |
2153 | disable this. |
2228 | disable this. |
2154 | .Sp |
2229 | .Sp |
2155 | A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly |
2230 | A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly |
2156 | in combination with other switches) is: |
2231 | in combination with other switches) is: |
2157 | .Sp |
2232 | .Sp |
2158 | .Vb 17 |
2233 | .Vb 15 |
2159 | \& MWM-hints |
2234 | \& MWM-hints |
2160 | \& EWMH-hints (pid, utf8 names) and protocols (ping) |
2235 | \& EWMH-hints (pid, utf8 names) and protocols (ping) |
2161 | \& seperate underline colour (-underlineColor) |
2236 | \& seperate underline colour (-underlineColor) |
2162 | \& settable border widths and borderless switch (-w, -b, -bl) |
2237 | \& settable border widths and borderless switch (-w, -b, -bl) |
|
|
2238 | \& visual depth selection (-depth) |
2163 | \& settable extra linespacing /-lsp) |
2239 | \& settable extra linespacing /-lsp) |
2164 | \& iso-14755-2 and -3, and visual feedback |
2240 | \& iso-14755-2 and -3, and visual feedback |
2165 | \& backindex and forwardindex escape sequence |
|
|
2166 | \& window op and some xterm/OSC escape sequences |
|
|
2167 | \& tripleclickwords (-tcw) |
2241 | \& tripleclickwords (-tcw) |
2168 | \& settable insecure mode (-insecure) |
2242 | \& settable insecure mode (-insecure) |
2169 | \& keysym remapping support |
2243 | \& keysym remapping support |
2170 | \& cursor blinking and underline cursor (-cb, -uc) |
2244 | \& cursor blinking and underline cursor (-cb, -uc) |
2171 | \& XEmbed support (-embed) |
2245 | \& XEmbed support (-embed) |
2172 | \& user-pty (-pty-fd) |
2246 | \& user-pty (-pty-fd) |
2173 | \& hold on exit (-hold) |
2247 | \& hold on exit (-hold) |
2174 | \& skip builtin block graphics (-sbg) |
2248 | \& skip builtin block graphics (-sbg) |
|
|
2249 | .Ve |
|
|
2250 | .Sp |
|
|
2251 | It also enabled some non-essential features otherwise disabled, such as: |
|
|
2252 | .Sp |
|
|
2253 | .Vb 11 |
|
|
2254 | \& some round-trip time optimisations |
|
|
2255 | \& nearest color allocation on pseudocolor screens |
|
|
2256 | \& UTF8_STRING supporr for selection |
2175 | \& sgr modes 90..97 and 100..107 |
2257 | \& sgr modes 90..97 and 100..107 |
|
|
2258 | \& backindex and forwardindex escape sequences |
|
|
2259 | \& view change/zero scorllback esacpe sequences |
|
|
2260 | \& locale switching escape sequence |
|
|
2261 | \& window op and some xterm/OSC escape sequences |
|
|
2262 | \& rectangular selections |
|
|
2263 | \& trailing space removal for selections |
|
|
2264 | \& verbose X error handling |
2176 | .Ve |
2265 | .Ve |
2177 | .IP "\-\-enable\-iso14755 (default: on)" 4 |
2266 | .IP "\-\-enable\-iso14755 (default: on)" 4 |
2178 | .IX Item "--enable-iso14755 (default: on)" |
2267 | .IX Item "--enable-iso14755 (default: on)" |
2179 | Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or |
2268 | Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or |
2180 | \&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by |
2269 | \&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by |