README.configure

   1 CONFIGURE OPTIONS
   2     General hint: if you get compile errors, then likely your configuration
   3     hasn't been tested well. Either try with "--enable-everything" or use
   4     the default configuration (i.e. no "--enable-xxx" or "--disable-xxx"
   5     switches). Of course, you should always report when a combination
   6     doesn't work, so it can be fixed. Marc Lehmann <rxvt@schmorp.de>.
   7
   8     All
   9
  10     --enable-everything
  11         Add (or remove) support for all non-multichoice options listed in
  12         "./configure --help", except for "--enable-assert".
  13
  14         You can specify this and then disable options you do not like by
  15         *following* this with the appropriate "--disable-..." arguments, or
  16         you can start with a minimal configuration by specifying
  17         "--disable-everything" and than adding just the "--enable-..."
  18         arguments you want.
  19
  20     --enable-xft (default: enabled)
  21         Add support for Xft (anti-aliases, among others) fonts. Xft fonts
  22         are slower and require lots of memory, but as long as you don't use
  23         them, you don't pay for them.
  24
  25     --enable-font-styles (default: on)
  26         Add support for bold, *italic* and *bold italic* font styles. The
  27         fonts can be set manually or automatically.
  28
  29     --with-codesets=NAME,... (default: all)
  30         Compile in support for additional codeset (encoding) groups ("eu",
  31         "vn" are always compiled in, which includes most 8-bit character
  32         sets). These codeset tables are used for driving X11 core fonts,
  33         they are not required for Xft fonts, although having them compiled
  34         in lets rxvt-unicode choose replacement fonts more intelligently.
  35         Compiling them in will make your binary bigger (all of together cost
  36         about 700kB), but it doesn't increase memory usage unless you use a
  37         font requiring one of these encodings.
  38
  39    all             all available codeset groups
  40    zh              common chinese encodings
  41    zh_ext          rarely used but very big chinese encodings
  42    jp              common japanese encodings
  43    jp_ext          rarely used but big japanese encodings
  44    kr              korean encodings
  45     --enable-xim (default: on)
  46         Add support for XIM (X Input Method) protocol. This allows using
  47         alternative input methods (e.g. kinput2) and will also correctly set
  48         up the input for people using dead keys or compose keys.
  49
  50     --enable-unicode3 (default: off)
  51         Recommended to stay off unless you really need non-BMP characters.
  52
  53         Enable direct support for displaying unicode codepoints above 65535
  54         (the basic multilingual page). This increases storage requirements
  55         per character from 2 to 4 bytes. X11 fonts do not yet support these
  56         extra characters, but Xft does.
  57
  58         Please note that rxvt-unicode can store unicode code points >65535
  59         even without this flag, but the number of such characters is limited
  60         to a few thousand (shared with combining characters, see next
  61         switch), and right now rxvt-unicode cannot display them
  62         (input/output and cut&paste still work, though).
  63
  64     --enable-combining (default: on)
  65         Enable automatic composition of combining characters into composite
  66         characters. This is required for proper viewing of text where
  67         accents are encoded as separate unicode characters. This is done by
  68         using precomposited characters when available or creating new
  69         pseudo-characters when no precomposed form exists.
  70
  71         Without --enable-unicode3, the number of additional precomposed
  72         characters is somewhat limited (the 6400 private use characters will
  73         be (ab-)used). With --enable-unicode3, no practical limit exists.
  74
  75         This option will also enable storage (but not display) of characters
  76         beyond plane 0 (>65535) when --enable-unicode3 was not specified.
  77
  78         The combining table also contains entries for arabic presentation
  79         forms, but these are not currently used. Bug me if you want these to
  80         be used (and tell me how these are to be used...).
  81
  82     --enable-fallback(=CLASS) (default: Rxvt)
  83         When reading resource settings, also read settings for class CLASS.
  84         To disable resource fallback use --disable-fallback.
  85
  86     --with-res-name=NAME (default: urxvt)
  87         Use the given name as default application name when reading
  88         resources. Specify --with-res-name=rxvt to replace rxvt.
  89
  90     --with-res-class=CLASS (default: URxvt)
  91         Use the given class as default application class when reading
  92         resources. Specify --with-res-class=Rxvt to replace rxvt.
  93
  94     --enable-utmp (default: on)
  95         Write user and tty to utmp file (used by programs like w) at start
  96         of rxvt execution and delete information when rxvt exits.
  97
  98     --enable-wtmp (default: on)
  99         Write user and tty to wtmp file (used by programs like last) at
 100         start of rxvt execution and write logout when rxvt exits. This
 101         option requires --enable-utmp to also be specified.
 102
 103     --enable-lastlog (default: on)
 104         Write user and tty to lastlog file (used by programs like lastlogin)
 105         at start of rxvt execution. This option requires --enable-utmp to
 106         also be specified.
 107
 108     --enable-afterimage (default: on)
 109         Add support for libAfterImage to be used for transparency and
 110         background images. It adds support for many file formats including
 111         JPG, PNG, SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep
 112         image XML
 113         (<http://www.afterstep.org/visualdoc.php?show=asimagexml>).
 114
 115         This option also adds such eye candy as blending an image over the
 116         root background, as well as dynamic scaling and bluring of
 117         background images.
 118
 119         Note that with this option enabled, rxvt's memory footprint might
 120         increase by a few megabytes even if no extra features are used
 121         (mostly due to third-party libraries used by libAI). Memory
 122         footprint may somewhat be lowered if libAfterImage is configured
 123         without support for SVG.
 124
 125     --enable-transparency (default: on)
 126         Add support for backgrounds, creating illusion of transparency in
 127         the term.
 128
 129     --enable-fading (default: on)
 130         Add support for fading the text when focus is lost.
 131
 132     --enable-rxvt-scroll (default: on)
 133         Add support for the original rxvt scrollbar.
 134
 135     --enable-next-scroll (default: on)
 136         Add support for a NeXT-like scrollbar.
 137
 138     --enable-xterm-scroll (default: on)
 139         Add support for an Xterm-like scrollbar.
 140
 141     --disable-backspace-key
 142         Removes any handling of the backspace key by us - let the X server
 143         do it.
 144
 145     --disable-delete-key
 146         Removes any handling of the delete key by us - let the X server do
 147         it.
 148
 149     --disable-resources
 150         Removes any support for resource checking.
 151
 152     --disable-swapscreen
 153         Remove support for secondary/swap screen.
 154
 155     --enable-frills (default: on)
 156         Add support for many small features that are not essential but nice
 157         to have. Normally you want this, but for very small binaries you may
 158         want to disable this.
 159
 160         A non-exhaustive list of features enabled by "--enable-frills"
 161         (possibly in combination with other switches) is:
 162
 163           MWM-hints
 164           EWMH-hints (pid, utf8 names) and protocols (ping)
 165           urgency hint
 166           separate underline colour (-underlineColor)
 167           settable border widths and borderless switch (-w, -b, -bl)
 168           visual depth selection (-depth)
 169           settable extra linespacing /-lsp)
 170           iso-14755 5.1 (basic) support
 171           tripleclickwords (-tcw)
 172           settable insecure mode (-insecure)
 173           keysym remapping support
 174           cursor blinking and underline cursor (-bc, -uc)
 175           XEmbed support (-embed)
 176           user-pty (-pty-fd)
 177           hold on exit (-hold)
 178           compile in built-in block graphics
 179           skip builtin block graphics (-sbg)
 180           separate highlightcolor support (-hc)
 181
 182         It also enables some non-essential features otherwise disabled, such
 183         as:
 184
 185           some round-trip time optimisations
 186           nearest color allocation on pseudocolor screens
 187           UTF8_STRING support for selection
 188           sgr modes 90..97 and 100..107
 189           backindex and forwardindex escape sequences
 190           view change/zero scrollback escape sequences
 191           locale switching escape sequence
 192           window op and some xterm/OSC escape sequences
 193           rectangular selections
 194           trailing space removal for selections
 195           verbose X error handling
 196
 197     --enable-iso14755 (default: on)
 198         Enable extended ISO 14755 support (see rxvt(1)). Basic support
 199         (section 5.1) is enabled by "--enable-frills", while support for
 200         5.2, 5.3 and 5.4 is enabled with this switch.
 201
 202     --enable-keepscrolling (default: on)
 203         Add support for continual scrolling of the display when you hold the
 204         mouse button down on a scrollbar arrow.
 205
 206     --enable-selectionscrolling (default: on)
 207         Add support for scrolling when the selection moves to the top or
 208         bottom of the screen.
 209
 210     --enable-mousewheel (default: on)
 211         Add support for scrolling via mouse wheel or buttons 4 & 5.
 212
 213     --enable-slipwheeling (default: on)
 214         Add support for continual scrolling (using the mouse wheel as an
 215         accelerator) while the control key is held down. This option
 216         requires --enable-mousewheel to also be specified.
 217
 218     --enable-smart-resize (default: off)
 219         Add smart growth/shrink behaviour when resizing. This should keep
 220         the window corner which is closest to a corner of the screen in a
 221         fixed position.
 222
 223     --enable-text-blink (default: on)
 224         Add support for blinking text.
 225
 226     --enable-pointer-blank (default: on)
 227         Add support to have the pointer disappear when typing or inactive.
 228
 229     --enable-perl (default: on)
 230         Enable an embedded perl interpreter. See the rxvtperl(3) manpage for
 231         more info on this feature, or the files in src/perl/ for the
 232         extensions that are installed by default. The perl interpreter that
 233         is used can be specified via the "PERL" environment variable when
 234         running configure. Even when compiled in, perl will *not* be
 235         initialised when all extensions have been disabled "-pe ""
 236         --perl-ext-common """, so it should be safe to enable from a
 237         resource standpoint.
 238
 239     --enable-assert (default: off)
 240         Enables the assertions in the code, normally disabled. This switch
 241         is only useful when developing rxvt-unicode.
 242
 243     --with-afterimage-config=DIR
 244         Look for the libAfterImage config script in DIR.
 245
 246     --with-name=NAME (default: urxvt)
 247         Set the basename for the installed binaries, resulting in "urxvt",
 248         "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt".
 249
 250     --with-term=NAME (default: rxvt-unicode)
 251         Change the environmental variable for the terminal to NAME.
 252
 253     --with-terminfo=PATH
 254         Change the environmental variable for the path to the terminfo tree
 255         to PATH.
 256
 257     --with-x
 258         Use the X Window System (pretty much default, eh?).
 259