[armedbear-cvs] r13556 - trunk/abcl/contrib/abcl-asdf

[mevenson at common-lisp.net]

Author: mevenson
Date: Sat Sep  3 01:10:43 2011
New Revision: 13556

Log:
README for using the ASDF definitions to define JVM artifacts.

Added:
   trunk/abcl/contrib/abcl-asdf/README.markdown

Added: trunk/abcl/contrib/abcl-asdf/README.markdown
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ trunk/abcl/contrib/abcl-asdf/README.markdown	Sat Sep  3 01:10:43 2011	(r13556)
@@ -0,0 +1,89 @@
+ABCL-ASDF
+=========
+
+    CL-USER> (require 'abcl-contrib)
+
+    CL-USER> (require 'abcl-asdf)
+    
+    
+ABCL specific contributions to ASDF system definition mainly concerned
+with finding JVM artifiacts such as jar archives to be loaded.
+
+Examples
+--------
+
+    ;;;; -*- Mode: LISP -*-
+    (in-package :asdf)
+
+    (defsystem :log4j
+      :components ((:mvn "log4j/log4j" 
+                    :version "1.4.9")))
+
+API
+---
+
+We define out API as consisting of the following ASDF classes:
+
+JAR-DIRECTORY, JAR-FILE, and CLASS-FILE-DIRECTORY for JVM artifacts
+that have a currently valid pathname representation 
+
+mvn
+
+iri 
+
+
+
+Example 2
+---------
+
+For a filesystem of jar archives:
+
+./lib/ext/flora2-reasoner/XSBFlora.jar
+./lib/ext/iris-reasoner/iris/iris-0.58.jar
+./lib/ext/iris-reasoner/jgrapht/jgrapht-jdk1.5-0.7.1.jar
+./lib/ext/log4j/log4j-1.2.14.jar
+./lib/ext/mandrax-reasoner/commons-collections-2.1.jar
+./lib/ext/mandrax-reasoner/jdom-b10.jar
+./lib/ext/mandrax-reasoner/log4j-1.2.8.jar
+./lib/ext/mandrax-reasoner/mandarax-3.4.jar
+./lib/ext/mins-reasoner/mins-v0_3.jar
+./lib/ext/pellet-reasoner/aterm/1.6/aterm-java-1.6.jar
+./lib/ext/pellet-reasoner/commons-logging/1.1/commons-logging-1.1.jar
+./lib/ext/pellet-reasoner/kaon/1.2.9/rdfapi.jar
+./lib/ext/pellet-reasoner/owl-api/1.4.3/abstractparser.jar
+./lib/ext/pellet-reasoner/owl-api/1.4.3/io.jar
+./lib/ext/pellet-reasoner/owl-api/1.4.3/rdfparser.jar
+./lib/ext/pellet-reasoner/owl-api/1.4.3/validation.jar
+./lib/ext/pellet-reasoner/owl-api/owl-api-econn/2006-04-27/api.jar
+./lib/ext/pellet-reasoner/owl-api/owl-api-econn/2006-04-27/impl.jar
+./lib/ext/pellet-reasoner/pellet/pellet.jar
+./lib/ext/pellet-reasoner/relaxng/1.0/relaxngDatatype.jar
+./lib/ext/pellet-reasoner/xsdlib/xsdlib.jar
+./lib/ext/wsmo/WSML-grammar-20081202.jar
+./lib/ext/wsmo/wsmo-api-0.6.2.jar
+./lib/ext/wsmo/wsmo4j-0.6.2.jar
+./lib/ext/xsb-system/interprolog.jar
+
+The following ASDF defintion loads enough JVM artifacts to use the
+IRIS reasoner:
+
+    (defsystem :wsml2reasoner-jars
+      :version "0.6.4"  ;; last sync with SVN
+      :depends-on (:abcld) :components 
+    ((:module wsml2reasoner 
+	    :pathname "lib/" :components
+	    ((:jar-file "wsml2reasoner")))
+      (:module iris-libs 
+  	    :pathname "lib/ext/iris-reasoner/iris/" :components
+	    ((:jar-file "iris-0.58")))
+      (:module jgrapht-libs 
+	    :pathname "lib/ext/iris-reasoner/jgrapht/" :components
+	    ((:jar-file "jgrapht-jdk1.5-0.7.1")))
+      (:module wsmo-libs
+ 	    :pathname "lib/ext/wsmo/" :components
+	    ((:jar-file "WSML-grammar-20081202")
+	     (:jar-file "wsmo-api-0.6.2")
+	     (:jar-file "wsmo4j-0.6.2")))
+      (:module log4j-libs
+	 :pathname "lib/ext/log4j/" :components
+	      ((:jar-file "log4j-1.2.14")))))