-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 cnya be fixed. Marc Lehmann
-<rxvt@schmorp.de>.
-
---enable-everything
- add support for all non-multichoice options listed in "./configure
- --help". Note that unlike other enable options this is order
- dependant. You can specify this and then disable options which
- this enables by _following_ this with the appropriate commands.
---enable-xft
- add support for xft (anti-aliases, 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.
---with-codesets=NAME,...
- compile in support for additional codeset groups:
- jp common japanese encodings
- jp_ext rarely used but big japanese encodings
- kr korean encodings
- cn common chinese encodings
- cn_ext rarely used but very big chinese encodigs
- all all of the above
---enable-xim
- add support for XIM (X Input Method) protocol. This allows using
- alternative input methods (e.g. kinput2) and will also correctly
- set up the input for people using dead keys or compose keys.
---enable-unicode3
- enable support for 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
+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
+ <rxvt@schmorp.de>.
+
+ --enable-everything
+ Add support for all non-multichoice options listed in "./configure
+ --help". Note that unlike other enable options this is order
+ dependant. You can specify this and then disable options which this
+ enables by *following* this with the appropriate commands.
+
+ --enable-xft
+ Add support for Xft (anti-aliases, 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.
+
+ --enable-font-styles
+ Add support for bold, *italic* and *bold italic* font styles. The
+ fonts can be set manually or automatically.
+
+ --with-codesets=NAME,...
+ 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 currently only used for driving X11 core
+ fonts, they are not required for Xft fonts. Compiling them in will
+ make your binary bigger (together about 700kB), but it doesn't
+ increase memory usage unless you use an X11 font requiring one of
+ these encodings.
+
+ all all available codeset groups
+ zh common chinese encodings
+ zh_ext rarely used but very big chinese encodigs
+ jp common japanese encodings
+ jp_ext rarely used but big japanese encodings
+ kr korean encodings
+
+ --enable-xim
+ Add support for XIM (X Input Method) protocol. This allows using
+ alternative input methods (e.g. kinput2) and will also correctly set
+ up the input for people using dead keys or compose keys.
+
+ --enable-unicode3
+ 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
extra characters, but Xft does.
---enable-combining
- 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 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 will use the
- private use area, extending the number of combinations to
- 8448). With --enable-unicode3, no practical limit exists. This
- will also enable storage of characters >16bit. They currently
- won't display properly, but they will paste correctly.
+
+ 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 view thousand (shared with combining characters, see next
+ switch), and right now rxvt-unicode cannot display them
+ (input/output and cut&paste still work, though).
+
+ --enable-combining
+ 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
+ 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 will use
+ the private use area, extending the number of combinations to 8448).
+ With --enable-unicode3, no practical limit exists. This will also
+ enable storage of characters >65535.
+
The combining table also contains entries for arabic presentation
- forms, but these are not currently used. Bug me if you want
- these to be used.
---enable-fallback(=CLASS)
- when reading resource settings, also read settings for class CLASS
- (default: Rxvt). To disable resource fallback use --disable-fallback.
---with-res-name=NAME
- use the given name (default: urxvt) as default application name
- when reading resources. Specify --with-res-name=rxvt to replace
- rxvt.
---with-res-class=CLASS
- use the given class (default: URxvt) as default application class
- when reading resources. Specify --with-res-class=Rxvt to replace
+ forms, but these are not currently used. Bug me if you want these to
+ be used.
+
+ --enable-fallback(=CLASS)
+ When reading resource settings, also read settings for class CLASS
+ (default: Rxvt). To disable resource fallback use
+ --disable-fallback.
+
+ --with-res-name=NAME
+ Use the given name (default: urxvt) as default application name when
+ reading resources. Specify --with-res-name=rxvt to replace rxvt.
+
+ --with-res-class=CLASS
+ Use the given class (default: URxvt) as default application class
+ when reading resources. Specify --with-res-class=Rxvt to replace
rxvt.
---enable-utmp
- 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
- 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
- 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-xpm-background
- add support for XPM background pixmaps
---enable-transparency
- add support for inheriting parent backgrounds thus giving a fake
- transparency to the term
---enable-menubar
- add support for our menu bar system (this interacts badly with
- dynamic locale switching currently)
---enable-rxvt-scroll
- add support for the original rxvt scrollbar
---enable-next-scroll
- add support for a NeXT-like scrollbar
---enable-xterm-scroll
- add support for an Xterm-like scrollbar
---enable-plain-scroll
- add support for a very unobtrusive, plain-looking scrollbar that
- is the favourite of the rxvt-unicode author, having used it for
- many years.
---enable-half-shadow
- make shadows on the scrollbar only half the normal width & height.
- only applicable to rxvt scrollbars
---enable-ttygid
- change tty device setting to group "tty" - only use this if
- your system uses this type of security
---disable-backspace-key
- disable any handling of the backspace key by us - let the X server
- do it
---disable-delete-key
- disable any handling of the delete key by us - let the X server
- do it
---disable-resources
- remove all resources 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
---enable-strings
- 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 swap screen
---enable-frills
- add support for some lesser used features
---enable-linespace
- add support to provide user specified line spacing between text rows
---enable-keepscrolling
- add support for continual scrolling of the display when you hold
- the mouse button down on a scrollbar arrow
---enable-mousewheel
- add support for scrolling via mouse wheel or buttons 4 & 5
---enable-slipwheeling
- add support for continual scrolling (using the mouse wheel as an
- accelerator) while the control key is held down. This option
- requires --enable-mousewheel to also be specified.
---enable-old-selection
- remove support for reverting the mouse selection style to that
- of v2.20 (and prior)
---disable-new-selection
- remove support for mouse selection style like that of xterm
---enable-dmalloc
- use Gray Watson's malloc - which is good for debugging
- See http://www.letters.com/dmalloc/ 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.
- You can only use either this option and the following (should
- you use either)
---enable-dlmalloc
- use Doug Lea's malloc - which is good for a production version
- See http://g.oswego.edu/dl/html/malloc.html for details
---enable-smart-resize
- add smart growth/shrink behaviour when changing font size
- via from hot keys. This should keep in a fixed position the
- rxvt corner which is closest to a corner of the screen
---enable-256-color
- add support for 256 colours rather than the base 16 colours
---enable-cursor-blink
- add support for a blinking cursor
---enable-pointer-blank
- add support to have the pointer disappear when typing or inactive
---with-name=NAME
- set the basename for the installed binaries (default: urxvt, resulting
- in urxvt, urxvtd etc.). Specify --with-name=rxvt to replace rxvt.
---with-term=NAME
- change the environmental variable for the terminal to NAME
- (default "rxvt")
---with-terminfo=PATH
- change the environmental variable for the path to the terminfo
- tree to PATH
---with-x
- use the X Window System (pretty much default, eh?)
---with-xpm-includes=DIR
- look for the XPM includes in DIR
---with-xpm-library=DIR
- look for the XPM library in DIR
---with-xpm
- not needed - define via --enable-xpm-background
+
+ --enable-utmp
+ 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
+ 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
+ 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-xpm-background
+ Add support for XPM background pixmaps.
+
+ --enable-transparency
+ Add support for inheriting parent backgrounds thus giving a fake
+ transparency to the term.
+
+ --enable-fading
+ Add support for fading the text when focus is lost.
+
+ --enable-tinting
+ Add support for tinting of transparent backgrounds.
+
+ --enable-menubar
+ Add support for our menu bar system (this interacts badly with
+ dynamic locale switching currently).
+
+ --enable-rxvt-scroll
+ Add support for the original rxvt scrollbar.
+
+ --enable-next-scroll
+ Add support for a NeXT-like scrollbar.
+
+ --enable-xterm-scroll
+ Add support for an Xterm-like scrollbar.
+
+ --enable-plain-scroll
+ Add support for a very unobtrusive, plain-looking scrollbar that is
+ the favourite of the rxvt-unicode author, having used it for many
+ years.
+
+ --enable-half-shadow
+ Make shadows on the scrollbar only half the normal width & height.
+ only applicable to rxvt scrollbars.
+
+ --enable-ttygid
+ Change tty device setting to group "tty" - only use this if your
+ system uses this type of security.
+
+ --disable-backspace-key
+ Disable any handling of the backspace key by us - let the X server
+ do it.
+
+ --disable-delete-key
+ Disable any handling of the delete key by us - let the X server do
+ it.
+
+ --disable-resources
+ Remove all resources 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
+ 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 swap screen.
+
+ --enable-frills
+ Add support for many small features that are not essential but nice
+ to have. Normally you want this, but for very small binaries you may
+ want to disable this.
+
+ A non-exhaustive list of features enabled by "--enable-frills"
+ (possibly in combination with other switches) is:
+
+ MWM-hints
+ seperate underline colour
+ settable border widths and borderless switch
+ settable extra linespacing
+ extra window properties (e.g. UTF-8 window names and PID)
+ iso-14755-2 and -3, and visual feedback
+ backindex and forwardindex escape sequence
+ window op and locale change escape sequences
+ tripleclickwords
+ settable insecure mode
+ keysym remapping support
+
+ --enable-iso14755
+ Enable extended ISO 14755 support (see rxvt(1), or doc/rxvt.1.txt).
+ 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.
+
+ --enable-keepscrolling
+ Add support for continual scrolling of the display when you hold the
+ mouse button down on a scrollbar arrow.
+
+ --enable-mousewheel
+ Add support for scrolling via mouse wheel or buttons 4 & 5.
+
+ --enable-slipwheeling
+ Add support for continual scrolling (using the mouse wheel as an
+ accelerator) while the control key is held down. This option
+ requires --enable-mousewheel to also be specified.
+
+ --disable-new-selection
+ Remove support for mouse selection style like that of xterm.
+
+ --enable-dmalloc
+ Use Gray Watson's malloc - which is good for debugging See
+ http://www.letters.com/dmalloc/ 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.
+
+ You can only use either this option and the following (should you
+ use either) .
+
+ --enable-dlmalloc
+ Use Doug Lea's malloc - which is good for a production version See
+ <http://g.oswego.edu/dl/html/malloc.html> for details.
+
+ --enable-smart-resize
+ Add smart growth/shrink behaviour when changing font size via from
+ hot keys. This should keep in a fixed position the rxvt corner which
+ is closest to a corner of the screen.
+
+ --enable-cursor-blink
+ Add support for a blinking cursor.
+
+ --enable-pointer-blank
+ Add support to have the pointer disappear when typing or inactive.
+
+ --with-name=NAME
+ Set the basename for the installed binaries (default: "urxvt",
+ resulting in "urxvt", "urxvtd" etc.). Specify "--with-name=rxvt" to
+ replace with "rxvt".
+
+ --with-term=NAME
+ Change the environmental variable for the terminal to NAME (default
+ "rxvt-unicode")
+
+ --with-terminfo=PATH
+ Change the environmental variable for the path to the terminfo tree
+ to PATH.
+
+ --with-x
+ Use the X Window System (pretty much default, eh?).
+
+ --with-xpm-includes=DIR
+ Look for the XPM includes in DIR.
+
+ --with-xpm-library=DIR
+ Look for the XPM library in DIR.
+
+ --with-xpm
+ Not needed - define via --enable-xpm-background.