A utility library featuring Lua and custom GTK+ widgets
C Lua Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
examples
gui
util
ylua
LICENSE-LGPL
README.rst
libwhygui.pc.in
libwhyutil.pc.in
waf
wscript

README.rst

libwhy

libwhy is a library for developing GTK+ applications using Lua.

libwhy is written and copyright (c) 2012 by Sean Bolton, and is licensed under the GNU Lesser General Public License, version 2.1. See the enclosed file LICENSE-LGPL for more information.

A number of the files within this package are also licensed under other terms. In particular, Lua is under an MIT/Expat license, see gui/lua/LICENSE-MIT, and the example code has been released to the public domain, see examples/LICENSE-CC0.

There is no documentation, other than this README and the source.

The Lua in libwhy is a stock Lua 5.2.1, with no LUA_COMPAT_* macros defined, plus a patch which adds a '%C' format specifier to string.format. This format acts just like '%g', but always outputs numbers in the 'C' locale, that is, with '.' for the decimal point.

libwhy also installs a Lua binary as <prefix>/bin/ylua. ylua links to libwhy, making select portions of GTK+ and the libwhy custom GTK+ widgets available to Lua scripts. ylua includes Mike Pall's advanced readline patch. The example programs in the example/ directory can be run using ylua, for example:

$ ylua examples/epicycloids.lua

The latest version of libwhy may be found on github:

https://github.com/smbolton/libwhy

while release tarballs may be found here:

http://smbolton.com/linux.html