summaryrefslogtreecommitdiffstats
path: root/Sluift
diff options
context:
space:
mode:
authorRemko Tronçon <git@el-tramo.be>2013-09-16 18:23:27 (GMT)
committerSwift Review <review@swift.im>2013-09-16 18:35:56 (GMT)
commit8b4837cbe9da12f008c5cd5d964114154b9dee96 (patch)
tree03e0772ccb6b18bdd9e7bacd1c3a90347e1e3c96 /Sluift
parent10f91c4973c8d464b06149525c6eb7be979453f9 (diff)
downloadswift-8b4837cbe9da12f008c5cd5d964114154b9dee96.zip
swift-8b4837cbe9da12f008c5cd5d964114154b9dee96.tar.bz2
Add Sluift README
Contains only some build hints at the moment. Change-Id: I09fc3b133e880949ad8ee33227ab35f36f3ec875
Diffstat (limited to 'Sluift')
-rw-r--r--Sluift/README.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/Sluift/README.md b/Sluift/README.md
new file mode 100644
index 0000000..8eacc2b
--- /dev/null
+++ b/Sluift/README.md
@@ -0,0 +1,21 @@
+# Sluift
+
+## Building/Installing
+
+If you have a Lua installed on your system, edit `config.py` to point the build
+to it using the `lua_libdir`, `lua_includedir`, and `lua_libname` (usually
+only needed on Windows) variables.
+
+In case no Lua installation is found, a bundled Lua version will be used.
+Note that there are several limitations when using the bundled Lua:
+
+- The standalone Sluift binary will not support dynamic loading of modules.
+- The Sluift module will not be built
+
+The standalone executable will be placed into `Sluift/exe`, and the loadable
+Lua module in `Sluift/dll`.
+
+In order to use the Sluift Lua module, make sure it is copied to a location in the
+Lua search path (`LUA_PATH`, or the built-in path). On Linux and Mac OS X, this is
+typically `<LUA_INSTALLPREFIX>/lib/lua/<LUA_VERSION>/`. If `require 'sluift'` fails,
+the error message will give an indication what this path is.