[armedbear-cvs] r13856 - in trunk/abcl/doc: design/pathnames manual

[mevenson at common-lisp.net]

Author: mevenson
Date: Sun Feb  5 04:17:08 2012
New Revision: 13856

Log:
manual: clarify the interface for the default implementation for cannonicalization of URIs.

Modified:
   trunk/abcl/doc/design/pathnames/pathnames.tex
   trunk/abcl/doc/manual/abcl.bib
   trunk/abcl/doc/manual/abcl.tex

Modified: trunk/abcl/doc/design/pathnames/pathnames.tex
==============================================================================
--- trunk/abcl/doc/design/pathnames/pathnames.tex	Sun Feb  5 01:28:54 2012	(r13855)
+++ trunk/abcl/doc/design/pathnames/pathnames.tex	Sun Feb  5 04:17:08 2012	(r13856)
@@ -4,7 +4,7 @@
 % \usepackage{abcl}
 
 \begin{document}
-\title{An Implementation and Analysis of Addding IRI to Common Lisp's Pathname}
+\title{An Implementation and Analysis of Adding IRI to Common Lisp's Pathname}
 \date{October 2011}
 \author{Mark~Evenson}
 

Modified: trunk/abcl/doc/manual/abcl.bib
==============================================================================
--- trunk/abcl/doc/manual/abcl.bib	Sun Feb  5 01:28:54 2012	(r13855)
+++ trunk/abcl/doc/manual/abcl.bib	Sun Feb  5 04:17:08 2012	(r13856)
@@ -79,7 +79,7 @@
 }
 
 @TechReport{jsr-223,
-  author =       {Mike Grogan},
+  author =       {Grogan,Mike},
   title =        {Scripting for the {Java} Platform},
   institution =  {Sun Microsystems, Inc.},
   year =         2006,
@@ -88,3 +88,12 @@
   note =      {\url{http://jcp.org/aboutJava/communityprocess/final/jsr223/index.html}},
 }
 
+
+ at Misc{uri-pathname,
+  key =       {evenson2011},
+  author = {Evenson, Mark},
+  title =     {Unpublished draft of {An Implementation and Analysis of Adding IRI to Common Lisp's Pathname}},
+  howpublished = {\url{http://code.google.com/p/abcl-dynamic-install/source/browse/doc/design/pathnames/pathnames.tex}},
+  year =  {2011},
+  note =      {Last accessed Feb 5, 2012},
+}

Modified: trunk/abcl/doc/manual/abcl.tex
==============================================================================
--- trunk/abcl/doc/manual/abcl.tex	Sun Feb  5 01:28:54 2012	(r13855)
+++ trunk/abcl/doc/manual/abcl.tex	Sun Feb  5 04:17:08 2012	(r13856)
@@ -828,11 +828,21 @@
 \item A stream obtained via OPEN on a URL-PATHNAME cannot be the
   target of write operations.
 
-\item No canonicalization is performed on the underlying \textsc{URI} (i.e. the
-implementation does not attempt to compute the current name of the
-representing resource unless it is requested to be resolved.)  Upon
-resolution, any cannoicalization procedures followed in resolving the
-resource (e.g. following redirects) are discarded.  
+\index{URI}
+\item No canonicalization is performed on the underlying \textsc{URI}
+  (i.e. the implementation does not attempt to compute the current
+  name of the representing resource unless it is requested to be
+  resolved.)  Upon resolution, any cannoicalization procedures
+  followed in resolving the resource (e.g. following redirects) are
+  discarded.  Users may programatically initiate a new, local
+  computation by applying the \code{CL:TRUENAME} function to a
+  \code{EXT:URL-PATHNAME} object.  Depending on the reliablity and
+  properties of your local \textsc{REST} infrastructure, these results
+  may not necessarily be idempotent over time\footnote {See
+  \cite{evenson2011} for the draft of the publication of the technical
+  details}.
+
+
 
 \end{itemize}