Changeset 13649


Ignore:
Timestamp:
10/21/11 07:57:51 (9 years ago)
Author:
Mark Evenson
Message:

abcl-20111021a ABCL User Manual

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/1.0.x/abcl/doc/manual/abcl.tex

    r13648 r13649  
    1919\subsection{Version}
    2020This manual corresponds to abcl-1.0.0, released on October 22, 2011.
     21
     22\subsection{License}
     23
     24The implementation is licensed under the terms of the GPL v2 of June
     251991 with the ``classpath-exception'' that makes its deployment in
     26commercial settings quite reasonable.  The license is viral in the
     27sense that if you change the implementation, and redistribute those
     28changes, you are required to provide the source to those changes back
     29to be merged with the public trunk.
    2130
    2231\chapter{Running}
     
    2736under the control of a suitable JVM by using the ``-jar'' option to
    2837parse the manifest, and select the named class
    29 (\code{org.armedbear.lisp.Main}) for execution:
     38(\code{org.armedbear.lisp.Main}) for execution, viz:
    3039
    3140\begin{listing-shell}
     
    7382\end{verbatim}
    7483
    75 All of the command line arguments which follow the occurrence of ``--''
     84All of the command line arguments which follow the occurrence of ``----''
    7685are passed into a list bound to the EXT:*COMMAND-LINE-ARGUMENT-LIST*
    7786variable.
     
    91100
    92101\section{ANSI Common Lisp}
    93 \textsc{ABCL} is currently a non-conforming ANSI Common Lisp implementation due
    94 to the following issues:
     102\textsc{ABCL} is currently a (non)-conforming ANSI Common Lisp
     103implementation due to the following known issues:
    95104
    96105\begin{itemize}
    97106  \item The generic function signatures of the DOCUMENTATION symbol do
    98107    not match the CLHS.
    99   \item The TIME form does not return a proper VALUES to its caller.
     108  \item The TIME form does not return a proper VALUES environment to
     109    its caller.
    100110\end{itemize}
    101111
    102 Somewhat confusingly, this statement of non-conformance
    103 in the accompanying user documentation fullfills the requirements that
     112Somewhat confusingly, this statement of non-conformance in the
     113accompanying user documentation fullfills the requirements that
    104114\textsc{ABCL} is a conforming ANSI Common Lisp implementation
    105115according to the CLHS \footnote{Common Lisp Hyperspec language
     
    861871We implement a special hexadecimal escape sequence for specifying
    862872characters to the Lisp reader, namely we allow a sequences of the form
    863 \# \textbackslash Uxxxx to be processed by the reader as character whose code is
    864 specified by the hexadecimal digits ``xxxx''.  The hexadecimal sequence
    865 must be exactly four digits long, padded by leading zeros for values
    866 less than 0x1000.
     873\# \textbackslash Uxxxx to be processed by the reader as character
     874whose code is specified by the hexadecimal digits ``xxxx''.  The
     875hexadecimal sequence must be exactly four digits long \footnote{This
     876  represents a compromise with contemporary in 2011 32bit hosting
     877  architecures for which we wish to make text processing efficient.
     878  Should the User require more control over UNICODE processing we
     879  recommend Edi Weisz' excellent work with FLEXI-STREAMS which we
     880  fully support}, padded by leading zeros for values less than 0x1000.
    867881
    868882Note that this sequence is never output by the implementation.  Instead,
Note: See TracChangeset for help on using the changeset viewer.