--- rxvt-unicode/README.configure 2005/12/22 16:44:10 1.32 +++ rxvt-unicode/README.configure 2007/06/02 05:07:11 1.54 @@ -1,10 +1,9 @@ CONFIGURE OPTIONS General hint: if you get compile errors, then likely your configuration hasn't been tested well. Either try with "--enable-everything" or use - the ./reconf script as a base for experiments. ./reconf is used by - myself, so it should generally be a working config. Of course, you - should always report when a combination doesn't work, so it can be - fixed. Marc Lehmann . + the default configuration (i.e. "--enable-xxx" or "--disable-xxx"). Of + course, you should always report when a combination doesn't work, so it + can be fixed. Marc Lehmann . All @@ -39,7 +38,7 @@ all all available codeset groups zh common chinese encodings - zh_ext rarely used but very big chinese encodigs + zh_ext rarely used but very big chinese encodings jp common japanese encodings jp_ext rarely used but big japanese encodings kr korean encodings @@ -50,6 +49,8 @@ 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. + Enable direct support for displaying unicode codepoints above 65535 (the basic multilingual page). This increases storage requirements per character from 2 to 4 bytes. X11 fonts do not yet support these @@ -69,9 +70,8 @@ pseudo-characters when no precomposed form exists. Without --enable-unicode3, the number of additional precomposed - characters is rather limited (2048, if this is full, rxvt-unicode - will use the private use area, extending the number of combinations - to 8448). With --enable-unicode3, no practical limit exists. + characters is somewhat limited (the 6400 private use characters will + be (ab-)used). With --enable-unicode3, no practical limit exists. This option will also enable storage (but not display) of characters beyond plane 0 (>65535) when --enable-unicode3 was not specified. @@ -106,10 +106,10 @@ at start of rxvt execution. This option requires --enable-utmp to also be specified. - --enable-xpm-background (default: off) + --enable-xpm-background (default: on) Add support for XPM background pixmaps. - --enable-transparency (default: off) + --enable-transparency (default: on) Add support for inheriting parent backgrounds thus giving a fake transparency to the term. @@ -121,10 +121,6 @@ Add support for tinting of transparent backgrounds (requires "--enable-transparency"). - --enable-menubar (default: off) - Add support for our menu bar system (this interacts badly with - dynamic locale switching currently). - --enable-rxvt-scroll (default: on) Add support for the original rxvt scrollbar. @@ -139,10 +135,6 @@ the favourite of the rxvt-unicode author, having used it for many years. - --enable-half-shadow (default: off) - Make shadows on the scrollbar only half the normal width & height. - only applicable to rxvt scrollbars. - --enable-ttygid (default: off) Change tty device setting to group "tty" - only use this if your system uses this type of security. @@ -158,22 +150,6 @@ --disable-resources Removes any support for resource checking. - --enable-xgetdefault - Make resources checking via XGetDefault() instead of our small - version which only checks ~/.Xdefaults, or if that doesn't exist - then ~/.Xresources. - - Please note that nowadays, things like XIM will automatically pull - in and use the full X resource manager, so the overhead of using it - might be very small, if nonexistant. - - --enable-strings (default: off) - Add support for our possibly faster memset() function and other - various routines, overriding your system's versions which may have - been hand-crafted in assembly or may require extra libraries to link - in. (this breaks ANSI-C rules and has problems on many GNU/Linux - systems). - --disable-swapscreen Remove support for secondary/swap screen. @@ -187,17 +163,36 @@ MWM-hints EWMH-hints (pid, utf8 names) and protocols (ping) - seperate underline colour - settable border widths and borderless switch - settable extra linespacing - iso-14755-2 and -3, and visual feedback - backindex and forwardindex escape sequence - window op and some xterm/OSC escape sequences - tripleclickwords - settable insecure mode + urgency hint + seperate underline colour (-underlineColor) + settable border widths and borderless switch (-w, -b, -bl) + visual depth selection (-depth) + settable extra linespacing /-lsp) + iso-14755 5.1 (basic) support + tripleclickwords (-tcw) + settable insecure mode (-insecure) keysym remapping support - cursor blinking and underline cursor - -embed, -pty-fd and -hold options + cursor blinking and underline cursor (-cb, -uc) + XEmbed support (-embed) + user-pty (-pty-fd) + hold on exit (-hold) + skip builtin block graphics (-sbg) + separate highlightcolor support (-hc) + + It also enables some non-essential features otherwise disabled, such + as: + + some round-trip time optimisations + nearest color allocation on pseudocolor screens + UTF8_STRING support for selection + sgr modes 90..97 and 100..107 + backindex and forwardindex escape sequences + view change/zero scrollback escape sequences + locale switching escape sequence + window op and some xterm/OSC escape sequences + rectangular selections + trailing space removal for selections + verbose X error handling --enable-iso14755 (default: on) Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt). @@ -221,7 +216,7 @@ --enable-dmalloc (default: off) Use Gray Watson's malloc - which is good for debugging See - http://www.letters.com/dmalloc/ for details If you use either this + for details If you use either this or the next option, you may need to edit src/Makefile after compiling to point DINCLUDE and DLIB to the right places. @@ -240,6 +235,13 @@ --enable-pointer-blank (default: on) 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 + (doc/rxvtperl.txt) for more info on this feature, or the files in + src/perl-ext/ 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. + --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".