* Makefile.am (subpkgdatadir): VERSION -> GUILE_EFFECTIVE_VERSION.

[bpt/guile.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index fedf6df..d75cc57 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -102,6 +102,14 @@ switches specific to Guile you may find useful in some circumstances.
   thread support do not affect you if you don't actually use threads.
 
 
+--disable-linuxthreads  ---  Disable pthread compatability hack on Linux
+
+  If you experience problems on GNU/Linux that are related to
+  pthreads, you might try this option.  Guile with then not link with
+  the pthreads library, but will also not try to be compatible to
+  programs that use both libguile and libpthread.
+
+
 --with-modules  ---  Specify statically linked `modules'
 
   Guile can dynamically load `plugin modules' during runtime, using
@@ -191,6 +199,29 @@ switches specific to Guile you may find useful in some circumstances.
 --disable-regex       ---  omit regular expression interfaces
 
 
+Cross building Guile  =====================================================
+
+As of guile-1.5.x, the build process uses compiled C files for
+snarfing, and (indirectly, through libtool) for linking, and uses the
+guile executable for generating documentation.
+
+When cross building guile, you first need to configure, build and
+install guile for your build host.
+
+Then, you may configure guile for cross building, eg:
+
+    ./configure --host=i686-pc-cygwin --disable-shared
+
+Two special options for cross building are available:
+
+--with-cc-for-build      --- native C compiler, to be used during build
+                             defaults to: `PATH=/usr/bin:$PATH cc'
+
+--with-guile-for-build   --- native Guile executable, to be used during build
+                             defaults to: `guile', assuming you just
+                             installed this guile natively.
+
+
 Using Guile Without Installing It =========================================
 
 If you want to run Guile without installing it, set the environment
@@ -210,6 +241,17 @@ or if you're using CSH or one of its variants:
 
   setenv GUILE_LOAD_PATH /home/jimb/guile-snap
 
+You will additionally need to set your `LTDL_LIBRARY_PATH' environment
+variable to the directory in which the compiled SRFI support modules
+are created if you want to use the modules for SRFI-4, SRFI-13 or
+SRFI-14 support.  Similar to the example above, this will be,
+
+  export LTDL_LIBRARY_PATH=/home/jimb/guile-snap/srfi/.libs
+
+or if you're using CSH or one of its variants:
+
+  setenv LTDL_LIBRARY_PATH /home/jimb/guile-snap/srfi/.libs
+
 
 Installing SLIB ===========================================================