--- rxvt-unicode/README.configure 2009/12/30 06:14:03 1.64 +++ rxvt-unicode/README.configure 2023/02/13 17:29:02 1.89 @@ -9,7 +9,8 @@ --enable-everything Add (or remove) support for all non-multichoice options listed in - "./configure --help", except for "--enable-assert". + "./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,15 +27,15 @@ 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, they are not required for Xft fonts, although having them compiled in lets rxvt-unicode choose replacement fonts more intelligently. - Compiling them in will make your binary bigger (all of together cost - about 700kB), but it doesn't increase memory usage unless you use a - font requiring one of these encodings. + Compiling them in will make your binary bigger (all of them together + cost about 700kB), but it doesn't increase memory usage unless you + use a font requiring one of these encodings. all all available codeset groups zh common chinese encodings @@ -48,24 +49,24 @@ up the input for people using dead keys or compose keys. --enable-unicode3 (default: off) - Recommended to stay off unless you really need non-BMP characters. + Recommended to stay off unless you really need a lot of non-BMP + characters. - Enable direct support for displaying unicode codepoints above 65535 + Enable support for direct storage of unicode characters above 65535 (the basic multilingual page). This increases storage requirements per character from 2 to 4 bytes. X11 fonts do not yet support these extra characters, but Xft does. - Please note that rxvt-unicode can store unicode code points >65535 - even without this flag, but the number of such characters is limited - to a few thousand (shared with combining characters, see next - switch), and right now rxvt-unicode cannot display them - (input/output and cut&paste still work, though). + Please note that rxvt-unicode can store and display unicode + characters above 65535 even without this flag, but the number of + such characters is limited to a few thousand (shared with combining + characters, see next switch). --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. @@ -91,40 +92,20 @@ Use the given class as default application class when reading resources. Specify --with-res-class=Rxvt to replace rxvt. - --enable-utmp (default: on) - Write user and tty to utmp file (used by programs like w) at start - of rxvt execution and delete information when rxvt exits. - - --enable-wtmp (default: on) - Write user and tty to wtmp file (used by programs like last) at - start of rxvt execution and write logout when rxvt exits. This - option requires --enable-utmp to also be specified. - - --enable-lastlog (default: on) - Write user and tty to lastlog file (used by programs like lastlogin) - at start of rxvt execution. This option requires --enable-utmp to - 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 - (). - - 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 - 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-startup-notification (default: on) + Add support for freedesktop startup notifications. This allows + window managers to display some kind of progress indicator during + startup. --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 this feature depends 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,10 +144,10 @@ 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) @@ -177,13 +158,19 @@ hold on exit (-hold) compile in built-in block graphics skip builtin block graphics (-sbg) - separate highlightcolor support (-hc) + separate highlight colour (-highlightColor, -highlightTextColor) + focus reporting mode (1004). + extended mouse reporting modes (1005, 1006 and 1015). + visual selection via -visual and -depth. + systemd socket activation + selectable rewrapmode + bracketed paste mode 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 +182,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 +214,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 @@ -240,19 +227,32 @@ Enables the assertions in the code, normally disabled. This switch is only useful when developing rxvt-unicode. - --with-afterimage-config=DIR - Look for the libAfterImage config script in DIR. + --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-name=NAME (default: urxvt) Set the basename for the installed binaries, resulting in "urxvt", "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt". --with-term=NAME (default: rxvt-unicode) - Change the environmental variable for the terminal to NAME. + Sets the default "TERM" value that urxvt sets. The default is either + "rxvt-unicode" or "rxvt-unicode-256color", as appropriate. --with-terminfo=PATH - Change the environmental variable for the path to the terminfo tree - to PATH. + If set, urxvt will set the environment variable "TERMINFO" to the + given PATH, which can be useful as a last resort if installing the + terminfo entries system-wide is not possible. --with-x Use the X Window System (pretty much default, eh?).