X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=INSTALL;h=378515b33b8e34575fd45298d293663d42aee037;hb=HEAD;hp=31377099a17aad92153542e24620bd44a05935f1;hpb=aadc8391153b7b939462752dfa3f8dec49b2eba1;p=sbcl.git diff --git a/INSTALL b/INSTALL index 3137709..378515b 100644 --- a/INSTALL +++ b/INSTALL @@ -172,40 +172,44 @@ INSTALLING SBCL enabling or disabling features like documentation strings, threads, or extra debugging code. - The preferred way to do this is by creating a file - "customize-target-features.lisp", containing a lambda expression - which is applied to the default *FEATURES* set and which returns the - new *FEATURES* set, e.g. - - (lambda (features) - (flet ((enable (x) - (pushnew x features)) - (disable (x) - (setf features (remove x features)))) - ;; Threading support. - (enable :sb-thread))) - - This is the preferred way because it lets local changes interact - cleanly with CVS changes to the main, global source tree. + The preferred way to do this is using commandline arguments to make.sh: + + --fancy Enables all supported feature enhancements. + --with- Enables a specific feature. + --without- Disables a specific feature. Some features of interest: - :SB-THREAD + :SB-THREAD (--with-sb-thread, --without-sb-thread) + Native threads. Enabled by default on x86[-64] Linux only, also available on x86[-64] Max OS X, x86[-64] FreeBSD, x86 Solaris, and PPC Linux. - :SB-UNICODE - Unicode support. Enabled by default. Disabling this feature - limits characters to the 8-bit ISO-8859-1 set. + NOTE: --fancy enables threads on all platforms where they can be + built, even if they aren't 100% stable on that platform. + + :SB-CORE-COMPRESSION (--with-sb-core-compression) + + Adds zlib as a build-dependency, and makes SBCL able to save + compressed cores. Not enabled by default. + + :SB-XREF-FOR-INTERNALS (--with-sb-xref-for-internals) - :SB-XREF-FOR-INTERNALS XREF data for SBCL internals. Not enabled by default, increases core size by 5-6mb. + :SB-UNICODE (--without-sb-unicode) + + Unicode support. Enabled by default. Disabling this feature + limits characters to the 8-bit ISO-8859-1 set. + A catalog of available features and their meaning can be found in "base-target-features.lisp-expr". + Please do NOT edit base-target-features.lisp-expr in order to enable + or disable build features. + 2.3. Troubleshooting "GNU Make not found"