[Lxml-checkins] r44069 - lxml/trunk/doc

[scoder at codespeak.net]

Author: scoder
Date: Thu Jun  7 08:52:45 2007
New Revision: 44069

Modified:
   lxml/trunk/doc/build.txt
Log:
doc: how to use newer libraries on Mac-OS X

Modified: lxml/trunk/doc/build.txt
==============================================================================
--- lxml/trunk/doc/build.txt	(original)
+++ lxml/trunk/doc/build.txt	Thu Jun  7 08:52:45 2007
@@ -44,7 +44,7 @@
   http://codespeak.net/svn/lxml/pyrex/
 
   A subversion checkout of lxml will automatically retrieve the latest Pyrex
-  as external project source (``svn:externals``).  Look out for the ``Pyrex``
+  as external project source (``svn:externals``).  Look for the ``Pyrex``
   directory in the source tree.
 
   Since version 1.1.2, the lxml source distribution also includes this Pyrex
@@ -182,6 +182,26 @@
 lxml maintainer.
 
 
+Providing newer library versions on Mac-OS X
+--------------------------------------------
+
+The Unix environment in Mac-OS X makes it relatively easy to install
+Unix/Linux style package management tools and new software.  However, it seems
+to be hard to get libraries set up for exclusive usage that Mac-OS X ships in
+an older version.  The result can be segfaults on this platform that are hard
+to track down.
+
+To make sure the newer libxml2 and libxslt versions are used (e.g. under
+fink), you should add the directory where you installed the libraries to the
+``DYLD_LIBRARY_PATH`` environment variable.  This seems to fix a lot of
+problems for users.
+
+Alternatively, you can build lxml statically.  A way to do this on MS Windows
+is described in the next section, but it should be easy to adapt it for
+Mac-OS.  That way, you can always be sure you use the versions you compiled
+lxml with, regardless of the runtime environement.
+
+
 Static linking on Windows
 -------------------------