Changeset 13649 for branches/1.0.x/abcl/doc/manual/abcl.tex

Timestamp:

10/21/11 07:57:51 (12 years ago)

Author:

Mark Evenson

Message:

abcl-20111021a ABCL User Manual

File:

• branches/1.0.x/abcl/doc/manual/abcl.tex (modified) (5 diffs)

branches/1.0.x/abcl/doc/manual/abcl.tex

@@ -19 +19 @@
 \subsection{Version}
 This manual corresponds to abcl-1.0.0, released on October 22, 2011.
+
+\subsection{License}
+
+The implementation is licensed under the terms of the GPL v2 of June
+1991 with the ``classpath-exception'' that makes its deployment in
+commercial settings quite reasonable.  The license is viral in the
+sense that if you change the implementation, and redistribute those
+changes, you are required to provide the source to those changes back
+to be merged with the public trunk.
 
 \chapter{Running}
@@ -27 +36 @@
 under the control of a suitable JVM by using the ``-jar'' option to
 parse the manifest, and select the named class
-(\code{org.armedbear.lisp.Main}) for execution:
+(\code{org.armedbear.lisp.Main}) for execution, viz:
 
 \begin{listing-shell}
@@ -73 +82 @@
 \end{verbatim}
 
-All of the command line arguments which follow the occurrence of ``--''
+All of the command line arguments which follow the occurrence of ``----''
 are passed into a list bound to the EXT:*COMMAND-LINE-ARGUMENT-LIST*
 variable.
@@ -91 +100 @@
 
 \section{ANSI Common Lisp}
-\textsc{ABCL} is currently a non-conforming ANSI Common Lisp implementation due
-to the following issues:
+\textsc{ABCL} is currently a (non)-conforming ANSI Common Lisp
+implementation due to the following known issues:
 
 \begin{itemize}
   \item The generic function signatures of the DOCUMENTATION symbol do
     not match the CLHS.
-  \item The TIME form does not return a proper VALUES to its caller.
+  \item The TIME form does not return a proper VALUES environment to
+    its caller.
 \end{itemize}
 
-Somewhat confusingly, this statement of non-conformance 
-in the accompanying user documentation fullfills the requirements that
+Somewhat confusingly, this statement of non-conformance in the
+accompanying user documentation fullfills the requirements that
 \textsc{ABCL} is a conforming ANSI Common Lisp implementation
 according to the CLHS \footnote{Common Lisp Hyperspec language
@@ -861 +871 @@
 We implement a special hexadecimal escape sequence for specifying
 characters to the Lisp reader, namely we allow a sequences of the form
-\# \textbackslash Uxxxx to be processed by the reader as character whose code is
-specified by the hexadecimal digits ``xxxx''.  The hexadecimal sequence
-must be exactly four digits long, padded by leading zeros for values
-less than 0x1000.
+\# \textbackslash Uxxxx to be processed by the reader as character
+whose code is specified by the hexadecimal digits ``xxxx''.  The
+hexadecimal sequence must be exactly four digits long \footnote{This
+  represents a compromise with contemporary in 2011 32bit hosting
+  architecures for which we wish to make text processing efficient.
+  Should the User require more control over UNICODE processing we
+  recommend Edi Weisz' excellent work with FLEXI-STREAMS which we
+  fully support}, padded by leading zeros for values less than 0x1000.
 
 Note that this sequence is never output by the implementation.  Instead,