Changeset 13798


Ignore:
Timestamp:
01/25/12 07:48:02 (9 years ago)
Author:
Mark Evenson
Message:

Merge User manual from what we tagged as 1.0.1

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/abcl/doc/manual/abcl.tex

    r13749 r13798  
    66\begin{document}
    77\title{A Manual for Armed Bear Common Lisp}
    8 \date{January 10, 2012}
     8\date{January 25, 2012}
    99\author{Mark~Evenson, Erik~H\"{u}lsmann, Alessio~Stalla, Ville~Voutilainen}
    1010
     
    2222
    2323\subsection{Version}
    24 This manual corresponds to abcl-1.0.1 released on January 10, 2012.
     24This manual corresponds to abcl-1.1.0-dev, as yet unreleased..
    2525
    2626\subsection{License}
     
    4848\texttt{Thanks for JSS.}
    4949
    50 
    5150\item and of course
    5251\emph{Peter Graves}
     
    5857\textsc{ABCL} is packaged as a single jar file usually named either
    5958``abcl.jar'' or possibly``abcl-1.0.1.jar'' if one is using a versioned
    60 package on the local filesytem from your system vendor.  This byte
     59package on the local filesystem from your system vendor.  This byte
    6160archive can be executed under the control of a suitable JVM \footnote
    6261{Java Virtual Machine} by using the ``-jar'' option to parse the
     
    164163
    165164  \item An incomplete implementation of a properly named metaobject
    166     protocol (viz. (A)MOP \footnote{The Art of the  Metaobject Protocol} )
     165    protocol (c.f. the (A)MOP \footnote{The Art of the  Metaobject Protocol} specification)
    167166
    168167    % N.b.
     
    561560ABCL can be built with support for JSR-223, which offers a
    562561language-agnostic API to invoke other languages from Java. The binary
    563 distribution downloadable from ABCL's common-lisp.net home is built
     562distribution download-able from ABCL's common-lisp.net home is built
    564563with JSR-223 support. If you're building ABCL from source on a pre-1.6
    565564JVM, you need to have a JSR-223 implementation in your CLASSPATH (such
     
    603602through ScriptEngineManager (refer to the javax.script documentation).
    604603
    605 \subsubsection{Startup and configuration file}
    606 
    607 At startup (i.e. when its constructor is invoked, as part of the
     604\subsubsection{Start-up and configuration file}
     605
     606At start-up (i.e. when its constructor is invoked, as part of the
    608607static initialization phase of AbclScriptEngineFactory) the ABCL
    609608script engine attempts to load an "init file" from the classpath
    610609(/abcl-script-config.lisp). If present, this file can be used to
    611 customize the behaviour of the engine, by setting a number of
     610customize the behavior of the engine, by setting a number of
    612611variables in the ABCL-SCRIPT package. Here is a list of the available
    613612variables:
     
    10591058required source and fasls in a jar archive.
    10601059
    1061 \url{http://svn.common-lisp.net/armedbear/trunk/abcl/contrib/asdf-jar/README.markdown}
     1060See \url{http://svn.common-lisp.net/armedbear/trunk/abcl/contrib/asdf-jar/README.markdown}.
    10621061
    10631062
     
    10651064\label{section:jss}
    10661065
    1067 To one used to a syntax that can construct macros the Java syntax
    1068 may be said to suck, so we introduce the \code{SHARPSIGN-DOUBLE-QUOTE} \#" macro.
     1066To one used to the more universal syntax of Lisp pairs for which the
     1067definition of read and compile time macros is quite natural, the Java
     1068syntax available to the Java programmer may be said to suck.  To
     1069alleviate this situation, we introduce the
     1070\code{SHARPSIGN-DOUBLE-QUOTE} (``\\#"Q'') macro, the first of perhaps
     1071  many exper
    10691072
    10701073\subsection{JSS usage}
     1074
     1075\label{section:jss}
    10711076
    10721077Example:
     
    11141119On October 22, 2011, with the publication of this Manual explicitly
    11151120stating the conformance of Armed Bear Common Lisp to \textsc{ANSI}, we
    1116 released abcl-1.0.0.
    1117 
     1121released abcl-1.0.0.  We released abcl-1.0.1 as a maintainence release
     1122on January 10, 2012.
    11181123
    11191124
     
    11311136  \url{http://www.quicklisp.org/}
    11321137
     1138\label{_:RHODES2007}
    11331139\bibitem{Rhodes2007}
    11341140Christopher Rhodes
     
    11381144\url{http://jcsu.jesus.cam.ac.uk/~csr21/spec.pdf}
    11391145
     1146\label{_:AMOP}
     1147\bibitem{AMOP}
     1148Gregor Kiczales, Jim de Rivieres, and Daniel G. Bobrow
     1149The Art of the Metaobject Protocol
     1150% XXX online citation
     1151
    11401152\end{thebibliography}
    11411153
Note: See TracChangeset for help on using the changeset viewer.