ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/doc/rxvt.7.pod
(Generate patch)

Comparing rxvt-unicode/doc/rxvt.7.pod (file contents):
Revision 1.58 by root, Wed Jul 13 02:24:02 2005 UTC vs.
Revision 1.62 by root, Tue Nov 8 17:35:28 2005 UTC

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

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines