[armedbear-cvs] r13579 - trunk/abcl/doc/manual

[mevenson at common-lisp.net]

Author: mevenson
Date: Wed Sep  7 05:24:05 2011
New Revision: 13579

Log:
Document using Rhodes' extensible sequeunces for java.util.List.

Modified:
   trunk/abcl/doc/manual/abcl.tex

Modified: trunk/abcl/doc/manual/abcl.tex
==============================================================================
--- trunk/abcl/doc/manual/abcl.tex	Wed Sep  7 05:05:29 2011	(r13578)
+++ trunk/abcl/doc/manual/abcl.tex	Wed Sep  7 05:24:05 2011	(r13579)
@@ -139,7 +139,8 @@
 \section{Lisp from Java}
 
 Manipulation of the Lisp API is currently lacking a stable interface,
-so what is documented here is subject to change.  
+so the following documented interfaces are subject to change with
+notice:
 
 \begin{itemize}
 \item All Lisp values are descendants of LispObject.java
@@ -310,6 +311,9 @@
 registering object finalizers, constructing reference weakly held by
 the garbage collector and others.
 
+See \ref{Extensible Sequences} for a generic function interface to
+the native JVM contract for \code{java.util.List}.
+
 \include{extensions}
 
 \chapter{Beyond ANSI}
@@ -319,6 +323,16 @@
 specification which are either widely adopted or are especially useful
 in working with the hosting JVM.
 
+\section{Extensible Sequences}
+
+Chritopher Rhodes proposal for extensible sequences is implemented in
+the SEQUENCE package.  These user extensible sequences are used
+directly in \code{java-collections.lisp} provide these CLOS
+abstractions on the standard Java collection classes as defined by the
+\code{java.util.List} contract
+
+
+
 \section{Extensions to CLOS}
 
 There is an additional syntax for specializing the parameter of a