1 | .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.14 |
1 | .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3 |
2 | .\" |
2 | .\" |
3 | .\" Standard preamble: |
3 | .\" Standard preamble: |
4 | .\" ======================================================================== |
4 | .\" ======================================================================== |
5 | .de Sh \" Subsection heading |
5 | .de Sh \" Subsection heading |
6 | .br |
6 | .br |
… | |
… | |
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 "2005-02-14" "5.1" "RXVT-UNICODE" |
132 | .TH rxvt 7 "2005-06-26" "5.6" "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 |
… | |
… | |
227 | \& infocmp -C rxvt-unicode |
227 | \& infocmp -C rxvt-unicode |
228 | .Ve |
228 | .Ve |
229 | .Sp |
229 | .Sp |
230 | Or you could use this termcap entry, generated by the command above: |
230 | Or you could use this termcap entry, generated by the command above: |
231 | .Sp |
231 | .Sp |
232 | .Vb 19 |
232 | .Vb 20 |
233 | \& rxvt-unicode|rxvt-unicode terminal (X Window System):\e |
233 | \& rxvt-unicode|rxvt-unicode terminal (X Window System):\e |
234 | \& :am:bw:eo:km:mi:ms:xn:xo:\e |
234 | \& :am:bw:eo:km:mi:ms:xn:xo:\e |
235 | \& :co#80:it#8:li#24:lm#0:\e |
235 | \& :co#80:it#8:li#24:lm#0:\e |
236 | \& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e |
236 | \& :AL=\eE[%dL:DC=\eE[%dP:DL=\eE[%dM:DO=\eE[%dB:IC=\eE[%d@:\e |
237 | \& :K1=\eEOw:K2=\eEOu:K3=\eEOy:K4=\eEOq:K5=\eEOs:LE=\eE[%dD:\e |
237 | \& :K1=\eEOw:K2=\eEOu:K3=\eEOy:K4=\eEOq:K5=\eEOs:LE=\eE[%dD:\e |
238 | \& :RI=\eE[%dC:SF=\eE[%dS:SR=\eE[%dT:UP=\eE[%dA:ae=^O:al=\eE[L:\e |
238 | \& :RI=\eE[%dC:SF=\eE[%dS:SR=\eE[%dT:UP=\eE[%dA:ae=\eE(B:al=\eE[L:\e |
239 | \& :as=^N:bl=^G:cd=\eE[J:ce=\eE[K:cl=\eE[H\eE[2J:cm=\eE[%i%d;%dH:\e |
239 | \& :as=\eE(0:bl=^G:cd=\eE[J:ce=\eE[K:cl=\eE[H\eE[2J:\e |
240 | \& :cr=^M:cs=\eE[%i%d;%dr:ct=\eE[3g:dc=\eE[P:dl=\eE[M:do=^J:\e |
240 | \& :cm=\eE[%i%d;%dH:cr=^M:cs=\eE[%i%d;%dr:ct=\eE[3g:dc=\eE[P:\e |
241 | \& :ec=\eE[%dX:ei=\eE[4l:ho=\eE[H:i1=\eE[?47l\eE=\eE[?1l:ic=\eE[@:\e |
241 | \& :dl=\eE[M:do=^J:ec=\eE[%dX:ei=\eE[4l:ho=\eE[H:\e |
|
|
242 | \& :i1=\eE[?47l\eE=\eE[?1l:ic=\eE[@:im=\eE[4h:\e |
242 | \& :im=\eE[4h:is=\eE[r\eE[m\eE[2J\eE[H\eE[?7h\eE[?1;3;4;6l\eE[4l:\e |
243 | \& :is=\eE[r\eE[m\eE[2J\eE[H\eE[?7h\eE[?1;3;4;6l\eE[4l:\e |
243 | \& :k1=\eE[11~:k2=\eE[12~:k3=\eE[13~:k4=\eE[14~:k5=\eE[15~:\e |
244 | \& :k1=\eE[11~:k2=\eE[12~:k3=\eE[13~:k4=\eE[14~:k5=\eE[15~:\e |
244 | \& :k6=\eE[17~:k7=\eE[18~:k8=\eE[19~:k9=\eE[20~:kD=\eE[3~:\e |
245 | \& :k6=\eE[17~:k7=\eE[18~:k8=\eE[19~:k9=\eE[20~:kD=\eE[3~:\e |
245 | \& :kI=\eE[2~:kN=\eE[6~:kP=\eE[5~:kb=\e177:kd=\eEOB:ke=\eE[?1l\eE>:\e |
246 | \& :kI=\eE[2~:kN=\eE[6~:kP=\eE[5~:kb=\e177:kd=\eEOB:ke=\eE[?1l\eE>:\e |
246 | \& :kh=\eE[7~:kl=\eEOD:kr=\eEOC:ks=\eE[?1h\eE=:ku=\eEOA:le=^H:\e |
247 | \& :kh=\eE[7~:kl=\eEOD:kr=\eEOC:ks=\eE[?1h\eE=:ku=\eEOA:le=^H:\e |
247 | \& :mb=\eE[5m:md=\eE[1m:me=\eE[m\e017:mr=\eE[7m:nd=\eE[C:rc=\eE8:\e |
248 | \& :mb=\eE[5m:md=\eE[1m:me=\eE[m\e017:mr=\eE[7m:nd=\eE[C:rc=\eE8:\e |
… | |
… | |
405 | the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you |
406 | the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you |
406 | might be forced to use a different font. |
407 | might be forced to use a different font. |
407 | .Sp |
408 | .Sp |
408 | All of this is not a problem when using X11 core fonts, as their bounding |
409 | All of this is not a problem when using X11 core fonts, as their bounding |
409 | box data is correct. |
410 | box data is correct. |
|
|
411 | .IP "On Solaris 9, many line-drawing characters are too wide." 4 |
|
|
412 | .IX Item "On Solaris 9, many line-drawing characters are too wide." |
|
|
413 | Seems to be a known bug, read |
|
|
414 | <http://nixdoc.net/files/forum/about34198.html>. Some people use the |
|
|
415 | following ugly workaround to get non-double-wide-characters working: |
|
|
416 | .Sp |
|
|
417 | .Vb 1 |
|
|
418 | \& #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x) |
|
|
419 | .Ve |
410 | .IP "My Compose (Multi_key) key is no longer working." 4 |
420 | .IP "My Compose (Multi_key) key is no longer working." 4 |
411 | .IX Item "My Compose (Multi_key) key is no longer working." |
421 | .IX Item "My Compose (Multi_key) key is no longer working." |
412 | The most common causes for this are that either your locale is not set |
422 | The most common causes for this are that either your locale is not set |
413 | correctly, or you specified a \fBpreeditStyle\fR that is not supported by |
423 | correctly, or you specified a \fBpreeditStyle\fR that is not supported by |
414 | your input method. For example, if you specified \fBOverTheSpot\fR and |
424 | your input method. For example, if you specified \fBOverTheSpot\fR and |
… | |
… | |
456 | .Sp |
466 | .Sp |
457 | As you might have guessed, FreeBSD does neither define this symobl nor |
467 | As you might have guessed, FreeBSD does neither define this symobl nor |
458 | does it support it. Instead, it uses it's own internal representation of |
468 | does it support it. Instead, it uses it's own internal representation of |
459 | \&\fBwchar_t\fR. This is, of course, completely fine with respect to standards. |
469 | \&\fBwchar_t\fR. This is, of course, completely fine with respect to standards. |
460 | .Sp |
470 | .Sp |
|
|
471 | However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and |
|
|
472 | \&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR. |
|
|
473 | .Sp |
461 | However, \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support |
474 | \&\f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support multi-language |
462 | multi-language apps in an \s-1OS\s0, as using a locale-dependent (and |
475 | apps in an \s-1OS\s0, as using a locale-dependent (and non\-standardized) |
463 | non\-standardized) representation of \fBwchar_t\fR makes it impossible to |
476 | representation of \fBwchar_t\fR makes it impossible to convert between |
464 | convert between \fBwchar_t\fR (as used by X11 and your applications) and any |
477 | \&\fBwchar_t\fR (as used by X11 and your applications) and any other encoding |
465 | other encoding without implementing OS-specific-wrappers for each and |
478 | without implementing OS-specific-wrappers for each and every locale. There |
466 | every locale. There simply are no APIs to convert \fBwchar_t\fR into anything |
479 | simply are no APIs to convert \fBwchar_t\fR into anything except the current |
467 | except the current locale encoding. |
480 | locale encoding. |
468 | .Sp |
481 | .Sp |
469 | Some applications (such as the formidable \fBmlterm\fR) work around this |
482 | Some applications (such as the formidable \fBmlterm\fR) work around this |
470 | by carrying their own replacement functions for character set handling |
483 | by carrying their own replacement functions for character set handling |
471 | with them, and either implementing OS-dependent hacks or doing multiple |
484 | with them, and either implementing OS-dependent hacks or doing multiple |
472 | conversions (which is slow and unreliable in case the \s-1OS\s0 implements |
485 | conversions (which is slow and unreliable in case the \s-1OS\s0 implements |
473 | encodings slightly different than the terminal emulator). |
486 | encodings slightly different than the terminal emulator). |
474 | .Sp |
487 | .Sp |
475 | The rxvt-unicode author insists that the right way to fix this is in the |
488 | The rxvt-unicode author insists that the right way to fix this is in the |
476 | system libraries once and for all, instead of forcing every app to carry |
489 | system libraries once and for all, instead of forcing every app to carry |
477 | complete replacements for them :) |
490 | complete replacements for them :) |
|
|
491 | .IP "I use Solaris 9 and it doesn't compile/work/etc." 4 |
|
|
492 | .IX Item "I use Solaris 9 and it doesn't compile/work/etc." |
|
|
493 | Try the diff in \fIdoc/solaris9.patch\fR as a base. It fixes the worst |
|
|
494 | problems with \f(CW\*(C`wcwidth\*(C'\fR and a compile problem. |
478 | .IP "How does rxvt-unicode determine the encoding to use?" 4 |
495 | .IP "How does rxvt-unicode determine the encoding to use?" 4 |
479 | .IX Item "How does rxvt-unicode determine the encoding to use?" |
496 | .IX Item "How does rxvt-unicode determine the encoding to use?" |
480 | .PD 0 |
497 | .PD 0 |
481 | .IP "Is there an option to switch encodings?" 4 |
498 | .IP "Is there an option to switch encodings?" 4 |
482 | .IX Item "Is there an option to switch encodings?" |
499 | .IX Item "Is there an option to switch encodings?" |
… | |
… | |
1612 | Ps = 13 Change colour of mouse foreground to Pt |
1629 | Ps = 13 Change colour of mouse foreground to Pt |
1613 | Ps = 17 Change colour of highlight characters to Pt |
1630 | Ps = 17 Change colour of highlight characters to Pt |
1614 | Ps = 18 Change colour of bold characters to Pt |
1631 | Ps = 18 Change colour of bold characters to Pt |
1615 | Ps = 19 Change colour of underlined characters to Pt |
1632 | Ps = 19 Change colour of underlined characters to Pt |
1616 | Ps = 20 Change default background to Pt |
1633 | Ps = 20 Change default background to Pt |
1617 | Ps = 39 Change default foreground colour to Pt rxvt compile-time option |
1634 | Ps = 39 Change default foreground colour to Pt. |
1618 | Ps = 46 Change Log File to Pt unimplemented |
1635 | Ps = 46 Change Log File to Pt unimplemented |
1619 | Ps = 49 Change default background colour to Pt rxvt compile-time option |
1636 | Ps = 49 Change default background colour to Pt. |
1620 | 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 |
1637 | 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 |
1621 | Ps = 55 Log all scrollback buffer and all of screen to Pt |
1638 | Ps = 55 Log all scrollback buffer and all of screen to Pt |
1622 | Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (@@RXVT_NAME@@ extension) |
1639 | Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills). |
1623 | Ps = 703 Menubar command Pt rxvt compile-time option (rxvt-unicode extension) |
1640 | Ps = 703 Menubar command Pt (Compile menubar). |
1624 | Ps = 704 Change colour of italic characters to Pt |
1641 | Ps = 704 Change colour of italic characters to Pt |
1625 | Ps = 705 Change background pixmap tint colour to Pt |
1642 | Ps = 705 Change background pixmap tint colour to Pt (Compile transparency). |
1626 | Ps = 710 Set normal fontset to Pt. Same as Ps = 50. |
1643 | Ps = 710 Set normal fontset to Pt. Same as Ps = 50. |
1627 | Ps = 711 Set bold fontset to Pt. Similar to Ps = 50. |
1644 | Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles). |
1628 | Ps = 712 Set italic fontset to Pt. Similar to Ps = 50. |
1645 | Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles). |
1629 | Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50. |
1646 | Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles). |
|
|
1647 | Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). |
|
|
1648 | Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills). |
1630 | .TE |
1649 | .TE |
1631 | |
1650 | |
1632 | .PP |
1651 | .PP |
1633 | |
1652 | |
1634 | .IX Xref "menuBar" |
1653 | .IX Xref "menuBar" |
… | |
… | |
2184 | .IX Item "--enable-font-styles" |
2203 | .IX Item "--enable-font-styles" |
2185 | Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font |
2204 | Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font |
2186 | styles. The fonts can be set manually or automatically. |
2205 | styles. The fonts can be set manually or automatically. |
2187 | .IP "\-\-with\-codesets=NAME,..." 4 |
2206 | .IP "\-\-with\-codesets=NAME,..." 4 |
2188 | .IX Item "--with-codesets=NAME,..." |
2207 | .IX Item "--with-codesets=NAME,..." |
2189 | Compile in support for additional codeset (encoding) groups (eu, vn are |
2208 | Compile in support for additional codeset (encoding) groups (\f(CW\*(C`eu\*(C'\fR, \f(CW\*(C`vn\*(C'\fR |
2190 | always compiled in, which includes most 8\-bit character sets). These |
2209 | are always compiled in, which includes most 8\-bit character sets). These |
2191 | codeset tables are currently only used for driving X11 core fonts, they |
2210 | codeset tables are used for driving X11 core fonts, they are not required |
2192 | are not required for Xft fonts. Compiling them in will make your binary |
2211 | for Xft fonts, although having them compiled in lets rxvt-unicode choose |
2193 | bigger (together about 700kB), but it doesn't increase memory usage unless |
2212 | replacement fonts more intelligently. Compiling them in will make your |
|
|
2213 | binary bigger (all of together cost about 700kB), but it doesn't increase |
2194 | you use an X11 font requiring one of these encodings. |
2214 | memory usage unless you use a font requiring one of these encodings. |
2195 | .TS |
2215 | .TS |
2196 | l l . |
2216 | l l . |
2197 | all all available codeset groups |
2217 | all all available codeset groups |
2198 | zh common chinese encodings |
2218 | zh common chinese encodings |
2199 | zh_ext rarely used but very big chinese encodigs |
2219 | zh_ext rarely used but very big chinese encodigs |
… | |
… | |
2341 | disable this. |
2361 | disable this. |
2342 | .Sp |
2362 | .Sp |
2343 | A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly |
2363 | A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly |
2344 | in combination with other switches) is: |
2364 | in combination with other switches) is: |
2345 | .Sp |
2365 | .Sp |
2346 | .Vb 11 |
2366 | .Vb 13 |
2347 | \& MWM-hints |
2367 | \& MWM-hints |
|
|
2368 | \& EWMH-hints (pid, utf8 names) and protocols (ping) |
2348 | \& seperate underline colour |
2369 | \& seperate underline colour |
2349 | \& settable border widths and borderless switch |
2370 | \& settable border widths and borderless switch |
2350 | \& settable extra linespacing |
2371 | \& settable extra linespacing |
2351 | \& extra window properties (e.g. UTF-8 window names and PID) |
|
|
2352 | \& iso-14755-2 and -3, and visual feedback |
2372 | \& iso-14755-2 and -3, and visual feedback |
2353 | \& backindex and forwardindex escape sequence |
2373 | \& backindex and forwardindex escape sequence |
2354 | \& window op and locale change escape sequences |
2374 | \& window op and some xterm/OSC escape sequences |
2355 | \& tripleclickwords |
2375 | \& tripleclickwords |
2356 | \& settable insecure mode |
2376 | \& settable insecure mode |
2357 | \& keysym remapping support |
2377 | \& keysym remapping support |
|
|
2378 | \& cursor blinking and underline cursor |
|
|
2379 | \& -embed and -pty-fd options |
2358 | .Ve |
2380 | .Ve |
2359 | .IP "\-\-enable\-iso14755" 4 |
2381 | .IP "\-\-enable\-iso14755" 4 |
2360 | .IX Item "--enable-iso14755" |
2382 | .IX Item "--enable-iso14755" |
2361 | Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or |
2383 | Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or |
2362 | \&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by |
2384 | \&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by |
… | |
… | |
2393 | .IP "\-\-enable\-smart\-resize" 4 |
2415 | .IP "\-\-enable\-smart\-resize" 4 |
2394 | .IX Item "--enable-smart-resize" |
2416 | .IX Item "--enable-smart-resize" |
2395 | Add smart growth/shrink behaviour when changing font size via from hot |
2417 | Add smart growth/shrink behaviour when changing font size via from hot |
2396 | keys. This should keep in a fixed position the rxvt corner which is |
2418 | keys. This should keep in a fixed position the rxvt corner which is |
2397 | closest to a corner of the screen. |
2419 | closest to a corner of the screen. |
2398 | .IP "\-\-enable\-cursor\-blink" 4 |
|
|
2399 | .IX Item "--enable-cursor-blink" |
|
|
2400 | Add support for a blinking cursor. |
|
|
2401 | .IP "\-\-enable\-pointer\-blank" 4 |
2420 | .IP "\-\-enable\-pointer\-blank" 4 |
2402 | .IX Item "--enable-pointer-blank" |
2421 | .IX Item "--enable-pointer-blank" |
2403 | Add support to have the pointer disappear when typing or inactive. |
2422 | Add support to have the pointer disappear when typing or inactive. |
2404 | .IP "\-\-with\-name=NAME" 4 |
2423 | .IP "\-\-with\-name=NAME" 4 |
2405 | .IX Item "--with-name=NAME" |
2424 | .IX Item "--with-name=NAME" |