[bknr-cvs] edi changed trunk/thirdparty/drakma/
BKNR Commits
bknr at bknr.net
Mon Feb 9 09:57:29 UTC 2009
Revision: 4194
Author: edi
URL: http://bknr.net/trac/changeset/4194
Update documentation
U trunk/thirdparty/drakma/CHANGELOG.txt
U trunk/thirdparty/drakma/conditions.lisp
U trunk/thirdparty/drakma/doc/index.html
U trunk/thirdparty/drakma/packages.lisp
Modified: trunk/thirdparty/drakma/CHANGELOG.txt
===================================================================
--- trunk/thirdparty/drakma/CHANGELOG.txt 2009-02-09 09:34:30 UTC (rev 4193)
+++ trunk/thirdparty/drakma/CHANGELOG.txt 2009-02-09 09:57:29 UTC (rev 4194)
@@ -1,3 +1,7 @@
+Version 0.12.0
+2009-02-09
+Use the new ("binary") version of Chunga
+Added conditions types
Added *ALLOW-DOTLESS-COOKIE-DOMAINS-P* (thanks to Daniel Janus)
Fix generation of user agent header (bug caught by Chaitanya Gupta)
Modified: trunk/thirdparty/drakma/conditions.lisp
===================================================================
--- trunk/thirdparty/drakma/conditions.lisp 2009-02-09 09:34:30 UTC (rev 4193)
+++ trunk/thirdparty/drakma/conditions.lisp 2009-02-09 09:57:29 UTC (rev 4194)
@@ -58,7 +58,7 @@
(define-condition parameter-error (drakma-simple-error)
()
- (:documentation "Signalled if a function was called with incosistent or illegal parameters."))
+ (:documentation "Signalled if a function was called with inconsistent or illegal parameters."))
(defun parameter-error (format-control &rest format-arguments)
"Signals an error of type PARAMETER-ERROR with the provided
Modified: trunk/thirdparty/drakma/doc/index.html
===================================================================
--- trunk/thirdparty/drakma/doc/index.html 2009-02-09 09:34:30 UTC (rev 4193)
+++ trunk/thirdparty/drakma/doc/index.html 2009-02-09 09:57:29 UTC (rev 4194)
@@ -96,6 +96,17 @@
<li><a href="#parameter-value"><code>parameter-value</code></a>
<li><a href="#get-content-type"><code>get-content-type</code></a>
</ol>
+ <li><a href="#conditions">Conditions</a>
+ <ol>
+ <li><a href="#drakma-condition"><code>drakma-condition</code></a>
+ <li><a href="#drakma-error"><code>drakma-error</code></a>
+ <li><a href="#drakma-warning"><code>drakma-warning</code></a>
+ <li><a href="#syntax-error"><code>syntax-error</code></a>
+ <li><a href="#parameter-error"><code>parameter-error</code></a>
+ <li><a href="#cookie-error"><code>cookie-error</code></a>
+ <li><a href="#cookie-error-cookie"><code>cookie-error-cookie</code></a>
+ <li><a href="#cookie-date-parse-error"><code>cookie-date-parse-error</code></a>
+ </ol>
</ol>
<li><a href="#prob">Potential problems</a>
<li><a href="#ack">Acknowledgements</a>
@@ -643,7 +654,7 @@
Drakma together with this documentation can be downloaded
from <a href="http://weitz.de/files/drakma.tar.gz">http://weitz.de/files/drakma.tar.gz</a>.
-The current version is 0.11.5. Drakma can be installed
+The current version is 0.12.0. Drakma can be installed
via <a href="http://www.cliki.net/asdf">ASDF</a> and depends on the
open source
libraries <a href="http://www.cliki.net/cl-base64">CL-BASE64</a> (use
@@ -1284,6 +1295,8 @@
Whether Drakma is allowed to treat <code>Expires</code> dates in
cookie headers as non-existent if it can't parse them. If the value
of this variable is <code>NIL</code> (which is the default), an error
+of
+type <a href="#cookie-date-parse-error"><code>COOKIE-DATE-PARSE-ERROR</code></a>
will be signalled instead.
<p>
Note that Drakma tries hard to parse every date representation its
@@ -1451,6 +1464,109 @@
<!-- End of entry for GET-CONTENT-TYPE -->
+<h4><a name="conditions" class=none>Conditions</a></h4>
+
+This section lists all the condition types that are defined by Drakma.
+
+<!-- Entry for DRAKMA-CONDITION -->
+
+<p><br>[Condition]
+<br><a class=none name="drakma-condition"><b>drakma-condition</b></a>
+
+<blockquote><br>
+All conditions signalled by Drakma are of this type. This is a subtype of <a href="http://www.lispworks.com/documentation/HyperSpec/Body/e_cnd.htm"><code>CONDITION</code></a>.
+</blockquote>
+
+<!-- End of entry for DRAKMA-CONDITION -->
+
+<!-- Entry for DRAKMA-ERROR -->
+
+<p><br>[Error]
+<br><a class=none name="drakma-error"><b>drakma-error</b></a>
+
+<blockquote><br>
+All errors signalled by Drakma are of this type. This is a subtype of <a href="#drakma-condition"><code>DRAKMA-CONDITION</code></a> and of <a href="http://www.lispworks.com/documentation/HyperSpec/Body/e_error.htm"><code>ERROR</code></a>.
+</blockquote>
+
+<!-- End of entry for DRAKMA-ERROR -->
+
+<!-- Entry for DRAKMA-WARNING -->
+
+<p><br>[Warning]
+<br><a class=none name="drakma-warning"><b>drakma-warning</b></a>
+
+<blockquote><br>
+All warnings signalled by Drakma are of this type. This is a subtype of <a href="#drakma-condition"><code>DRAKMA-CONDITION</code></a> and of <a href="http://www.lispworks.com/documentation/HyperSpec/Body/e_warnin.htm"><code>WARNING</code></a>.
+</blockquote>
+
+<!-- End of entry for DRAKMA-WARNING -->
+
+<!-- Entry for SYNTAX-ERROR -->
+
+<p><br>[Error]
+<br><a class=none name="syntax-error"><b>syntax-error</b></a>
+
+<blockquote><br> An error of this type is signalled if Drakma
+encounters wrong or unknown syntax when reading the reply from the
+server. This is a subtype
+of <a href="#drakma-error"><code>DRAKMA-ERROR</code></a>.
+</blockquote>
+
+<!-- End of entry for SYNTAX-ERROR -->
+
+<!-- Entry for PARAMETER-ERROR -->
+
+<p><br>[Error]
+<br><a class=none name="parameter-error"><b>parameter-error</b></a>
+
+<blockquote><br> An error of this type is signalled if a function was
+called with inconsistent or illegal parameters. This is a subtype
+of <a href="#drakma-error"><code>DRAKMA-ERROR</code></a>.
+</blockquote>
+
+<!-- End of entry for PARAMETER-ERROR -->
+
+<!-- Entry for COOKIE-ERROR -->
+
+<p><br>[Error]
+<br><a class=none name="cookie-error"><b>cookie-error</b></a>
+
+<blockquote><br> An error of this type is signalled in case of an
+attempt to create a <a href="#cookie"><code>COOKIE</code></a> object
+that's not valid. This is a subtype
+of <a href="#drakma-error"><code>DRAKMA-ERROR</code></a>. The
+condition object contains a <code><i>cookie</i></code> slot which can be accessed with the
+<a href="#cookie-error-cookie"><code>COOKIE-ERROR-COOKIE</code></a> reader. Note that the content of this slot can be
+<code>NIL</code> if the cookie couldn't be initialized.
+</blockquote>
+
+<!-- End of entry for COOKIE-ERROR -->
+
+<p><br>[Reader]
+<br><a class=none name="cookie-error-cookie"><b>cookie-error-cookie</b> <i>error</i> => <i>cookie-or-nil</i></a>
+
+<blockquote><br> If <code><i>error</i></code> is of
+type <a href="#cookie-error"><code>COOKIE-ERROR</code></a>, this
+function will return the associated invalid cookie or <code>NIL</code> if the
+cookie couldn't be created.
+</blockquote>
+
+<!-- Entry for COOKIE-DATE-PARSE-ERROR -->
+
+<p><br>[Error]
+<br><a class=none name="cookie-date-parse-error"><b>cookie-date-parse-error</b></a>
+
+<blockquote><br> An error of this type is signalled if Drakma tried to
+parse the date of an incoming cookie header and can't interpret it.
+This is a subtype
+of <a href="#cookie-error"><code>COOKIE-ERROR</code></a>.
+<p>
+See also <a href="#*ignore-unparseable-cookie-dates-p*"><code>*IGNORE-UNPARSEABLE-COOKIE-DATES-P*</code></a>.
+</blockquote>
+
+<!-- End of entry for COOKIE-DATE-PARSE-ERROR -->
+
+
<br> <br><h3><a class=none name="prob">Potential problems</a></h3>
Some web servers (notably <a href="http://paulgraham.com/">Paul Graham</a>'s
Modified: trunk/thirdparty/drakma/packages.lisp
===================================================================
--- trunk/thirdparty/drakma/packages.lisp 2009-02-09 09:34:30 UTC (rev 4193)
+++ trunk/thirdparty/drakma/packages.lisp 2009-02-09 09:57:29 UTC (rev 4194)
@@ -42,6 +42,7 @@
:cookie
:cookie-error
:cookie-error-cookie
+ :cookie-date-parse-error
:cookie-domain
:cookie-expires
:cookie-http-only-p
@@ -63,4 +64,5 @@
:parameter-present-p
:parameter-value
:read-tokens-and-parameters
- :split-tokens))
+ :split-tokens
+ :syntax-error))
More information about the Bknr-cvs
mailing list