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.17 by root, Fri Feb 18 12:15:07 2005 UTC vs.
Revision 1.21 by root, Thu Jun 30 14:00:49 2005 UTC

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-18" "5.2" "RXVT-UNICODE" 132.TH rxvt 7 "2005-06-26" "5.6" "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
… …
406the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you 406the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you
407might be forced to use a different font. 407might be forced to use a different font.
408.Sp 408.Sp
409All of this is not a problem when using X11 core fonts, as their bounding 409All of this is not a problem when using X11 core fonts, as their bounding
410box data is correct. 410box 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."
413Seems to be a known bug, read
414<http://nixdoc.net/files/forum/about34198.html>. Some people use the
415following 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."
413The most common causes for this are that either your locale is not set 422The most common causes for this are that either your locale is not set
414correctly, or you specified a \fBpreeditStyle\fR that is not supported by 423correctly, or you specified a \fBpreeditStyle\fR that is not supported by
415your input method. For example, if you specified \fBOverTheSpot\fR and 424your input method. For example, if you specified \fBOverTheSpot\fR and
… …
457.Sp 466.Sp
458As you might have guessed, FreeBSD does neither define this symobl nor 467As you might have guessed, FreeBSD does neither define this symobl nor
459does it support it. Instead, it uses it's own internal representation of 468does 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
471However, 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
462However, \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
463multi-language apps in an \s-1OS\s0, as using a locale-dependent (and 475apps in an \s-1OS\s0, as using a locale-dependent (and non\-standardized)
464non\-standardized) representation of \fBwchar_t\fR makes it impossible to 476representation of \fBwchar_t\fR makes it impossible to convert between
465convert 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
466other encoding without implementing OS-specific-wrappers for each and 478without implementing OS-specific-wrappers for each and every locale. There
467every locale. There simply are no APIs to convert \fBwchar_t\fR into anything 479simply are no APIs to convert \fBwchar_t\fR into anything except the current
468except the current locale encoding. 480locale encoding.
469.Sp 481.Sp
470Some applications (such as the formidable \fBmlterm\fR) work around this 482Some applications (such as the formidable \fBmlterm\fR) work around this
471by carrying their own replacement functions for character set handling 483by carrying their own replacement functions for character set handling
472with them, and either implementing OS-dependent hacks or doing multiple 484with them, and either implementing OS-dependent hacks or doing multiple
473conversions (which is slow and unreliable in case the \s-1OS\s0 implements 485conversions (which is slow and unreliable in case the \s-1OS\s0 implements
474encodings slightly different than the terminal emulator). 486encodings slightly different than the terminal emulator).
475.Sp 487.Sp
476The rxvt-unicode author insists that the right way to fix this is in the 488The rxvt-unicode author insists that the right way to fix this is in the
477system libraries once and for all, instead of forcing every app to carry 489system libraries once and for all, instead of forcing every app to carry
478complete replacements for them :) 490complete 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."
493Try the diff in \fIdoc/solaris9.patch\fR as a base. It fixes the worst
494problems 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?"
… …
1613Ps = 13 Change colour of mouse foreground to Pt 1629Ps = 13 Change colour of mouse foreground to Pt
1614Ps = 17 Change colour of highlight characters to Pt 1630Ps = 17 Change colour of highlight characters to Pt
1615Ps = 18 Change colour of bold characters to Pt 1631Ps = 18 Change colour of bold characters to Pt
1616Ps = 19 Change colour of underlined characters to Pt 1632Ps = 19 Change colour of underlined characters to Pt
1617Ps = 20 Change default background to Pt 1633Ps = 20 Change default background to Pt
1618Ps = 39 Change default foreground colour to Pt rxvt compile-time option 1634Ps = 39 Change default foreground colour to Pt.
1619Ps = 46 Change Log File to Pt unimplemented 1635Ps = 46 Change Log File to Pt unimplemented
1620Ps = 49 Change default background colour to Pt rxvt compile-time option 1636Ps = 49 Change default background colour to Pt.
1621Ps = 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 1637Ps = 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
1622Ps = 55 Log all scrollback buffer and all of screen to Pt 1638Ps = 55 Log all scrollback buffer and all of screen to Pt
1623Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (@@RXVT_NAME@@ extension) 1639Ps = 701 Change current locale to Pt, or, if Pt is ?, return the current locale (Compile frills).
1624Ps = 703 Menubar command Pt rxvt compile-time option (rxvt-unicode extension) 1640Ps = 703 Menubar command Pt (Compile menubar).
1625Ps = 704 Change colour of italic characters to Pt 1641Ps = 704 Change colour of italic characters to Pt
1626Ps = 705 Change background pixmap tint colour to Pt 1642Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
1627Ps = 710 Set normal fontset to Pt. Same as Ps = 50. 1643Ps = 710 Set normal fontset to Pt. Same as Ps = 50.
1628Ps = 711 Set bold fontset to Pt. Similar to Ps = 50. 1644Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
1629Ps = 712 Set italic fontset to Pt. Similar to Ps = 50. 1645Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1630Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50. 1646Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1647Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1648Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1631.TE 1649.TE
1632 1650
1633.PP 1651.PP
1634 1652
1635.IX Xref "menuBar" 1653.IX Xref "menuBar"
… …
2185.IX Item "--enable-font-styles" 2203.IX Item "--enable-font-styles"
2186Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font 2204Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font
2187styles. The fonts can be set manually or automatically. 2205styles. The fonts can be set manually or automatically.
2188.IP "\-\-with\-codesets=NAME,..." 4 2206.IP "\-\-with\-codesets=NAME,..." 4
2189.IX Item "--with-codesets=NAME,..." 2207.IX Item "--with-codesets=NAME,..."
2190Compile in support for additional codeset (encoding) groups (eu, vn are 2208Compile in support for additional codeset (encoding) groups (\f(CW\*(C`eu\*(C'\fR, \f(CW\*(C`vn\*(C'\fR
2191always compiled in, which includes most 8\-bit character sets). These 2209are always compiled in, which includes most 8\-bit character sets). These
2192codeset tables are currently only used for driving X11 core fonts, they 2210codeset tables are used for driving X11 core fonts, they are not required
2193are not required for Xft fonts. Compiling them in will make your binary 2211for Xft fonts, although having them compiled in lets rxvt-unicode choose
2194bigger (together about 700kB), but it doesn't increase memory usage unless 2212replacement fonts more intelligently. Compiling them in will make your
2213binary bigger (all of together cost about 700kB), but it doesn't increase
2195you use an X11 font requiring one of these encodings. 2214memory usage unless you use a font requiring one of these encodings.
2196.TS 2215.TS
2197l l . 2216l l .
2198all all available codeset groups 2217all all available codeset groups
2199zh common chinese encodings 2218zh common chinese encodings
2200zh_ext rarely used but very big chinese encodigs 2219zh_ext rarely used but very big chinese encodigs
… …
2342disable this. 2361disable this.
2343.Sp 2362.Sp
2344A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly 2363A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2345in combination with other switches) is: 2364in combination with other switches) is:
2346.Sp 2365.Sp
2347.Vb 12 2366.Vb 13
2348\& MWM-hints 2367\& MWM-hints
2368\& EWMH-hints (pid, utf8 names) and protocols (ping)
2349\& seperate underline colour 2369\& seperate underline colour
2350\& settable border widths and borderless switch 2370\& settable border widths and borderless switch
2351\& settable extra linespacing 2371\& settable extra linespacing
2352\& extra window properties (e.g. UTF-8 window names and PID)
2353\& iso-14755-2 and -3, and visual feedback 2372\& iso-14755-2 and -3, and visual feedback
2354\& backindex and forwardindex escape sequence 2373\& backindex and forwardindex escape sequence
2355\& window op and locale change escape sequences 2374\& window op and some xterm/OSC escape sequences
2356\& tripleclickwords 2375\& tripleclickwords
2357\& settable insecure mode 2376\& settable insecure mode
2358\& keysym remapping support 2377\& keysym remapping support
2378\& cursor blinking and underline cursor
2359\& -embed and -pty-fd options 2379\& -embed and -pty-fd options
2360.Ve 2380.Ve
2361.IP "\-\-enable\-iso14755" 4 2381.IP "\-\-enable\-iso14755" 4
2362.IX Item "--enable-iso14755" 2382.IX Item "--enable-iso14755"
2363Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or 2383Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or
… …
2395.IP "\-\-enable\-smart\-resize" 4 2415.IP "\-\-enable\-smart\-resize" 4
2396.IX Item "--enable-smart-resize" 2416.IX Item "--enable-smart-resize"
2397Add smart growth/shrink behaviour when changing font size via from hot 2417Add smart growth/shrink behaviour when changing font size via from hot
2398keys. This should keep in a fixed position the rxvt corner which is 2418keys. This should keep in a fixed position the rxvt corner which is
2399closest to a corner of the screen. 2419closest to a corner of the screen.
2400.IP "\-\-enable\-cursor\-blink" 4
2401.IX Item "--enable-cursor-blink"
2402Add support for a blinking cursor.
2403.IP "\-\-enable\-pointer\-blank" 4 2420.IP "\-\-enable\-pointer\-blank" 4
2404.IX Item "--enable-pointer-blank" 2421.IX Item "--enable-pointer-blank"
2405Add support to have the pointer disappear when typing or inactive. 2422Add support to have the pointer disappear when typing or inactive.
2406.IP "\-\-with\-name=NAME" 4 2423.IP "\-\-with\-name=NAME" 4
2407.IX Item "--with-name=NAME" 2424.IX Item "--with-name=NAME"

Diff Legend

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