ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/rxvt-unicode/README.configure
Revision: 1.14
Committed: Fri Jul 30 14:59:11 2004 UTC (19 years, 10 months ago) by root
Branch: MAIN
CVS Tags: rel-3_5, rel-3_4, rel-3_3
Changes since 1.13: +2 -0 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 pcg 1.11 General hint: if you get compile errors, then likely your configuration
2     hasn't been tested well. Either try with --enable-everything or use the
3     ./reconf script as a base for experiments. ./reconf is used by myself,
4     so it should generally be a working config. Of course, you should always
5 root 1.13 report when a combination doesn't work, so it can be fixed. Marc Lehmann
6 pcg 1.11 <rxvt@schmorp.de>.
7    
8 pcg 1.1 --enable-everything
9 pcg 1.7 add support for all non-multichoice options listed in "./configure
10     --help". Note that unlike other enable options this is order
11     dependant. You can specify this and then disable options which
12     this enables by _following_ this with the appropriate commands.
13 pcg 1.2 --enable-xft
14     add support for xft (anti-aliases, among others) fonts. xft fonts are
15     slower and require lots of memory, but as long as you don't use them,
16     you don't pay for them.
17     --with-codesets=NAME,...
18     compile in support for additional codeset groups:
19     jp common japanese encodings
20     jp_ext rarely used but big japanese encodings
21     kr korean encodings
22     cn common chinese encodings
23     cn_ext rarely used but very big chinese encodigs
24 pcg 1.7 all all of the above
25 pcg 1.8 --enable-xim
26     add support for XIM (X Input Method) protocol. This allows using
27     alternative input methods (e.g. kinput2) and will also correctly
28     set up the input for people using dead keys or compose keys.
29 pcg 1.2 --enable-unicode3
30 pcg 1.10 enable support for unicode codepoints above 65535 (the basic
31     multilingual page). This increases storage requirements per
32     character from 2 to 4 bytes. X11 fonts do not yet support these
33     extra characters, but Xft does.
34     --enable-combining
35     enable automatic composition of combining characters into
36     composite characters. This is required for proper viewing of text
37     where accents are encoded as seperate unicode characters. This is
38     done by using precomposited characters when available or creating
39     new pseudo-characters when no precomposed form exists. Without
40     --enable-unicode3, the number of additional precomposed characters
41     is rather limited (2048, if this is full, rxvt will use the
42     private use area, extending the number of combinations to
43     8448). With --enable-unicode3, no practical limit exists. This
44     will also enable storage of characters >16bit. They currently
45     won't display properly, but they will paste correctly.
46     The combining table also contains entries for arabic presentation
47     forms, but these are not currently used. Bug me if you want
48     these to be used.
49 pcg 1.8 --enable-fallback(=CLASS)
50     when reading resource settings, also read settings for class CLASS
51     (default: Rxvt). To disable resource fallback use --disable-fallback.
52     --with-res-name=NAME
53     use the given name (default: urxvt) as default application name
54     when reading resources. Specify --with-res-name=rxvt to replace
55     rxvt.
56     --with-res-class=CLASS
57     use the given class (default: URxvt) as default application class
58     when reading resources. Specify --with-res-class=Rxvt to replace
59     rxvt.
60 pcg 1.1 --enable-utmp
61     write user and tty to utmp file (used by programs like ``w'') at
62     start of rxvt execution and delete information when rxvt exits.
63     --enable-wtmp
64     write user and tty to wtmp file (used by programs like ``last'') at
65     start of rxvt execution and write logout when rxvt exits. This
66     option requires --enable-utmp to also be specified.
67     --enable-lastlog
68     write user and tty to lastlog file (used by programs like
69     ``lastlogin'') at start of rxvt execution. This option requires
70     --enable-utmp to also be specified.
71     --enable-xpm-background
72     add support for XPM background pixmaps
73     --enable-transparency
74     add support for inheriting parent backgrounds thus giving a fake
75     transparency to the term
76 root 1.14 --enable-fading
77     add support for fading the text when focus is lost.
78 pcg 1.12 --enable-tinting
79     add support for tinting of transparent backgrounds.
80 pcg 1.1 --enable-menubar
81 pcg 1.7 add support for our menu bar system (this interacts badly with
82     dynamic locale switching currently)
83 pcg 1.1 --enable-rxvt-scroll
84     add support for the original rxvt scrollbar
85     --enable-next-scroll
86     add support for a NeXT-like scrollbar
87     --enable-xterm-scroll
88     add support for an Xterm-like scrollbar
89 pcg 1.5 --enable-plain-scroll
90 pcg 1.7 add support for a very unobtrusive, plain-looking scrollbar that
91     is the favourite of the rxvt-unicode author, having used it for
92     many years.
93 pcg 1.1 --enable-half-shadow
94     make shadows on the scrollbar only half the normal width & height.
95     only applicable to rxvt scrollbars
96     --enable-ttygid
97     change tty device setting to group "tty" - only use this if
98     your system uses this type of security
99     --disable-backspace-key
100     disable any handling of the backspace key by us - let the X server
101     do it
102     --disable-delete-key
103     disable any handling of the delete key by us - let the X server
104     do it
105     --disable-resources
106     remove all resources checking
107     --enable-xgetdefault
108     make resources checking via XGetDefault() instead of our small
109     version which only checks ~/.Xdefaults, or if that doesn't exist
110     then ~/.Xresources
111     --enable-strings
112     add support for our possibly faster memset() function and other
113     various routines, overriding your system's versions which may
114     have been hand-crafted in assembly or may require extra libraries
115 pcg 1.7 to link in. (this breaks ANSI-C rules and has problems on many
116     GNU/Linux systems).
117 pcg 1.1 --disable-swapscreen
118     remove support for swap screen
119     --enable-frills
120     add support for some lesser used features
121     --enable-linespace
122     add support to provide user specified line spacing between text rows
123     --enable-keepscrolling
124     add support for continual scrolling of the display when you hold
125     the mouse button down on a scrollbar arrow
126     --enable-mousewheel
127     add support for scrolling via mouse wheel or buttons 4 & 5
128 pcg 1.3 --enable-slipwheeling
129 pcg 1.1 add support for continual scrolling (using the mouse wheel as an
130     accelerator) while the control key is held down. This option
131     requires --enable-mousewheel to also be specified.
132     --enable-old-selection
133     remove support for reverting the mouse selection style to that
134     of v2.20 (and prior)
135     --disable-new-selection
136     remove support for mouse selection style like that of xterm
137     --enable-dmalloc
138     use Gray Watson's malloc - which is good for debugging
139     See http://www.letters.com/dmalloc/ for details
140     If you use either this or the next option, you may need to
141     edit src/Makefile after compiling to point DINCLUDE and DLIB to
142     the right places.
143     You can only use either this option and the following (should
144     you use either)
145     --enable-dlmalloc
146     use Doug Lea's malloc - which is good for a production version
147     See http://g.oswego.edu/dl/html/malloc.html for details
148     --enable-smart-resize
149     add smart growth/shrink behaviour when changing font size
150     via from hot keys. This should keep in a fixed position the
151     rxvt corner which is closest to a corner of the screen
152     --enable-256-color
153 pcg 1.3 add support for 256 colours rather than the base 16 colours
154 pcg 1.1 --enable-cursor-blink
155     add support for a blinking cursor
156     --enable-pointer-blank
157     add support to have the pointer disappear when typing or inactive
158 pcg 1.8 --with-name=NAME
159     set the basename for the installed binaries (default: urxvt, resulting
160     in urxvt, urxvtd etc.). Specify --with-name=rxvt to replace rxvt.
161 pcg 1.1 --with-term=NAME
162     change the environmental variable for the terminal to NAME
163 pcg 1.5 (default "rxvt")
164 pcg 1.1 --with-terminfo=PATH
165     change the environmental variable for the path to the terminfo
166     tree to PATH
167     --with-x
168     use the X Window System (pretty much default, eh?)
169     --with-xpm-includes=DIR
170     look for the XPM includes in DIR
171     --with-xpm-library=DIR
172     look for the XPM library in DIR
173     --with-xpm
174     not needed - define via --enable-xpm-background
175 pcg 1.7