Changeset 13856

Timestamp:

02/05/12 12:17:08 (11 years ago)

Author:

Mark Evenson

Message:

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

Location:

trunk/abcl/doc

Files:

• design/pathnames/pathnames.tex (modified) (1 diff)
• manual/abcl.bib (modified) (2 diffs)
• manual/abcl.tex (modified) (1 diff)

trunk/abcl/doc/design/pathnames/pathnames.tex

@@ -5 +5 @@
 
 \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}

trunk/abcl/doc/manual/abcl.bib

@@ -80 +80 @@
 
 @TechReport{jsr-223,
-  author =       {Mike Grogan},
+  author =       {Grogan,Mike},
   title =        {Scripting for the {Java} Platform},
   institution =  {Sun Microsystems, Inc.},
@@ -89 +89 @@
 }
 
+
+@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},
+}

trunk/abcl/doc/manual/abcl.tex

@@ -829 +829 @@
   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}