aboutsummaryrefslogtreecommitdiff
path: root/contrib/lutok/README
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/lutok/README')
-rw-r--r--contrib/lutok/README27
1 files changed, 27 insertions, 0 deletions
diff --git a/contrib/lutok/README b/contrib/lutok/README
new file mode 100644
index 000000000000..f39d33d77bb4
--- /dev/null
+++ b/contrib/lutok/README
@@ -0,0 +1,27 @@
+Lutok is a lightweight C++ API library for Lua.
+
+Lutok provides thin C++ wrappers around the Lua C API to ease the
+interaction between C++ and Lua. These wrappers make intensive use of
+RAII to prevent resource leakage, expose C++-friendly data types, report
+errors by means of exceptions and ensure that the Lua stack is always
+left untouched in the face of errors. The library also provides a small
+subset of miscellaneous utility functions built on top of the wrappers.
+
+Lutok focuses on providing a clean and safe C++ interface; the drawback
+is that it is not suitable for performance-critical environments. In
+order to implement error-safe C++ wrappers on top of a Lua C binary
+library, Lutok adds several layers or abstraction and error checking
+that go against the original spirit of the Lua C API and thus degrade
+performance.
+
+For further information on the contents of this distribution file,
+please refer to the following other documents:
+
+* AUTHORS: List of authors and contributors to this project.
+* COPYING: License information.
+* INSTALL: Compilation and installation instructions.
+* NEWS: List of major changes between formal releases.
+
+For general project information, please visit:
+
+ https://github.com/jmmv/lutok/