Imported from ../lua-3.2.tar.gz.
[lua.git] / etc / README
blob002190aeff243d43054d3b0ba59252d1317b3053
1 This directory contains some code that might be useful.
3 bin2c.c
4         This program converts files to byte arrays that are automatically
5         run with lua_dobuffer.
6         This allows C programs to include all necessary Lua code, even in
7         precompiled form.
8         Even if the code is included in source form, bin2c is useful because it
9         avoids the hassle of having to quote special characters in C strings.
10         Example of usage: Run bin2c file1 file2 ... > init.h. Then, in your C
11         program, just do #include "init.h" anywhere in the *body* of a
12         function. This will be equivalent to calling
13                 lua_dofile("file1"); lua_dofile("file2"); ...
15 min.c
16         The smallest Lua interpreter possible.
18 setfallback.lua
19         An implementation of fallbacks on top of tag methods.
20         Useful if you have Lua code written for version 2.5 or earlier,
21         which uses setfallback.
22         If you have C code that uses lua_setfallback, then define LUA_COMPAT2_5
23         before building Lua (see config).
25 trace.c
26         A simple execution tracer. An example of how to use the debugging hooks.