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

Comparing rxvt-unicode/README.configure (file contents):
Revision 1.14 by root, Fri Jul 30 14:59:11 2004 UTC vs.
Revision 1.63 by root, Sun Jun 15 13:54:15 2008 UTC

1CONFIGURE OPTIONS
1General hint: if you get compile errors, then likely your configuration 2 General hint: if you get compile errors, then likely your configuration
2hasn't been tested well. Either try with --enable-everything or use the 3 hasn't been tested well. Either try with "--enable-everything" or use
3./reconf script as a base for experiments. ./reconf is used by myself, 4 the default configuration (i.e. no "--enable-xxx" or "--disable-xxx"
4so it should generally be a working config. Of course, you should always 5 switches). Of course, you should always report when a combination
5report when a combination doesn't work, so it can be fixed. Marc Lehmann 6 doesn't work, so it can be fixed. Marc Lehmann <rxvt@schmorp.de>.
6<rxvt@schmorp.de>.
7 7
8 All
9
8--enable-everything 10 --enable-everything
9 add support for all non-multichoice options listed in "./configure 11 Add (or remove) support for all non-multichoice options listed in
10 --help". Note that unlike other enable options this is order 12 "./configure --help".
13
11 dependant. You can specify this and then disable options which 14 You can specify this and then disable options you do not like by
12 this enables by _following_ this with the appropriate commands. 15 *following* this with the appropriate "--disable-..." arguments, or
13--enable-xft 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)
14 add support for xft (anti-aliases, among others) fonts. xft fonts are 21 Add support for Xft (anti-aliases, among others) fonts. Xft fonts
15 slower and require lots of memory, but as long as you don't use them, 22 are slower and require lots of memory, but as long as you don't use
16 you don't pay for them. 23 them, you don't pay for them.
17--with-codesets=NAME,... 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)
18 compile in support for additional codeset groups: 30 Compile in support for additional codeset (encoding) groups ("eu",
19 jp common japanese encodings 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
20 jp_ext rarely used but big japanese encodings 43 jp_ext rarely used but big japanese encodings
21 kr korean encodings 44 kr korean encodings
22 cn common chinese encodings 45 --enable-xim (default: on)
23 cn_ext rarely used but very big chinese encodigs
24 all all of the above
25--enable-xim
26 add support for XIM (X Input Method) protocol. This allows using 46 Add support for XIM (X Input Method) protocol. This allows using
27 alternative input methods (e.g. kinput2) and will also correctly 47 alternative input methods (e.g. kinput2) and will also correctly set
28 set up the input for people using dead keys or compose keys. 48 up the input for people using dead keys or compose keys.
29--enable-unicode3 49
50 --enable-unicode3 (default: off)
51 Recommended to stay off unless you really need non-BMP characters.
52
30 enable support for unicode codepoints above 65535 (the basic 53 Enable direct support for displaying unicode codepoints above 65535
31 multilingual page). This increases storage requirements per 54 (the basic multilingual page). This increases storage requirements
32 character from 2 to 4 bytes. X11 fonts do not yet support these 55 per character from 2 to 4 bytes. X11 fonts do not yet support these
33 extra characters, but Xft does. 56 extra characters, but Xft does.
34--enable-combining 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)
35 enable automatic composition of combining characters into 65 Enable automatic composition of combining characters into composite
36 composite characters. This is required for proper viewing of text 66 characters. This is required for proper viewing of text where
37 where accents are encoded as seperate unicode characters. This is 67 accents are encoded as seperate unicode characters. This is done by
38 done by using precomposited characters when available or creating 68 using precomposited characters when available or creating new
39 new pseudo-characters when no precomposed form exists. Without 69 pseudo-characters when no precomposed form exists.
70
40 --enable-unicode3, the number of additional precomposed characters 71 Without --enable-unicode3, the number of additional precomposed
41 is rather limited (2048, if this is full, rxvt will use the 72 characters is somewhat limited (the 6400 private use characters will
42 private use area, extending the number of combinations to
43 8448). With --enable-unicode3, no practical limit exists. This 73 be (ab-)used). With --enable-unicode3, no practical limit exists.
44 will also enable storage of characters >16bit. They currently 74
45 won't display properly, but they will paste correctly. 75 This option will also enable storage (but not display) of characters
76 beyond plane 0 (>65535) when --enable-unicode3 was not specified.
77
46 The combining table also contains entries for arabic presentation 78 The combining table also contains entries for arabic presentation
47 forms, but these are not currently used. Bug me if you want 79 forms, but these are not currently used. Bug me if you want these to
48 these to be used. 80 be used (and tell me how these are to be used...).
49--enable-fallback(=CLASS) 81
82 --enable-fallback(=CLASS) (default: Rxvt)
50 when reading resource settings, also read settings for class CLASS 83 When reading resource settings, also read settings for class CLASS.
51 (default: Rxvt). To disable resource fallback use --disable-fallback. 84 To disable resource fallback use --disable-fallback.
52--with-res-name=NAME 85
53 use the given name (default: urxvt) as default application name 86 --with-res-name=NAME (default: urxvt)
87 Use the given name as default application name when reading
54 when reading resources. Specify --with-res-name=rxvt to replace 88 resources. Specify --with-res-name=rxvt to replace rxvt.
55 rxvt. 89
56--with-res-class=CLASS 90 --with-res-class=CLASS (default: URxvt)
57 use the given class (default: URxvt) as default application class 91 Use the given class as default application class when reading
58 when reading resources. Specify --with-res-class=Rxvt to replace 92 resources. Specify --with-res-class=Rxvt to replace rxvt.
59 rxvt. 93
60--enable-utmp 94 --enable-utmp (default: on)
61 write user and tty to utmp file (used by programs like ``w'') at 95 Write user and tty to utmp file (used by programs like w) at start
62 start of rxvt execution and delete information when rxvt exits. 96 of rxvt execution and delete information when rxvt exits.
63--enable-wtmp 97
98 --enable-wtmp (default: on)
64 write user and tty to wtmp file (used by programs like ``last'') at 99 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 100 start of rxvt execution and write logout when rxvt exits. This
66 option requires --enable-utmp to also be specified. 101 option requires --enable-utmp to also be specified.
67--enable-lastlog 102
103 --enable-lastlog (default: on)
68 write user and tty to lastlog file (used by programs like 104 Write user and tty to lastlog file (used by programs like lastlogin)
69 ``lastlogin'') at start of rxvt execution. This option requires 105 at start of rxvt execution. This option requires --enable-utmp to
70 --enable-utmp to also be specified. 106 also be specified.
71--enable-xpm-background 107
72 add support for XPM background pixmaps 108 --enable-afterimage (default: on)
73--enable-transparency 109 Add support for libAfterImage to be used for transparency and
74 add support for inheriting parent backgrounds thus giving a fake 110 background images. It adds support for many file formats including
75 transparency to the term 111 JPG, PNG, SVG, TIFF, GIF, XPM, BMP, ICO, XCF, TGA and AfterStep
76--enable-fading 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)
77 add support for fading the text when focus is lost. 130 Add support for fading the text when focus is lost.
78--enable-tinting 131
79 add support for tinting of transparent backgrounds. 132 --enable-rxvt-scroll (default: on)
80--enable-menubar
81 add support for our menu bar system (this interacts badly with
82 dynamic locale switching currently)
83--enable-rxvt-scroll
84 add support for the original rxvt scrollbar 133 Add support for the original rxvt scrollbar.
85--enable-next-scroll 134
135 --enable-next-scroll (default: on)
86 add support for a NeXT-like scrollbar 136 Add support for a NeXT-like scrollbar.
87--enable-xterm-scroll 137
138 --enable-xterm-scroll (default: on)
88 add support for an Xterm-like scrollbar 139 Add support for an Xterm-like scrollbar.
89--enable-plain-scroll 140
90 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--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 141 --disable-backspace-key
100 disable any handling of the backspace key by us - let the X server 142 Removes any handling of the backspace key by us - let the X server
101 do it 143 do it.
144
102--disable-delete-key 145 --disable-delete-key
103 disable any handling of the delete key by us - let the X server 146 Removes any handling of the delete key by us - let the X server do
104 do it 147 it.
148
105--disable-resources 149 --disable-resources
106 remove all resources checking 150 Removes any support for resource checking.
107--enable-xgetdefault 151
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 to link in. (this breaks ANSI-C rules and has problems on many
116 GNU/Linux systems).
117--disable-swapscreen 152 --disable-swapscreen
118 remove support for swap screen 153 Remove support for secondary/swap screen.
119--enable-frills 154
120 add support for some lesser used features 155 --enable-frills (default: on)
121--enable-linespace 156 Add support for many small features that are not essential but nice
122 add support to provide user specified line spacing between text rows 157 to have. Normally you want this, but for very small binaries you may
123--enable-keepscrolling 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 seperate 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 (-cb, -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)
124 add support for continual scrolling of the display when you hold 203 Add support for continual scrolling of the display when you hold the
125 the mouse button down on a scrollbar arrow 204 mouse button down on a scrollbar arrow.
126--enable-mousewheel 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)
127 add support for scrolling via mouse wheel or buttons 4 & 5 211 Add support for scrolling via mouse wheel or buttons 4 & 5.
128--enable-slipwheeling 212
213 --enable-slipwheeling (default: on)
129 add support for continual scrolling (using the mouse wheel as an 214 Add support for continual scrolling (using the mouse wheel as an
130 accelerator) while the control key is held down. This option 215 accelerator) while the control key is held down. This option
131 requires --enable-mousewheel to also be specified. 216 requires --enable-mousewheel to also be specified.
132--enable-old-selection 217
133 remove support for reverting the mouse selection style to that 218 --enable-smart-resize (default: off)
134 of v2.20 (and prior) 219 Add smart growth/shrink behaviour when resizing. This should keep
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 220 the window corner which is closest to a corner of the screen in a
152--enable-256-color 221 fixed position.
153 add support for 256 colours rather than the base 16 colours 222
154--enable-cursor-blink 223 --enable-text-blink (default: on)
155 add support for a blinking cursor 224 Add support for blinking text.
156--enable-pointer-blank 225
226 --enable-pointer-blank (default: on)
157 add support to have the pointer disappear when typing or inactive 227 Add support to have the pointer disappear when typing or inactive.
158--with-name=NAME 228
159 set the basename for the installed binaries (default: urxvt, resulting 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 --with-afterimage-config=DIR
240 Look for the libAfterImage config script in DIR.
241
242 --with-name=NAME (default: urxvt)
243 Set the basename for the installed binaries, resulting in "urxvt",
160 in urxvt, urxvtd etc.). Specify --with-name=rxvt to replace rxvt. 244 "urxvtd" etc.). Specify "--with-name=rxvt" to replace with "rxvt".
161--with-term=NAME 245
246 --with-term=NAME (default: rxvt-unicode)
162 change the environmental variable for the terminal to NAME 247 Change the environmental variable for the terminal to NAME.
163 (default "rxvt") 248
164--with-terminfo=PATH 249 --with-terminfo=PATH
165 change the environmental variable for the path to the terminfo 250 Change the environmental variable for the path to the terminfo tree
166 tree to PATH 251 to PATH.
252
167--with-x 253 --with-x
168 use the X Window System (pretty much default, eh?) 254 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 255

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines