>>>> "Adrian" == Adrian Aichner
<adrian(a)xemacs.org> writes:
Adrian> Whitespace changes are not worth chasing down, just the structure of
Adrian> lists, and documentation syntax.
The best I can make it is as follows. If you have any comments let me know
but be warned that autoconf 2.5 has some very definite ideas about the
structure of the generic arguments that are very difficult to change.
Malcolm
---------------------------------------------------------------------------
`configure' configures this package to adapt to many kinds of systems.
Usage: ./configure [OPTION]... [VAR=VALUE]...
To assign environment variables (e.g., CC, CFLAGS...), specify them as
VAR=VALUE. See below for descriptions of some of the useful variables.
Defaults for the options are specified in brackets.
Configuration:
-h, --help display this help and exit
--help=short display options specific to this package
--help=recursive display the short help of all the included packages
-V, --version display version information and exit
-q, --quiet, --silent do not print `checking...' messages
--cache-file=FILE cache test results in FILE [disabled]
-C, --config-cache alias for `--cache-file=config.cache'
-n, --no-create do not create output files
--srcdir=DIR find the sources in DIR [configure dir or `..']
Installation directories:
--prefix=PREFIX install architecture-independent files in PREFIX
[/usr/local]
--exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
[PREFIX]
By default, `make install' will install all the files in
`/usr/local/bin', `/usr/local/lib' etc. You can specify
an installation prefix other than `/usr/local' using `--prefix',
for instance `--prefix=$HOME'.
For better control, use the options below.
Fine tuning of the installation directories:
--bindir=DIR user executables [EPREFIX/bin]
--sbindir=DIR system admin executables [EPREFIX/sbin]
--libexecdir=DIR program executables [EPREFIX/libexec]
--datadir=DIR read-only architecture-independent data [PREFIX/share]
--sysconfdir=DIR read-only single-machine data [PREFIX/etc]
--sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com]
--localstatedir=DIR modifiable single-machine data [PREFIX/var]
--libdir=DIR object code libraries [EPREFIX/lib]
--includedir=DIR C header files [PREFIX/include]
--oldincludedir=DIR C header files for non-gcc [/usr/include]
--infodir=DIR info documentation [PREFIX/info]
--mandir=DIR man documentation [PREFIX/man]
X features:
--x-includes=DIR X include files are in DIR
--x-libraries=DIR X library files are in DIR
System types:
--build=BUILD configure for building on BUILD [guessed]
Optional Features:
--with-FEATURE[=ARG] include FEATURE [ARG=yes]
--enable-FEATURE[=ARG] alias for --with-FEATURE
--without-FEATURE do not use FEATURE (same as --with-FEATURE=no)
--disable-FEATURE alias for --without-FEATURE
Compilation options
-------------------
--with-compiler C compiler to use
--with-xemacs-compiler compiler to use to compile just the xemacs
executable and C modules. If you want to compile
XEmacs as C++, use e.g.
`--with-xemacs-compiler=g++'. This turns on a lot of
additional error-checking.
--with-gcc Use GCC to compile XEmacs.
--with-cflags Compiler flags. These flags will be placed after any
flags inserted for warnings, debugging or
optimization; setting this does not disable the
insertion of those flags. Use configure settings
such as `--with-optimization=no' or
`enable-debug=no' to turn them off, or override them
with `--with-cflags-optimization',
`--with-cflags-debugging', or `with-cflags-warning'.
--with-cflags-warning Override compiler flags used to control warnings.
Normally, don't set this, as XEmacs already turns on
the maximum safe warning level.
--with-optimization Control whether compilation is optimized. By
default, optimization is on in release versions and
off in beta versions, since it can interfere with
proper stack backtraces.
--with-cflags-optimization=FLAGS
Override compiler flags used to control
optimization. If blank, forces no optimization; if
non-blank, forces optimization. Normally, don't set
this; XEmacs automatically sets the maximum safe
optimization flags appropriate for the compiler
being invoked. If you just want to turn optimization
on or off, use `with-optimization' instead.
--with-cflags-debugging=FLAGS
Override compiler flags used to add debugging
information to the executable. Normally, debugging
information is added whenever possible (i.e. unless
optimization is turned on and the compiler does not
permit debugging and optimization simultaneously).
--with-cpp C preprocessor to use (e.g. /usr/ccs/lib/cpp or cc
-E)
--with-cppflags C preprocessor flags (e.g. -I/foo or -Dfoo=bar)
--with-libs Additional libraries (e.g. -lfoo)
--with-ldflags Additional linker flags (e.g. -L/foo)
--with-site-includes Prepend to include search path.
--with-site-libraries Prepend to library search path.
--with-site-prefixes Prepend to include and library search paths, with
/include and /lib added. Comes after site-includes
and site-libraries, if any.
--with-site-runtime-libraries
--with-dynamic Link dynamically if supported by system. 'No' forces
static linking.
Installation options
--------------------
--with-prefix=no Don't compile the value for `prefix' into the
executable.
--with-netinstall Support for installation over the internet. Only
functional on the MS Windows platforms.
--with-statedir
--with-lispdir
--with-archlibdir
--with-moduledir
--with-etcdir
--with-docdir
Run-time path-searching options
-------------------------------
--with-site-lisp=no Allow for a site-lisp directory in the XEmacs
hierarchy searched before the installation packages.
--with-site-modules Disable site-modules directory in the XEmacs
hierarchy, which is searched before the installation
modules.
--with-package-prefix Specify packages root.
--with-package-path Search path for package hierarchies.
--with-infopath
Window-system options
---------------------
--with-gtk Support GTK on the X Window System. (EXPERIMENTAL)
--with-gnome Support GNOME on the X Window System. (EXPERIMENTAL)
--with-msw Support MS Windows as a window system (only under
Cygwin and MinGW). `--with-msw=no' may be needed on
*nix systems with Wine installed.
--with-toolbars Enable toolbar support. Default: yes.
--with-wmcommand Compile without realized leader window which will
keep the WM_COMMAND property.
--with-athena Use TYPE Athena widgets (xaw, 3d, next, 95, or xpm).
--with-menubars=TYPE Use TYPE menubars (lucid, motif, or no). The Lucid
widgets emulate Motif (mostly) but are faster.
*WARNING* The Motif menubar is currently broken.
Lucid menubars are the default.
--with-scrollbars=TYPE
Use TYPE scrollbars (lucid, motif, athena, or no).
Lucid scrollbars are the default.
--with-dialogs=TYPE Use TYPE dialog boxes (lucid, motif, athena, or no).
There are no true Lucid dialogs; Motif dialogs will
be used if Motif can be found, else Athena is used.
--with-widgets Use TYPE native widgets (lucid, motif, athena, or
no). Other widget types are currently unsupported.
There are no true Lucid widgets; Motif widgets will
be used if Motif can be found, else Athena is used.
--with-dragndrop Compile in the generic drag and drop API. This is
automatically added if one of the drag and drop
protocols is found (currently CDE, OffiX, MSWindows,
and GTK). *WARNING* The Drag'n'drop support is under
development and is considered experimental.
--with-cde Compile in support for CDE drag and drop.
--with-offix Compile in support for OffiX drag and drop.
*WARNING* If you compile in OffiX, you may not be
able to use multiple X displays success- fully. If
the two servers are from different vendors, the
results may be unpredictable.
--with-xmu Use Xmu utilities. Default: yes.
--with-external-widget
Support XEmacs server for text widgets in other
applications.
TTY (character terminal) options
--------------------------------
--with-tty Enable TTY support. Default: yes.
--with-ncurses Use the ncurses library for tty support.
--with-gpm Compile in GPM mouse support for ttys.
Image options
-------------
--with-xpm Compile with support for XPM images. PRACTICALLY
REQUIRED. Although this library is nonstandard and a
real hassle to build, many basic things (e.g.
toolbars) depend on it, and you will run into many
problems without it.
--with-png Compile with support for PNG images. Recommended
because the images on the About page are not
viewable without it.
--with-jpeg Compile with support for JPEG images. Useful if you
are using a mail, news reader, or web browser in
XEmacs, so that JPEG images can be displayed.
--with-tiff Compile with support for TIFF images. Possibly
useful, for the same reason as JPEG images.
--with-xface Compile with support for X-Face mail headers.
Requires the compface package.
--with-gif Compile without the (builtin) support for GIF
images.
Sound options
-------------
--with-sound Compile with sound support. Valid types are
`native', `nas' and `esd'. Prefix a type with
'no'
to disable. The first type can be `none' or `all'.
`none' means `nonative,nonas,noesd'. `all' means
`native,nas,esd'. Later options override earlier
ones for the same TYPE. The default is to autodetect
all sound support except for ESD which defaults to
off.
--with-native-sound-lib Path to sound library (for systems with name
conflicts).
Internationalization options
----------------------------
--with-mule Compile with Mule (Multi-Lingual Emacs) support,
needed to support non-Latin-1 (including Asian)
languages.
--with-canna Support the Canna Japanese input method. Requires
Mule.
--with-wnn Support the Wnn Asian language input method.
Requires Mule.
--with-wnn6 Support the Wnn6 Asian language input method
(proprietary). Requires Mule.
--with-xfs Enable XFontSet support for internationalized
menubar. Incompatible with `--with-xim=motif'.
`--with-menubars=lucid' (the default) is
desirable.
File-related options
--------------------
--with-default-eol-detection
Turns on by default auto-detection of end-of-line
type when reading a file. Applies to those platforms
where auto-detection is off by default (non-Mule
Unix). Has no effect otherwise.
--with-clash-detection
Disable use of lock files to detect multiple edits
of the same file.
Database options
----------------
--with-database Compile with database support. Valid types are `no'
or a comma-separated list of one or more of `berkdb'
and either `dbm' or `gnudbm'.
--with-ldap Support the LDAP protocol.
--with-postgresql Support the PostgreSQL RDBMS.
Mail options
------------
--with-mail-locking Specify the locking to be used by movemail to
prevent concurrent updates of mail spool files.
Valid types are `lockf', `flock', `dot',
`locking'
or `mmdf'.
--with-pop Support POP for mail retrieval.
--with-kerberos Support Kerberos-authenticated POP.
--with-hesiod Support Hesiod to get the POP server host.
Networking options
------------------
--with-tooltalk Support the ToolTalk IPC protocol.
--with-socks Compile with support for SOCKS (an Internet proxy).
--with-dnet Compile with support for DECnet.
--with-ipv6-cname Try IPv6 information first when canonicalizing host
names. This option has no effect unless system
supports getaddrinfo(3) and getnameinfo(3).
Memory allocation options
-------------------------
--with-rel-alloc Enable the relocating allocator.
--with-dlmalloc Use Doug Lea's malloc implementation.
--with-system-malloc Use the system malloc, not the one distributed with
XEmacs.
--with-debug-malloc Use a debugging malloc.
Emacs Lisp options
------------------
--with-bignum=TYPE Compile in support for bignums, ratios, or bigfloats
using library support. TYPE must be one of "gmp"
(for GNU MP), "mp" (for BSD MP), or "no"
(disabled).
Debugging options
-----------------
--with-debug Enable additional debugging information. No time
cost.
--with-error-checking Compile with internal error-checking added. Causes
noticeable loss of speed. Valid types are extents,
bufpos, malloc, gc, types, text, byte_code, glyphs,
display, structures.
--with-memory-usage-stats
Enable LISP memory usage API.
--with-quick-build Speed up the build cycle by leaving out steps where
XEmacs will still work (more or less) without them.
Potentially dangerous if you don't know what you're
doing. This (1) doesn't garbage-collect after
loading each file during dumping, (2) doesn't
automatically rebuild the DOC file (remove it by
hand to get it rebuilt), (3) Removes config.h,
lisp.h and associated files from the dependency
lists, so changes to these files don't automatically
cause all .c files to be rebuilt.
--with-union-type Use union definition of Lisp_Object type. Known to
trigger bugs in some compilers.
--with-quantify Support performance debugging using Quantify.
--with-purify Support memory debugging using Purify.
Developer options
-----------------
--with-workshop Support the Sun WorkShop (formerly Sparcworks)
development environment.
--with-sparcworks Alias for --with-workshop
--with-pdump Enable portable LISP preloader.
--with-dump-in-exec Enable dumping into executable (enabled by default
for `pdump', not enabled by default in combination
with `mc-alloc').
--with-kkcc Enable new GC algorithms.
--with-mc-alloc Enable new allocator.
--with-assertions Compile in runtime assertions.
--with-modules Compile in experimental support for dynamically
loaded libraries (Dynamic Shared Objects).
--with-zlib Support inflate (de)compression internally.
--with-infodock Support the Infodock version of XEmacs. Infodock is
a SourceForge project).
Optional Packages:
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
--without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no)
--with-x use the X Window System
Some influential environment variables:
CC C compiler command
CFLAGS C compiler flags
LDFLAGS linker flags, e.g. -L<lib dir> if you have libraries in a
nonstandard directory <lib dir>
CPPFLAGS C/C++ preprocessor flags, e.g. -I<include dir> if you have
headers in a nonstandard directory <include dir>
CPP C preprocessor
Use these variables to override the choices made by `configure' or to help
it to find libraries and programs with nonstandard names/locations.
---------------------------------------------------------------------------
--
Malcolm Purvis <malcolmp(a)xemacs.org>