… | |
… | |
2185 | =end table |
2185 | =end table |
2186 | |
2186 | |
2187 | =head1 CONFIGURE OPTIONS |
2187 | =head1 CONFIGURE OPTIONS |
2188 | |
2188 | |
2189 | General hint: if you get compile errors, then likely your configuration |
2189 | General hint: if you get compile errors, then likely your configuration |
2190 | hasn't been tested well. Either try with --enable-everything or use the |
2190 | hasn't been tested well. Either try with C<--enable-everything> or use |
2191 | ./reconf script as a base for experiments. ./reconf is used by myself, |
2191 | the F<./reconf> script as a base for experiments. F<./reconf> is used by |
2192 | so it should generally be a working config. Of course, you should always |
2192 | myself, so it should generally be a working config. Of course, you should |
2193 | report when a combination doesn't work, so it can be fixed. Marc Lehmann |
2193 | always report when a combination doesn't work, so it can be fixed. Marc |
2194 | <rxvt@schmorp.de>. |
2194 | Lehmann <rxvt@schmorp.de>. |
|
|
2195 | |
|
|
2196 | All |
2195 | |
2197 | |
2196 | =over 4 |
2198 | =over 4 |
2197 | |
2199 | |
2198 | =item --enable-everything |
2200 | =item --enable-everything |
2199 | |
2201 | |
2200 | Add support for all non-multichoice options listed in "./configure |
2202 | Add (or remove) support for all non-multichoice options listed in "./configure |
2201 | --help". Note that unlike other enable options this is order dependant. |
2203 | --help". |
|
|
2204 | |
2202 | You can specify this and then disable options which this enables by |
2205 | You can specify this and then disable options you do not like by |
2203 | I<following> this with the appropriate commands. |
2206 | I<following> this with the appropriate C<--disable-...> arguments, |
|
|
2207 | or you can start with a minimal configuration by specifying |
|
|
2208 | C<--disable-everything> and than adding just the C<--enable-...> arguments |
|
|
2209 | you want. |
2204 | |
2210 | |
2205 | =item --enable-xft |
2211 | =item --enable-xft (default: enabled) |
2206 | |
2212 | |
2207 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts are |
2213 | Add support for Xft (anti-aliases, among others) fonts. Xft fonts are |
2208 | slower and require lots of memory, but as long as you don't use them, you |
2214 | slower and require lots of memory, but as long as you don't use them, you |
2209 | don't pay for them. |
2215 | don't pay for them. |
2210 | |
2216 | |
2211 | =item --enable-font-styles |
2217 | =item --enable-font-styles (default: on) |
2212 | |
2218 | |
2213 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
2219 | Add support for B<bold>, I<italic> and B<< I<bold italic> >> font |
2214 | styles. The fonts can be set manually or automatically. |
2220 | styles. The fonts can be set manually or automatically. |
2215 | |
2221 | |
2216 | =item --with-codesets=NAME,... |
2222 | =item --with-codesets=NAME,... (default: all) |
2217 | |
2223 | |
2218 | Compile in support for additional codeset (encoding) groups (C<eu>, C<vn> |
2224 | Compile in support for additional codeset (encoding) groups (C<eu>, C<vn> |
2219 | are always compiled in, which includes most 8-bit character sets). These |
2225 | are always compiled in, which includes most 8-bit character sets). These |
2220 | codeset tables are used for driving X11 core fonts, they are not required |
2226 | codeset tables are used for driving X11 core fonts, they are not required |
2221 | for Xft fonts, although having them compiled in lets rxvt-unicode choose |
2227 | for Xft fonts, although having them compiled in lets rxvt-unicode choose |
… | |
… | |
2232 | jp_ext rarely used but big japanese encodings |
2238 | jp_ext rarely used but big japanese encodings |
2233 | kr korean encodings |
2239 | kr korean encodings |
2234 | |
2240 | |
2235 | =end table |
2241 | =end table |
2236 | |
2242 | |
2237 | =item --enable-xim |
2243 | =item --enable-xim (default: on) |
2238 | |
2244 | |
2239 | Add support for XIM (X Input Method) protocol. This allows using |
2245 | Add support for XIM (X Input Method) protocol. This allows using |
2240 | alternative input methods (e.g. kinput2) and will also correctly |
2246 | alternative input methods (e.g. kinput2) and will also correctly |
2241 | set up the input for people using dead keys or compose keys. |
2247 | set up the input for people using dead keys or compose keys. |
2242 | |
2248 | |
2243 | =item --enable-unicode3 |
2249 | =item --enable-unicode3 (default: off) |
2244 | |
2250 | |
2245 | Enable direct support for displaying unicode codepoints above |
2251 | Enable direct support for displaying unicode codepoints above |
2246 | 65535 (the basic multilingual page). This increases storage |
2252 | 65535 (the basic multilingual page). This increases storage |
2247 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
2253 | requirements per character from 2 to 4 bytes. X11 fonts do not yet |
2248 | support these extra characters, but Xft does. |
2254 | support these extra characters, but Xft does. |
… | |
… | |
2251 | even without this flag, but the number of such characters is |
2257 | even without this flag, but the number of such characters is |
2252 | limited to a view thousand (shared with combining characters, |
2258 | limited to a view thousand (shared with combining characters, |
2253 | see next switch), and right now rxvt-unicode cannot display them |
2259 | see next switch), and right now rxvt-unicode cannot display them |
2254 | (input/output and cut&paste still work, though). |
2260 | (input/output and cut&paste still work, though). |
2255 | |
2261 | |
2256 | =item --enable-combining |
2262 | =item --enable-combining (default: on) |
2257 | |
2263 | |
2258 | Enable automatic composition of combining characters into |
2264 | Enable automatic composition of combining characters into |
2259 | composite characters. This is required for proper viewing of text |
2265 | composite characters. This is required for proper viewing of text |
2260 | where accents are encoded as seperate unicode characters. This is |
2266 | where accents are encoded as seperate unicode characters. This is |
2261 | done by using precomposited characters when available or creating |
2267 | done by using precomposited characters when available or creating |
… | |
… | |
2271 | |
2277 | |
2272 | The combining table also contains entries for arabic presentation forms, |
2278 | The combining table also contains entries for arabic presentation forms, |
2273 | but these are not currently used. Bug me if you want these to be used (and |
2279 | but these are not currently used. Bug me if you want these to be used (and |
2274 | tell me how these are to be used...). |
2280 | tell me how these are to be used...). |
2275 | |
2281 | |
2276 | =item --enable-fallback(=CLASS) |
2282 | =item --enable-fallback(=CLASS) (default: Rxvt) |
2277 | |
2283 | |
2278 | When reading resource settings, also read settings for class CLASS |
2284 | When reading resource settings, also read settings for class CLASS. To disable resource fallback use --disable-fallback. |
2279 | (default: Rxvt). To disable resource fallback use --disable-fallback. |
|
|
2280 | |
2285 | |
2281 | =item --with-res-name=NAME |
2286 | =item --with-res-name=NAME (default: urxvt) |
2282 | |
2287 | |
2283 | Use the given name (default: urxvt) as default application name when |
2288 | Use the given name as default application name when |
2284 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
2289 | reading resources. Specify --with-res-name=rxvt to replace rxvt. |
2285 | |
2290 | |
2286 | =item --with-res-class=CLASS |
2291 | =item --with-res-class=CLASS /default: URxvt) |
2287 | |
2292 | |
2288 | Use the given class (default: URxvt) as default application class |
2293 | Use the given class as default application class |
2289 | when reading resources. Specify --with-res-class=Rxvt to replace |
2294 | when reading resources. Specify --with-res-class=Rxvt to replace |
2290 | rxvt. |
2295 | rxvt. |
2291 | |
2296 | |
2292 | =item --enable-utmp |
2297 | =item --enable-utmp (default: on) |
2293 | |
2298 | |
2294 | Write user and tty to utmp file (used by programs like F<w>) at |
2299 | Write user and tty to utmp file (used by programs like F<w>) at |
2295 | start of rxvt execution and delete information when rxvt exits. |
2300 | start of rxvt execution and delete information when rxvt exits. |
2296 | |
2301 | |
2297 | =item --enable-wtmp |
2302 | =item --enable-wtmp (default: on) |
2298 | |
2303 | |
2299 | Write user and tty to wtmp file (used by programs like F<last>) at |
2304 | Write user and tty to wtmp file (used by programs like F<last>) at |
2300 | start of rxvt execution and write logout when rxvt exits. This |
2305 | start of rxvt execution and write logout when rxvt exits. This |
2301 | option requires --enable-utmp to also be specified. |
2306 | option requires --enable-utmp to also be specified. |
2302 | |
2307 | |
2303 | =item --enable-lastlog |
2308 | =item --enable-lastlog (default: on) |
2304 | |
2309 | |
2305 | Write user and tty to lastlog file (used by programs like |
2310 | Write user and tty to lastlog file (used by programs like |
2306 | F<lastlogin>) at start of rxvt execution. This option requires |
2311 | F<lastlogin>) at start of rxvt execution. This option requires |
2307 | --enable-utmp to also be specified. |
2312 | --enable-utmp to also be specified. |
2308 | |
2313 | |
2309 | =item --enable-xpm-background |
2314 | =item --enable-xpm-background (default: off) |
2310 | |
2315 | |
2311 | Add support for XPM background pixmaps. |
2316 | Add support for XPM background pixmaps. |
2312 | |
2317 | |
2313 | =item --enable-transparency |
2318 | =item --enable-transparency (default: off) |
2314 | |
2319 | |
2315 | Add support for inheriting parent backgrounds thus giving a fake |
2320 | Add support for inheriting parent backgrounds thus giving a fake |
2316 | transparency to the term. |
2321 | transparency to the term. |
2317 | |
2322 | |
2318 | =item --enable-fading |
2323 | =item --enable-fading (default: on) |
2319 | |
2324 | |
2320 | Add support for fading the text when focus is lost. |
2325 | Add support for fading the text when focus is lost (requires C<--enable-transparency>). |
2321 | |
2326 | |
2322 | =item --enable-tinting |
2327 | =item --enable-tinting (default: on) |
2323 | |
2328 | |
2324 | Add support for tinting of transparent backgrounds. |
2329 | Add support for tinting of transparent backgrounds (requires C<--enable-transparency>). |
2325 | |
2330 | |
2326 | =item --enable-menubar |
2331 | =item --enable-menubar (default: off) |
2327 | |
2332 | |
2328 | Add support for our menu bar system (this interacts badly with |
2333 | Add support for our menu bar system (this interacts badly with |
2329 | dynamic locale switching currently). |
2334 | dynamic locale switching currently). |
2330 | |
2335 | |
2331 | =item --enable-rxvt-scroll |
2336 | =item --enable-rxvt-scroll (default: on) |
2332 | |
2337 | |
2333 | Add support for the original rxvt scrollbar. |
2338 | Add support for the original rxvt scrollbar. |
2334 | |
2339 | |
2335 | =item --enable-next-scroll |
2340 | =item --enable-next-scroll (default: on) |
2336 | |
2341 | |
2337 | Add support for a NeXT-like scrollbar. |
2342 | Add support for a NeXT-like scrollbar. |
2338 | |
2343 | |
2339 | =item --enable-xterm-scroll |
2344 | =item --enable-xterm-scroll (default: on) |
2340 | |
2345 | |
2341 | Add support for an Xterm-like scrollbar. |
2346 | Add support for an Xterm-like scrollbar. |
2342 | |
2347 | |
2343 | =item --enable-plain-scroll |
2348 | =item --enable-plain-scroll (default: on) |
2344 | |
2349 | |
2345 | Add support for a very unobtrusive, plain-looking scrollbar that |
2350 | Add support for a very unobtrusive, plain-looking scrollbar that |
2346 | is the favourite of the rxvt-unicode author, having used it for |
2351 | is the favourite of the rxvt-unicode author, having used it for |
2347 | many years. |
2352 | many years. |
2348 | |
2353 | |
2349 | =item --enable-half-shadow |
2354 | =item --enable-half-shadow (default: off) |
2350 | |
2355 | |
2351 | Make shadows on the scrollbar only half the normal width & height. |
2356 | Make shadows on the scrollbar only half the normal width & height. |
2352 | only applicable to rxvt scrollbars. |
2357 | only applicable to rxvt scrollbars. |
2353 | |
2358 | |
2354 | =item --enable-ttygid |
2359 | =item --enable-ttygid (default: off) |
2355 | |
2360 | |
2356 | Change tty device setting to group "tty" - only use this if |
2361 | Change tty device setting to group "tty" - only use this if |
2357 | your system uses this type of security. |
2362 | your system uses this type of security. |
2358 | |
2363 | |
2359 | =item --disable-backspace-key |
2364 | =item --disable-backspace-key |
2360 | |
2365 | |
2361 | Disable any handling of the backspace key by us - let the X server |
2366 | Removes any handling of the backspace key by us - let the X server do it. |
|
|
2367 | |
|
|
2368 | =item --disable-delete-key |
|
|
2369 | |
|
|
2370 | Removes any handling of the delete key by us - let the X server |
2362 | do it. |
2371 | do it. |
2363 | |
2372 | |
2364 | =item --disable-delete-key |
|
|
2365 | |
|
|
2366 | Disable any handling of the delete key by us - let the X server |
|
|
2367 | do it. |
|
|
2368 | |
|
|
2369 | =item --disable-resources |
2373 | =item --disable-resources |
2370 | |
2374 | |
2371 | Remove all resources checking. |
2375 | Removes any support for resource checking. |
2372 | |
2376 | |
2373 | =item --enable-xgetdefault |
2377 | =item --enable-xgetdefault |
2374 | |
2378 | |
2375 | Make resources checking via XGetDefault() instead of our small |
2379 | Make resources checking via XGetDefault() instead of our small |
2376 | version which only checks ~/.Xdefaults, or if that doesn't exist then |
2380 | version which only checks ~/.Xdefaults, or if that doesn't exist then |
… | |
… | |
2378 | |
2382 | |
2379 | Please note that nowadays, things like XIM will automatically pull in and |
2383 | Please note that nowadays, things like XIM will automatically pull in and |
2380 | use the full X resource manager, so the overhead of using it might be very |
2384 | use the full X resource manager, so the overhead of using it might be very |
2381 | small, if nonexistant. |
2385 | small, if nonexistant. |
2382 | |
2386 | |
2383 | =item --enable-strings |
2387 | =item --enable-strings (default: off) |
2384 | |
2388 | |
2385 | Add support for our possibly faster memset() function and other |
2389 | Add support for our possibly faster memset() function and other |
2386 | various routines, overriding your system's versions which may |
2390 | various routines, overriding your system's versions which may |
2387 | have been hand-crafted in assembly or may require extra libraries |
2391 | have been hand-crafted in assembly or may require extra libraries |
2388 | to link in. (this breaks ANSI-C rules and has problems on many |
2392 | to link in. (this breaks ANSI-C rules and has problems on many |
2389 | GNU/Linux systems). |
2393 | GNU/Linux systems). |
2390 | |
2394 | |
2391 | =item --disable-swapscreen |
2395 | =item --disable-swapscreen |
2392 | |
2396 | |
2393 | Remove support for swap screen. |
2397 | Remove support for secondary/swap screen. |
2394 | |
2398 | |
2395 | =item --enable-frills |
2399 | =item --enable-frills (default: on) |
2396 | |
2400 | |
2397 | Add support for many small features that are not essential but nice to |
2401 | Add support for many small features that are not essential but nice to |
2398 | have. Normally you want this, but for very small binaries you may want to |
2402 | have. Normally you want this, but for very small binaries you may want to |
2399 | disable this. |
2403 | disable this. |
2400 | |
2404 | |
… | |
… | |
2413 | settable insecure mode |
2417 | settable insecure mode |
2414 | keysym remapping support |
2418 | keysym remapping support |
2415 | cursor blinking and underline cursor |
2419 | cursor blinking and underline cursor |
2416 | -embed and -pty-fd options |
2420 | -embed and -pty-fd options |
2417 | |
2421 | |
2418 | =item --enable-iso14755 |
2422 | =item --enable-iso14755 (default: on) |
2419 | |
2423 | |
2420 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2424 | Enable extended ISO 14755 support (see @@RXVT_NAME@@(1), or |
2421 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
2425 | F<doc/rxvt.1.txt>). Basic support (section 5.1) is enabled by |
2422 | C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with |
2426 | C<--enable-frills>, while support for 5.2, 5.3 and 5.4 is enabled with |
2423 | this switch. |
2427 | this switch. |
2424 | |
2428 | |
2425 | =item --enable-keepscrolling |
2429 | =item --enable-keepscrolling (default: on) |
2426 | |
2430 | |
2427 | Add support for continual scrolling of the display when you hold |
2431 | Add support for continual scrolling of the display when you hold |
2428 | the mouse button down on a scrollbar arrow. |
2432 | the mouse button down on a scrollbar arrow. |
2429 | |
2433 | |
2430 | =item --enable-mousewheel |
2434 | =item --enable-mousewheel (default: on) |
2431 | |
2435 | |
2432 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2436 | Add support for scrolling via mouse wheel or buttons 4 & 5. |
2433 | |
2437 | |
2434 | =item --enable-slipwheeling |
2438 | =item --enable-slipwheeling (default: on) |
2435 | |
2439 | |
2436 | Add support for continual scrolling (using the mouse wheel as an |
2440 | Add support for continual scrolling (using the mouse wheel as an |
2437 | accelerator) while the control key is held down. This option |
2441 | accelerator) while the control key is held down. This option |
2438 | requires --enable-mousewheel to also be specified. |
2442 | requires --enable-mousewheel to also be specified. |
2439 | |
2443 | |
2440 | =item --disable-new-selection |
2444 | =item --disable-new-selection |
2441 | |
2445 | |
2442 | Remove support for mouse selection style like that of xterm. |
2446 | Remove support for mouse selection style like that of xterm. |
2443 | |
2447 | |
2444 | =item --enable-dmalloc |
2448 | =item --enable-dmalloc (default: off) |
2445 | |
2449 | |
2446 | Use Gray Watson's malloc - which is good for debugging See |
2450 | Use Gray Watson's malloc - which is good for debugging See |
2447 | http://www.letters.com/dmalloc/ for details If you use either this or the |
2451 | http://www.letters.com/dmalloc/ for details If you use either this or the |
2448 | next option, you may need to edit src/Makefile after compiling to point |
2452 | next option, you may need to edit src/Makefile after compiling to point |
2449 | DINCLUDE and DLIB to the right places. |
2453 | DINCLUDE and DLIB to the right places. |
2450 | |
2454 | |
2451 | You can only use either this option and the following (should |
2455 | You can only use either this option and the following (should |
2452 | you use either) . |
2456 | you use either) . |
2453 | |
2457 | |
2454 | =item --enable-dlmalloc |
2458 | =item --enable-dlmalloc (default: off) |
2455 | |
2459 | |
2456 | Use Doug Lea's malloc - which is good for a production version |
2460 | Use Doug Lea's malloc - which is good for a production version |
2457 | See L<http://g.oswego.edu/dl/html/malloc.html> for details. |
2461 | See L<http://g.oswego.edu/dl/html/malloc.html> for details. |
2458 | |
2462 | |
2459 | =item --enable-smart-resize |
2463 | =item --enable-smart-resize (default: on) |
2460 | |
2464 | |
2461 | Add smart growth/shrink behaviour when changing font size via from hot |
2465 | Add smart growth/shrink behaviour when changing font size via from hot |
2462 | keys. This should keep in a fixed position the rxvt corner which is |
2466 | keys. This should keep in a fixed position the rxvt corner which is |
2463 | closest to a corner of the screen. |
2467 | closest to a corner of the screen. |
2464 | |
2468 | |
2465 | =item --enable-pointer-blank |
2469 | =item --enable-pointer-blank (default: on) |
2466 | |
2470 | |
2467 | Add support to have the pointer disappear when typing or inactive. |
2471 | Add support to have the pointer disappear when typing or inactive. |
2468 | |
2472 | |
2469 | =item --with-name=NAME |
2473 | =item --with-name=NAME (default: urxvt) |
2470 | |
2474 | |
2471 | Set the basename for the installed binaries (default: C<urxvt>, resulting |
2475 | Set the basename for the installed binaries, resulting |
2472 | in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with |
2476 | in C<urxvt>, C<urxvtd> etc.). Specify C<--with-name=rxvt> to replace with |
2473 | C<rxvt>. |
2477 | C<rxvt>. |
2474 | |
2478 | |
2475 | =item --with-term=NAME |
2479 | =item --with-term=NAME (default: rxvt-unicode) |
2476 | |
2480 | |
2477 | Change the environmental variable for the terminal to NAME (default |
2481 | Change the environmental variable for the terminal to NAME. |
2478 | C<rxvt-unicode>) |
|
|
2479 | |
2482 | |
2480 | =item --with-terminfo=PATH |
2483 | =item --with-terminfo=PATH |
2481 | |
2484 | |
2482 | Change the environmental variable for the path to the terminfo tree to |
2485 | Change the environmental variable for the path to the terminfo tree to |
2483 | PATH. |
2486 | PATH. |