metadata: normalize README, manual, and asdf metadata

parent 5992ced7
......@@ -8,6 +8,7 @@ Armed Bear Common Lisp is a conforming implementation of ANSI Common
Lisp that runs in a Java virtual machine. It compiles Lisp code
directly to Java byte code.
LICENSE
=======
......@@ -22,7 +23,9 @@ making a combined work based on this software. Thus, the terms and
conditions of the GNU General Public License cover the whole
combination.
** Classpath Exception
Classpath Exception
-------------------
As a special exception, the copyright holders of this software give
you permission to link this software with independent modules to
......@@ -39,7 +42,7 @@ exception statement from your version.
RUNNING FROM DOCKER
===================
With [Docker Engine][] installed so that one may execute:
With [Docker Engine][] installed one may execute:
docker run -it easye/abcl
......@@ -71,32 +74,16 @@ to get
[Docker Engine]: https://www.docker.com/products/docker-engine
## Building Docker Container locally from modifications
Get the source; use the Dockerfile to build.
docker pull easye/openjdk8
docker build -t easye/abcl .
Building a Docker Image With Modifications
------------------------------------------
See <file:Dockerfile> for specifics on build instructions.
Get the source (see below); make yer mods; use the Dockerfile to build.
RUNNING FROM DOCKER
===================
docker build -t YOURID/abcl .
docker run -it YOURID/abcl
With [Docker Engine][] installed so that one may execute:
docker pull easye/openjdk8
docker run easye/abcl
[Docker Engine]: https://www.docker.com/products/docker-engine
## Building Docker Container locally from modifications
docker pull easye/openjdk8
docker build -t e/abcl .
docker run -it e/abcl
See <file:Dockerfile> for build instructions.
See <file:Dockerfile> for the build instructions.
RUNNING FROM BINARY RELEASE
......@@ -210,7 +197,7 @@ value of '*JDK*' there should be an executable Java compiler in
Then, one may either use the 'build-from-lisp.bash' shell script or load
the necessary files into your Lisp image by hand.
** Using the 'build-from-lisp.bash' script
### Using the 'build-from-lisp.bash' script
Under UNIX-like systems, one may simply invoke the
'build-from-lisp.bash' script. As noted above, one must first copy the
......@@ -240,7 +227,7 @@ In case of failure in the javac stage, you might try this:
This invokes javac separately for each .java file, which avoids running
into limitations on command line length (but is a lot slower).
** Building from another Lisp manually
### Building from another Lisp manually
There is also an ASDF definition in 'abcl.asd' for the BUILD-ABCL
which can be used to load the necessary Lisp definitions, after which
......@@ -262,7 +249,8 @@ ABCL now has a manual stating its conformance to the ANSI standard,
providing a compliant and practical Common Lisp implementation.
### Tests
Tests
-----
ABCL 1.4.0 now fails 47 out of 21708 total tests in the [revised and
expanded ANSI CL test suite][ansi-test] (derived from the tests
......@@ -277,12 +265,11 @@ more information.
### Deficiencies
Many. But patches are solicited.
Many. But Patches to address issues mentioned above will be gladly
accepted.
Patches to address any of the issues mentioned above will
be gladly accepted.
# Contact
CONTACT
=======
Please report problems to the development mailing list:
......@@ -290,7 +277,8 @@ Please report problems to the development mailing list:
Have fun!
# Authors
AUTHORS
=======
On behalf of all ABCL development team and contributors,
......
......@@ -19,7 +19,7 @@
dc:identifier <urn:abcl.org/1.5.0#dev> ;
doap:language "Common Lisp" ;
dc:created "01-JAN-2004" ;
dc:modified "08-OCT-2016" ;
dc:modified "03-FEB-2017" ;
dc:version "abcl-1.5.0" ;
dc:release "dev" ;
abcl:git <https://github.com/easye/abcl/> ; # Does this overwrite? TODO Check RDF specs.
......@@ -69,7 +69,8 @@
rdf:_11 "Olof-Joachim Frahm" ;
rdf:_7 _:cyrus ;
rdf:_8 _:dmiles ;
rdf:_9 _:alanr ;
rdf:_9 _:alanr ;
rdf:_9 "Alan Ruttenberg" ;
rdf:_10 _:pipping ;
rdf:_10 "Elias Pipping" ;
rdf:_12 "Vibhu Mohindra" ;
......@@ -134,7 +135,9 @@ doap:Project rdfs:seeAlso [
doap:Project rdfs:seeAlso
<http://abcl.org/trac/timeline> ,
<http://abcl.org/trac/wiki> ,
<http://abcl.org/trac/wiki> ,
<http://github.com/armedbear/abcl/> ,
<http://gitlab.common-lisp.net/abcl/abcl/> ,
<http://code.google.com/p/abcl-dynamic-install/> ,
<http://abcl.org/svn/trunk/abcl/> .
......@@ -148,10 +151,11 @@ doap:Project rdfs:seeAlso
rdf:_7 abcl:jna ;
rdf:_8 abcl:asdf-jar ;
rdf:_9 abcl:quicklisp-abcl ;
rdf:_10 abcl:abcl-introspect ;
] .
abcl:jna dc:version "4.2.2" .
abcl:asdf dc:version "3.1.7.35" .
abcl:asdf dc:version "3.2.0" .
abcl:abcl-contrib
rdfs:seeAlso <file:contrib/README.markdown> .
......
......@@ -3,7 +3,8 @@
(asdf:defsystem :abcl-asdf-tests
:author "Mark Evenson"
:description "<> asdf:defsystem <urn:abcl.org/release/1.5.0/contrib/abcl-asdf/test#1.6.0>"
:long-description "<urn:abcl.org/release/1.5.0/contrib/abcl-asdf/test#>"
:version "1.6.0"
:defsystem-depends-on (prove-asdf)
:depends-on (abcl-asdf ;; our dependencies
;; Actual testing framework
......
......@@ -3,8 +3,9 @@
(asdf:defsystem :abcl-introspect
:author "Alan Ruttenberg"
:version "1.0.1"
:description "Introspection on compiled function to aid source location and other debugging functions."
:long-description "<urn:abcl.org/release/1.5.0/contrib/abcl-introspect#>"
:version "1.0.1"
:depends-on (jss)
:components ((:file "abcl-introspect")
(:file "stacktrace")))
......@@ -3,8 +3,9 @@
(defsystem :asdf-jar
:author "Mark Evenson"
:description "Packaging ASDF systems into jar files"
:long-description "<urn:abcl.org/release/1.5.0/contrib/asdf-jar#>"
:version "0.3.2"
:description "<> asdf:defsystem <urn:abcl.org/release/1.5.0/contrib/asdf-jar#0.3.2>"
:components
((:module base :pathname "" :components
((:file "asdf-jar")
......
(require :asdf)
(asdf:defsystem jfli
:long-description "<urn:abcl.org/release/1.5.0/contrib/jfli#>"
:version "0.2.0"
:components ((:file "jfli")))
;;; Requires integration with IntelliJ IDEA editor (free download)
(asdf:defsystem jfli-intellij-tests
(asdf:defsystem jfli/intellij-tests
:version "0.2.0"
:description "<> asdf:defsystem <urn:abcl.org/release/1.5.0/contrib/jfli#0.2.0> ."
:depends-on (jfli)
:components ((:module test
:components ((:file "yanking")))))
(in-package :asdf)
(require :asdf)
(in-package :cl-user)
(asdf:defsystem :jss
:author "Alan Ruttenberg, Mark Evenson"
:long-description "<urn:abcl.org/release/1.5.0/contrib/jss#>"
:version "3.2.3"
:description "<> asdf:defsystem <urn:abcl.org/release/1.5.0/contrib/jss#3.2.2>"
:components ((:module base :pathname "" :serial t
:components ((:file "packages")
(:file "invoke")
......
;;;; -*- Mode: LISP -*-
(require :asdf)
(in-package :cl-user)
;;;; Need to have jna.jar present for CFFI to work.
(asdf:defsystem :jna
:version "4.2.2"
:description "<> asdf:defsystem <urn:abcl.org/release/1.5.0/contrib/jna#4.2.2>"
:defsystem-depends-on (jss abcl-asdf)
:components ((:mvn "net.java.dev.jna/jna/4.2.2"
:alternate-uri "http://repo1.maven.org/maven2/net/java/dev/jna/jna/4.2.2/jna-4.2.2.jar"
:classname "com.sun.jna.Native")))
:long-description "<urn:abcl.org/release/1.5.0/contrib/jna#4.2.2>"
:version "4.2.2"
:defsystem-depends-on (jss abcl-asdf)
:components ((:mvn "net.java.dev.jna/jna/4.2.2"
:alternate-uri "http://repo1.maven.org/maven2/net/java/dev/jna/jna/4.2.2/jna-4.2.2.jar"
:classname "com.sun.jna.Native")))
(in-package :asdf)
(defmethod perform :after ((o load-op) (c (eql (find-system :jna))))
(defmethod asdf:perform :after ((o asdf:load-op) (c (eql (asdf:find-system :jna))))
(when (jss:find-java-class "com.sun.jna.Native")
(provide :jna)))
......
;;;; -*- Mode: LISP -*-
(require :asdf)
(in-package :cl-user)
(asdf:defsystem :log4j
:defsystem-depends-on (abcl-asdf)
......
......@@ -22,15 +22,15 @@ December 2016}
\subsection{Preface to the Fifth Edition}
\textsc{ABCL} 1.4 consolidates eighteen months of production bugfixes,
and substatianally improves the support for invoking external
and substantially improves the support for invoking external
processes via SYS:RUN-PROGRAM.
%%Preface to the Fourth edition, abcl-1.3.
\subsection{Preface to the Fourth Edition}
\textsc{ABCL} 1.3 now implements an optimized implementation of the
LispStack abstraction thanks to Dmitry Nadezhin which runs on ORCL
JVMs from 1.[5-8] conformantly.
\code{org.armedbare.lisp.LispStack} abstraction thanks to Dmitry
Nadezhin which runs on ORCL JVMs from 1.[5-8] conformantly.
%%Preface to the Third edition, abcl-1.2.
\subsection{Preface to the Third Edition}
......@@ -1314,7 +1314,7 @@ reader in the definition of the \code{SHARPSIGN-DOUBLE-QUOTE}
\section{ASDF}
asdf-3.1.7.43 (see \cite{asdf}) is packaged as core component of \textsc{ABCL},
asdf-3.2.0 (see \cite{asdf}) is packaged as core component of \textsc{ABCL},
but not initialized by default, as it relies on the \textsc{CLOS} subsystem
which can take a bit of time to start \footnote{While this time is
``merely'' on the order of seconds for contemporary 2011 machines,
......@@ -1364,11 +1364,13 @@ definitions, as the following example references the
abstraction for handling logging systems:
\begin{listing-lisp}
;;;; -*- Mode: LISP -*-
(in-package :asdf)
;;;; -*- Mode: LISP -*-
(require :asdf)
(in-package :cl-user)
(defsystem :log4j
:components ((:mvn "log4j/log4j" :version "1.4.9")))
(asdf:defsystem :log4j
:defsystem-depends-on (abcl-asdf)
:components ((:mvn "log4j/log4j" :version "1.4.9")))
\end{listing-lisp}
\subsection{API}
......@@ -1380,8 +1382,8 @@ ASDF classes:
\code{CLASS-FILE-DIRECTORY} for JVM artifacts that have a currently
valid pathname representation.
Both the MVN and IRI classes descend from ASDF-COMPONENT, but do not
directly have a filesystem location.
Both the \code{MVN} and \code{IRI} classes descend from
\code{ASDF-COMPONENT}, but do not directly have a filesystem location.
For use outside of ASDF system definitions, we currently define one
method, \code{ABCL-ASDF:RESOLVE-DEPENDENCIES} which locates,
......@@ -1420,7 +1422,6 @@ locally from the network as well.
More extensive documentations and examples can be found at
\url{http://abcl.org/svn/tags/1.4.0/contrib/abcl-asdf/README.markdown}.
\section{asdf-jar}
The asdf-jar contrib provides a system for packaging \textsc{ASDF}
......@@ -1432,7 +1433,6 @@ fasls in a jar archive.
The documentation for this contrib can be found at
\url{http://abcl.org/svn/tags/1.4.0/contrib/asdf-jar/README.markdown}.
\section{jss}
\label{section:jss}
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment