annotate configure.usage @ 1318:b531bf8658e9

[xemacs-hg @ 2003-02-21 06:56:46 by ben] redisplay fixes et al. PROBLEMS: Add comment about Cygwin, unexec and sysmalloc. Move some non-general stuff out of general. Make a section for x86. configure.in: Add check for broken alloca in funcalls. mule/mule-cmds.el: Alias file-name to native not vice-versa. Do set EOL of native but not of process output to fix various problems and be consistent with code-init.el. code-cmds.el: Return a name not a coding system. code-init.el: Reindent. Remove `file-name' since it should always be the same as native. unicode.el: Rename to load-unicode-mapping-table as suggested by the anonymous (but rather Turnbullian) comment in unicode.c. xemacs.dsp: Add /k to default build. alloc.c: Make gc_currently_forbidden static. config.h.in, lisp.h: Move some stuff to lisp.h. console-gtk.h, console-impl.h, console-msw.h, console-x.h, event-Xt.c, event-msw.c, redisplay-gtk.c, redisplay-msw.c, redisplay-output.c, redisplay-x.c, gtk-xemacs.c: Remove duplicated code to redraw exposed area. Add deadbox method needed by the generalized redraw code. Defer redrawing if already in redisplay. frame-msw.c, event-stream.c, frame.c: Add comments about calling Lisp. debug.c, general-slots.h: Move generalish symbols to general-slots.h. doprnt.c: reindent. lisp.h, dynarr.c: Add debug code for locking a dynarr to catch invalid mods. Use in redisplay.c. eval.c: file-coding.c: Define file-name as alias for native not vice-versa. frame-gtk.c, frame-x.c: Move Qwindow_id to general-slots. dialog-msw.c, glyphs-gtk.c, glyphs-msw.c, glyphs-widget.c, glyphs-x.c, gui.c, gui.h, menubar-msw.c, menubar.c: Ensure that various glyph functions that eval within redisplay protect the evals. Same for calls to internal_equal(). Modify various functions, e.g. gui_item_*(), to protect evals within redisplay, taking an in_redisplay parameter if it's possible for them to be called both inside and outside of redisplay. gutter.c: Defer specifier-changed updating till after redisplay, if necessary, since we need to enter redisplay to do it. gutter.c: Do nothing if in redisplay. lisp.h: Add version of alloca() for use in function calls. lisp.h: Add XCAD[D+]R up to 6 D's, and aliases X1ST, X2ND, etc. frame.c, frame.h, redisplay.c, redisplay.h, signal.c, toolbar.c: Redo critical-section code and move from frame.c to redisplay.c. Require that every place inside of redisplay catch errors itself, not at the edge of the critical section (thereby bypassing the rest of redisplay and leaving things in an inconsistent state). Introduce separate means of holding frame-size changes without entering a complete critical section. Introduce "post-redisplay" methods for deferring things till after redisplay. Abort if we enter redisplay reentrantly. Disable all quit checking in redisplay since it's too dangerous. Ensure that all calls to QUIT trigger an abort if unprotected. redisplay.c, scrollbar-gtk.c, scrollbar-x.c, scrollbar.c: Create enter/exit_redisplay_critical_section_maybe() for code that needs to ensure it's in a critical section but doesn't interfere with an existing critical section. sysdep.c: Use _wexecve() when under Windows NT for Unicode correctness. text.c, text.h: Add new_dfc() functions, which return an alloca()ed value rather than requiring an lvalue. (Not really used yet; used in another workspace, to come.) Add some macros for SIZED_EXTERNAL. Update the encoding aliases after involved scrutinization of the X manual. unicode.c: Answer the anonymous but suspiciously Turnbullian questions. Rename parse-unicode-translation-table to load-unicode-mapping-table, as suggested.
author ben
date Fri, 21 Feb 2003 06:57:21 +0000
parents f99d3d25df86
children c5da5c66fea7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
243
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
1 Usage: configure [--OPTION[=VALUE] ...] [CONFIGURATION]
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
2
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
3 Set compilation and installation parameters for XEmacs, and report.
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
4
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
5 Note that for most of the following options, you can explicitly enable
380
8626e4521993 Import from CVS: tag r21-2-5
cvs
parents: 373
diff changeset
6 them using `--OPTION=yes' and explicitly disable them using `--OPTION=no'.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
7 This is especially useful for auto-detected options.
276
6330739388db Import from CVS: tag r21-0b36
cvs
parents: 274
diff changeset
8 The option `--without-FEATURE' is a synonym for `--with-FEATURE=no'.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
9
272
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
10 Options marked with a (*) are auto-detected.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
11
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
12 Many features require external packages to be installed first.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
13 Get them from ftp://ftp.xemacs.org/pub/xemacs/aux.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
14
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
15 Use colons (or quoted spaces) to separate directory names in option
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
16 values which are PATHs (i.e. lists of directories).
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
17
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
18 The results of configure tests are saved in config.log, which is useful
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
19 for diagnosing problems.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
20
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
21
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
22 General options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
23 ----------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
24
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
25 --help Issue this usage message.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
26 --verbose Accepted but ignored.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
27 --extra-verbose Display more information, useful for debugging.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
28
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
29
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
30 Compilation options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
31 --------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
32
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
33 --compiler=PROG C compiler to use
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
34 --xemacs-compiler=PROG compiler to use to compile just the xemacs executable.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
35 If you want to compile XEmacs as C++, use e.g.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
36 `--xemacs-compiler=g++'. This turns on a lot of
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
37 additional error-checking.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
38 --with-gcc (*) Use GCC to compile XEmacs.
1111
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
39 --cflags=FLAGS Compiler flags (such as -O); setting this overrides
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
40 all default compiler flags except those that control
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
41 warnings.
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
42 --cflags_warning=FLAGS Override compiler flags used to control warnings.
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
43 Normally, don't set this, as XEmacs already turns on
184461bc8de4 [xemacs-hg @ 2002-11-18 06:52:23 by ben]
ben
parents: 974
diff changeset
44 the maximum safe warning level.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
45 --cpp=PROG C preprocessor to use (e.g. /usr/ccs/lib/cpp or cc -E)
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
46 --cppflags=FLAGS C preprocessor flags (e.g. -I/foo or -Dfoo=bar)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
47 --libs=LIBS Additional libraries (e.g. -lfoo)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
48 --ldflags=FLAGS Additional linker flags (e.g. -L/foo)
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
49 --site-includes=PATH List of directories to search first for header files
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
50 --site-libraries=PATH List of directories to search first for libraries
243
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
51 --site-prefixes=PATH List of directories to search for include/ and lib/
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
52 subdirectories, just after 'site-includes' and
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
53 'site-libraries'
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
54 --site-runtime-libraries=PATH
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
55 List of ALL directories to search for dynamically
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
56 linked libraries at run time
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
57 --dynamic=yes Link dynamically if supported by system.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
58 --dynamic=no Force static linking on systems where dynamic
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
59 linking is the default.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
60 --srcdir=DIR Look for the XEmacs source files in DIR.
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
61 Works best when using GNU Make. Allows you to build
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
62 XEmacs in various different ways using the same
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
63 source tree.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
64
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
65
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
66 Installation options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
67 ---------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
68
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
69 --prefix=DIR Install files below DIR. Defaults to `/usr/local'.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
70 --with-prefix=no Don't compile the value of --prefix into the
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
71 executable.
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
72 --with-netinstall Compile in support for installation over the internet.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
73 Only functional on the MS Windows platforms.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
74 --bindir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
75 --datadir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
76 --statedir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
77 --libdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
78 --infodir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
79 --mandir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
80 --lispdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
81 --sitelispdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
82 --etcdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
83 --lockdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
84 --archlibdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
85 --docdir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
86 --moduledir=DIR
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
87 You may also control individually where various
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
88 parts of XEmacs are installed. Note that we
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
89 recommend against explicitly setting any of these
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
90 variables. See the INSTALL file for a complete list
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
91 plus the reasons we advise not changing them.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
92
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
93
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
94 Run-time path-searching options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
95 --------------------------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
96
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
97 --with-site-lisp=yes Allow for a site-lisp directory in the XEmacs hierarchy
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
98 searched before the installation packages.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
99 --with-site-modules=no Disable site-modules directory in the XEmacs hierarchy,
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
100 which is searched before the installation modules.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
101 --package-path=PATH Directories to search for packages to dump with xemacs.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
102 PATH splits into three parts separated by double
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
103 colons (::), an early, a late, and a last part,
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
104 corresponding to their position in the various
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
105 system paths: The early part is always first,
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
106 the late part somewhere in the middle, and the
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
107 last part at the very back.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
108 Only the late part gets seen at dump time.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
109 If PATH has only one component, that component
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
110 is late.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
111 If PATH has two components, the first is
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
112 early, the second is late.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
113 --infopath=PATH Directories to search for Info documents, info dir
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
114 and localdir files in case run-time searching
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
115 for them fails.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
116
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
117
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
118 Window-system options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
119 ----------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
120
462
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 442
diff changeset
121 --with-gtk Support GTK on the X Window System. (EXPERIMENTAL)
0784d089fdc9 Import from CVS: tag r21-2-46
cvs
parents: 442
diff changeset
122 --with-gnome Support GNOME on the X Window System. (EXPERIMENTAL)
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
123 --with-x11 (*) Support the X Window System.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
124 --x-includes=DIR Search for X header files in DIR.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
125 --x-libraries=DIR Search for X libraries in DIR.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
126 --with-msw (*) Support MS Windows as a window system (only under
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
127 Cygwin and MinGW). `--with-msw=no' may be needed on
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
128 *nix systems with Wine installed.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
129 --with-toolbars=no Don't compile with any toolbar support.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
130 --with-wmcommand=no Compile without realized leader window which will
414
da8ed4261e83 Import from CVS: tag r21-2-15
cvs
parents: 412
diff changeset
131 keep the WM_COMMAND property.
434
9d177e8d4150 Import from CVS: tag r21-2-25
cvs
parents: 432
diff changeset
132 --with-athena=TYPE Use TYPE Athena widgets
9d177e8d4150 Import from CVS: tag r21-2-25
cvs
parents: 432
diff changeset
133 (xaw, 3d, next, 95, or xpm)
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
134 --with-menubars=TYPE Use TYPE menubars (lucid, motif, or no). The Lucid
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
135 widgets emulate Motif (mostly) but are faster.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
136 *WARNING* The Motif menubar is currently broken.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
137 --with-scrollbars=TYPE Use TYPE scrollbars
434
9d177e8d4150 Import from CVS: tag r21-2-25
cvs
parents: 432
diff changeset
138 (lucid, motif, athena, or no).
642
277f059a321b [xemacs-hg @ 2001-08-01 18:59:04 by adrian]
adrian
parents: 610
diff changeset
139 --with-dialogs=TYPE Use TYPE dialog boxes (lucid, motif, athena, or no).
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
140 Lucid menubars and scrollbars are the default.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
141 Motif dialog boxes will be used if Motif can be found.
642
277f059a321b [xemacs-hg @ 2001-08-01 18:59:04 by adrian]
adrian
parents: 610
diff changeset
142 --with-widgets=TYPE Use TYPE widgets (lucid, motif, athena, or no).
974
fce478afd5b4 [xemacs-hg @ 2002-08-24 10:23:48 by scop]
scop
parents: 925
diff changeset
143 Other widget types are currently unsupported.
420
41dbb7a9d5f2 Import from CVS: tag r21-2-18
cvs
parents: 414
diff changeset
144 Motif widgets will be used if Motif can be found.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
145 --with-dragndrop Compile in the generic drag and drop API. This is
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
146 automatically added if one of the drag and drop
642
277f059a321b [xemacs-hg @ 2001-08-01 18:59:04 by adrian]
adrian
parents: 610
diff changeset
147 protocols is found (currently CDE, OffiX, MSWindows,
277f059a321b [xemacs-hg @ 2001-08-01 18:59:04 by adrian]
adrian
parents: 610
diff changeset
148 and GTK).
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
149 *WARNING* The Drag'n'drop support is under development
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
150 and is considered experimental.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
151 --with-cde Compile in support for CDE drag and drop.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
152 --with-offix Compile in support for OffiX drag and drop.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
153 *WARNING* If you compile in OffiX, you may not be
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
154 able to use multiple X displays success-
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
155 fully. If the two servers are from
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
156 different vendors, the results may be
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
157 unpredictable.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
158 --with-xmu=no (*) For those unfortunates whose vendors don't ship Xmu.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
159 --external-widget Compile with external widget support.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
160
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
161
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
162 TTY (character terminal) options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
163 ---------------------------------
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
164
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
165 --with-tty=no Don't support ttys.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
166 --with-ncurses (*) Use the ncurses library for tty support.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
167 --with-gpm (*) Compile in GPM mouse support for ttys.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
168
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
169
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
170 Image options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
171 --------------
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
172
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
173 --with-xpm (*) Compile with support for XPM images. PRACTICALLY
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
174 REQUIRED. Although this library is nonstandard and
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
175 a real hassle to build, many basic things (e.g.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
176 toolbars) depend on it, and you will run into
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
177 many problems without it.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
178 --with-png (*) Compile with support for PNG images. Recommended
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
179 because the images on the About page are not viewable
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
180 without it.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
181 --with-jpeg (*) Compile with support for JPEG images. Useful if
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
182 you are using a mail, news reader, or web browser
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
183 in XEmacs, so that JPEG images can be displayed.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
184 --with-tiff (*) Compile with support for TIFF images. Possibly
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
185 useful, for the same reason as JPEG images.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
186 --with-xface (*) Compile with support for X-Face mail headers.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
187 Requires the compface package. Of doubtful
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
188 usefulness.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
189 --with-gif=no Compile without the (builtin) support for GIF images.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
190
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
191
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
192 Sound options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
193 --------------
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
194
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
195 --with-sound=TYPE[,TYPE[,...]] (*) Compile with sound support.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
196 Valid types are `native', `nas' and `esd'.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
197 Prefix a type with 'no' to disable.
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
198 The first type can be `none' or `all'. `none' means
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
199 `nonative,nonas,noesd'. `all' means `native,nas,esd'.
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
200 Later options override earlier ones for the same TYPE.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
201 The default is to autodetect all sound support.
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
202 --native-sound-lib=LIB Native sound support library. Needed on Suns
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
203 with `--with-sound=native,nas' because both sound
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
204 libraries are called libaudio.
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
205
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
206
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
207 Internationalization options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
208 -----------------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
209
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
210 --with-mule Compile with Mule (MUlti-Lingual Emacs) support,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
211 needed to support non-Latin-1 (including Asian)
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
212 languages.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
213 --with-xim=xlib Compile with support for X input methods,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
214 --with-xim=motif (*) Used in conjunction with Mule support.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
215 Use either raw Xlib to provide XIM support, or
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
216 the Motif XmIm* routines (when available).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
217 NOTE: On some systems bugs in X11's XIM support
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
218 will cause XEmacs to crash, so by default,
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
219 no XIM support is compiled in, unless running
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
220 on Solaris and the XmIm* routines are detected.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
221 --with-canna (*) Compile with support for Canna (a Japanese input method
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
222 used in conjunction with Mule support).
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
223 --with-wnn (*) Compile with support for Wnn (a multi-language input
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
224 method used in conjunction with Mule support).
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
225 --with-wnn6 (*) Compile with support for the commercial package Wnn6.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
226 --with-i18n3 Compile with I18N level 3 (support for message
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
227 translation). This doesn't currently work.
724
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
228 --with-xfs Compile with XFontSet support for internationalized
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
229 menubar. Incompatible with `--with-xim=motif'.
76d5a3dd827a [xemacs-hg @ 2002-01-05 07:33:11 by stephent]
stephent
parents: 708
diff changeset
230 `--with-menubars=lucid' (the default) is desirable.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
231
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
232
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
233 File-related options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
234 ---------------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
235
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
236 --with-default-eol-detection
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
237 Turns on by default auto-detection of end-of-line type
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
238 when reading a file. Applies to those platforms where
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
239 auto-detection is off by default (non-Mule Unix). Has
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
240 no effect otherwise.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
241 --with-clash-detection=no
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
242 Disable use of lock files to detect multiple edits
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
243 of the same file.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
244
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
245
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
246 Database options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
247 -----------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
248
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
249 --with-database=TYPE (*) Compile with database support. Valid types are
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
250 `no' or a comma-separated list of one or more
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
251 of `berkdb' and either `dbm' or `gnudbm'.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
252 --with-ldap (*) Compile with support for the LDAP protocol.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
253 --with-postgresql (*) Compile with support for the PostgreSQL RDBMS.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
254
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
255
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
256 Mail options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
257 -------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
258
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
259 --mail-locking=TYPE (*) Specify the locking to be used by movemail to prevent
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
260 concurrent updates of mail spool files. Valid types
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
261 are `lockf', `flock', `dot', `locking' or `mmdf'.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
262 --with-pop Support POP for mail retrieval.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
263 --with-kerberos Support Kerberos-authenticated POP.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
264 --with-hesiod Support Hesiod to get the POP server host.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
265
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
266
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
267 Networking options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
268 -------------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
269
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
270 --with-tooltalk (*) Support the ToolTalk IPC protocol.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
271 --with-socks Compile with support for SOCKS (an Internet proxy).
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
272 --with-dnet (*) Compile with support for DECnet.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
273 --with-ipv6-cname Try IPv6 information first when canonicalizing host
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
274 names. This option has no effect unless system
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
275 supports getaddrinfo(3) and getnameinfo(3).
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
276
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
277
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
278 Memory allocation options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
279 --------------------------
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
280
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
281 --rel-alloc Use the relocating allocator (default for this option
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
282 is system-dependent).
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
283 --with-dlmalloc Control usage of Doug Lea malloc on systems that have
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
284 it in the standard C library (default is to use it if
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
285 it is available).
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
286 --with-system-malloc Force use of the system malloc, rather than GNU malloc.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
287 --with-debug-malloc Use the debugging malloc package.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
288
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
289
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
290 Debugging options:
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
291 ------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
292
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
293 --debug Compile with support for debugging XEmacs.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
294 (Causes code-size increase and little loss of speed.)
221
6c0ae1f9357f Import from CVS: tag r20-4b9
cvs
parents: 219
diff changeset
295 --error-checking=TYPE[,TYPE]...
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
296 Compile with internal error-checking added.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
297 Causes noticeable loss of speed. Valid types
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
298 are extents, bufpos, malloc, gc, typecheck.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
299 --error-checking=none Disable all internal error-checking (the default).
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
300 --error-checking=all Enable all internal error-checking.
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
301 --memory-usage-stats Compile with additional code to allow you to
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
302 determine what XEmacs's memory is being used
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
303 for. Causes a small code increase but no loss
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
304 of speed. Normally enabled when --debug is given.
771
943eaba38521 [xemacs-hg @ 2002-03-13 08:51:24 by ben]
ben
parents: 724
diff changeset
305 --quick-build Speed up the build cycle by leaving out steps where
943eaba38521 [xemacs-hg @ 2002-03-13 08:51:24 by ben]
ben
parents: 724
diff changeset
306 XEmacs will still work (more or less) without them.
943eaba38521 [xemacs-hg @ 2002-03-13 08:51:24 by ben]
ben
parents: 724
diff changeset
307 Potentially dangerous if you don't know what you're
943eaba38521 [xemacs-hg @ 2002-03-13 08:51:24 by ben]
ben
parents: 724
diff changeset
308 doing. This (1) doesn't garbage-collect after loading
1303
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
309 each file during dumping, (2) doesn't
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
310 automatically rebuild the DOC file (remove it by hand
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
311 to get it rebuilt), (3) Removes config.h, lisp.h and
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
312 associated files from the dependency lists, so changes
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
313 to these files don't automatically cause all .c files
f99d3d25df86 [xemacs-hg @ 2003-02-15 10:15:54 by ben]
ben
parents: 1202
diff changeset
314 to be rebuilt.
388
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
315 --use-union-type Enable or disable use of a union, instead of an
aabb7f5b1c81 Import from CVS: tag r21-2-9
cvs
parents: 380
diff changeset
316 int, for the fundamental Lisp_Object type; this
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
317 provides stricter type-checking. WARNING: This has
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
318 a tendency to trigger compiler bugs, especially in
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
319 combination with other features that increase the
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
320 complexity of expressions, for example `--with-mule'
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
321 and `--error-checking=all'. Crashes have been
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
322 observed with union type in combination with the
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
323 two options just mentioned under various versions of
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
324 GCC as well as MSVC++ 6.0. Furthermore, many
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
325 debuggers have problems (i.e. bugs) dealing with
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
326 unions, and even for those that don't, debugging can
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
327 be inconvenient because of no syntax for entering a
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
328 union. We recommend `--use-union-type' *ONLY* for
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
329 testing purposes, not for production builds. If you
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
330 are using `-use-union-type' and get some weird
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
331 crash, try redoing without union type.
392
1f50e6fe4f3f Import from CVS: tag r21-2-11
cvs
parents: 388
diff changeset
332 --with-quantify Add support for performance debugging using Quantify.
1f50e6fe4f3f Import from CVS: tag r21-2-11
cvs
parents: 388
diff changeset
333 --with-purify Add support for memory debugging using Purify.
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
334
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
335
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
336 Developer options:
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
337 ------------------
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
338
1202
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
339 --with-workshop Support the Sun WorkShop (formerly Sparcworks)
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
340 development environment.
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
341 --pdump New, portable, relocatable dumper. Currently works
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
342 quite well, somewhere in beta-to-late-beta, we
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
343 might say. (Infamous for being the former
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
344 "experimental, don't-sue-me-if-your-house-collapses-
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
345 and-your-wife-leaves-you" portable dumper.)
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
346 --use-kkcc Enable the use of new GC algorithms. (EXPERIMENTAL)
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
347 --with-modules (*) Compile in experimental support for dynamically
6041a741b6d6 [xemacs-hg @ 2003-01-12 11:03:13 by michaels]
michaels
parents: 1111
diff changeset
348 loaded libraries (Dynamic Shared Objects).
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
349
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
350
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
351 If successful, configure leaves its status in config.status. If
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
352 unsuccessful after disturbing the status quo, it removes config.status.
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
353
272
c5d627a313b1 Import from CVS: tag r21-0b34
cvs
parents: 269
diff changeset
354 The configure script also recognizes some environment variables, each
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
355 of which is equivalent to a corresponding configure flag. Configure
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
356 flags take precedence over environment variables, if both are specified.
243
f220cc83d72e Import from CVS: tag r20-5b20
cvs
parents: 239
diff changeset
357
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
358 environment corresponding
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
359 variable configure flag
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
360 ----------- --------------
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
361 CC --compiler
594
fd49b88b9f06 [xemacs-hg @ 2001-05-31 12:47:21 by ben]
ben
parents: 464
diff changeset
362 XEMACS_CC --xemacs-compiler
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
363 CPP --cpp
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
364 CFLAGS --cflags
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
365 CPPFLAGS --cppflags
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
366 LDFLAGS --ldflags
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
367 LIBS --libs
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 438
diff changeset
368 LD_RUN_PATH --site-runtime-libraries
215
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
369
1f0dabaa0855 Import from CVS: tag r20-4b6
cvs
parents:
diff changeset
370 For more details on the install process, consult the INSTALL file.