This is lua, a sample Lua interpreter.
It can be used as a batch interpreter and also interactively.
There are man pages for it in both nroff and html in ../../doc.

Here are the options that it understands:
  -        execute stdin as a file
  -c       close lua when exiting
  -e stat  execute string `stat'
  -f name  execute file `name' with remaining arguments in table `arg'
  -i       enter interactive mode with prompt
  -q       enter interactive mode without prompt
  -sNUM    set stack size to NUM (must be the first option)
  -v       print version information
  a=b      set global `a' to string `b'
  name     execute file `name'

If no options are given, then it reads lines from stdin and executes them
as they are read -- so, each line must contain a complete statement.
To span a statement across several lines, end each line with a backslash '\'.

To change the prompt, set the global variable _PROMPT to whatever you want.
You can do that after calling the interpreter or on the command line with
	lua _PROMPT="lua: " -i
for example.

You must be careful when using quotes on the command line because they are
usually handled by the shell.

This interpreter is good for using Lua as a standalone language.
For a minimal interpreter, see etc/min.c.

If your application simply exports new functions to Lua (which is common),
then you can use this interpreter unmodified, as follows: define a function 
	void myinit (void)
in your own code. In this function, you should do whatever initializations
are needed by your application, typically exporting your functions to Lua.
Then, compile lua.c #define'ing USERINIT as myinit. In Unix, this would be
something like
	cc -DUSERINIT=myinit $(LUA)/src/lua/lua.c mylib.c -llua 
Of course, you can use any name instead of "myinit".

If you use this scheme, you must explicily open any standard libraries you need
inside myinit. See lua.c for an init function that opens all standard libraries.
