Changeset 13856


Ignore:
Timestamp:
02/05/12 12:17:08 (9 years ago)
Author:
Mark Evenson
Message:

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

Location:
trunk/abcl/doc
Files:
3 edited

Legend:

Unmodified
Added
Removed
  • trunk/abcl/doc/design/pathnames/pathnames.tex

    r13631 r13856  
    55
    66\begin{document}
    7 \title{An Implementation and Analysis of Addding IRI to Common Lisp's Pathname}
     7\title{An Implementation and Analysis of Adding IRI to Common Lisp's Pathname}
    88\date{October 2011}
    99\author{Mark~Evenson}
  • trunk/abcl/doc/manual/abcl.bib

    r13854 r13856  
    8080
    8181@TechReport{jsr-223,
    82   author =       {Mike Grogan},
     82  author =       {Grogan,Mike},
    8383  title =        {Scripting for the {Java} Platform},
    8484  institution =  {Sun Microsystems, Inc.},
     
    8989}
    9090
     91
     92@Misc{uri-pathname,
     93  key =       {evenson2011},
     94  author = {Evenson, Mark},
     95  title =     {Unpublished draft of {An Implementation and Analysis of Adding IRI to Common Lisp's Pathname}},
     96  howpublished = {\url{http://code.google.com/p/abcl-dynamic-install/source/browse/doc/design/pathnames/pathnames.tex}},
     97  year =  {2011},
     98  note =      {Last accessed Feb 5, 2012},
     99}
  • trunk/abcl/doc/manual/abcl.tex

    r13855 r13856  
    829829  target of write operations.
    830830
    831 \item No canonicalization is performed on the underlying \textsc{URI} (i.e. the
    832 implementation does not attempt to compute the current name of the
    833 representing resource unless it is requested to be resolved.)  Upon
    834 resolution, any cannoicalization procedures followed in resolving the
    835 resource (e.g. following redirects) are discarded. 
     831\index{URI}
     832\item No canonicalization is performed on the underlying \textsc{URI}
     833  (i.e. the implementation does not attempt to compute the current
     834  name of the representing resource unless it is requested to be
     835  resolved.)  Upon resolution, any cannoicalization procedures
     836  followed in resolving the resource (e.g. following redirects) are
     837  discarded.  Users may programatically initiate a new, local
     838  computation by applying the \code{CL:TRUENAME} function to a
     839  \code{EXT:URL-PATHNAME} object.  Depending on the reliablity and
     840  properties of your local \textsc{REST} infrastructure, these results
     841  may not necessarily be idempotent over time\footnote {See
     842  \cite{evenson2011} for the draft of the publication of the technical
     843  details}.
     844
     845
    836846
    837847\end{itemize}
Note: See TracChangeset for help on using the changeset viewer.