[mirror_edk2.git] / AppPkg / Applications / Lua / ReadMe.txt

This is Lua 5.2.3, released on 11 Nov 2013.\r
\r
For installation instructions, license details, and\r
further information about Lua, see doc/readme.html.\r
=================================================\r
\r
Embedding Lua\r
-------------\r
The Lua library instance, LuaLib, is defined by StdLib.inc.  Since, currently, all applications which\r
embed Lua are also StdLib applications, StdLib.inc will be included by your package's .DSC file.\r
\r
The header files required to use LuaLib are in the standard include path at StdLib\Include\Lua.\r
They may be referenced as:\r
  #include  <Lua/lua.h>\r
  #include  <Lua/lualib.h>\r
  #include  <Lua/lauxlib>\r
  #include  <Lua/luaconf.h>\r
\r
Lua/luaconf.h is the Lua configuration file.  If you wish to build Lua with custom characteristics,\r
this is the file to modify.  Modify the file in StdLib\Include\Lua since the file in the Lua\r
source tree is just a stub which references the file in StdLib.\r
\r
\r
Installation on UEFI\r
--------------------\r
Install the Lua.efi file into \Efi\Tools.   This is the standalone Lua interpreter.\r
Create a directory, \Efi\StdLib\lib\Lua.    This is the default location for Lua scripts.\r
\r
If desired, copy the files from AppPkg\Applications\Lua\scripts, in the source tree, into\r
\Efi\StdLib\lib\Lua.\r
\r
Bugs and Other Issues\r
---------------------\r
EOF characters, ^D or ^Z, are not properly recognized by the console and can't be used to\r
terminate an application.  Use os.exit() to exit Lua.\r
Commit	Line	Data
16a5fed6	1	This is Lua 5.2.3, released on 11 Nov 2013.\r
	2	\r
	3	For installation instructions, license details, and\r
	4	further information about Lua, see doc/readme.html.\r
	5	=================================================\r
	6	\r
	7	Embedding Lua\r
	8	-------------\r
	9	The Lua library instance, LuaLib, is defined by StdLib.inc. Since, currently, all applications which\r
	10	embed Lua are also StdLib applications, StdLib.inc will be included by your package's .DSC file.\r
	11	\r
	12	The header files required to use LuaLib are in the standard include path at StdLib\Include\Lua.\r
	13	They may be referenced as:\r
	14	#include <Lua/lua.h>\r
	15	#include <Lua/lualib.h>\r
	16	#include <Lua/lauxlib>\r
	17	#include <Lua/luaconf.h>\r
	18	\r
	19	Lua/luaconf.h is the Lua configuration file. If you wish to build Lua with custom characteristics,\r
	20	this is the file to modify. Modify the file in StdLib\Include\Lua since the file in the Lua\r
	21	source tree is just a stub which references the file in StdLib.\r
	22	\r
	23	\r
	24	Installation on UEFI\r
	25	--------------------\r
	26	Install the Lua.efi file into \Efi\Tools. This is the standalone Lua interpreter.\r
	27	Create a directory, \Efi\StdLib\lib\Lua. This is the default location for Lua scripts.\r
	28	\r
	29	If desired, copy the files from AppPkg\Applications\Lua\scripts, in the source tree, into\r
	30	\Efi\StdLib\lib\Lua.\r
6b980b67 DM	31	\r
	32	Bugs and Other Issues\r
	33	---------------------\r
	34	EOF characters, ^D or ^Z, are not properly recognized by the console and can't be used to\r
	35	terminate an application. Use os.exit() to exit Lua.\r