README
1Alexandria is a collection of portable public domain utilities that
2meet the following constraints:
3
4 * Utilities, not extensions: Alexandria will not contain conceptual
5 extensions to Common Lisp, instead limiting itself to tools and
6 utilities that fit well within the framework of standard ANSI
7 Common Lisp. Test-frameworks, system definitions, logging
8 facilities, serialization layers, etc. are all outside the scope of
9 Alexandria as a library, though well within the scope of Alexandria
10 as a project.
11
12 * Conservative: Alexandria limits itself to what project members
13 consider conservative utilities. Alexandria does not and will not
14 include anaphoric constructs, loop-like binding macros, etc.
15
16 * Portable: Alexandria limits itself to portable parts of Common
17 Lisp. Even apparently conservative and useful functions remain
18 outside the scope of Alexandria if they cannot be implemented
19 portably. Portability is here defined as portable within a
20 conforming implementation: implementation bugs are not considered
21 portability issues.
22
23Homepage:
24
25 http://common-lisp.net/project/alexandria/
26
27Mailing lists:
28
29 http://lists.common-lisp.net/mailman/listinfo/alexandria-devel
30 http://lists.common-lisp.net/mailman/listinfo/alexandria-cvs
31
32Repository:
33
34 git://gitlab.common-lisp.net/alexandria/alexandria.git
35
36Documentation:
37
38 http://common-lisp.net/project/alexandria/draft/alexandria.html
39
40 (To build docs locally: cd doc && make html pdf info)
41
42Patches:
43
44 Patches are always welcome! Please prepare pull requests in
45 gitlab, though we also can pull branches off github.
46
47 Patches should include a commit message that explains what's being
48 done and /why/, and when fixing a bug or adding a feature you should
49 also include a test-case.
50
51Versioning & Changes:
52
53 Be advised that the ALEXANDRIA-1 package is frozen; there are so many
54 existing users that any newly exported symbols are likely to break
55 someone's code.
56 For that reason an ALEXANDRIA-2 package is now open for additions;
57 to make switching over easier it will include all the symbols from
58 ALEXANDRIA-1 as well [just change your (:USE ALEXANDRIA) to
59 (:USE ALEXANDRIA-2) to get the new functions in your package].
60
61 Alexandria will be running 1.x version numbers until ALEXANDRIA-2 is
62 frozen as well; then a 2.0.0 will be released.
63