| 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-21" "5.2" "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 |
| … | |
… | |
| 406 | 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 |
| 407 | might be forced to use a different font. |
407 | might be forced to use a different font. |
| 408 | .Sp |
408 | .Sp |
| 409 | 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 |
| 410 | 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 |
| 411 | .IP "My Compose (Multi_key) key is no longer working." 4 |
420 | .IP "My Compose (Multi_key) key is no longer working." 4 |
| 412 | .IX Item "My Compose (Multi_key) key is no longer working." |
421 | .IX Item "My Compose (Multi_key) key is no longer working." |
| 413 | 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 |
| 414 | 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 |
| 415 | your input method. For example, if you specified \fBOverTheSpot\fR and |
424 | your input method. For example, if you specified \fBOverTheSpot\fR and |
| … | |
… | |
| 457 | .Sp |
466 | .Sp |
| 458 | 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 |
| 459 | 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 |
| 460 | \&\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. |
| 461 | .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 |
| 462 | 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 |
| 463 | 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) |
| 464 | non\-standardized) representation of \fBwchar_t\fR makes it impossible to |
476 | representation of \fBwchar_t\fR makes it impossible to convert between |
| 465 | 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 |
| 466 | other encoding without implementing OS-specific-wrappers for each and |
478 | without implementing OS-specific-wrappers for each and every locale. There |
| 467 | 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 |
| 468 | except the current locale encoding. |
480 | locale encoding. |
| 469 | .Sp |
481 | .Sp |
| 470 | Some applications (such as the formidable \fBmlterm\fR) work around this |
482 | Some applications (such as the formidable \fBmlterm\fR) work around this |
| 471 | by carrying their own replacement functions for character set handling |
483 | by carrying their own replacement functions for character set handling |
| 472 | with them, and either implementing OS-dependent hacks or doing multiple |
484 | with them, and either implementing OS-dependent hacks or doing multiple |
| 473 | 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 |
| 474 | encodings slightly different than the terminal emulator). |
486 | encodings slightly different than the terminal emulator). |
| 475 | .Sp |
487 | .Sp |
| 476 | 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 |
| 477 | 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 |
| 478 | 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. |
| 479 | .IP "How does rxvt-unicode determine the encoding to use?" 4 |
495 | .IP "How does rxvt-unicode determine the encoding to use?" 4 |
| 480 | .IX Item "How does rxvt-unicode determine the encoding to use?" |
496 | .IX Item "How does rxvt-unicode determine the encoding to use?" |
| 481 | .PD 0 |
497 | .PD 0 |
| 482 | .IP "Is there an option to switch encodings?" 4 |
498 | .IP "Is there an option to switch encodings?" 4 |
| 483 | .IX Item "Is there an option to switch encodings?" |
499 | .IX Item "Is there an option to switch encodings?" |
| … | |
… | |
| 2187 | .IX Item "--enable-font-styles" |
2203 | .IX Item "--enable-font-styles" |
| 2188 | 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 |
| 2189 | styles. The fonts can be set manually or automatically. |
2205 | styles. The fonts can be set manually or automatically. |
| 2190 | .IP "\-\-with\-codesets=NAME,..." 4 |
2206 | .IP "\-\-with\-codesets=NAME,..." 4 |
| 2191 | .IX Item "--with-codesets=NAME,..." |
2207 | .IX Item "--with-codesets=NAME,..." |
| 2192 | 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 |
| 2193 | always compiled in, which includes most 8\-bit character sets). These |
2209 | are always compiled in, which includes most 8\-bit character sets). These |
| 2194 | 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 |
| 2195 | 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 |
| 2196 | 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 |
| 2197 | you use an X11 font requiring one of these encodings. |
2214 | memory usage unless you use a font requiring one of these encodings. |
| 2198 | .TS |
2215 | .TS |
| 2199 | l l . |
2216 | l l . |
| 2200 | all all available codeset groups |
2217 | all all available codeset groups |
| 2201 | zh common chinese encodings |
2218 | zh common chinese encodings |
| 2202 | zh_ext rarely used but very big chinese encodigs |
2219 | zh_ext rarely used but very big chinese encodigs |
| … | |
… | |
| 2344 | disable this. |
2361 | disable this. |
| 2345 | .Sp |
2362 | .Sp |
| 2346 | 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 |
| 2347 | in combination with other switches) is: |
2364 | in combination with other switches) is: |
| 2348 | .Sp |
2365 | .Sp |
| 2349 | .Vb 12 |
2366 | .Vb 13 |
| 2350 | \& MWM-hints |
2367 | \& MWM-hints |
| 2351 | \& EWMH-hints (pid, utf8 names) and protocols (ping) |
2368 | \& EWMH-hints (pid, utf8 names) and protocols (ping) |
| 2352 | \& seperate underline colour |
2369 | \& seperate underline colour |
| 2353 | \& settable border widths and borderless switch |
2370 | \& settable border widths and borderless switch |
| 2354 | \& settable extra linespacing |
2371 | \& settable extra linespacing |
| … | |
… | |
| 2356 | \& backindex and forwardindex escape sequence |
2373 | \& backindex and forwardindex escape sequence |
| 2357 | \& window op and some xterm/OSC escape sequences |
2374 | \& window op and some xterm/OSC escape sequences |
| 2358 | \& tripleclickwords |
2375 | \& tripleclickwords |
| 2359 | \& settable insecure mode |
2376 | \& settable insecure mode |
| 2360 | \& keysym remapping support |
2377 | \& keysym remapping support |
|
|
2378 | \& cursor blinking and underline cursor |
| 2361 | \& -embed and -pty-fd options |
2379 | \& -embed and -pty-fd options |
| 2362 | .Ve |
2380 | .Ve |
| 2363 | .IP "\-\-enable\-iso14755" 4 |
2381 | .IP "\-\-enable\-iso14755" 4 |
| 2364 | .IX Item "--enable-iso14755" |
2382 | .IX Item "--enable-iso14755" |
| 2365 | 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 |
| … | |
… | |
| 2397 | .IP "\-\-enable\-smart\-resize" 4 |
2415 | .IP "\-\-enable\-smart\-resize" 4 |
| 2398 | .IX Item "--enable-smart-resize" |
2416 | .IX Item "--enable-smart-resize" |
| 2399 | 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 |
| 2400 | 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 |
| 2401 | closest to a corner of the screen. |
2419 | closest to a corner of the screen. |
| 2402 | .IP "\-\-enable\-cursor\-blink" 4 |
|
|
| 2403 | .IX Item "--enable-cursor-blink" |
|
|
| 2404 | Add support for a blinking cursor. |
|
|
| 2405 | .IP "\-\-enable\-pointer\-blank" 4 |
2420 | .IP "\-\-enable\-pointer\-blank" 4 |
| 2406 | .IX Item "--enable-pointer-blank" |
2421 | .IX Item "--enable-pointer-blank" |
| 2407 | Add support to have the pointer disappear when typing or inactive. |
2422 | Add support to have the pointer disappear when typing or inactive. |
| 2408 | .IP "\-\-with\-name=NAME" 4 |
2423 | .IP "\-\-with\-name=NAME" 4 |
| 2409 | .IX Item "--with-name=NAME" |
2424 | .IX Item "--with-name=NAME" |
