[sword-svn] r2786 - in trunk/bindings: . swig

[greg.hellings at crosswire.org]

Author: greg.hellings
Date: 2013-02-27 07:12:52 -0700 (Wed, 27 Feb 2013)
New Revision: 2786

Modified:
   trunk/bindings/README
   trunk/bindings/swig/README
Log:
Update the bindings README files for swig.


Modified: trunk/bindings/README
===================================================================
--- trunk/bindings/README	2013-02-23 23:53:35 UTC (rev 2785)
+++ trunk/bindings/README	2013-02-27 14:12:52 UTC (rev 2786)
@@ -1,3 +1,32 @@
+Building Perl or Python (through swig)
+-------------
+
+To build the SWIG (Perl, Python) bindings the recommended path is to build the library
+with the CMake toolchain. This requires installing the CMake application appropriate to
+your operating system (most Linux distributions will have this as an existing package
+as CMake is integral to building many popular applications).
+
+Additionally you will need the development packages for the language you are targeting
+and the swig application itself. All of these should be directly available through your
+distribution's package system.
+
+Python: In Fedora you can get this with a 'yum install python-devel' and a similar call
+to apt-get in Debian/Ubuntu/etc.
+Perl: In Fedora you're looking for 'yum install perl-devel' and the equivalent package
+in Debian/Ubuntu/etc.
+
+After this, you need to add the argument -DSWORD_BINDINGS="Python" or
+-DSWORD_BINDINGS="Perl" when you invoke CMake. If you wish to build both bindings then
+just call -DSWORD_BINDINGS="Python Perl" instead. This needs to be done at the level of
+the whole SWORD library and not just here within the bindings directory. The files will
+be installed to their standard system-wide location when you run 'make install' with
+the rest of the library.
+
+If you wish to install the Python bindings to another directory instead you can specify
+the option -DSWORD_PYTHON_INSTALL_DIR="/some/other/path" at configure time. No comparable
+option is currently available for the Perl bindings because the maintainer is unaware
+of how to implement it.
+
 Building java
 -------------
 

Modified: trunk/bindings/swig/README
===================================================================
--- trunk/bindings/swig/README	2013-02-23 23:53:35 UTC (rev 2785)
+++ trunk/bindings/swig/README	2013-02-27 14:12:52 UTC (rev 2786)
@@ -1,3 +1,7 @@
+WARNING These directions have not been tested in a while and might not work,
+see the updated directions in the README file in the parent directory from this
+file (<sword-root>/bindings/README) for directions on building with CMake.
+
 Building the SWIG Bindings
 ==========================