3rdparties/software/alexandria-20200427-git/README (2355 bytes)
1 Alexandria is a collection of portable public domain utilities that 2 meet 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 23 Homepage: 24 25 http://common-lisp.net/project/alexandria/ 26 27 Mailing lists: 28 29 http://lists.common-lisp.net/mailman/listinfo/alexandria-devel 30 http://lists.common-lisp.net/mailman/listinfo/alexandria-cvs 31 32 Repository: 33 34 git://gitlab.common-lisp.net/alexandria/alexandria.git 35 36 Documentation: 37 38 http://common-lisp.net/project/alexandria/draft/alexandria.html 39 40 (To build docs locally: cd doc && make html pdf info) 41 42 Patches: 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 51 Versioning & 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.