[elephant-cvs] CVS elephant/doc

[ieslick]

Update of /project/elephant/cvsroot/elephant/doc
In directory clnet:/tmp/cvs-serv8074/doc

Modified Files:
	installation.texinfo user-guide.texinfo 
Log Message:
Final changes to build process for prebuilt windows files, documenting user configuration options, enabling clsql-lib load paths and some installation manual edits

--- /project/elephant/cvsroot/elephant/doc/installation.texinfo	2007/04/29 21:54:51	1.14
+++ /project/elephant/cvsroot/elephant/doc/installation.texinfo	2007/04/30 00:38:31	1.15
@@ -246,6 +246,10 @@
 @comment node-name, next, previous, up
 @section Setting up Berkeley DB
 
+We recommend that you download and build a distribution from Oracle.
+Some problems have been reported with linking to Debian, Cygwin or
+other packages.  This is especially true for Windows users.
+
 Beyond ensuring that the file ``my-config.sexp'' points to your BDB
 installation directories and files, nothing else should be required to
 configure the example that uses a local ``testdb'' directory as a
@@ -428,13 +432,20 @@
 @comment node-name, next, previous, up
 @section Elephant on Windows
 
-The build process on Windows currently only works with GCC under Cygwin.
-The process can be a bit tricky, so if it doesn't work out of the box,
-we recommend that you download the DLLs from the Elephant website
-download page (@url{http://www.common-lisp.net/project/elephant/downloads.html'}).
-
-Unpack the .zip file into the elephant root directory.  Then run the batch file
-``copy-dll.bat'' to move them into their proper directory.
+The build process on Windows currently only works with GCC under
+Cygwin.  The process can be a bit tricky, so if it doesn't work out of
+the box or you don't want to install cygwin, we recommend that you
+download the DLLs from the Elephant website download page
+(@url{http://www.common-lisp.net/project/elephant/downloads.html'}).
+
+Unpack the .zip file into the elephant root directory.  Ensure that
+your @code{my-config.sexp} file configuration for Windows has
+ at code{:prebuilt-binaries} set to ``t'' so it will know to look in
+the elephant root during the asdf loading process.
+
+For Berkeley DB users we recommend downloading the Windows binary
+distribution of Berkeley DB 4.5 to minimize any potential linking
+issues.
 
 @node Test Suites
 @comment node-name, next, previous, up
--- /project/elephant/cvsroot/elephant/doc/user-guide.texinfo	2007/04/28 14:24:57	1.21
+++ /project/elephant/cvsroot/elephant/doc/user-guide.texinfo	2007/04/30 00:38:31	1.22
@@ -1555,7 +1555,7 @@
 described in config.sexp.  They are:
 
 @itemize
- at item @code{:map-using-degree2} - Improve the efficiency of cursor traversals
+ at item @code{:berkeley-db-map-degree2} - Improve the efficiency of cursor traversals
   in the various mapping functions.  Defaults to true, meaning a value
 you just read while mapping may change before the traversal is done.
 So if you operate only on the current cursor location, you are