SUMMARY
=======
This is a port of the Lua programming language for AmigaOS 4.0.

Now includes dynamic library support which opens up all sorts of
possibilites for easily extending Lua with AmigaOS functionality.
See the amiga directory for more information.

An example amigalua.library is provided to give a small sample of
what is possible without having to recompile Lua itself.


ABOUT LUA
=========
For more information about Lua see http://www.lua.org/

Lua is a powerful light-weight programming language designed for extending
applications. Lua is also frequently used as a general-purpose, stand-alone
language. Lua is free software.

Lua combines simple procedural syntax with powerful data description
constructs based on associative arrays and extensible semantics. Lua is
dynamically typed, interpreted from bytecodes, and has automatic memory
management with garbage collection, making it ideal for configuration,
scripting, and rapid prototyping. 

A fundamental concept in the design of Lua is to provide meta-mechanisms
for implementing features, instead of providing a host of features directly
in the language. For example, although Lua is not a pure object-oriented
language, it does provide meta-mechanisms for implementing classes and
inheritance. Lua's meta-mechanisms bring an economy of concepts and keep
the language small, while allowing the semantics to be extended in
unconventional ways. Extensible semantics is a distinguishing feature
of Lua. 

Lua is a language engine that you can embed into your application. This
means that, besides syntax and semantics, Lua has an API that allows the
application to exchange data with Lua programs and also to extend Lua with
C functions. In this sense, Lua can be regarded as a language framework for
building domain-specific languages. 

Lua is implemented as a small library of C functions, written in ANSI C,
and compiles unmodified in all known platforms. The implementation goals
are simplicity, efficiency, portability, and low embedding cost. The result
is a fast language engine with small footprint, making it ideal in
embedded systems too. 
Lua is designed and implemented by a team at Tecgraf, the Computer
Graphics Technology Group of PUC-Rio (the Pontifical Catholic University
of Rio de Janeiro in Brazil). Tecgraf is a laboratory of the Department
of Computer Science. 


CONFIGURATION
=============

Everything builds with gmake now.

By default the clib2-ts flavour is built with dynamic library support.

Edit the src/luaconf.h file and Makefiles to customize Lua to your
particular project. Some projects may not require dynamic library
loading and could just use simply clib2 or newlib for example.


INSTALLATION
============

Installation into your SDK varies depending on what flavour of Lua
you want to use for your project. Here is what to do to install the
standard Lua (clib2-ts with dynamic library support) into your SDK:

Copy src/lua and src/luac binaries to SDK:Local/C
Copy src/liblua.a to SDK:Local/clib2/lib
Copy src/#?.(h|hpp) SDK:Local/common/include


HISTORY
=======
5.1-2   - updated to SDK 51.22
        - updated to use clib2 1.200
        - updated readme

5.1-1   - ported to AmigaOS using standard build system (use gmake)
        - added preliminary dynamic library support
        - not publically released

5.0.2   - ported to AmigaOS with custom Makefile et al

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                83889  178932  46.9% -lh5- 7ef9 May 27 16:59 lua-5.1-2/amiga/amigalua.library
[generic]                 1723    5947  29.0% -lh5- 7d83 May 27 14:18 lua-5.1-2/amiga/amigalua_lib.c
[generic]                 1260    3280  38.4% -lh5- 714c May 27 16:59 lua-5.1-2/amiga/amigalua_lib.o
[generic]                  666    1599  41.7% -lh5- f60b May  6 20:56 lua-5.1-2/amiga/amigalua_lua.c
[generic]                 1064    2476  43.0% -lh5- 2e55 May 27 16:59 lua-5.1-2/amiga/amigalua_lua.o
[generic]                  164     247  66.4% -lh5- 13f2 Mar 26 15:21 lua-5.1-2/amiga/dynamic-test.lua
[generic]                  305     491  62.1% -lh5- 95ab May 27 16:53 lua-5.1-2/amiga/Makefile
[generic]                  807    1528  52.8% -lh5- 67c4 Jan  6 14:58 lua-5.1-2/COPYRIGHT
[generic]                 3402   19854  17.1% -lh5- f8a1 Feb 10 12:13 lua-5.1-2/doc/contents.html
[generic]                 4232    4232 100.0% -lh0- 112b Oct 23  2001 lua-5.1-2/doc/logo.gif
[generic]                 1633    3619  45.1% -lh5- 8892 Jan  6 09:03 lua-5.1-2/doc/lua.1
[generic]                  115     196  58.7% -lh5- 938e Jun 14  2004 lua-5.1-2/doc/lua.css
[generic]                 1751    3951  44.3% -lh5- 492e Feb  7 09:38 lua-5.1-2/doc/lua.html
[generic]                 1653    3617  45.7% -lh5- 2fa8 Feb 12 16:46 lua-5.1-2/doc/luac.1
[generic]                 1770    3896  45.4% -lh5- ba73 Feb 12 16:46 lua-5.1-2/doc/luac.html
[generic]                65607  233955  28.0% -lh5- 0d5c Feb 14 08:11 lua-5.1-2/doc/manual.html
[generic]                  339     658  51.5% -lh5- 0d4b Sep  7  2005 lua-5.1-2/doc/readme.html
[generic]                  206     678  30.4% -lh5- e00e Mar 30  2005 lua-5.1-2/etc/all.c
[generic]                  126     191  66.0% -lh5- bfd4 Dec 22  2004 lua-5.1-2/etc/lua.hpp
[generic]                  396    1078  36.7% -lh5- a32a Jul 31  2000 lua-5.1-2/etc/lua.ico
[generic]                  312     589  53.0% -lh5- 634d Feb  7 09:54 lua-5.1-2/etc/lua.pc
[generic]                  117     179  65.4% -lh5- fdbb Sep  8  2005 lua-5.1-2/etc/luavs.bat
[generic]                  443     919  48.2% -lh5- ef48 May  6 21:03 lua-5.1-2/etc/Makefile
[generic]                  404     803  50.3% -lh5- 3dc0 Feb  9 02:30 lua-5.1-2/etc/min.c
[generic]                  624    1253  49.8% -lh5- 4f9b Sep  1  2005 lua-5.1-2/etc/noparser.c
[generic]                  527     928  56.8% -lh5- fec9 Mar 19 16:16 lua-5.1-2/etc/README
[generic]                  382     806  47.4% -lh5- 1d88 Aug 25  2005 lua-5.1-2/etc/strict.lua
[generic]                 3187    7908  40.3% -lh5- 8f2a Feb 20 07:28 lua-5.1-2/HISTORY
[generic]                 1599    3756  42.6% -lh5- 00c0 Jan 25 10:19 lua-5.1-2/INSTALL
[generic]                 1495    3614  41.4% -lh5- e9d8 May  6 20:59 lua-5.1-2/Makefile
[generic]                  541    2257  24.0% -lh5- 426d Feb 20 07:37 lua-5.1-2/MANIFEST
[generic]                  690    1354  51.0% -lh5- c6a8 Jan 19 04:51 lua-5.1-2/README
[generic]                 1612    3382  47.7% -lh5- d5c7 May 27 16:57 lua-5.1-2/README.AmigaOS
[generic]                 5204   22380  23.3% -lh5- 1383 Jan 10 05:50 lua-5.1-2/src/lapi.c
[generic]                  206     258  79.8% -lh5- 70f2 Apr 25  2005 lua-5.1-2/src/lapi.h
[generic]                 5917   13956  42.4% -lh5- 704f May 27 16:57 lua-5.1-2/src/lapi.o
[generic]                 4885   17230  28.4% -lh5- ca00 Jan 16 05:42 lua-5.1-2/src/lauxlib.c
[generic]                 1567    5747  27.3% -lh5- e7cd Dec 29 08:32 lua-5.1-2/src/lauxlib.h
[generic]                 5492   13892  39.5% -lh5- edf5 May 27 16:58 lua-5.1-2/src/lauxlib.o
[generic]                 4659   16654  28.0% -lh5- 3a95 Jan 18 04:49 lua-5.1-2/src/lbaselib.c
[generic]                 6455   18324  35.2% -lh5- 3a54 May 27 16:58 lua-5.1-2/src/lbaselib.o
[generic]                 5608   21164  26.5% -lh5- 4346 Dec 22 09:19 lua-5.1-2/src/lcode.c
[generic]                  928    2787  33.3% -lh5- b2fe Nov  8  2005 lua-5.1-2/src/lcode.h
[generic]                 6113   13256  46.1% -lh5- 839c May 27 16:57 lua-5.1-2/src/lcode.o
[generic]                 2807   10045  27.9% -lh5- 0b43 Dec 29 08:32 lua-5.1-2/src/ldblib.c
[generic]                 4626   11928  38.8% -lh5- 13b5 May 27 16:58 lua-5.1-2/src/ldblib.o
[generic]                 4833   15998  30.2% -lh5- 523d Dec 22 09:19 lua-5.1-2/src/ldebug.c
[generic]                  443    1057  41.9% -lh5- 8f6d Apr 25  2005 lua-5.1-2/src/ldebug.h
[generic]                 5291    9984  53.0% -lh5- 6fac May 27 16:57 lua-5.1-2/src/ldebug.o
[generic]                 4720   14700  32.1% -lh5- fffb Dec 22 09:19 lua-5.1-2/src/ldo.c
[generic]                  740    1893  39.1% -lh5- 93c8 Aug 24  2005 lua-5.1-2/src/ldo.h
[generic]                 4200    7964  52.7% -lh5- 8565 May 27 16:57 lua-5.1-2/src/ldo.o
[generic]                 1128    3107  36.3% -lh5- e6e2 Feb 16 08:53 lua-5.1-2/src/ldump.c
[generic]                 1140    2128  53.6% -lh5- 6323 May 27 16:57 lua-5.1-2/src/ldump.o
[generic]                 1555    4602  33.8% -lh5- f628 Dec 22 09:19 lua-5.1-2/src/lfunc.c
[generic]                  428    1121  38.2% -lh5- aa2b Apr 25  2005 lua-5.1-2/src/lfunc.h
[generic]                 1402    2936  47.8% -lh5- f28d May 27 16:57 lua-5.1-2/src/lfunc.o
[generic]                 5966   19967  29.9% -lh5- c60b Mar 26 14:22 lua-5.1-2/src/lgc.c
[generic]                 1131    3155  35.8% -lh5- 8fe3 Aug 24  2005 lua-5.1-2/src/lgc.h
[generic]                 4444    8560  51.9% -lh5- 3fb5 May 27 16:57 lua-5.1-2/src/lgc.o
[generic]               103172  248216  41.6% -lh5- 6b8d May 27 16:58 lua-5.1-2/src/liblua.a
[generic]                  391     761  51.4% -lh5- cd94 Mar 24 17:50 lua-5.1-2/src/linit.c
[generic]                  651    1612  40.4% -lh5- b4f0 May 27 16:58 lua-5.1-2/src/linit.o
[generic]                 3802   13002  29.2% -lh5- 4ff9 Jan 28 05:59 lua-5.1-2/src/liolib.c
[generic]                 5358   13780  38.9% -lh5- 0fbe May 27 16:58 lua-5.1-2/src/liolib.o
[generic]                 3597   12450  28.9% -lh5- e1a4 Feb  6 11:28 lua-5.1-2/src/llex.c
[generic]                  980    2173  45.1% -lh5- dfc9 Dec  7 08:43 lua-5.1-2/src/llex.h
[generic]                 4313    9568  45.1% -lh5- edd0 May 27 16:57 lua-5.1-2/src/llex.o
[generic]                 1086    2345  46.3% -lh5- 45d2 Dec 27 10:12 lua-5.1-2/src/llimits.h
[generic]                 1410    5827  24.2% -lh5- e704 Aug 26  2005 lua-5.1-2/src/lmathlib.c
[generic]                 2554    8144  31.4% -lh5- ca1b May 27 16:58 lua-5.1-2/src/lmathlib.o
[generic]                  976    2168  45.0% -lh5- e2fc Dec 26 06:35 lua-5.1-2/src/lmem.c
[generic]                  599    1490  40.2% -lh5- bf72 Apr 25  2005 lua-5.1-2/src/lmem.h
[generic]                  758    1508  50.3% -lh5- 7bea May 27 16:57 lua-5.1-2/src/lmem.o
[generic]                 5705   20774  27.5% -lh5- 3998 Mar 26 15:53 lua-5.1-2/src/loadlib.c
[generic]                 4584   12032  38.1% -lh5- 9767 May 27 16:58 lua-5.1-2/src/loadlib.o
[generic]                 1926    5494  35.1% -lh5- ee83 Feb 10 10:43 lua-5.1-2/src/lobject.c
[generic]                 2638    8495  31.1% -lh5- 1921 Mar 26 14:21 lua-5.1-2/src/lobject.h
[generic]                 2172    4436  49.0% -lh5- 5ac5 May 27 16:57 lua-5.1-2/src/lobject.o
[generic]                  709    2880  24.6% -lh5- a11f Nov  8  2005 lua-5.1-2/src/lopcodes.c
[generic]                 2770    8083  34.3% -lh5- 24d1 Dec  2 11:42 lua-5.1-2/src/lopcodes.h
[generic]                  786    1692  46.5% -lh5- 13d0 May 27 16:57 lua-5.1-2/src/lopcodes.o
[generic]                 1949    5878  33.2% -lh5- 5f1f Jan 27 06:54 lua-5.1-2/src/loslib.c
[generic]                 3115    7668  40.6% -lh5- 7900 May 27 16:58 lua-5.1-2/src/loslib.o
[generic]                10325   36568  28.2% -lh5- cb76 Dec 22 09:19 lua-5.1-2/src/lparser.c
[generic]                  972    2277  42.7% -lh5- c7a2 Oct  3  2005 lua-5.1-2/src/lparser.h
[generic]                 9147   19228  47.6% -lh5- 9158 May 27 16:57 lua-5.1-2/src/lparser.o
[generic]                 2002    5638  35.5% -lh5- d404 Oct  6  2005 lua-5.1-2/src/lstate.c
[generic]                 1914    4932  38.8% -lh5- 271f Feb  6 11:27 lua-5.1-2/src/lstate.h
[generic]                 1606    3252  49.4% -lh5- f2dd May 27 16:58 lua-5.1-2/src/lstate.o
[generic]                 1301    3106  41.9% -lh5- 24df Dec 22 09:19 lua-5.1-2/src/lstring.c
[generic]                  408     810  50.4% -lh5- 6060 Apr 25  2005 lua-5.1-2/src/lstring.h
[generic]                 1111    1992  55.8% -lh5- 0179 May 27 16:58 lua-5.1-2/src/lstring.o
[generic]                 6480   23172  28.0% -lh5- baef Dec 29 08:32 lua-5.1-2/src/lstrlib.c
[generic]                 8094   17944  45.1% -lh5- fd73 May 27 16:58 lua-5.1-2/src/lstrlib.o
[generic]                 5229   16264  32.2% -lh5- 1646 Mar 26 14:21 lua-5.1-2/src/ltable.c
[generic]                  449    1180  38.1% -lh5- 632c Mar 26 14:21 lua-5.1-2/src/ltable.h
[generic]                 3981    7448  53.5% -lh5- 1a29 May 27 16:58 lua-5.1-2/src/ltable.o
[generic]                 2268    7049  32.2% -lh5- 27f0 Oct 23  2005 lua-5.1-2/src/ltablib.c
[generic]                 2771    6928  40.0% -lh5- b07b May 27 16:58 lua-5.1-2/src/ltablib.o
[generic]                  806    1646  49.0% -lh5- 2843 Jan 10 05:50 lua-5.1-2/src/ltm.c
[generic]                  548    1014  54.0% -lh5- 1f78 Jun  6  2005 lua-5.1-2/src/ltm.h
[generic]                 1080    2176  49.6% -lh5- f133 May 27 16:58 lua-5.1-2/src/ltm.o
[generic]               172544  396147  43.6% -lh5- 8e2e May 27 16:58 lua-5.1-2/src/lua
[generic]                 3247    9835  33.0% -lh5- 5d03 Dec 29 09:23 lua-5.1-2/src/lua.c
[generic]                 3435   11580  29.7% -lh5- e46b Jan 10 05:50 lua-5.1-2/src/lua.h
[generic]                 4108    8968  45.8% -lh5- c0b9 May 27 16:58 lua-5.1-2/src/lua.o
[generic]               113453  255453  44.4% -lh5- b988 May 27 16:58 lua-5.1-2/src/luac
[generic]                 1811    4574  39.6% -lh5- 2cd8 Nov 11  2005 lua-5.1-2/src/luac.c
[generic]                 2978    6272  47.5% -lh5- 0359 May 27 16:58 lua-5.1-2/src/luac.o
[generic]                 7337   21682  33.8% -lh5- 749b May  6 21:31 lua-5.1-2/src/luaconf.h
[generic]                  398    1022  38.9% -lh5- 131f Dec 27 10:12 lua-5.1-2/src/lualib.h
[generic]                 1613    4512  35.7% -lh5- 9c59 Feb 16 08:53 lua-5.1-2/src/lundump.c
[generic]                  437     882  49.5% -lh5- 3a01 Nov 11  2005 lua-5.1-2/src/lundump.h
[generic]                 1949    3912  49.8% -lh5- 7eac May 27 16:58 lua-5.1-2/src/lundump.o
[generic]                 6263   23041  27.2% -lh5- 8640 Jan 23 12:51 lua-5.1-2/src/lvm.c
[generic]                  444    1155  38.4% -lh5- 0a2a Aug 22  2005 lua-5.1-2/src/lvm.h
[generic]                 7003   14204  49.3% -lh5- 9463 May 27 16:58 lua-5.1-2/src/lvm.o
[generic]                  704    1624  43.3% -lh5- d169 Jun  3  2005 lua-5.1-2/src/lzio.c
[generic]                  662    1552  42.7% -lh5- 4ee9 May 17  2005 lua-5.1-2/src/lzio.h
[generic]                  825    1520  54.3% -lh5- 1cfa May 27 16:58 lua-5.1-2/src/lzio.o
[generic]                 1792    6145  29.2% -lh5- e3fa May  6 21:33 lua-5.1-2/src/Makefile
[generic]                 1702    4871  34.9% -lh5- 75a7 Jan 11 15:49 lua-5.1-2/src/print.c
[generic]                 3647    8052  45.3% -lh5- 3f0f May 27 16:58 lua-5.1-2/src/print.o
[generic]                  364     645  56.4% -lh5- fea3 Oct 30  2002 lua-5.1-2/test/bisect.lua
[generic]                  160     293  54.6% -lh5- f5bb Aug  7  2002 lua-5.1-2/test/cf.lua
[generic]                   74      80  92.5% -lh5- 2474 Aug 12  2002 lua-5.1-2/test/echo.lua
[generic]                  144     181  79.6% -lh5- 5560 Mar 11  2003 lua-5.1-2/test/env.lua
[generic]                  291     707  41.2% -lh5- 3f5a Dec 13  2002 lua-5.1-2/test/factorial.lua
[generic]                  321     605  53.1% -lh5- c1ed Nov 22  2002 lua-5.1-2/test/fib.lua
[generic]                  154     254  60.6% -lh5- 57d1 Oct 24  2003 lua-5.1-2/test/fibfor.lua
[generic]                  275     418  65.8% -lh5- f9b6 Aug  7  2002 lua-5.1-2/test/globals.lua
[generic]                   85      86  98.8% -lh5- 3e81 Aug  6  2002 lua-5.1-2/test/hello.lua
[generic]                 1154    2635  43.8% -lh5- b252 Aug 28  2002 lua-5.1-2/test/life.lua
[generic]                  143     234  61.1% -lh5- 9c62 Aug 11  2005 lua-5.1-2/test/luac.lua
[generic]                  134     169  79.3% -lh5- a02b Dec 22  2004 lua-5.1-2/test/printf.lua
[generic]                  557    1177  47.3% -lh5- 0a73 May 17  2005 lua-5.1-2/test/README
[generic]                  177     260  68.1% -lh5- fbf4 Mar 11  2003 lua-5.1-2/test/readonly.lua
[generic]                  384     774  49.6% -lh5- f322 Oct 30  2002 lua-5.1-2/test/sieve.lua
[generic]                  665    1494  44.5% -lh5- 5666 Aug  7  2002 lua-5.1-2/test/sort.lua
[generic]                  196     283  69.3% -lh5- 8e0f Feb  4  2004 lua-5.1-2/test/table.lua
[generic]                  355     749  47.4% -lh5- a053 Aug 11  2005 lua-5.1-2/test/trace-calls.lua
[generic]                  378     728  51.9% -lh5- 2ef6 Mar 11  2003 lua-5.1-2/test/trace-globals.lua
[generic]                  219     364  60.2% -lh5- a0fd Dec 20  2004 lua-5.1-2/test/xd.lua
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total       144 files  834004 2125205  39.2%            May 28 14:10