Hi,
Please find attached the DRAFT ARC case for including lua 5.1.3
to opensolaris.
rahul
-------------- next part --------------
Including Lua 5.1.3 with OpenSolaris
12 August 2008
1. Summary and motivation
1.1. Introduction
This FastTrack delivers Lua 5.1.3[1] as a component in
opensolaris.
From the Lua HomePage [1], "Lua is a powerful, fast, light-weight,
embeddable scripting language."
This FastTrack proposes the integration of the most recent stable
release of Lua 5.1.3,
This case seeks Minor Release Binding.
2. Technical issues
2.1. Key objects
/usr/lua/
lib/
liblua.so
liblua.a
bin/
luac
lua
man/
man1/
lua.1
luac.1
include/
lauxlib.h
lparser.h
lfunc.h
lopcodes.h
lualib.h
lmem.h
llimits.h
lcode.h
lua.hpp
lstate.h
lapi.h
lgc.h
lua.h
lstring.h
lzio.h
llex.h
luaconf.h
lobject.h
lundump.h
ldebug.h
ltable.h
ldo.h
lvm.h
ltm.h
2.2. Versioning
At any point of time there is only one Lua release available. The
current release is 5.1.3
2.4 Directory Naming and Structure
The proposed directory layout for Lua is
/usr/lua/
/bin
/lib
/include
/man
The detailed directory and file layout for Lua is provided in
Addendum 1.
3. Lua Documentation.
The documentation is available at Lua site[2]. Man pages
are delivered as part of installation.
4. Packaging and Delivery
The Lua is delivered as SUNWlua package.
5. Lua Interfaces
5.1. Interface Stability
The Lua project says this in their FAQ:
"If you're concerned with incompatibilities, you shouldn't,
because we make every effort to avoid introducing any incompatibilities.
When incompatibilities are unavoidable, previous code is usually supported
unmodified, possibly by building Lua with a suitable compilation flag."
Since this is external to sun, the interfaces are classified as Uncommitted.
5.2. Imported Interfaces
Lua does not have any dependency other than the core solaris libraries.
5.3. Exported Interfaces
NAME STABILITY NOTES
/usr/lua/lib/liblua.so Uncommitted Shared Library
/usr/lua/lib/liblua.a Uncommitted Static Library
/usr/lua/bin/luac Uncommitted Executable Location
/usr/lua/bin/lua Uncommitted Executable Location
/usr/lua/man/man1/lua.1 Uncommitted man file
/usr/lua/man/man1/luac.1 Uncommitted man file
/usr/lua/include/lauxlib.h Uncommitted include file
/usr/lua/include/lparser.h Uncommitted include file
/usr/lua/include/lfunc.h Uncommitted include file
/usr/lua/include/lopcodes.h Uncommitted include file
/usr/lua/include/lualib.h Uncommitted include file
/usr/lua/include/lmem.h Uncommitted include file
/usr/lua/include/llimits.h Uncommitted include file
/usr/lua/include/lcode.h Uncommitted include file
/usr/lua/include/lua.hpp Uncommitted include file
/usr/lua/include/lstate.h Uncommitted include file
/usr/lua/include/lapi.h Uncommitted include file
/usr/lua/include/lgc.h Uncommitted include file
/usr/lua/include/lua.h Uncommitted include file
/usr/lua/include/lstring.h Uncommitted include file
/usr/lua/include/lzio.h Uncommitted include file
/usr/lua/include/llex.h Uncommitted include file
/usr/lua/include/luaconf.h Uncommitted include file
/usr/lua/include/lobject.h Uncommitted include file
/usr/lua/include/lundump.h Uncommitted include file
/usr/lua/include/ldebug.h Uncommitted include file
/usr/lua/include/ltable.h Uncommitted include file
/usr/lua/include/ldo.h Uncommitted include file
/usr/lua/include/lvm.h Uncommitted include file
/usr/lua/include/ltm.h Uncommitted include file
6. References
[1] http://www.lua.org/
[2] http://www.lua.org/docs.html
================================================================
Addendum 1: Lua Integration Directory and File Structure.
1. The following files are included in the Lua integration:
/usr/
lua/
bin/
luac
lua
include/
lauxlib.h
lparser.h
lfunc.h
lopcodes.h
lualib.h
lmem.h
llimits.h
lcode.h
lua.hpp
lstate.h
lapi.h
lgc.h
lua.h
lstring.h
lzio.h
llex.h
luaconf.h
lobject.h
lundump.h
ldebug.h
ltable.h
ldo.h
lvm.h
ltm.h
lib/
liblua.so
liblua.a
man/
man1/
lua.1
luac.1
