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.18 by root, Sun Feb 20 19:45:30 2005 UTC vs.
Revision 1.23 by root, Wed Jul 13 03:08:57 2005 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 "2005-02-20" "5.2" "RXVT-UNICODE" 132.TH rxvt 7 "2005-07-13" "5.7" "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
… …
162.IX Item "How do I know which rxvt-unicode version I'm using?" 162.IX Item "How do I know which rxvt-unicode version I'm using?"
163The version number is displayed with the usage (\-h). Also the escape 163The version number is displayed with the usage (\-h). Also the escape
164sequence \f(CW\*(C`ESC [ 8 n\*(C'\fR sets the window title to the version number. 164sequence \f(CW\*(C`ESC [ 8 n\*(C'\fR sets the window title to the version number.
165.IP "I am using Debian GNU/Linux and have a problem..." 4 165.IP "I am using Debian GNU/Linux and have a problem..." 4
166.IX Item "I am using Debian GNU/Linux and have a problem..." 166.IX Item "I am using Debian GNU/Linux and have a problem..."
167The Debian GNU/Linux package of rxvt-unicode contains large patches that 167The Debian GNU/Linux package of rxvt-unicode in sarge contains large
168considerably change the behaviour of rxvt\-unicode. Before reporting a 168patches that considerably change the behaviour of rxvt\-unicode. Before
169bug to the original rxvt-unicode author please download and install the 169reporting a bug to the original rxvt-unicode author please download and
170genuine version (<http://software.schmorp.de#rxvt\-unicode>) and try to 170install the genuine version (<http://software.schmorp.de#rxvt\-unicode>)
171reproduce the problem. If you cannot, chances are that the problems are 171and try to reproduce the problem. If you cannot, chances are that the
172specific to Debian GNU/Linux, in which case it should be reported via the 172problems are specific to Debian GNU/Linux, in which case it should be
173Debian Bug Tracking System (use \f(CW\*(C`reportbug\*(C'\fR to report the bug). 173reported via the Debian Bug Tracking System (use \f(CW\*(C`reportbug\*(C'\fR to report
174the bug).
174.Sp 175.Sp
175For other problems that also affect the Debian package, you can and 176For other problems that also affect the Debian package, you can and
176probably should use the Debian \s-1BTS\s0, too, because, after all, it's also a 177probably should use the Debian \s-1BTS\s0, too, because, after all, it's also a
177bug in the Debian version and it serves as a reminder for other users that 178bug in the Debian version and it serves as a reminder for other users that
178might encounter the same issue. 179might encounter the same issue.
… …
205\& URxvt.termName: rxvt 206\& URxvt.termName: rxvt
206.Ve 207.Ve
207.Sp 208.Sp
208If you don't plan to use \fBrxvt\fR (quite common...) you could also replace 209If you don't plan to use \fBrxvt\fR (quite common...) you could also replace
209the rxvt terminfo file with the rxvt-unicode one. 210the rxvt terminfo file with the rxvt-unicode one.
211.ie n .IP """tic"" outputs some error when compiling the terminfo entry." 4
212.el .IP "\f(CWtic\fR outputs some error when compiling the terminfo entry." 4
213.IX Item "tic outputs some error when compiling the terminfo entry."
214Most likely it's the empty definition for \f(CW\*(C`enacs=\*(C'\fR. Just replace it by
215\&\f(CW\*(C`enacs=\eE[0@\*(C'\fR and try again.
210.ie n .IP """bash""'s readline does not work correctly under @@RXVT_NAME@@." 4 216.ie n .IP """bash""'s readline does not work correctly under @@RXVT_NAME@@." 4
211.el .IP "\f(CWbash\fR's readline does not work correctly under @@RXVT_NAME@@." 4 217.el .IP "\f(CWbash\fR's readline does not work correctly under @@RXVT_NAME@@." 4
212.IX Item "bash's readline does not work correctly under @@RXVT_NAME@@." 218.IX Item "bash's readline does not work correctly under @@RXVT_NAME@@."
213.PD 0 219.PD 0
214.IP "I need a termcap file entry." 4 220.IP "I need a termcap file entry." 4
… …
406the \f(CW\*(C`\-lsp\*(C'\fR option to give the font more height. If that doesn't work, you 412the \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. 413might be forced to use a different font.
408.Sp 414.Sp
409All of this is not a problem when using X11 core fonts, as their bounding 415All of this is not a problem when using X11 core fonts, as their bounding
410box data is correct. 416box data is correct.
417.IP "On Solaris 9, many line-drawing characters are too wide." 4
418.IX Item "On Solaris 9, many line-drawing characters are too wide."
419Seems to be a known bug, read
420<http://nixdoc.net/files/forum/about34198.html>. Some people use the
421following ugly workaround to get non-double-wide-characters working:
422.Sp
423.Vb 1
424\& #define wcwidth(x) wcwidth(x) > 1 ? 1 : wcwidth(x)
425.Ve
411.IP "My Compose (Multi_key) key is no longer working." 4 426.IP "My Compose (Multi_key) key is no longer working." 4
412.IX Item "My Compose (Multi_key) key is no longer working." 427.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 428The 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 429correctly, or you specified a \fBpreeditStyle\fR that is not supported by
415your input method. For example, if you specified \fBOverTheSpot\fR and 430your input method. For example, if you specified \fBOverTheSpot\fR and
… …
457.Sp 472.Sp
458As you might have guessed, FreeBSD does neither define this symobl nor 473As you might have guessed, FreeBSD does neither define this symobl nor
459does it support it. Instead, it uses it's own internal representation of 474does 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. 475\&\fBwchar_t\fR. This is, of course, completely fine with respect to standards.
461.Sp 476.Sp
477However, that means rxvt-unicode only works in \f(CW\*(C`POSIX\*(C'\fR, \f(CW\*(C`ISO\-8859\-1\*(C'\fR and
478\&\f(CW\*(C`UTF\-8\*(C'\fR locales under FreeBSD (which all use Unicode as \fBwchar_t\fR.
479.Sp
462However, \f(CW\*(C`_\|_STDC_ISO_10646_\|_\*(C'\fR is the only sane way to support 480\&\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 481apps in an \s-1OS\s0, as using a locale-dependent (and non\-standardized)
464non\-standardized) representation of \fBwchar_t\fR makes it impossible to 482representation of \fBwchar_t\fR makes it impossible to convert between
465convert between \fBwchar_t\fR (as used by X11 and your applications) and any 483\&\fBwchar_t\fR (as used by X11 and your applications) and any other encoding
466other encoding without implementing OS-specific-wrappers for each and 484without implementing OS-specific-wrappers for each and every locale. There
467every locale. There simply are no APIs to convert \fBwchar_t\fR into anything 485simply are no APIs to convert \fBwchar_t\fR into anything except the current
468except the current locale encoding. 486locale encoding.
469.Sp 487.Sp
470Some applications (such as the formidable \fBmlterm\fR) work around this 488Some applications (such as the formidable \fBmlterm\fR) work around this
471by carrying their own replacement functions for character set handling 489by carrying their own replacement functions for character set handling
472with them, and either implementing OS-dependent hacks or doing multiple 490with them, and either implementing OS-dependent hacks or doing multiple
473conversions (which is slow and unreliable in case the \s-1OS\s0 implements 491conversions (which is slow and unreliable in case the \s-1OS\s0 implements
474encodings slightly different than the terminal emulator). 492encodings slightly different than the terminal emulator).
475.Sp 493.Sp
476The rxvt-unicode author insists that the right way to fix this is in the 494The 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 495system libraries once and for all, instead of forcing every app to carry
478complete replacements for them :) 496complete replacements for them :)
497.IP "I use Solaris 9 and it doesn't compile/work/etc." 4
498.IX Item "I use Solaris 9 and it doesn't compile/work/etc."
499Try the diff in \fIdoc/solaris9.patch\fR as a base. It fixes the worst
500problems with \f(CW\*(C`wcwidth\*(C'\fR and a compile problem.
501.IP "How can I use rxvt-unicode under cygwin?" 4
502.IX Item "How can I use rxvt-unicode under cygwin?"
503rxvt-unicode should compile and run out of the box on cygwin, using
504the X11 libraries that come with cygwin. libW11 emulation is no
505longer supported (and makes no sense, either, as it only supported a
506single font). I recommend starting the X\-server in \f(CW\*(C`\-multiwindow\*(C'\fR or
507\&\f(CW\*(C`\-rootless\*(C'\fR mode instead, which will result in similar look&feel as the
508old libW11 emulation.
509.Sp
510At the time of this writing, cygwin didn't seem to support any multi-byte
511encodings (you might try \f(CW\*(C`LC_CTYPE=C\-UTF\-8\*(C'\fR), so you are likely limited
512to 8\-bit encodings.
479.IP "How does rxvt-unicode determine the encoding to use?" 4 513.IP "How does rxvt-unicode determine the encoding to use?" 4
480.IX Item "How does rxvt-unicode determine the encoding to use?" 514.IX Item "How does rxvt-unicode determine the encoding to use?"
481.PD 0 515.PD 0
482.IP "Is there an option to switch encodings?" 4 516.IP "Is there an option to switch encodings?" 4
483.IX Item "Is there an option to switch encodings?" 517.IX Item "Is there an option to switch encodings?"
… …
692\& URxvt.color7: #e1dddd 726\& URxvt.color7: #e1dddd
693\& URxvt.color15: #e1dddd 727\& URxvt.color15: #e1dddd
694.Ve 728.Ve
695.IP "How can I start @@RXVT_NAME@@d in a race-free way?" 4 729.IP "How can I start @@RXVT_NAME@@d in a race-free way?" 4
696.IX Item "How can I start @@RXVT_NAME@@d in a race-free way?" 730.IX Item "How can I start @@RXVT_NAME@@d in a race-free way?"
697Despite it's name, @@RXVT_NAME@@d is not a real daemon, but more like a 731Try \f(CW\*(C`@@RXVT_NAME@@d \-f \-o\*(C'\fR, which tells @@RXVT_NAME@@d to open the
698server that answers @@RXVT_NAME@@c's requests, so it doesn't background 732display, create the listening socket and then fork.
699itself.
700.Sp
701To ensure @@RXVT_NAME@@d is listening on it's socket, you can use the
702following method to wait for the startup message before continuing:
703.Sp
704.Vb 1
705\& { @@RXVT_NAME@@d & } | read
706.Ve
707.IP "What's with the strange Backspace/Delete key behaviour?" 4 733.IP "What's with the strange Backspace/Delete key behaviour?" 4
708.IX Item "What's with the strange Backspace/Delete key behaviour?" 734.IX Item "What's with the strange Backspace/Delete key behaviour?"
709Assuming that the physical Backspace key corresponds to the 735Assuming that the physical Backspace key corresponds to the
710BackSpace keysym (not likely for Linux ... see the following 736BackSpace keysym (not likely for Linux ... see the following
711question) there are two standard values that can be used for 737question) there are two standard values that can be used for
… …
1613Ps = 13 Change colour of mouse foreground to Pt 1639Ps = 13 Change colour of mouse foreground to Pt
1614Ps = 17 Change colour of highlight characters to Pt 1640Ps = 17 Change colour of highlight characters to Pt
1615Ps = 18 Change colour of bold characters to Pt 1641Ps = 18 Change colour of bold characters to Pt
1616Ps = 19 Change colour of underlined characters to Pt 1642Ps = 19 Change colour of underlined characters to Pt
1617Ps = 20 Change default background to Pt 1643Ps = 20 Change default background to Pt
1618Ps = 39 Change default foreground colour to Pt rxvt compile-time option 1644Ps = 39 Change default foreground colour to Pt.
1619Ps = 46 Change Log File to Pt unimplemented 1645Ps = 46 Change Log File to Pt unimplemented
1620Ps = 49 Change default background colour to Pt rxvt compile-time option 1646Ps = 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 1647Ps = 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 1648Ps = 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) 1649Ps = 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) 1650Ps = 703 Menubar command Pt (Compile menubar).
1625Ps = 704 Change colour of italic characters to Pt 1651Ps = 704 Change colour of italic characters to Pt
1626Ps = 705 Change background pixmap tint colour to Pt 1652Ps = 705 Change background pixmap tint colour to Pt (Compile transparency).
1627Ps = 710 Set normal fontset to Pt. Same as Ps = 50. 1653Ps = 710 Set normal fontset to Pt. Same as Ps = 50.
1628Ps = 711 Set bold fontset to Pt. Similar to Ps = 50. 1654Ps = 711 Set bold fontset to Pt. Similar to Ps = 50 (Compile styles).
1629Ps = 712 Set italic fontset to Pt. Similar to Ps = 50. 1655Ps = 712 Set italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1630Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50. 1656Ps = 713 Set bold-italic fontset to Pt. Similar to Ps = 50 (Compile styles).
1657Ps = 720 Move viewing window up by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1658Ps = 721 Move viewing window down by Pt lines, or clear scrollback buffer if Pt = 0 (Compile frills).
1631.TE 1659.TE
1632 1660
1633.PP 1661.PP
1634 1662
1635.IX Xref "menuBar" 1663.IX Xref "menuBar"
… …
2185.IX Item "--enable-font-styles" 2213.IX Item "--enable-font-styles"
2186Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font 2214Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font
2187styles. The fonts can be set manually or automatically. 2215styles. The fonts can be set manually or automatically.
2188.IP "\-\-with\-codesets=NAME,..." 4 2216.IP "\-\-with\-codesets=NAME,..." 4
2189.IX Item "--with-codesets=NAME,..." 2217.IX Item "--with-codesets=NAME,..."
2190Compile in support for additional codeset (encoding) groups (eu, vn are 2218Compile 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 2219are always compiled in, which includes most 8\-bit character sets). These
2192codeset tables are currently only used for driving X11 core fonts, they 2220codeset 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 2221for Xft fonts, although having them compiled in lets rxvt-unicode choose
2194bigger (together about 700kB), but it doesn't increase memory usage unless 2222replacement fonts more intelligently. Compiling them in will make your
2223binary bigger (all of together cost about 700kB), but it doesn't increase
2195you use an X11 font requiring one of these encodings. 2224memory usage unless you use a font requiring one of these encodings.
2196.TS 2225.TS
2197l l . 2226l l .
2198all all available codeset groups 2227all all available codeset groups
2199zh common chinese encodings 2228zh common chinese encodings
2200zh_ext rarely used but very big chinese encodigs 2229zh_ext rarely used but very big chinese encodigs
… …
2342disable this. 2371disable this.
2343.Sp 2372.Sp
2344A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly 2373A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2345in combination with other switches) is: 2374in combination with other switches) is:
2346.Sp 2375.Sp
2347.Vb 12 2376.Vb 13
2348\& MWM-hints 2377\& MWM-hints
2349\& EWMH-hints (pid, utf8 names) and protocols (ping) 2378\& EWMH-hints (pid, utf8 names) and protocols (ping)
2350\& seperate underline colour 2379\& seperate underline colour
2351\& settable border widths and borderless switch 2380\& settable border widths and borderless switch
2352\& settable extra linespacing 2381\& settable extra linespacing
2353\& iso-14755-2 and -3, and visual feedback 2382\& iso-14755-2 and -3, and visual feedback
2354\& backindex and forwardindex escape sequence 2383\& backindex and forwardindex escape sequence
2355\& window op and locale change escape sequences 2384\& window op and some xterm/OSC escape sequences
2356\& tripleclickwords 2385\& tripleclickwords
2357\& settable insecure mode 2386\& settable insecure mode
2358\& keysym remapping support 2387\& keysym remapping support
2388\& cursor blinking and underline cursor
2359\& -embed and -pty-fd options 2389\& -embed and -pty-fd options
2360.Ve 2390.Ve
2361.IP "\-\-enable\-iso14755" 4 2391.IP "\-\-enable\-iso14755" 4
2362.IX Item "--enable-iso14755" 2392.IX Item "--enable-iso14755"
2363Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or 2393Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or
… …
2395.IP "\-\-enable\-smart\-resize" 4 2425.IP "\-\-enable\-smart\-resize" 4
2396.IX Item "--enable-smart-resize" 2426.IX Item "--enable-smart-resize"
2397Add smart growth/shrink behaviour when changing font size via from hot 2427Add smart growth/shrink behaviour when changing font size via from hot
2398keys. This should keep in a fixed position the rxvt corner which is 2428keys. This should keep in a fixed position the rxvt corner which is
2399closest to a corner of the screen. 2429closest 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 2430.IP "\-\-enable\-pointer\-blank" 4
2404.IX Item "--enable-pointer-blank" 2431.IX Item "--enable-pointer-blank"
2405Add support to have the pointer disappear when typing or inactive. 2432Add support to have the pointer disappear when typing or inactive.
2406.IP "\-\-with\-name=NAME" 4 2433.IP "\-\-with\-name=NAME" 4
2407.IX Item "--with-name=NAME" 2434.IX Item "--with-name=NAME"

Diff Legend

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