Hello,
I have updated configure.usage. With these updates, one can use the
elisp package Build again to build a daikon XEmacs.
-- Added lots of `with-' prefixes to options.
-- Installation options took always the next line as documentation.
E.g.,--bindir was represented in Build, --datadir was missing, etc.
Still missing: --with-zlib, --with-infodock, --with-native-sound-lib.
I couldn't decide in which section I should put them, or if I should
open a new section.
Cheers,
Joachim
ChangeLog addition:
2005-11-02 Joachim Schrod <jschrod(a)acm.org>
* configure.usage: Update to current options of configure,
to make elisp package Build work with daikon as well.
XEmacs 21.5 source patch:
Diff command: cvs -q -f diff -u
Files affected: configure.usage
Index: configure.usage
===================================================================
RCS file: /pack/xemacscvs/XEmacs/xemacs/configure.usage,v
retrieving revision 1.39
diff -u -r1.39 configure.usage
--- configure.usage 2005/04/08 23:10:15 1.39
+++ configure.usage 2005/11/02 21:10:05
@@ -30,48 +30,52 @@
Compilation options:
--------------------
---compiler=PROG C compiler to use
---xemacs-compiler=PROG compiler to use to compile just the xemacs executable.
+--with-compiler=PROG C compiler to use
+--with-xemacs-compiler=PROG
+ compiler to use to compile just the xemacs executable.
If you want to compile XEmacs as C++, use e.g.
- `--xemacs-compiler=g++'. This turns on a lot of
+ `--with-xemacs-compiler=g++'. This turns on a lot of
additional error-checking.
--with-gcc (*) Use GCC to compile XEmacs.
---cflags=FLAGS Compiler flags (such as -O); setting this overrides
+--with-cflags=FLAGS Compiler flags (such as -O); setting this overrides
all default compiler flags except those that control
warnings.
---cflags-warning=FLAGS Override compiler flags used to control warnings.
+--with-cflags-warning=FLAGS 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.
---cflags-optimization=FLAGS
+--with-cflags-optimization=FLAGS
Override compiler flags used to control optimization.
Only has an effect when optimization is enabled.
Normally, don't set this, as XEmacs will already set
the maximum safe optimization flags appropriate for
the compiler being invoked.
---cflags-debugging=FLAGS
+--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).
---cpp=PROG C preprocessor to use (e.g. /usr/ccs/lib/cpp or cc -E)
---cppflags=FLAGS C preprocessor flags (e.g. -I/foo or -Dfoo=bar)
---libs=LIBS Additional libraries (e.g. -lfoo)
---ldflags=FLAGS Additional linker flags (e.g. -L/foo)
---site-includes=PATH List of directories to search first for header files
---site-libraries=PATH List of directories to search first for libraries
---site-prefixes=PATH List of directories to search for include/ and lib/
+--with-cpp=PROG C preprocessor to use (e.g. /usr/ccs/lib/cpp or cc -E)
+--with-cppflags=FLAGS C preprocessor flags (e.g. -I/foo or -Dfoo=bar)
+--with-libs=LIBS Additional libraries (e.g. -lfoo)
+--with-ldflags=FLAGS Additional linker flags (e.g. -L/foo)
+--with-site-includes=PATH
+ List of directories to search first for header files
+--with-site-libraries=PATH
+ List of directories to search first for libraries
+--with-site-prefixes=PATH
+ List of directories to search for include/ and lib/
subdirectories, just after 'site-includes' and
'site-libraries'
---site-runtime-libraries=PATH
+--with-site-runtime-libraries=PATH
List of ALL directories to search for dynamically
linked libraries at run time
---dynamic=yes Link dynamically if supported by system.
---dynamic=no Force static linking on systems where dynamic
+--with-dynamic=yes Link dynamically if supported by system.
+--with-dynamic=no Force static linking on systems where dynamic
linking is the default.
--srcdir=DIR Look for the XEmacs source files in DIR.
Works best when using GNU Make. Allows you to build
@@ -87,19 +91,27 @@
executable.
--with-netinstall Compile in support for installation over the internet.
Only functional on the MS Windows platforms.
---bindir=DIR
---datadir=DIR
---statedir=DIR
---libdir=DIR
---infodir=DIR
---mandir=DIR
---lispdir=DIR
---sitelispdir=DIR
---etcdir=DIR
---lockdir=DIR
---archlibdir=DIR
---docdir=DIR
---moduledir=DIR
+--with-bindir=DIR install location of executables.
+--with-datadir=DIR install location of architecture-independent
+ read-only data files.
+--with-statedir=DIR install location of architecture-independent
+ data files that get modified.
+--with-libdir=DIR install location of architecture-specific data files.
+--with-infodir=DIR install location of XEmacs info files.
+--with-mandir=DIR install location of man pages for XEmacs and its
+ utilities (like `etags').
+--with-lispdir=DIR install location of XEmacs lisp libraries.
+--with-sitelispdir=DIR indicates where XEmacs should search for lisp libraries
+ specific to your site. See also --with-site-lisp
+--with-etcdir=DIR location of the rest of architecture-independent data.
+--with-lockdir=DIR indicates the directory where XEmacs keeps track of its
+ locking information.
+--with-archlibdir=DIR location of executable files and other
+ architecture-dependent data used while running.
+--with-docdir=DIR install location of Lisp documentation strings.
+--with-moduledir=DIR location of any dynamic modules.
+ See also --with-modules.
+
You may also control individually where various
parts of XEmacs are installed. Note that we
recommend against explicitly setting any of these
@@ -114,18 +126,19 @@
searched before the installation packages.
--with-site-modules=no Disable site-modules directory in the XEmacs hierarchy,
which is searched before the installation modules.
---package-prefix=PATH Specify a directory under which packages will
+--with-package-prefix=PATH Specify a directory under which packages will
be searched. The directories `xemacs-packages' and
(if MULE support exists) `mule-packages' (along with,
optionally, `site-packages') should exist under this
directory. This is preferred to specifying
- `--package-path' directly and is equivalent to
- --package-path="~/.xemacs::${package-prefix}/\
+ `--with-package-path' directly and is equivalent to
+ --with-package-path="~/.xemacs::${package-prefix}/\
site-packages:${package_prefix}/xemacs-packages:\
${package_prefix}/mule-packages"
(or the same without `.../mule-packages' if no
MULE support exists)
---package-path=PATH Directories to search for packages to dump with xemacs.
+--with-package-path=PATH
+ Directories to search for packages to dump with xemacs.
PATH splits into three parts separated by double
colons (::), an early, a late, and a last part,
corresponding to their position in the various
@@ -137,7 +150,7 @@
is late.
If PATH has two components, the first is
early, the second is late.
---infopath=PATH Directories to search for Info documents, info dir
+--with-infopath=PATH Directories to search for Info documents, info dir
and localdir files in case run-time searching
for them fails.
@@ -184,7 +197,7 @@
different vendors, the results may be
unpredictable.
--with-xmu=no (*) For those unfortunates whose vendors don't ship Xmu.
---external-widget Compile with external widget support.
+--with-external-widget Compile with external widget support.
TTY (character terminal) options:
@@ -309,7 +322,7 @@
Memory allocation options:
--------------------------
---rel-alloc Use the relocating allocator (default for this option
+--with-rel-alloc Use the relocating allocator (default for this option
is system-dependent).
--with-dlmalloc Control usage of Doug Lea malloc on systems that have
it in the standard C library (default is to use it if
@@ -321,7 +334,7 @@
Emacs Lisp options:
-------------------
---use-number-lib=TYPE Compile in support for bignums, ratios, or bigfloats
+--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).
@@ -329,19 +342,20 @@
Debugging options:
------------------
---debug Compile with support for debugging XEmacs.
+--with-assertions Compile with assertions to catch internal errors.
+--with-debug Compile with support for debugging XEmacs.
(Causes code-size increase and little loss of speed.)
---error-checking=TYPE[,TYPE]...
+--with-error-checking=TYPE[,TYPE]...
Compile with internal error-checking added.
Causes noticeable loss of speed. Valid types
are extents, bufpos, malloc, gc, typecheck.
---error-checking=none Disable all internal error-checking (the default).
---error-checking=all Enable all internal error-checking.
---memory-usage-stats Compile with additional code to allow you to
+--with-error-checking=none Disable all internal error-checking (the default).
+--with-error-checking=all Enable all internal error-checking.
+--with-memory-usage-stats Compile with additional code to allow you to
determine what XEmacs's memory is being used
for. Causes a small code increase but no loss
of speed. Normally enabled when --debug is given.
---quick-build Speed up the build cycle by leaving out steps where
+--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
@@ -351,7 +365,7 @@
associated files from the dependency lists, so changes
to these files don't automatically cause all .c files
to be rebuilt.
---use-union-type Enable or disable use of a union, instead of an
+--with-union-type Enable or disable use of a union, instead of an
int, for the fundamental Lisp_Object type; this
provides stricter type-checking. WARNING: This has
a tendency to trigger compiler bugs, especially in
@@ -377,16 +391,16 @@
--with-workshop Support the Sun WorkShop (formerly Sparcworks)
development environment.
---pdump New, portable, relocatable dumper. Currently works
+--with-pdump New, portable, relocatable dumper. Currently works
quite well, somewhere in beta-to-late-beta, we
might say. (Infamous for being the former
"experimental, don't-sue-me-if-your-house-collapses-
and-your-wife-leaves-you" portable dumper.)
---dump-in-exec Put the dump image into the executable (enabled by
+--with-dump-in-exec the dump image into the executable (enabled by
default for `pdump', not enabled by default in
combination with `mc-alloc'.
---use-kkcc Enable the use of new GC algorithms. (EXPERIMENTAL)
---mc-alloc Enable the new allocator. (EXPERIMENTAL)
+--with-kkcc Enable the use of new GC algorithms. (EXPERIMENTAL)
+--with-mc-alloc Enable the new allocator. (EXPERIMENTAL)
--with-modules (*) Compile in experimental support for dynamically
loaded libraries (Dynamic Shared Objects).
@@ -401,13 +415,13 @@
environment corresponding
variable configure flag
----------- --------------
-CC --compiler
-XEMACS_CC --xemacs-compiler
-CPP --cpp
-CFLAGS --cflags
-CPPFLAGS --cppflags
-LDFLAGS --ldflags
-LIBS --libs
-LD_RUN_PATH --site-runtime-libraries
+CC --with-compiler
+XEMACS_CC --with-xemacs-compiler
+CPP --with-cpp
+CFLAGS --with-cflags
+CPPFLAGS --with-cppflags
+LDFLAGS --with-ldflags
+LIBS --with-libs
+LD_RUN_PATH --with-site-runtime-libraries
For more details on the install process, consult the INSTALL file.