1Spirit
2======
3
4Spirit is a set of C++ libraries for parsing and output generation implemented as
5Domain Specific Embedded Languages (DSEL) using Expression templates and Template
6Meta-Programming. The Spirit libraries enable a target grammar to be written
7exclusively in C++. Inline grammar specifications can mix freely with other
8C++ code and, thanks to the generative power of C++ templates, are immediately
9executable.
10
11### Spirit.X3 (3rd generation)
12
13[Documentation](http://www.boost.org/doc/libs/develop/libs/spirit/doc/x3/html/index.html)
14
15The newest Spirit shines faster compile times. Currently only a parser framework.
16
17Requires C++14 compiler (GCC 5, Clang 3.6, VS 2015 Update 3).
18
19### Spirit V2 (2nd generation)
20
21[Documentation](http://www.boost.org/doc/libs/develop/libs/spirit/doc/html/index.html)
22
23The latest Long Term Support version of Spirit. A Swiss Army knife for data
24manipulation on any kind of input.
25
26Consists of:
27  - [Qi]: Parser framework.
28  - [Karma]: Generator framework.
29  - [Lex]: Lexical analyzer framework.
30
31Runs on most C++03 compilers (GCC 4.1, Clang 3.0, VS 2005).
32
33[Spirit V2]: http://www.boost.org/doc/libs/develop/libs/spirit/doc/html/index.html
34[Qi]: http://www.boost.org/doc/libs/develop/libs/spirit/doc/html/spirit/qi.html
35[Karma]: http://www.boost.org/doc/libs/develop/libs/spirit/doc/html/spirit/karma.html
36[Lex]: http://www.boost.org/doc/libs/develop/libs/spirit/doc/html/spirit/lex.html
37
38### Spirit.Classic (1st generation)
39
40[Documentation](http://www.boost.org/doc/libs/develop/libs/spirit/classic/index.html)
41
42An elderling member of Spirit. It receives only limited maintanance, but
43it is still used even inside Boost by [Boost.Serialization] and [Boost.Wave]
44libraries. It also contains Phoenix V1.
45
46Spririt.Classic should support even ancient compilers.
47
48[Boost.Serialization]: http://boost.org/libs/serialization
49[Boost.Wave]: http://boost.org/libs/wave
50
51## Brief History
52
53Date       | Boost | Commit   | Event
54---------- | ----- | -------- | -----------------------------------------------
552014-03-18 | 1.56  | 8a353328 | Spirit.X3 is added
562013-12-14 | 1.56  | c0537c82 | Phoenix V2 is retired
572011-03-28 | 1.47  | 400a764d | [Phoenix V3] support added to Spirit V2
582009-04-30 | 1.41  | 5963a395 | [Spirit.Repository] is appeared
592008-04-13 | 1.36  | ffd0cc10 | Spirit V2 (Qi, Karma, Lex, Phoenix V2) is added
602006-08-23 | 1.35  | 2dc892b4 | Fusion V1 is retired
612003-01-31 | 1.30  | 81907916 | Spirit is the part of the Boost
62
63[Phoenix V3]: http://boost.org/libs/phoenix
64[Spirit.Repository]: http://www.boost.org/doc/libs/develop/libs/spirit/doc/html/spirit/repository.html
65