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

parent 82819391
......@@ -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}
......
......@@ -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}},
}
@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},
}
......@@ -828,11 +828,21 @@ a \code{CL:PATHNAME} is accepted with the following caveats:
\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}
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment