From 659a20a99978871335b3411b499b441c13d060bf Mon Sep 17 00:00:00 2001 From: James Roseborough Date: Thu, 12 Jul 2012 14:45:08 +0000 Subject: [PATCH] Start the 3.0-alpha1 version --- README.html | 72 ++++++++++++++++++++++++++-------------------- version.properties | 2 +- 2 files changed, 42 insertions(+), 32 deletions(-) diff --git a/README.html b/README.html index 448da6ca..4ccb1dc2 100644 --- a/README.html +++ b/README.html @@ -16,7 +16,7 @@ Getting Started with LuaJ -James Roseborough, Ian Farmer, Version 2.0.3 +James Roseborough, Ian Farmer, Version 3.0-alpha1

Copyright © 2009-2012 Luaj.org. @@ -49,7 +49,7 @@ Freely available under the terms of the

1 - Introduction

Goals of Luaj

-Luaj is a lua interpreter based on the 5.1.x version of lua with the following goals in mind: +Luaj is a lua interpreter based on the 5.2.x version of lua with the following goals in mind: -

Differences with 1.0

-In addition to the basic goals of luaj, version 2.0 is aimed -at improving on the 1.0 vm in the following aspects. +

Luaj version and Lua Versions

+

Luaj 3.0.x

+Support for lua 5.2.x features: + +It also includes miscellaneous improvements over luaj 2.0.x: + +

Luaj 2.0.x

+Support for luaj 5.1.x features, plus: +

Luaj 1.0.x

+Support for most luaj 5.1.x features.

Performance

Good performance is a major goal of luaj. @@ -106,7 +116,7 @@ in comparison with the standard C distribution. 16.794 11.274 Java - java -cp luaj-jse-2.0.3.jar;bcel-5.2.jar lua -b fannkuch.lua 10 + java -cp luaj-jse-3.0-alpha1.jar;bcel-5.2.jar lua -b fannkuch.lua 10 @@ -116,7 +126,7 @@ in comparison with the standard C distribution. 16.701 13.789 - java -cp luaj-jse-2.0.3.jar lua -j fannkuch.lua 10 + java -cp luaj-jse-3.0-alpha1.jar lua -j fannkuch.lua 10 @@ -126,7 +136,7 @@ in comparison with the standard C distribution. 36.894 15.163 - java -cp luaj-jse-2.0.3.jar lua -n fannkuch.lua 10 + java -cp luaj-jse-3.0-alpha1.jar lua -n fannkuch.lua 10 lua 5.1.4 @@ -182,7 +192,7 @@ It is also faster than Java-lua implementations Jill, Kahlua, and Mochalua for a From the main distribution directory line type: 
-	java -cp lib/luaj-jse-2.0.3.jar lua examples/lua/hello.lua
+	java -cp lib/luaj-jse-3.0-alpha1.jar lua examples/lua/hello.lua

@@ -194,7 +204,7 @@ You should see the following output: To see how luaj can be used to acccess most Java API's including swing, try: 

-	java -cp lib/luaj-jse-2.0.3.jar lua examples/lua/swingapp.lua
+	java -cp lib/luaj-jse-3.0-alpha1.jar lua examples/lua/swingapp.lua

Compile lua source to lua bytecode

@@ -203,8 +213,8 @@ To see how luaj can be used to acccess most Java API's including swing, try: From the main distribution directory line type: 
-	java -cp lib/luaj-jse-2.0.3.jar luac examples/lua/hello.lua
-	java -cp lib/luaj-jse-2.0.3.jar lua luac.out
+	java -cp lib/luaj-jse-3.0-alpha1.jar luac examples/lua/hello.lua
+	java -cp lib/luaj-jse-3.0-alpha1.jar lua luac.out

@@ -216,9 +226,9 @@ The compiled output "luac.out" is lua bytecode and should run and produce the sa Luaj can compile to lua source code to Java source code: 

-	java -cp lib/luaj-jse-2.0.3.jar lua2java -s examples/lua -d . hello.lua
-	javac -cp lib/luaj-jse-2.0.3.jar hello.java
-	java -cp "lib/luaj-jse-2.0.3.jar;." lua -l hello
+	java -cp lib/luaj-jse-3.0-alpha1.jar lua2java -s examples/lua -d . hello.lua
+	javac -cp lib/luaj-jse-3.0-alpha1.jar hello.java
+	java -cp "lib/luaj-jse-3.0-alpha1.jar;." lua -l hello

@@ -229,7 +239,7 @@ There are no additional dependencies for compiling or running source-to-source c

Lua scripts can also be run directly in this mode without precompiling using the lua command with the -j option when run in JDK 1.5 or higher: 

-	java -cp lib/luaj-jse-2.0.3.jar lua -j examples/lua/hello.lua
+	java -cp lib/luaj-jse-3.0-alpha1.jar lua -j examples/lua/hello.lua

Compile lua bytecode to java bytecode

@@ -239,8 +249,8 @@ Luaj can compile lua sources or binaries directly to java bytecode if the bcel l 
 	ant bcel-lib
-	java -cp "lib/luaj-jse-2.0.3.jar;lib/bcel-5.2.jar" luajc -s examples/lua -d . hello.lua
-	java -cp "lib/luaj-jse-2.0.3.jar;." lua -l hello
+	java -cp "lib/luaj-jse-3.0-alpha1.jar;lib/bcel-5.2.jar" luajc -s examples/lua -d . hello.lua
+	java -cp "lib/luaj-jse-3.0-alpha1.jar;." lua -l hello

@@ -251,7 +261,7 @@ but the compiled classes must be in the class path at runtime, unless runtime ji

Lua scripts can also be run directly in this mode without precompiling using the lua command with the -b option and providing the bcel library in the class path: 

-	java -cp "lib/luaj-jse-2.0.3.jar;lib/bcel-5.2.jar" lua -b examples/lua/hello.lua
+	java -cp "lib/luaj-jse-3.0-alpha1.jar;lib/bcel-5.2.jar" lua -b examples/lua/hello.lua
@@ -276,7 +286,7 @@ A simple example may be found in

-You must include the library lib/luaj-jse-2.0.3.jar in your class path. +You must include the library lib/luaj-jse-3.0-alpha1.jar in your class path.

Run a script in a MIDlet

@@ -303,7 +313,7 @@ A simple example may be found in

-You must include the library lib/luaj-jme-2.0.3.jar in your midlet jar. +You must include the library lib/luaj-jme-3.0-alpha1.jar in your midlet jar.

An ant script to build and run the midlet is in @@ -331,7 +341,7 @@ The standard use of JSR-223 scripting engines may be used: All standard aspects of script engines including compiled statements should be supported.

-You must include the library lib/luaj-jse-2.0.3.jar in your class path. +You must include the library lib/luaj-jse-3.0-alpha1.jar in your class path.

A working example may be found in @@ -343,7 +353,7 @@ To compile and run it using Java 1.6 or higher: 

 	javac examples/jse/ScriptEngineSample.java
-	java -cp "lib/luaj-jse-2.0.3.jar;examples/jse" ScriptEngineSample
+	java -cp "lib/luaj-jse-3.0-alpha1.jar;examples/jse" ScriptEngineSample

Excluding the lua bytecode compiler

@@ -520,7 +530,7 @@ The following lua script will open a swing frame on Java SE: See a longer sample in examples/lua/swingapp.lua for details, including a simple animation loop, rendering graphics, mouse and key handling, and image loading. Or try running it using: 
-	java -cp lib/luaj-jse-2.0.3.jar lua examples/lua/swingapp.lua
+	java -cp lib/luaj-jse-3.0-alpha1.jar lua examples/lua/swingapp.lua

@@ -748,7 +758,7 @@ and LuaForge:

  • Enhance javadoc, put it in distribution and on line
  • Major refactor of luajava type coercion logic, improve method selection.
  • Add lib/luaj-sources-2.0.2.jar for easier integration into an IDE such as Netbeans
    • -  2.0.3