… | |
… | |
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-16" "7.0" "RXVT-UNICODE" |
132 | .TH rxvt 7 "2006-01-31" "7.5" "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 |
… | |
… | |
151 | .SH "DESCRIPTION" |
151 | .SH "DESCRIPTION" |
152 | .IX Header "DESCRIPTION" |
152 | .IX Header "DESCRIPTION" |
153 | This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting |
153 | This document contains the \s-1FAQ\s0, the \s-1RXVT\s0 \s-1TECHNICAL\s0 \s-1REFERENCE\s0 documenting |
154 | all escape sequences, and other background information. |
154 | all escape sequences, and other background information. |
155 | .PP |
155 | .PP |
156 | The newest version of this document is |
156 | The newest version of this document is also available on the World Wide Web at |
157 | also 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 | .Sh "The new selection selects pieces that are too big, how can I select single words?" |
162 | .IX Item "The new selection selects pieces that are too big, how can I select single words?" |
161 | .IX Subsection "The new selection selects pieces that are too big, how can I select single words?" |
163 | Yes. For example, if you want to select alphanumeric words, you can use |
162 | Yes. For example, if you want to select alphanumeric words, you can use |
164 | the following resource: |
163 | the following resource: |
165 | .Sp |
164 | .PP |
166 | .Vb 1 |
165 | .Vb 1 |
167 | \& URxvt.selection.pattern-0: ([[:word:]]+) |
166 | \& URxvt.selection.pattern-0: ([[:word:]]+) |
168 | .Ve |
167 | .Ve |
169 | .Sp |
168 | .PP |
170 | If you click more than twice, the selection will be extended |
169 | If you click more than twice, the selection will be extended |
171 | more and more. |
170 | more and more. |
172 | .Sp |
171 | .PP |
173 | To get a selection that is very similar to the old code, try this pattern: |
172 | To get a selection that is very similar to the old code, try this pattern: |
174 | .Sp |
173 | .PP |
175 | .Vb 1 |
174 | .Vb 1 |
176 | \& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) |
175 | \& URxvt.selection.pattern-0: ([^"&'()*,;<=>?@[\e\e\e\e]^`{|})]+) |
177 | .Ve |
176 | .Ve |
178 | .Sp |
177 | .PP |
179 | Please also note that the \fILeftClick Shift-LeftClik\fR combination also |
178 | Please also note that the \fILeftClick Shift-LeftClik\fR combination also |
180 | selects words like the old code. |
179 | selects words like the old code. |
181 | .IP "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?" 4 |
180 | .IP "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?" 4 |
182 | .IX Item "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?" |
181 | .IX Item "I don't like the new selection/popups/hotkeys/perl, how do I change/disable it?" |
183 | You can disable the perl extension completely by setting the |
182 | You can disable the perl extension completely by setting the |
… | |
… | |
200 | other combination either by setting the \fBsearchable-scrollback\fR resource: |
199 | other 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 |
|
|
210 | These are caused by the \f(CW\*(C`readline\*(C'\fR perl extension. Under normal |
|
|
211 | circumstances, it will move your cursor around when you click into the |
|
|
212 | line that contains it. It tries hard not to do this at the wrong moment, |
|
|
213 | but when running a program that doesn't parse cursor movements or in some |
|
|
214 | cases during rlogin sessions, it fails to detect this properly. |
|
|
215 | .Sp |
|
|
216 | You can permamently switch this feature off by disabling the \f(CW\*(C`readline\*(C'\fR |
|
|
217 | extension: |
|
|
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?" |
|
|
224 | Well, why, indeed? It does, in a way very similar to other X |
|
|
225 | applications. Most importantly, this means that if you or your \s-1OS\s0 loads |
|
|
226 | resources into the X display (the right way to do it), rxvt-unicode will |
|
|
227 | ignore 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 |
|
|
230 | If you have or use an \fI$HOME/.Xresources\fR file, chances are that |
|
|
231 | resources are loaded into your X\-server. In this case, you have to |
|
|
232 | re-login after every change (or run \fIxrdb \-merge \f(CI$HOME\fI/.Xresources\fR). |
|
|
233 | .Sp |
|
|
234 | Also consider the form resources have to use: |
|
|
235 | .Sp |
|
|
236 | .Vb 1 |
|
|
237 | \& URxvt.resource: value |
|
|
238 | .Ve |
|
|
239 | .Sp |
|
|
240 | If you want to use another form (there are lots of different ways of |
|
|
241 | specifying resources), make sure you understand wether and why it |
|
|
242 | works. 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?" |
|
|
245 | First of all, transparency isn't officially supported in rxvt\-unicode, so |
|
|
246 | you are mostly on your own. Do not bug the author about it (but you may |
|
|
247 | bug everybody else). Also, if you can't get it working consider it a rite |
|
|
248 | of passage: ... and you failed. |
|
|
249 | .Sp |
|
|
250 | Here are four ways to get transparency. \fBDo\fR read the manpage and option |
|
|
251 | descriptions for the programs mentioned and rxvt\-unicode. Really, do it! |
|
|
252 | .Sp |
|
|
253 | 1. Use inheritPixmap: |
|
|
254 | .Sp |
|
|
255 | .Vb 2 |
|
|
256 | \& Esetroot wallpaper.jpg |
|
|
257 | \& @@RXVT_NAME@@ -ip -tint red -sh 40 |
|
|
258 | .Ve |
|
|
259 | .Sp |
|
|
260 | That works. If you think it doesn't, you lack transparency and tinting |
|
|
261 | support, or you are unable to read. |
|
|
262 | .Sp |
|
|
263 | 2. Use a simple pixmap and emulate pseudo\-transparency. This enables you |
|
|
264 | to use effects other than tinting and shading: Just shade/tint/whatever |
|
|
265 | your 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 |
|
|
272 | That works. If you think it doesn't, you lack \s-1XPM\s0 and Perl support, or you |
|
|
273 | are unable to read. |
|
|
274 | .Sp |
|
|
275 | 3. 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 |
|
|
281 | This requires \s-1XFT\s0 support, and the support of your X\-server. If that |
|
|
282 | doesn't work for you, blame Xorg and Keith Packard. \s-1ARGB\s0 visuals aren't |
|
|
283 | there yet, no matter what they claim. Rxvt-Unicode contains the neccessary |
|
|
284 | bugfixes and workarounds for Xft and Xlib to make it work, but that |
|
|
285 | doesn't mean that your \s-1WM\s0 has the required kludges in place. |
|
|
286 | .Sp |
|
|
287 | 4. 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 |
|
|
294 | Then click on a window you want to make transparent. Replace \f(CW0xc0000000\fR |
|
|
295 | by other values to change the degree of opacity. If it doesn't work and |
|
|
296 | your 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?" |
207 | I often get asked about this, and I think, no, they didn't cause extra |
299 | 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 |
300 | 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 |
301 | that the urxvt binary is larger (due to some encoding tables always being |
… | |
… | |
284 | .Sp |
376 | .Sp |
285 | No large bloated libraries (of course, none were linked in statically), |
377 | No large bloated libraries (of course, none were linked in statically), |
286 | except maybe libX11 :) |
378 | except maybe libX11 :) |
287 | .IP "Does it support tabs, can I have a tabbed rxvt\-unicode?" 4 |
379 | .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?" |
380 | .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 |
381 | Beginning with version 7.3, there is a perl extension that implements a |
290 | tabbing functionality of many window managers or similar tabbing programs, |
382 | 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, |
383 | give you tabs: |
292 | as witnessed by \fIdoc/rxvt\-tabbed\fR or the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl |
384 | .Sp |
293 | module, which features a tabbed urxvt (murxvt) terminal as an example |
385 | .Vb 1 |
294 | embedding application. |
386 | \& @@RXVT_NAME@@ -pe tabbed |
|
|
387 | .Ve |
|
|
388 | .Sp |
|
|
389 | .Vb 1 |
|
|
390 | \& URxvt.perl-ext-common: default,tabbed |
|
|
391 | .Ve |
|
|
392 | .Sp |
|
|
393 | It will also work fine with tabbing functionality of many window managers |
|
|
394 | or similar tabbing programs, and its embedding-features allow it to be |
|
|
395 | embedded into other programs, as witnessed by \fIdoc/rxvt\-tabbed\fR or |
|
|
396 | the upcoming \f(CW\*(C`Gtk2::URxvt\*(C'\fR perl module, which features a tabbed urxvt |
|
|
397 | (murxvt) terminal as an example embedding application. |
295 | .IP "How do I know which rxvt-unicode version I'm using?" 4 |
398 | .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?" |
399 | .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 |
400 | 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 |
401 | 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 |
402 | using the @@RXVT_NAME@@c client, the version displayed is that of the |
300 | daemon. |
403 | daemon. |
301 | .IP "I am using Debian GNU/Linux and have a problem..." 4 |
404 | .IP "I am using Debian GNU/Linux and have a problem..." 4 |
302 | .IX Item "I am using Debian GNU/Linux and have a problem..." |
405 | .IX Item "I am using Debian GNU/Linux and have a problem..." |
303 | The Debian GNU/Linux package of rxvt-unicode in sarge contains large |
406 | The Debian GNU/Linux package of rxvt-unicode in sarge contains large |
304 | patches that considerably change the behaviour of rxvt\-unicode. Before |
407 | patches that considerably change the behaviour of rxvt-unicode (but |
305 | reporting a bug to the original rxvt-unicode author please download and |
408 | unfortunately this notice has been removed). Before reporting a bug to |
306 | install the genuine version (<http://software.schmorp.de#rxvt\-unicode>) |
409 | the original rxvt-unicode author please download and install the genuine |
307 | and try to reproduce the problem. If you cannot, chances are that the |
410 | version (<http://software.schmorp.de#rxvt\-unicode>) and try to reproduce |
308 | problems are specific to Debian GNU/Linux, in which case it should be |
411 | the problem. If you cannot, chances are that the problems are specific to |
|
|
412 | Debian GNU/Linux, in which case it should be reported via the Debian Bug |
309 | reported via the Debian Bug Tracking System (use \f(CW\*(C`reportbug\*(C'\fR to report |
413 | Tracking System (use \f(CW\*(C`reportbug\*(C'\fR to report the bug). |
310 | the bug). |
|
|
311 | .Sp |
414 | .Sp |
312 | For other problems that also affect the Debian package, you can and |
415 | For other problems that also affect the Debian package, you can and |
313 | probably should use the Debian \s-1BTS\s0, too, because, after all, it's also a |
416 | probably should use the Debian \s-1BTS\s0, too, because, after all, it's also a |
314 | bug in the Debian version and it serves as a reminder for other users that |
417 | bug in the Debian version and it serves as a reminder for other users that |
315 | might encounter the same issue. |
418 | might encounter the same issue. |
… | |
… | |
332 | one with \f(CW\*(C`\-\-disable\-everything\*(C'\fR (very useful) and a maximal one with |
435 | one with \f(CW\*(C`\-\-disable\-everything\*(C'\fR (very useful) and a maximal one with |
333 | \&\f(CW\*(C`\-\-enable\-everything\*(C'\fR (less useful, it will be very big due to a lot of |
436 | \&\f(CW\*(C`\-\-enable\-everything\*(C'\fR (less useful, it will be very big due to a lot of |
334 | encodings built-in that increase download times and are rarely used). |
437 | encodings built-in that increase download times and are rarely used). |
335 | .IP "I need to make it setuid/setgid to support utmp/ptys on my \s-1OS\s0, is this safe?" 4 |
438 | .IP "I need to make it setuid/setgid to support utmp/ptys on my \s-1OS\s0, is this safe?" 4 |
336 | .IX Item "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?" |
439 | .IX Item "I need to make it setuid/setgid to support utmp/ptys on my OS, is this safe?" |
337 | Likely not. While I honestly try to make it secure, and am probably not |
440 | It should be, starting with release 7.1. You are encouraged to properly |
338 | bad at it, I think it is simply unreasonable to expect all of freetype |
441 | install urxvt with privileges necessary for your \s-1OS\s0 now. |
339 | + fontconfig + xft + xlib + perl + ... + rxvt-unicode itself to all be |
|
|
340 | secure. Also, rxvt-unicode disables some options when it detects that it |
|
|
341 | runs setuid or setgid, which is not nice. Besides, with the embedded perl |
|
|
342 | interpreter the possibility for security problems easily multiplies. |
|
|
343 | .Sp |
442 | .Sp |
344 | Elevated privileges are only required for utmp and pty operations on some |
443 | When rxvt-unicode detects that it runs setuid or setgid, it will fork |
345 | systems (for example, GNU/Linux doesn't need any extra privileges for |
444 | into a helper process for privileged operations (pty handling on some |
346 | ptys, but some need it for utmp support). It is planned to mvoe this into |
445 | systems, utmp/wtmp/lastlog handling on others) and drop privileges |
347 | a forked handler process, but this is not yet done. |
446 | immediately. This is much safer than most other terminals that keep |
|
|
447 | privileges while running (but is more relevant to urxvt, as it contains |
|
|
448 | things as perl interpreters, which might be \*(L"helpful\*(R" to attackers). |
348 | .Sp |
449 | .Sp |
349 | So, while setuid/setgid operation is supported and not a problem on your |
450 | This forking is done as the very first within \fImain()\fR, which is very early |
350 | typical single-user-no-other-logins unix desktop, always remember that |
451 | and reduces possible bugs to initialisation code run before \fImain()\fR, or |
351 | its an awful lot of code, most of which isn't checked for security issues |
452 | things like the dynamic loader of your system, which should result in very |
352 | regularly. |
453 | little risk. |
353 | .IP "When I log-in to another system it tells me about missing terminfo data?" 4 |
454 | .IP "When I log-in to another system it tells me about missing terminfo data?" 4 |
354 | .IX Item "When I log-in to another system it tells me about missing terminfo data?" |
455 | .IX Item "When I log-in to another system it tells me about missing terminfo data?" |
355 | The terminal description used by rxvt-unicode is not as widely available |
456 | The terminal description used by rxvt-unicode is not as widely available |
356 | as that for xterm, or even rxvt (for which the same problem often arises). |
457 | as that for xterm, or even rxvt (for which the same problem often arises). |
357 | .Sp |
458 | .Sp |
… | |
… | |
1058 | .IX Header "RXVT TECHNICAL REFERENCE" |
1159 | .IX Header "RXVT TECHNICAL REFERENCE" |
1059 | .SH "DESCRIPTION" |
1160 | .SH "DESCRIPTION" |
1060 | .IX Header "DESCRIPTION" |
1161 | .IX Header "DESCRIPTION" |
1061 | The rest of this document describes various technical aspects of |
1162 | The rest of this document describes various technical aspects of |
1062 | \&\fBrxvt-unicode\fR. First the description of supported command sequences, |
1163 | \&\fBrxvt-unicode\fR. First the description of supported command sequences, |
1063 | followed by menu and pixmap support and last by a description of all |
1164 | followed by pixmap support and last by a description of all features |
1064 | features selectable at \f(CW\*(C`configure\*(C'\fR time. |
1165 | selectable at \f(CW\*(C`configure\*(C'\fR time. |
1065 | .SH "Definitions" |
1166 | .SH "Definitions" |
1066 | .IX Header "Definitions" |
1167 | .IX Header "Definitions" |
1067 | .ie n .IP "\fB\fB""c""\fB\fR" 4 |
1168 | .ie n .IP "\fB\fB""c""\fB\fR" 4 |
1068 | .el .IP "\fB\f(CBc\fB\fR" 4 |
1169 | .el .IP "\fB\f(CBc\fB\fR" 4 |
1069 | .IX Item "c" |
1170 | .IX Item "c" |
… | |
… | |
1811 | Ps = 12 Change colour of text cursor foreground to Pt |
1912 | Ps = 12 Change colour of text cursor foreground to Pt |
1812 | Ps = 13 Change colour of mouse foreground to Pt |
1913 | Ps = 13 Change colour of mouse foreground to Pt |
1813 | Ps = 17 Change colour of highlight characters to Pt |
1914 | Ps = 17 Change colour of highlight characters to Pt |
1814 | Ps = 18 Change colour of bold characters to Pt [deprecated, see 706] |
1915 | Ps = 18 Change colour of bold characters to Pt [deprecated, see 706] |
1815 | Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707] |
1916 | Ps = 19 Change colour of underlined characters to Pt [deprecated, see 707] |
1816 | Ps = 20 Change default background to Pt |
1917 | Ps = 20 Change background pixmap parameters (see section XPM) (Compile XPM). |
1817 | Ps = 39 Change default foreground colour to Pt. |
1918 | Ps = 39 Change default foreground colour to Pt. |
1818 | Ps = 46 Change Log File to Pt unimplemented |
1919 | Ps = 46 Change Log File to Pt unimplemented |
1819 | Ps = 49 Change default background colour to Pt. |
1920 | Ps = 49 Change default background colour to Pt. |
1820 | 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 |
1921 | 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 |
1821 | Ps = 55 Log all scrollback buffer and all of screen to Pt |
1922 | Ps = 55 Log all scrollback buffer and all of screen to Pt |
1822 | Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). |
1923 | Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). |
|
|
1924 | 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. |
1823 | Ps = 704 Change colour of italic characters to Pt |
1925 | Ps = 704 Change colour of italic characters to Pt |
1824 | Ps = 705 Change background pixmap tint colour to Pt (Compile transparency). |
1926 | Ps = 705 Change background pixmap tint colour to Pt (Compile transparency). |
1825 | Ps = 706 Change colour of bold characters to Pt |
1927 | Ps = 706 Change colour of bold characters to Pt |
1826 | Ps = 707 Change colour of underlined characters to Pt |
1928 | Ps = 707 Change colour of underlined characters to Pt |
1827 | Ps = 710 Set normal fontset to Pt. Same as Ps = 50. |
1929 | Ps = 710 Set normal fontset to Pt. Same as Ps = 50. |
… | |
… | |
2045 | Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using |
2147 | Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using |
2046 | alternative input methods (e.g. kinput2) and will also correctly |
2148 | alternative input methods (e.g. kinput2) and will also correctly |
2047 | set up the input for people using dead keys or compose keys. |
2149 | set up the input for people using dead keys or compose keys. |
2048 | .IP "\-\-enable\-unicode3 (default: off)" 4 |
2150 | .IP "\-\-enable\-unicode3 (default: off)" 4 |
2049 | .IX Item "--enable-unicode3 (default: off)" |
2151 | .IX Item "--enable-unicode3 (default: off)" |
|
|
2152 | Recommended to stay off unless you really need non-BMP characters. |
|
|
2153 | .Sp |
2050 | Enable direct support for displaying unicode codepoints above |
2154 | Enable direct support for displaying unicode codepoints above |
2051 | 65535 (the basic multilingual page). This increases storage |
2155 | 65535 (the basic multilingual page). This increases storage |
2052 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
2156 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
2053 | support these extra characters, but Xft does. |
2157 | support these extra characters, but Xft does. |
2054 | .Sp |
2158 | .Sp |
… | |
… | |
2063 | composite characters. This is required for proper viewing of text |
2167 | composite characters. This is required for proper viewing of text |
2064 | where accents are encoded as seperate unicode characters. This is |
2168 | where accents are encoded as seperate unicode characters. This is |
2065 | done by using precomposited characters when available or creating |
2169 | done by using precomposited characters when available or creating |
2066 | new pseudo-characters when no precomposed form exists. |
2170 | new pseudo-characters when no precomposed form exists. |
2067 | .Sp |
2171 | .Sp |
2068 | Without \-\-enable\-unicode3, the number of additional precomposed characters |
2172 | Without \-\-enable\-unicode3, the number of additional precomposed |
2069 | is rather limited (2048, if this is full, rxvt-unicode will use the |
2173 | characters is somewhat limited (the 6400 private use characters will be |
2070 | private use area, extending the number of combinations to 8448). With |
|
|
2071 | \&\-\-enable\-unicode3, no practical limit exists. |
2174 | (ab\-)used). With \-\-enable\-unicode3, no practical limit exists. |
2072 | .Sp |
2175 | .Sp |
2073 | This option will also enable storage (but not display) of characters |
2176 | This option will also enable storage (but not display) of characters |
2074 | beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified. |
2177 | beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified. |
2075 | .Sp |
2178 | .Sp |
2076 | The combining table also contains entries for arabic presentation forms, |
2179 | The combining table also contains entries for arabic presentation forms, |
2077 | but these are not currently used. Bug me if you want these to be used (and |
2180 | but these are not currently used. Bug me if you want these to be used (and |
2078 | tell me how these are to be used...). |
2181 | tell me how these are to be used...). |
2079 | .IP "\-\-enable\-fallback(=CLASS) (default: Rxvt)" 4 |
2182 | .IP "\-\-enable\-fallback(=CLASS) (default: Rxvt)" 4 |
2080 | .IX Item "--enable-fallback(=CLASS) (default: Rxvt)" |
2183 | .IX Item "--enable-fallback(=CLASS) (default: Rxvt)" |
2081 | When reading resource settings, also read settings for class \s-1CLASS\s0. To disable resource fallback use \-\-disable\-fallback. |
2184 | When reading resource settings, also read settings for class \s-1CLASS\s0. To |
|
|
2185 | disable resource fallback use \-\-disable\-fallback. |
2082 | .IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 |
2186 | .IP "\-\-with\-res\-name=NAME (default: urxvt)" 4 |
2083 | .IX Item "--with-res-name=NAME (default: urxvt)" |
2187 | .IX Item "--with-res-name=NAME (default: urxvt)" |
2084 | Use the given name as default application name when |
2188 | Use the given name as default application name when |
2085 | reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt. |
2189 | reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt. |
2086 | .IP "\-\-with\-res\-class=CLASS /default: URxvt)" 4 |
2190 | .IP "\-\-with\-res\-class=CLASS /default: URxvt)" 4 |
… | |
… | |
2127 | .IP "\-\-enable\-plain\-scroll (default: on)" 4 |
2231 | .IP "\-\-enable\-plain\-scroll (default: on)" 4 |
2128 | .IX Item "--enable-plain-scroll (default: on)" |
2232 | .IX Item "--enable-plain-scroll (default: on)" |
2129 | Add support for a very unobtrusive, plain-looking scrollbar that |
2233 | Add support for a very unobtrusive, plain-looking scrollbar that |
2130 | is the favourite of the rxvt-unicode author, having used it for |
2234 | is the favourite of the rxvt-unicode author, having used it for |
2131 | many years. |
2235 | many years. |
2132 | .IP "\-\-enable\-half\-shadow (default: off)" 4 |
|
|
2133 | .IX Item "--enable-half-shadow (default: off)" |
|
|
2134 | Make shadows on the scrollbar only half the normal width & height. |
|
|
2135 | only applicable to rxvt scrollbars. |
|
|
2136 | .IP "\-\-enable\-ttygid (default: off)" 4 |
2236 | .IP "\-\-enable\-ttygid (default: off)" 4 |
2137 | .IX Item "--enable-ttygid (default: off)" |
2237 | .IX Item "--enable-ttygid (default: off)" |
2138 | Change tty device setting to group \*(L"tty\*(R" \- only use this if |
2238 | Change tty device setting to group \*(L"tty\*(R" \- only use this if |
2139 | your system uses this type of security. |
2239 | your system uses this type of security. |
2140 | .IP "\-\-disable\-backspace\-key" 4 |
2240 | .IP "\-\-disable\-backspace\-key" 4 |
… | |
… | |
2157 | disable this. |
2257 | disable this. |
2158 | .Sp |
2258 | .Sp |
2159 | A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly |
2259 | A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly |
2160 | in combination with other switches) is: |
2260 | in combination with other switches) is: |
2161 | .Sp |
2261 | .Sp |
2162 | .Vb 17 |
2262 | .Vb 15 |
2163 | \& MWM-hints |
2263 | \& MWM-hints |
2164 | \& EWMH-hints (pid, utf8 names) and protocols (ping) |
2264 | \& EWMH-hints (pid, utf8 names) and protocols (ping) |
2165 | \& seperate underline colour (-underlineColor) |
2265 | \& seperate underline colour (-underlineColor) |
2166 | \& settable border widths and borderless switch (-w, -b, -bl) |
2266 | \& settable border widths and borderless switch (-w, -b, -bl) |
|
|
2267 | \& visual depth selection (-depth) |
2167 | \& settable extra linespacing /-lsp) |
2268 | \& settable extra linespacing /-lsp) |
2168 | \& iso-14755-2 and -3, and visual feedback |
2269 | \& iso-14755-2 and -3, and visual feedback |
2169 | \& backindex and forwardindex escape sequence |
|
|
2170 | \& window op and some xterm/OSC escape sequences |
|
|
2171 | \& tripleclickwords (-tcw) |
2270 | \& tripleclickwords (-tcw) |
2172 | \& settable insecure mode (-insecure) |
2271 | \& settable insecure mode (-insecure) |
2173 | \& keysym remapping support |
2272 | \& keysym remapping support |
2174 | \& cursor blinking and underline cursor (-cb, -uc) |
2273 | \& cursor blinking and underline cursor (-cb, -uc) |
2175 | \& XEmbed support (-embed) |
2274 | \& XEmbed support (-embed) |
2176 | \& user-pty (-pty-fd) |
2275 | \& user-pty (-pty-fd) |
2177 | \& hold on exit (-hold) |
2276 | \& hold on exit (-hold) |
2178 | \& skip builtin block graphics (-sbg) |
2277 | \& skip builtin block graphics (-sbg) |
|
|
2278 | .Ve |
|
|
2279 | .Sp |
|
|
2280 | It 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 |
2179 | \& 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 |
2180 | .Ve |
2294 | .Ve |
2181 | .IP "\-\-enable\-iso14755 (default: on)" 4 |
2295 | .IP "\-\-enable\-iso14755 (default: on)" 4 |
2182 | .IX Item "--enable-iso14755 (default: on)" |
2296 | .IX Item "--enable-iso14755 (default: on)" |
2183 | Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or |
2297 | Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or |
2184 | \&\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 |
… | |
… | |
2218 | keys. This should keep the window corner which is closest to a corner of |
2332 | keys. This should keep the window corner which is closest to a corner of |
2219 | the screen in a fixed position. |
2333 | the screen in a fixed position. |
2220 | .IP "\-\-enable\-pointer\-blank (default: on)" 4 |
2334 | .IP "\-\-enable\-pointer\-blank (default: on)" 4 |
2221 | .IX Item "--enable-pointer-blank (default: on)" |
2335 | .IX Item "--enable-pointer-blank (default: on)" |
2222 | Add support to have the pointer disappear when typing or inactive. |
2336 | Add support to have the pointer disappear when typing or inactive. |
2223 | .IP "\-\-enable\-perl (default: off)" 4 |
2337 | .IP "\-\-enable\-perl (default: on)" 4 |
2224 | .IX Item "--enable-perl (default: off)" |
2338 | .IX Item "--enable-perl (default: on)" |
2225 | Enable an embedded perl interpreter. See the \fB@@RXVT_NAME@@\f(BIperl\fB\|(3)\fR |
2339 | Enable an embedded perl interpreter. See the \fB@@RXVT_NAME@@\f(BIperl\fB\|(3)\fR |
2226 | manpage (\fIdoc/rxvtperl.txt\fR) for more info on this feature, or the files |
2340 | manpage (\fIdoc/rxvtperl.txt\fR) for more info on this feature, or the files |
2227 | in \fIsrc/perl\-ext/\fR for the extensions that are installed by default. The |
2341 | in \fIsrc/perl\-ext/\fR for the extensions that are installed by default. The |
2228 | perl interpreter that is used can be specified via the \f(CW\*(C`PERL\*(C'\fR environment |
2342 | perl interpreter that is used can be specified via the \f(CW\*(C`PERL\*(C'\fR environment |
2229 | variable when running configure. |
2343 | variable when running configure. |