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.26 by root, Tue Nov 8 17:35:28 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-11-08" "5.8" "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?"
… …
603rxvt-unicode then uses 8 bytes per screen cell. 637rxvt-unicode then uses 8 bytes per screen cell.
604.IP "Can I speed up Xft rendering somehow?" 4 638.IP "Can I speed up Xft rendering somehow?" 4
605.IX Item "Can I speed up Xft rendering somehow?" 639.IX Item "Can I speed up Xft rendering somehow?"
606Yes, the most obvious way to speed it up is to avoid Xft entirely, as 640Yes, the most obvious way to speed it up is to avoid Xft entirely, as
607it is simply slow. If you still want Xft fonts you might try to disable 641it is simply slow. If you still want Xft fonts you might try to disable
608antialiasing (by appending \f(CW\*(C`:antialiasing=false\*(C'\fR), which saves lots of 642antialiasing (by appending \f(CW\*(C`:antialias=false\*(C'\fR), which saves lots of
609memory and also speeds up rendering considerably. 643memory and also speeds up rendering considerably.
610.IP "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?" 4 644.IP "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?" 4
611.IX Item "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?" 645.IX Item "Rxvt-unicode doesn't seem to anti-alias its fonts, what is wrong?"
612Rxvt-unicode will use whatever you specify as a font. If it needs to 646Rxvt-unicode will use whatever you specify as a font. If it needs to
613fall back to it's default font search list it will prefer X11 core 647fall back to it's default font search list it will prefer X11 core
… …
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"
… …
2163.TE 2191.TE
2164 2192
2165.SH "CONFIGURE OPTIONS" 2193.SH "CONFIGURE OPTIONS"
2166.IX Header "CONFIGURE OPTIONS" 2194.IX Header "CONFIGURE OPTIONS"
2167General hint: if you get compile errors, then likely your configuration 2195General hint: if you get compile errors, then likely your configuration
2168hasn't been tested well. Either try with \-\-enable\-everything or use the 2196hasn't been tested well. Either try with \f(CW\*(C`\-\-enable\-everything\*(C'\fR or use
2169\&./reconf script as a base for experiments. ./reconf is used by myself, 2197the \fI./reconf\fR script as a base for experiments. \fI./reconf\fR is used by
2170so it should generally be a working config. Of course, you should always 2198myself, so it should generally be a working config. Of course, you should
2171report when a combination doesn't work, so it can be fixed. Marc Lehmann 2199always report when a combination doesn't work, so it can be fixed. Marc
2172<rxvt@schmorp.de>. 2200Lehmann <rxvt@schmorp.de>.
2201.PP
2202All
2173.IP "\-\-enable\-everything" 4 2203.IP "\-\-enable\-everything" 4
2174.IX Item "--enable-everything" 2204.IX Item "--enable-everything"
2175Add support for all non-multichoice options listed in \*(L"./configure 2205Add (or remove) support for all non-multichoice options listed in \*(L"./configure
2176\&\-\-help\*(R". Note that unlike other enable options this is order dependant. 2206\&\-\-help\*(R".
2207.Sp
2177You can specify this and then disable options which this enables by 2208You can specify this and then disable options you do not like by
2178\&\fIfollowing\fR this with the appropriate commands. 2209\&\fIfollowing\fR this with the appropriate \f(CW\*(C`\-\-disable\-...\*(C'\fR arguments,
2179.IP "\-\-enable\-xft" 4 2210or you can start with a minimal configuration by specifying
2180.IX Item "--enable-xft" 2211\&\f(CW\*(C`\-\-disable\-everything\*(C'\fR and than adding just the \f(CW\*(C`\-\-enable\-...\*(C'\fR arguments
2212you want.
2213.IP "\-\-enable\-xft (default: enabled)" 4
2214.IX Item "--enable-xft (default: enabled)"
2181Add support for Xft (anti\-aliases, among others) fonts. Xft fonts are 2215Add support for Xft (anti\-aliases, among others) fonts. Xft fonts are
2182slower and require lots of memory, but as long as you don't use them, you 2216slower and require lots of memory, but as long as you don't use them, you
2183don't pay for them. 2217don't pay for them.
2184.IP "\-\-enable\-font\-styles" 4 2218.IP "\-\-enable\-font\-styles (default: on)" 4
2185.IX Item "--enable-font-styles" 2219.IX Item "--enable-font-styles (default: on)"
2186Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font 2220Add support for \fBbold\fR, \fIitalic\fR and \fB\f(BIbold italic\fB\fR font
2187styles. The fonts can be set manually or automatically. 2221styles. The fonts can be set manually or automatically.
2188.IP "\-\-with\-codesets=NAME,..." 4 2222.IP "\-\-with\-codesets=NAME,... (default: all)" 4
2189.IX Item "--with-codesets=NAME,..." 2223.IX Item "--with-codesets=NAME,... (default: all)"
2190Compile in support for additional codeset (encoding) groups (eu, vn are 2224Compile 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 2225are always compiled in, which includes most 8\-bit character sets). These
2192codeset tables are currently only used for driving X11 core fonts, they 2226codeset 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 2227for Xft fonts, although having them compiled in lets rxvt-unicode choose
2194bigger (together about 700kB), but it doesn't increase memory usage unless 2228replacement fonts more intelligently. Compiling them in will make your
2229binary bigger (all of together cost about 700kB), but it doesn't increase
2195you use an X11 font requiring one of these encodings. 2230memory usage unless you use a font requiring one of these encodings.
2196.TS 2231.TS
2197l l . 2232l l .
2198all all available codeset groups 2233all all available codeset groups
2199zh common chinese encodings 2234zh common chinese encodings
2200zh_ext rarely used but very big chinese encodigs 2235zh_ext rarely used but very big chinese encodigs
2201jp common japanese encodings 2236jp common japanese encodings
2202jp_ext rarely used but big japanese encodings 2237jp_ext rarely used but big japanese encodings
2203kr korean encodings 2238kr korean encodings
2204.TE 2239.TE
2205 2240
2206.IP "\-\-enable\-xim" 4 2241.IP "\-\-enable\-xim (default: on)" 4
2207.IX Item "--enable-xim" 2242.IX Item "--enable-xim (default: on)"
2208Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using 2243Add support for \s-1XIM\s0 (X Input Method) protocol. This allows using
2209alternative input methods (e.g. kinput2) and will also correctly 2244alternative input methods (e.g. kinput2) and will also correctly
2210set up the input for people using dead keys or compose keys. 2245set up the input for people using dead keys or compose keys.
2211.IP "\-\-enable\-unicode3" 4 2246.IP "\-\-enable\-unicode3 (default: off)" 4
2212.IX Item "--enable-unicode3" 2247.IX Item "--enable-unicode3 (default: off)"
2213Enable direct support for displaying unicode codepoints above 2248Enable direct support for displaying unicode codepoints above
221465535 (the basic multilingual page). This increases storage 224965535 (the basic multilingual page). This increases storage
2215requirements per character from 2 to 4 bytes. X11 fonts do not yet 2250requirements per character from 2 to 4 bytes. X11 fonts do not yet
2216support these extra characters, but Xft does. 2251support these extra characters, but Xft does.
2217.Sp 2252.Sp
2218Please note that rxvt-unicode can store unicode code points >65535 2253Please note that rxvt-unicode can store unicode code points >65535
2219even without this flag, but the number of such characters is 2254even without this flag, but the number of such characters is
2220limited to a view thousand (shared with combining characters, 2255limited to a view thousand (shared with combining characters,
2221see next switch), and right now rxvt-unicode cannot display them 2256see next switch), and right now rxvt-unicode cannot display them
2222(input/output and cut&paste still work, though). 2257(input/output and cut&paste still work, though).
2223.IP "\-\-enable\-combining" 4 2258.IP "\-\-enable\-combining (default: on)" 4
2224.IX Item "--enable-combining" 2259.IX Item "--enable-combining (default: on)"
2225Enable automatic composition of combining characters into 2260Enable automatic composition of combining characters into
2226composite characters. This is required for proper viewing of text 2261composite characters. This is required for proper viewing of text
2227where accents are encoded as seperate unicode characters. This is 2262where accents are encoded as seperate unicode characters. This is
2228done by using precomposited characters when available or creating 2263done by using precomposited characters when available or creating
2229new pseudo-characters when no precomposed form exists. 2264new pseudo-characters when no precomposed form exists.
… …
2237beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified. 2272beyond plane 0 (>65535) when \-\-enable\-unicode3 was not specified.
2238.Sp 2273.Sp
2239The combining table also contains entries for arabic presentation forms, 2274The combining table also contains entries for arabic presentation forms,
2240but these are not currently used. Bug me if you want these to be used (and 2275but these are not currently used. Bug me if you want these to be used (and
2241tell me how these are to be used...). 2276tell me how these are to be used...).
2242.IP "\-\-enable\-fallback(=CLASS)" 4 2277.IP "\-\-enable\-fallback(=CLASS) (default: Rxvt)" 4
2243.IX Item "--enable-fallback(=CLASS)" 2278.IX Item "--enable-fallback(=CLASS) (default: Rxvt)"
2244When reading resource settings, also read settings for class \s-1CLASS\s0 2279When reading resource settings, also read settings for class \s-1CLASS\s0. To disable resource fallback use \-\-disable\-fallback.
2245(default: Rxvt). To disable resource fallback use \-\-disable\-fallback.
2246.IP "\-\-with\-res\-name=NAME" 4 2280.IP "\-\-with\-res\-name=NAME (default: urxvt)" 4
2247.IX Item "--with-res-name=NAME" 2281.IX Item "--with-res-name=NAME (default: urxvt)"
2248Use the given name (default: urxvt) as default application name when 2282Use the given name as default application name when
2249reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt. 2283reading resources. Specify \-\-with\-res\-name=rxvt to replace rxvt.
2250.IP "\-\-with\-res\-class=CLASS" 4 2284.IP "\-\-with\-res\-class=CLASS /default: URxvt)" 4
2251.IX Item "--with-res-class=CLASS" 2285.IX Item "--with-res-class=CLASS /default: URxvt)"
2252Use the given class (default: URxvt) as default application class 2286Use the given class as default application class
2253when reading resources. Specify \-\-with\-res\-class=Rxvt to replace 2287when reading resources. Specify \-\-with\-res\-class=Rxvt to replace
2254rxvt. 2288rxvt.
2255.IP "\-\-enable\-utmp" 4 2289.IP "\-\-enable\-utmp (default: on)" 4
2256.IX Item "--enable-utmp" 2290.IX Item "--enable-utmp (default: on)"
2257Write user and tty to utmp file (used by programs like \fIw\fR) at 2291Write user and tty to utmp file (used by programs like \fIw\fR) at
2258start of rxvt execution and delete information when rxvt exits. 2292start of rxvt execution and delete information when rxvt exits.
2259.IP "\-\-enable\-wtmp" 4 2293.IP "\-\-enable\-wtmp (default: on)" 4
2260.IX Item "--enable-wtmp" 2294.IX Item "--enable-wtmp (default: on)"
2261Write user and tty to wtmp file (used by programs like \fIlast\fR) at 2295Write user and tty to wtmp file (used by programs like \fIlast\fR) at
2262start of rxvt execution and write logout when rxvt exits. This 2296start of rxvt execution and write logout when rxvt exits. This
2263option requires \-\-enable\-utmp to also be specified. 2297option requires \-\-enable\-utmp to also be specified.
2264.IP "\-\-enable\-lastlog" 4 2298.IP "\-\-enable\-lastlog (default: on)" 4
2265.IX Item "--enable-lastlog" 2299.IX Item "--enable-lastlog (default: on)"
2266Write user and tty to lastlog file (used by programs like 2300Write user and tty to lastlog file (used by programs like
2267\&\fIlastlogin\fR) at start of rxvt execution. This option requires 2301\&\fIlastlogin\fR) at start of rxvt execution. This option requires
2268\&\-\-enable\-utmp to also be specified. 2302\&\-\-enable\-utmp to also be specified.
2269.IP "\-\-enable\-xpm\-background" 4 2303.IP "\-\-enable\-xpm\-background (default: off)" 4
2270.IX Item "--enable-xpm-background" 2304.IX Item "--enable-xpm-background (default: off)"
2271Add support for \s-1XPM\s0 background pixmaps. 2305Add support for \s-1XPM\s0 background pixmaps.
2272.IP "\-\-enable\-transparency" 4 2306.IP "\-\-enable\-transparency (default: off)" 4
2273.IX Item "--enable-transparency" 2307.IX Item "--enable-transparency (default: off)"
2274Add support for inheriting parent backgrounds thus giving a fake 2308Add support for inheriting parent backgrounds thus giving a fake
2275transparency to the term. 2309transparency to the term.
2276.IP "\-\-enable\-fading" 4 2310.IP "\-\-enable\-fading (default: on)" 4
2277.IX Item "--enable-fading" 2311.IX Item "--enable-fading (default: on)"
2278Add support for fading the text when focus is lost. 2312Add support for fading the text when focus is lost (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR).
2279.IP "\-\-enable\-tinting" 4 2313.IP "\-\-enable\-tinting (default: on)" 4
2280.IX Item "--enable-tinting" 2314.IX Item "--enable-tinting (default: on)"
2281Add support for tinting of transparent backgrounds. 2315Add support for tinting of transparent backgrounds (requires \f(CW\*(C`\-\-enable\-transparency\*(C'\fR).
2282.IP "\-\-enable\-menubar" 4 2316.IP "\-\-enable\-menubar (default: off)" 4
2283.IX Item "--enable-menubar" 2317.IX Item "--enable-menubar (default: off)"
2284Add support for our menu bar system (this interacts badly with 2318Add support for our menu bar system (this interacts badly with
2285dynamic locale switching currently). 2319dynamic locale switching currently).
2286.IP "\-\-enable\-rxvt\-scroll" 4 2320.IP "\-\-enable\-rxvt\-scroll (default: on)" 4
2287.IX Item "--enable-rxvt-scroll" 2321.IX Item "--enable-rxvt-scroll (default: on)"
2288Add support for the original rxvt scrollbar. 2322Add support for the original rxvt scrollbar.
2289.IP "\-\-enable\-next\-scroll" 4 2323.IP "\-\-enable\-next\-scroll (default: on)" 4
2290.IX Item "--enable-next-scroll" 2324.IX Item "--enable-next-scroll (default: on)"
2291Add support for a NeXT-like scrollbar. 2325Add support for a NeXT-like scrollbar.
2292.IP "\-\-enable\-xterm\-scroll" 4 2326.IP "\-\-enable\-xterm\-scroll (default: on)" 4
2293.IX Item "--enable-xterm-scroll" 2327.IX Item "--enable-xterm-scroll (default: on)"
2294Add support for an Xterm-like scrollbar. 2328Add support for an Xterm-like scrollbar.
2295.IP "\-\-enable\-plain\-scroll" 4 2329.IP "\-\-enable\-plain\-scroll (default: on)" 4
2296.IX Item "--enable-plain-scroll" 2330.IX Item "--enable-plain-scroll (default: on)"
2297Add support for a very unobtrusive, plain-looking scrollbar that 2331Add support for a very unobtrusive, plain-looking scrollbar that
2298is the favourite of the rxvt-unicode author, having used it for 2332is the favourite of the rxvt-unicode author, having used it for
2299many years. 2333many years.
2300.IP "\-\-enable\-half\-shadow" 4 2334.IP "\-\-enable\-half\-shadow (default: off)" 4
2301.IX Item "--enable-half-shadow" 2335.IX Item "--enable-half-shadow (default: off)"
2302Make shadows on the scrollbar only half the normal width & height. 2336Make shadows on the scrollbar only half the normal width & height.
2303only applicable to rxvt scrollbars. 2337only applicable to rxvt scrollbars.
2304.IP "\-\-enable\-ttygid" 4 2338.IP "\-\-enable\-ttygid (default: off)" 4
2305.IX Item "--enable-ttygid" 2339.IX Item "--enable-ttygid (default: off)"
2306Change tty device setting to group \*(L"tty\*(R" \- only use this if 2340Change tty device setting to group \*(L"tty\*(R" \- only use this if
2307your system uses this type of security. 2341your system uses this type of security.
2308.IP "\-\-disable\-backspace\-key" 4 2342.IP "\-\-disable\-backspace\-key" 4
2309.IX Item "--disable-backspace-key" 2343.IX Item "--disable-backspace-key"
2310Disable any handling of the backspace key by us \- let the X server 2344Removes any handling of the backspace key by us \- let the X server do it.
2311do it.
2312.IP "\-\-disable\-delete\-key" 4 2345.IP "\-\-disable\-delete\-key" 4
2313.IX Item "--disable-delete-key" 2346.IX Item "--disable-delete-key"
2314Disable any handling of the delete key by us \- let the X server 2347Removes any handling of the delete key by us \- let the X server
2315do it. 2348do it.
2316.IP "\-\-disable\-resources" 4 2349.IP "\-\-disable\-resources" 4
2317.IX Item "--disable-resources" 2350.IX Item "--disable-resources"
2318Remove all resources checking. 2351Removes any support for resource checking.
2319.IP "\-\-enable\-xgetdefault" 4 2352.IP "\-\-enable\-xgetdefault" 4
2320.IX Item "--enable-xgetdefault" 2353.IX Item "--enable-xgetdefault"
2321Make resources checking via \fIXGetDefault()\fR instead of our small 2354Make resources checking via \fIXGetDefault()\fR instead of our small
2322version which only checks ~/.Xdefaults, or if that doesn't exist then 2355version which only checks ~/.Xdefaults, or if that doesn't exist then
2323~/.Xresources. 2356~/.Xresources.
2324.Sp 2357.Sp
2325Please note that nowadays, things like \s-1XIM\s0 will automatically pull in and 2358Please note that nowadays, things like \s-1XIM\s0 will automatically pull in and
2326use the full X resource manager, so the overhead of using it might be very 2359use the full X resource manager, so the overhead of using it might be very
2327small, if nonexistant. 2360small, if nonexistant.
2328.IP "\-\-enable\-strings" 4 2361.IP "\-\-enable\-strings (default: off)" 4
2329.IX Item "--enable-strings" 2362.IX Item "--enable-strings (default: off)"
2330Add support for our possibly faster \fImemset()\fR function and other 2363Add support for our possibly faster \fImemset()\fR function and other
2331various routines, overriding your system's versions which may 2364various routines, overriding your system's versions which may
2332have been hand-crafted in assembly or may require extra libraries 2365have been hand-crafted in assembly or may require extra libraries
2333to link in. (this breaks ANSI-C rules and has problems on many 2366to link in. (this breaks ANSI-C rules and has problems on many
2334GNU/Linux systems). 2367GNU/Linux systems).
2335.IP "\-\-disable\-swapscreen" 4 2368.IP "\-\-disable\-swapscreen" 4
2336.IX Item "--disable-swapscreen" 2369.IX Item "--disable-swapscreen"
2337Remove support for swap screen. 2370Remove support for secondary/swap screen.
2338.IP "\-\-enable\-frills" 4 2371.IP "\-\-enable\-frills (default: on)" 4
2339.IX Item "--enable-frills" 2372.IX Item "--enable-frills (default: on)"
2340Add support for many small features that are not essential but nice to 2373Add support for many small features that are not essential but nice to
2341have. Normally you want this, but for very small binaries you may want to 2374have. Normally you want this, but for very small binaries you may want to
2342disable this. 2375disable this.
2343.Sp 2376.Sp
2344A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly 2377A non-exhaustive list of features enabled by \f(CW\*(C`\-\-enable\-frills\*(C'\fR (possibly
2345in combination with other switches) is: 2378in combination with other switches) is:
2346.Sp 2379.Sp
2347.Vb 12 2380.Vb 13
2348\& MWM-hints 2381\& MWM-hints
2349\& EWMH-hints (pid, utf8 names) and protocols (ping) 2382\& EWMH-hints (pid, utf8 names) and protocols (ping)
2350\& seperate underline colour 2383\& seperate underline colour
2351\& settable border widths and borderless switch 2384\& settable border widths and borderless switch
2352\& settable extra linespacing 2385\& settable extra linespacing
2353\& iso-14755-2 and -3, and visual feedback 2386\& iso-14755-2 and -3, and visual feedback
2354\& backindex and forwardindex escape sequence 2387\& backindex and forwardindex escape sequence
2355\& window op and locale change escape sequences 2388\& window op and some xterm/OSC escape sequences
2356\& tripleclickwords 2389\& tripleclickwords
2357\& settable insecure mode 2390\& settable insecure mode
2358\& keysym remapping support 2391\& keysym remapping support
2392\& cursor blinking and underline cursor
2359\& -embed and -pty-fd options 2393\& -embed and -pty-fd options
2360.Ve 2394.Ve
2361.IP "\-\-enable\-iso14755" 4 2395.IP "\-\-enable\-iso14755 (default: on)" 4
2362.IX Item "--enable-iso14755" 2396.IX Item "--enable-iso14755 (default: on)"
2363Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or 2397Enable extended \s-1ISO\s0 14755 support (see @@RXVT_NAME@@(1), or
2364\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by 2398\&\fIdoc/rxvt.1.txt\fR). Basic support (section 5.1) is enabled by
2365\&\f(CW\*(C`\-\-enable\-frills\*(C'\fR, while support for 5.2, 5.3 and 5.4 is enabled with 2399\&\f(CW\*(C`\-\-enable\-frills\*(C'\fR, while support for 5.2, 5.3 and 5.4 is enabled with
2366this switch. 2400this switch.
2367.IP "\-\-enable\-keepscrolling" 4 2401.IP "\-\-enable\-keepscrolling (default: on)" 4
2368.IX Item "--enable-keepscrolling" 2402.IX Item "--enable-keepscrolling (default: on)"
2369Add support for continual scrolling of the display when you hold 2403Add support for continual scrolling of the display when you hold
2370the mouse button down on a scrollbar arrow. 2404the mouse button down on a scrollbar arrow.
2371.IP "\-\-enable\-mousewheel" 4 2405.IP "\-\-enable\-mousewheel (default: on)" 4
2372.IX Item "--enable-mousewheel" 2406.IX Item "--enable-mousewheel (default: on)"
2373Add support for scrolling via mouse wheel or buttons 4 & 5. 2407Add support for scrolling via mouse wheel or buttons 4 & 5.
2374.IP "\-\-enable\-slipwheeling" 4 2408.IP "\-\-enable\-slipwheeling (default: on)" 4
2375.IX Item "--enable-slipwheeling" 2409.IX Item "--enable-slipwheeling (default: on)"
2376Add support for continual scrolling (using the mouse wheel as an 2410Add support for continual scrolling (using the mouse wheel as an
2377accelerator) while the control key is held down. This option 2411accelerator) while the control key is held down. This option
2378requires \-\-enable\-mousewheel to also be specified. 2412requires \-\-enable\-mousewheel to also be specified.
2379.IP "\-\-disable\-new\-selection" 4 2413.IP "\-\-disable\-new\-selection" 4
2380.IX Item "--disable-new-selection" 2414.IX Item "--disable-new-selection"
2381Remove support for mouse selection style like that of xterm. 2415Remove support for mouse selection style like that of xterm.
2382.IP "\-\-enable\-dmalloc" 4 2416.IP "\-\-enable\-dmalloc (default: off)" 4
2383.IX Item "--enable-dmalloc" 2417.IX Item "--enable-dmalloc (default: off)"
2384Use Gray Watson's malloc \- which is good for debugging See 2418Use Gray Watson's malloc \- which is good for debugging See
2385http://www.letters.com/dmalloc/ for details If you use either this or the 2419http://www.letters.com/dmalloc/ for details If you use either this or the
2386next option, you may need to edit src/Makefile after compiling to point 2420next option, you may need to edit src/Makefile after compiling to point
2387\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places. 2421\&\s-1DINCLUDE\s0 and \s-1DLIB\s0 to the right places.
2388.Sp 2422.Sp
2389You can only use either this option and the following (should 2423You can only use either this option and the following (should
2390you use either) . 2424you use either) .
2391.IP "\-\-enable\-dlmalloc" 4 2425.IP "\-\-enable\-dlmalloc (default: off)" 4
2392.IX Item "--enable-dlmalloc" 2426.IX Item "--enable-dlmalloc (default: off)"
2393Use Doug Lea's malloc \- which is good for a production version 2427Use Doug Lea's malloc \- which is good for a production version
2394See <http://g.oswego.edu/dl/html/malloc.html> for details. 2428See <http://g.oswego.edu/dl/html/malloc.html> for details.
2395.IP "\-\-enable\-smart\-resize" 4 2429.IP "\-\-enable\-smart\-resize (default: on)" 4
2396.IX Item "--enable-smart-resize" 2430.IX Item "--enable-smart-resize (default: on)"
2397Add smart growth/shrink behaviour when changing font size via from hot 2431Add smart growth/shrink behaviour when changing font size via hot
2398keys. This should keep in a fixed position the rxvt corner which is 2432keys. This should keep in a fixed position the @@RXVT_NAME@@ corner which is
2399closest to a corner of the screen. 2433closest 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 2434.IP "\-\-enable\-pointer\-blank (default: on)" 4
2404.IX Item "--enable-pointer-blank" 2435.IX Item "--enable-pointer-blank (default: on)"
2405Add support to have the pointer disappear when typing or inactive. 2436Add support to have the pointer disappear when typing or inactive.
2406.IP "\-\-with\-name=NAME" 4 2437.IP "\-\-with\-name=NAME (default: urxvt)" 4
2407.IX Item "--with-name=NAME" 2438.IX Item "--with-name=NAME (default: urxvt)"
2408Set the basename for the installed binaries (default: \f(CW\*(C`urxvt\*(C'\fR, resulting 2439Set the basename for the installed binaries, resulting
2409in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with 2440in \f(CW\*(C`urxvt\*(C'\fR, \f(CW\*(C`urxvtd\*(C'\fR etc.). Specify \f(CW\*(C`\-\-with\-name=rxvt\*(C'\fR to replace with
2410\&\f(CW\*(C`rxvt\*(C'\fR. 2441\&\f(CW\*(C`rxvt\*(C'\fR.
2411.IP "\-\-with\-term=NAME" 4 2442.IP "\-\-with\-term=NAME (default: rxvt\-unicode)" 4
2412.IX Item "--with-term=NAME" 2443.IX Item "--with-term=NAME (default: rxvt-unicode)"
2413Change the environmental variable for the terminal to \s-1NAME\s0 (default 2444Change the environmental variable for the terminal to \s-1NAME\s0.
2414\&\f(CW\*(C`rxvt\-unicode\*(C'\fR)
2415.IP "\-\-with\-terminfo=PATH" 4 2445.IP "\-\-with\-terminfo=PATH" 4
2416.IX Item "--with-terminfo=PATH" 2446.IX Item "--with-terminfo=PATH"
2417Change the environmental variable for the path to the terminfo tree to 2447Change the environmental variable for the path to the terminfo tree to
2418\&\s-1PATH\s0. 2448\&\s-1PATH\s0.
2419.IP "\-\-with\-x" 4 2449.IP "\-\-with\-x" 4

Diff Legend

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