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

Comparing rxvt-unicode/doc/rxvt.7.man.in (file contents):
Revision 1.54 by root, Sat Jan 28 22:16:58 2006 UTC vs.
Revision 1.57 by root, Tue Jan 31 00:53:49 2006 UTC

… …
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-28" "7.4" "RXVT-UNICODE" 132.TH rxvt 7 "2006-01-31" "7.5" "RXVT-UNICODE"
133.SH "NAME" 133.SH "NAME"
134RXVT REFERENCE \- FAQ, command sequences and other background information 134RXVT 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
… …
151.SH "DESCRIPTION" 151.SH "DESCRIPTION"
152.IX Header "DESCRIPTION" 152.IX Header "DESCRIPTION"
153This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting 153This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting
154all escape sequences, and other background information. 154all escape sequences, and other background information.
155.PP 155.PP
156The newest version of this document is 156The newest version of this document is also available on the World Wide Web at
157also available on the World Wide Web at
158<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>. 157<http://cvs.schmorp.de/browse/*checkout*/rxvt\-unicode/doc/rxvt.7.html>.
159.SH "FREQUENTLY ASKED QUESTIONS" 158.SH "FREQUENTLY ASKED QUESTIONS"
160.IX Header "FREQUENTLY ASKED QUESTIONS" 159.IX Header "FREQUENTLY ASKED QUESTIONS"
161.IP "The new selection selects pieces that are too big, how can I select single words?" 4 160.IP "The new selection selects pieces that are too big, how can I select single words?" 4
162.IX Item "The new selection selects pieces that are too big, how can I select single words?" 161.IX Item "The new selection selects pieces that are too big, how can I select single words?"
… …
200other combination either by setting the \fBsearchable-scrollback\fR resource: 199other combination either by setting the \fBsearchable-scrollback\fR resource:
201.Sp 200.Sp
202.Vb 1 201.Vb 1
203\& URxvt.searchable-scrollback: CM-s 202\& URxvt.searchable-scrollback: CM-s
204.Ve 203.Ve
204.IP "The cursor moves when selecting text in the current input line, how do I switch this off?" 4
205.IX Item "The cursor moves when selecting text in the current input line, how do I switch this off?"
206.PD 0
207.IP "During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?" 4
208.IX Item "During rlogin/ssh/telnet/etc. sessions, clicking near the cursor outputs strange escape sequences, how do I fix this?"
209.PD
210These are caused by the \f(CW\*(C`readline\*(C'\fR perl extension. Under normal
211circumstances, it will move your cursor around when you click into the
212line that contains it. It tries hard not to do this at the wrong moment,
213but when running a program that doesn't parse cursor movements or in some
214cases during rlogin sessions, it fails to detect this properly.
215.Sp
216You can permamently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR
217extension:
218.Sp
219.Vb 1
220\& URxvt.perl-ext-common: default,-readline
221.Ve
222.IP "Why doesn't rxvt-unicode read my resources?" 4
223.IX Item "Why doesn't rxvt-unicode read my resources?"
224Well, why, indeed? It does, in a way very similar to other X
225applications. Most importantly, this means that if you or your \s-1OS\s0 loads
226resources into the X display (the right way to do it), rxvt-unicode will
227ignore any resource files in your home directory. It will only read
228\&\fI$HOME/.Xdefaults\fR when no resources are attached to the display.
229.Sp
230If you have or use an \fI$HOME/.Xresources\fR file, chances are that
231resources are loaded into your X\-server. In this case, you have to
232re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR).
233.Sp
234Also consider the form resources have to use:
235.Sp
236.Vb 1
237\& URxvt.resource: value
238.Ve
239.Sp
240If you want to use another form (there are lots of different ways of
241specifying resources), make sure you understand wether and why it
242works. If unsure, use the form above.
243.IP "I can't get transparency working, what am I doing wrong?" 4
244.IX Item "I can't get transparency working, what am I doing wrong?"
245First of all, transparency isn't officially supported in rxvt\-unicode, so
246you are mostly on your own. Do not bug the author about it (but you may
247bug everybody else). Also, if you can't get it working consider it a rite
248of passage: ... and you failed.
249.Sp
250Here are four ways to get transparency. \fBDo\fR read the manpage and option
251descriptions for the programs mentioned and rxvt\-unicode. Really, do it!
252.Sp
2531. Use inheritPixmap:
254.Sp
255.Vb 2
256\& Esetroot wallpaper.jpg
257\& @@RXVT_NAME@@ -ip -tint red -sh 40
258.Ve
259.Sp
260That works. If you think it doesn't, you lack transparency and tinting
261support, or you are unable to read.
262.Sp
2632. Use a simple pixmap and emulate pseudo\-transparency. This enables you
264to use effects other than tinting and shading: Just shade/tint/whatever
265your picture with gimp:
266.Sp
267.Vb 2
268\& convert wallpaper.jpg -blur 20x20 -modulate 30 background.xpm
269\& @@RXVT_NAME@@ -pixmap background.xpm -pe automove-background
270.Ve
271.Sp
272That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you
273are unable to read.
274.Sp
2753. Use an \s-1ARGB\s0 visual:
276.Sp
277.Vb 1
278\& @@RXVT_NAME@@ -depth 32 -fg grey90 -bg rgba:0000/0000/4444/cccc
279.Ve
280.Sp
281This requires \s-1XFT\s0 support, and the support of your X\-server. If that
282doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't
283there yet, no matter what they claim. Rxvt-Unicode contains the neccessary
284bugfixes and workarounds for Xft and Xlib to make it work, but that
285doesn't mean that your \s-1WM\s0 has the required kludges in place.
286.Sp
2874. Use xcompmgr and let it do the job:
288.Sp
289.Vb 2
290\& xprop -frame -f _NET_WM_WINDOW_OPACITY 32c \e
291\& -set _NET_WM_WINDOW_OPACITY 0xc0000000
292.Ve
293.Sp
294Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR
295by other values to change the degree of opacity. If it doesn't work and
296your server crashes, you got to keep the pieces.
205.IP "Isn't rxvt supposed to be small? Don't all those features bloat?" 4 297.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?" 298.IX Item "Isn't rxvt supposed to be small? Don't all those features bloat?"
207I often get asked about this, and I think, no, they didn't cause extra 299I often get asked about this, and I think, no, they didn't cause extra
208bloat. If you compare a minimal rxvt and a minimal urxvt, you can see 300bloat. If you compare a minimal rxvt and a minimal urxvt, you can see
209that the urxvt binary is larger (due to some encoding tables always being 301that the urxvt binary is larger (due to some encoding tables always being
… …
2165disable this. 2257disable this.
2166.Sp 2258.Sp
2167A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly 2259A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2168in combination with other switches) is: 2260in combination with other switches) is:
2169.Sp 2261.Sp
2170.Vb 18 2262.Vb 15
2171\& MWM-hints 2263\& MWM-hints
2172\& EWMH-hints (pid, utf8 names) and protocols (ping) 2264\& EWMH-hints (pid, utf8 names) and protocols (ping)
2173\& seperate underline colour (-underlineColor) 2265\& seperate underline colour (-underlineColor)
2174\& settable border widths and borderless switch (-w, -b, -bl) 2266\& settable border widths and borderless switch (-w, -b, -bl)
2175\& visual selection (-depth) 2267\& visual depth selection (-depth)
2176\& settable extra linespacing /-lsp) 2268\& settable extra linespacing /-lsp)
2177\& iso-14755-2 and -3, and visual feedback 2269\& iso-14755-2 and -3, and visual feedback
2178\& backindex and forwardindex escape sequence
2179\& window op and some xterm/OSC escape sequences
2180\& tripleclickwords (-tcw) 2270\& tripleclickwords (-tcw)
2181\& settable insecure mode (-insecure) 2271\& settable insecure mode (-insecure)
2182\& keysym remapping support 2272\& keysym remapping support
2183\& cursor blinking and underline cursor (-cb, -uc) 2273\& cursor blinking and underline cursor (-cb, -uc)
2184\& XEmbed support (-embed) 2274\& XEmbed support (-embed)
2185\& user-pty (-pty-fd) 2275\& user-pty (-pty-fd)
2186\& hold on exit (-hold) 2276\& hold on exit (-hold)
2187\& skip builtin block graphics (-sbg) 2277\& skip builtin block graphics (-sbg)
2278.Ve
2279.Sp
2280It also enabled some non-essential features otherwise disabled, such as:
2281.Sp
2282.Vb 11
2283\& some round-trip time optimisations
2284\& nearest color allocation on pseudocolor screens
2285\& UTF8_STRING supporr for selection
2188\& sgr modes 90..97 and 100..107 2286\& sgr modes 90..97 and 100..107
2287\& backindex and forwardindex escape sequences
2288\& view change/zero scorllback esacpe sequences
2289\& locale switching escape sequence
2290\& window op and some xterm/OSC escape sequences
2291\& rectangular selections
2292\& trailing space removal for selections
2293\& verbose X error handling
2189.Ve 2294.Ve
2190.IP "\-\-enable\-iso14755 (default: on)" 4 2295.IP "\-\-enable\-iso14755 (default: on)" 4
2191.IX Item "--enable-iso14755 (default: on)" 2296.IX Item "--enable-iso14755 (default: on)"
2192Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or 2297Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or
2193\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by 2298\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by

Diff Legend

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