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

Diff Legend

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