From ec7673f469b664367bcab7fee81d62fbc400c4d9 Mon Sep 17 00:00:00 2001 From: ThePhD Date: Fri, 12 Aug 2016 10:25:20 -0400 Subject: [PATCH] [ci-skip] be clear about what's being measured --- docs/source/benchmarks.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/source/benchmarks.rst b/docs/source/benchmarks.rst index df0c007c..c011e0a3 100644 --- a/docs/source/benchmarks.rst +++ b/docs/source/benchmarks.rst @@ -4,12 +4,14 @@ because somebody is going to ask eventually... ---------------------------------------------- +Here are measurements of the *overhead that libraries impose around the Lua C API*: that is, the cost of abstracting / wrapping the plain Lua C API. Measurements are (at the time of writing) done with all libraries compiled against a DLL version of Lua 5.3.3 to make sure each Lua call has the same overhead between libraries (no Link Time Optimizations or other static library optimizations). + These are some informal and formal benchmarks done by both the developers of sol and other library developers / users. We leave you to interpret the data as you see fit. * `lua_binding_benchmarks`_ by satoren (developer of `kaguya`_) (`Sol`_ is the "sol2" entry) * `lua-bench`_ by ThePhD (developer of `Sol`_) -As of the writing of this documentation (July 29th, 2016), :doc:`Sol` (Sol2) seems to take the cake in most categories for speed! Below are some graphs from `lua-bench`_. You can read the benchmarking code there if you think something was done wrong, and submit a pull requests or comment on something to make sure that ThePhD is being honest about his work. All categories are the performance of things described at the top of the :doc:`feature table`. +As of the writing of this documentation (August 12th, 2016), :doc:`Sol` (Sol2) seems to take the cake in most categories for speed! Below are some graphs from `lua-bench`_. You can read the benchmarking code there if you think something was done wrong, and submit a pull requests or comment on something to make sure that ThePhD is being honest about his work. All categories are the performance of things described at the top of the :doc:`feature table`. Note that Sol here makes use of its more performant variants (see :doc:`c_call`), and ThePhD also does his best to make use of the most performant variants for other frameworks by disabling type checks where possible as well (Thanks to Liam Devine of OOLua for explaining how to turn off type checks in OOLua).