[armedbear-cvs] r12722 - in trunk/abcl/examples: . google-app-engine

[Mark Evenson]

Author: mevenson
Date: Sun May 23 02:16:50 2010
New Revision: 12722

Log:
Examples reorganization:  Top-level README, GAE specific README.


Added:
   trunk/abcl/examples/google-app-engine/README
Modified:
   trunk/abcl/examples/README

Modified: trunk/abcl/examples/README
==============================================================================
--- trunk/abcl/examples/README	(original)
+++ trunk/abcl/examples/README	Sun May 23 02:16:50 2010
@@ -1,44 +1,48 @@
-ABCL Examples Building and Running Instructions
-===============================================
+ABCL Examples
+=============
 
-code by Ville Voutilainen
-(abcl_appengine code by Alex Muscar)
-instructions by Blake McBride
-updated by Mark Evenson
+Contributions from: 
+  Ville Voutilainen, Alex Muscar, Blake McBride, and Mark Evenson
 
-In general, to compile a Java class file (like Main.java for example
-in the 'java_exception_in_lisp' subdirectory) use:
 
-	cmd$ cd java_exception_in_lisp
-	cmd$ javac  -cp ../../../dist/abcl.jar  Main.java
+google-app-engine 
+                  
+   This example shows how to run a ABCL in a Java Servlet context in
+   general and in Google App Engine (GAE) in particular.
 
-where the "../../../dist/abcl.jar" represents the path to your
-abcl.jar file, which is built via the Ant based build.  This path
-could be slightly different depending on how the system was
-constructed, and possibly due to operating system conventions for
-specifying relative paths.  However you resolve this locally, we'll
-refer to this as '$ABCL_ROOT/dist/abcl.jar' for the rest of these
-instructions.
 
-This compiles the Java source file "Main.java" into a JVM runtime or
-class file named "Main.class".
+java-exception
 
-To run the example (Main.class for example) from a Unix-like OS use:
+   Handling Java exceptions with the Lisp condition system.
 
-	cmd$ java  -cp $ABCL_ROOT/dist/abcl.jar:.  Main
 
-or in Windows use:
+java-interface 
 
-	cmd$  java  -cp  $ABCL_ROOT/dist/abcl.jar;.  Main
+   Implementing a Java interface with Lisp.
 
-where "Main" is the initial class to run in your Java program.
 
+java-to-lisp-1 
 
-abcl_appengine
-==============
+   Simple examples of calling Lisp from Java.
 
-This example shows how to run your servlet off ABCL in general
-and in Google App Engine (GAE) in particular.
 
-When uploading your code to the server, be sure to put abcl.jar
-in war/WEB-INF/lib.
+java-to-lisp-2
+
+   More involved example of calling Lisp from Java including
+   parameters and return values.
+
+
+jsr-223
+
+   Using the implementation of the JSR-223 interface to use Common
+   Lisp as a pluggable scripting language on the JVM.
+
+
+lisp-to-java
+
+   Calling Java code from Lisp.
+
+
+misc
+
+   Code snippets currently without documentation.
\ No newline at end of file

Added: trunk/abcl/examples/google-app-engine/README
==============================================================================
--- (empty file)
+++ trunk/abcl/examples/google-app-engine/README	Sun May 23 02:16:50 2010
@@ -0,0 +1,16 @@
+Google App Engine
+=================
+
+Alex Muscar
+
+Running ABCL in a Google App Engine container.
+
+This example shows how to run your servlet off ABCL in general
+and in Google App Engine (GAE) in particular.
+
+When uploading your code to the server, be sure to put abcl.jar
+in war/WEB-INF/lib.
+
+
+
+