r10883: update policy
[puri.git] / README
1 PURI - Portable URI Library
2 ===========================
3
4 AUTHORS
5 -------
6 Franz, Inc <http://www.franz.com>
7 Kevin Rosenberg <kevin@rosenberg.net>
8
9
10 DOWNLOAD
11 --------
12 Puri home: http://files.b9.com/puri/
13 Portable tester home: http://files.b9.com/tester/
14
15
16 SUPPORTED PLATFORMS
17 -------------------
18    AllegroCL, CLISP, CMUCL, Lispworks, OpenMCL, SBCL
19
20
21 OVERVIEW
22 --------
23 This is portable Universal Resource Identifier library for Common Lisp
24 programs. It parses URI according to the RFC 2396 specification. It's
25 is based on Franz, Inc's opensource URI package and has been ported to
26 work other CL implementations. It is licensed under the LLGPL which
27 is included in this distribution.
28
29 A regression suite is included which uses Franz's open-source tester
30 library. I've ported that library for use on other CL
31 implementations. Puri completes 126/126 regression tests successfully.
32
33 Franz's unmodified documentation file is included in the file
34 uri.html. 
35
36
37 DIFFERENCES BETWEEN PURI and NET.URI
38 ------------------------------------
39
40 * Puri uses the package 'puri while NET.URI uses the package 'net.uri
41
42 * To signal an error parsing a URI, Puri uses the condition
43   :uri-parse-error while NET.URI uses the condition :parse-error. This
44   divergence occurs because Franz's parse-error condition uses
45   :format-control and :format-arguments slots which are not in the ANSI
46   specification for the parse-error condition.