--- rxvt-unicode/README.configure 2008/06/15 13:54:15 1.63 +++ rxvt-unicode/README.configure 2011/05/02 08:25:23 1.71 @@ -9,7 +9,8 @@ --enable-everything Add (or remove) support for all non-multichoice options listed in - "./configure --help". + "./configure --help", except for "--enable-assert" and + "--enable-256-color". You can specify this and then disable options you do not like by *following* this with the appropriate "--disable-..." arguments, or @@ -17,8 +18,8 @@ "--disable-everything" and than adding just the "--enable-..." arguments you want. - --enable-xft (default: enabled) - Add support for Xft (anti-aliases, among others) fonts. Xft fonts + --enable-xft (default: on) + Add support for Xft (anti-aliased, among others) fonts. Xft fonts are slower and require lots of memory, but as long as you don't use them, you don't pay for them. @@ -26,7 +27,7 @@ Add support for bold, *italic* and *bold italic* font styles. The fonts can be set manually or automatically. - --with-codesets=NAME,... (default: all) + --with-codesets=CS,... (default: all) Compile in support for additional codeset (encoding) groups ("eu", "vn" are always compiled in, which includes most 8-bit character sets). These codeset tables are used for driving X11 core fonts, @@ -64,8 +65,8 @@ --enable-combining (default: on) Enable automatic composition of combining characters into composite characters. This is required for proper viewing of text where - accents are encoded as seperate unicode characters. This is done by - using precomposited characters when available or creating new + accents are encoded as separate unicode characters. This is done by + using precomposed characters when available or creating new pseudo-characters when no precomposed form exists. Without --enable-unicode3, the number of additional precomposed @@ -79,7 +80,7 @@ forms, but these are not currently used. Bug me if you want these to be used (and tell me how these are to be used...). - --enable-fallback(=CLASS) (default: Rxvt) + --enable-fallback[=CLASS] (default: Rxvt) When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. @@ -106,25 +107,27 @@ also be specified. --enable-afterimage (default: on) - Add support for libAfterImage to be used for transparency and - background images. It adds support for many file formats including - JPG, PNG, SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep - image XML + Add support for libAfterImage to be used for background images. It + adds support for many file formats including JPG, PNG, SVG, TIFF, + GIF, XPM, BMP, ICO, XCF, TGA and AfterStep image XML (). - This option also adds such eye candy as blending an image over the - root background, as well as dynamic scaling and bluring of - background images. - - Note that with this option enabled, rxvt's memory footprint might + Note that with this option enabled, urxvt's memory footprint might increase by a few megabytes even if no extra features are used (mostly due to third-party libraries used by libAI). Memory footprint may somewhat be lowered if libAfterImage is configured without support for SVG. + --enable-pixbuf (default: on) + Add support for GDK-PixBuf to be used for background images. It adds + support for many file formats including JPG, PNG, TIFF, GIF, XPM, + BMP, ICO and TGA. + --enable-transparency (default: on) - Add support for backgrounds, creating illusion of transparency in - the term. + Add support for using the root pixmap as background to simulate + transparency. Note that blur and blend effects depend on + libAfterImage or on libXrender and on the availability of the RENDER + extension in the X server. --enable-fading (default: on) Add support for fading the text when focus is lost. @@ -163,27 +166,28 @@ MWM-hints EWMH-hints (pid, utf8 names) and protocols (ping) urgency hint - seperate underline colour (-underlineColor) + separate underline colour (-underlineColor) settable border widths and borderless switch (-w, -b, -bl) visual depth selection (-depth) - settable extra linespacing /-lsp) + settable extra linespacing (-lsp) iso-14755 5.1 (basic) support tripleclickwords (-tcw) settable insecure mode (-insecure) keysym remapping support - cursor blinking and underline cursor (-cb, -uc) + cursor blinking and underline cursor (-bc, -uc) XEmbed support (-embed) user-pty (-pty-fd) hold on exit (-hold) compile in built-in block graphics skip builtin block graphics (-sbg) - separate highlightcolor support (-hc) + separate highlight colour (-highlightColor, -highlightTextColor) + extended mouse reporting modes (1005 and 1015). It also enables some non-essential features otherwise disabled, such as: some round-trip time optimisations - nearest color allocation on pseudocolor screens + nearest colour allocation on pseudocolor screens UTF8_STRING support for selection sgr modes 90..97 and 100..107 backindex and forwardindex escape sequences @@ -195,7 +199,7 @@ verbose X error handling --enable-iso14755 (default: on) - Enable extended ISO 14755 support (see rxvt(1)). Basic support + Enable extended ISO 14755 support (see urxvt(1)). Basic support (section 5.1) is enabled by "--enable-frills", while support for 5.2, 5.3 and 5.4 is enabled with this switch. @@ -227,8 +231,8 @@ Add support to have the pointer disappear when typing or inactive. --enable-perl (default: on) - Enable an embedded perl interpreter. See the rxvtperl(3) manpage for - more info on this feature, or the files in src/perl/ for the + Enable an embedded perl interpreter. See the urxvtperl(3) manpage + for more info on this feature, or the files in src/perl/ for the extensions that are installed by default. The perl interpreter that is used can be specified via the "PERL" environment variable when running configure. Even when compiled in, perl will *not* be @@ -236,6 +240,24 @@ --perl-ext-common """, so it should be safe to enable from a resource standpoint. + --enable-assert (default: off) + Enables the assertions in the code, normally disabled. This switch + is only useful when developing rxvt-unicode. + + --enable-256-color (default: off) + Force use of so-called 256 colour mode, to work around buggy + applications that do not support termcap/terminfo, or simply improve + support for applications hardcoding the xterm 256 colour table. + + This switch breaks termcap/terminfo compatibility to + "TERM=rxvt-unicode", and consequently sets "TERM" to + "rxvt-unicode-256color" by default (doc/etc/ contains + termcap/terminfo definitions for both). + + It also results in higher memory usage and can slow down urxvt + dramatically when more than six fonts are in use by a terminal + instance. + --with-afterimage-config=DIR Look for the libAfterImage config script in DIR.