README 1.87 KB
Newer Older
Nikodemus Siivola's avatar
Nikodemus Siivola committed
1
2
Alexandria is a collection of portable public domain utilities that
meet the following constraints:
Nikodemus Siivola's avatar
Nikodemus Siivola committed
3

Nikodemus Siivola's avatar
Nikodemus Siivola committed
4
5
6
7
8
9
10
11
12
13
14
15
16
 * Utilities, not extensions: Alexandria will not contain conceptual
   extensions to Common Lisp, instead limiting itself to tools and
   utilities that fit well within the framework of standard ANSI
   Common Lisp. Test-frameworks, system definitions, logging
   facilities, serialization layers, etc. are all outside the scope of
   Alexandria as a library, though well within the scope of Alexandria
   as a project.

 * Conservative: Alexandria limits itself to what project members
   consider conservative utilities. Alexandria does not and will not
   include anaphoric constructs, loop-like binding macros, etc.

 * Portable: Alexandria limits itself to portable parts of Common
Michael Stevens's avatar
Michael Stevens committed
17
   Lisp. Even apparently conservative and useful functions remain
Nikodemus Siivola's avatar
Nikodemus Siivola committed
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
   outside the scope of Alexandria if they cannot be implemented
   portably. Portability is here defined as portable within a
   conforming implementation: implementation bugs are not considered
   portability issues.

Homepage:

  http://common-lisp.net/project/alexandria/

Mailing lists:

  http://lists.common-lisp.net/mailman/listinfo/alexandria-devel
  http://lists.common-lisp.net/mailman/listinfo/alexandria-cvs

Repository:

  git://common-lisp.net/projects/alexandria/alexandria.git

Documentation:

  http://common-lisp.net/project/alexandria/draft/alexandria.html

  (To build docs locally: cd doc && make html pdf info)

Patches:

  Patches are always welcome! Please send them to the mailing list as
  attachments, generated by "git format-patch -1".

  Patches should include a commit message that explains what's being
  done and /why/, and when fixing a bug or adding a feature you should
  also include a test-case.

Michael Stevens's avatar
Michael Stevens committed
51
  Be advised though that right now new features are unlikely to be
Nikodemus Siivola's avatar
Nikodemus Siivola committed
52
  accepted until 1.0 is officially out of the door.