ceph/src/boost/libs/spirit/README.md

   1 Spirit
   2 ======
   3
   4 Spirit is a set of C++ libraries for parsing and output generation implemented as
   5 Domain Specific Embedded Languages (DSEL) using Expression templates and Template
   6 Meta-Programming. The Spirit libraries enable a target grammar to be written
   7 exclusively in C++. Inline grammar specifications can mix freely with other
   8 C++ code and, thanks to the generative power of C++ templates, are immediately
   9 executable.
  10
  11 ### Spirit.X3 (3rd generation)
  12
  13 [Documentation](http://www.boost.org/doc/libs/develop/libs/spirit/doc/x3/html/index.html)
  14
  15 The newest Spirit shines faster compile times. Currently only a parser framework.
  16
  17 Requires 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
  23 The latest Long Term Support version of Spirit. A Swiss Army knife for data
  24 manipulation on any kind of input.
  25
  26 Consists of:
  27   - [Qi]: Parser framework.
  28   - [Karma]: Generator framework.
  29   - [Lex]: Lexical analyzer framework.
  30
  31 Runs 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
  42 An elderling member of Spirit. It receives only limited maintanance, but
  43 it is still used even inside Boost by [Boost.Serialization] and [Boost.Wave]
  44 libraries. It also contains Phoenix V1.
  45
  46 Spririt.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
  53 Date       | Boost | Commit   | Event
  54 ---------- | ----- | -------- | -----------------------------------------------
  55 2014-03-18 | 1.56  | 8a353328 | Spirit.X3 is added
  56 2013-12-14 | 1.56  | c0537c82 | Phoenix V2 is retired
  57 2011-03-28 | 1.47  | 400a764d | [Phoenix V3] support added to Spirit V2
  58 2009-04-30 | 1.41  | 5963a395 | [Spirit.Repository] is appeared
  59 2008-04-13 | 1.36  | ffd0cc10 | Spirit V2 (Qi, Karma, Lex, Phoenix V2) is added
  60 2006-08-23 | 1.35  | 2dc892b4 | Fusion V1 is retired
  61 2003-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