Spirit 1.8.5 with miniboost

This package comes bundled with a minimal subset of boost; just enough to use Spirit.

Note: In this release there is no separate miniboost directory, unlike the previous 1.8.x releases. This is an actual subset of the proper Boost distribution, containing all the headers and libraries required to use Spirit, run the regression tests and build the examples.

Historically, Spirit supported a lot of compilers, including (to some extent) poorly conforming compilers such as VC6. Spirit v1.6.x will be the last release that will support older poorly conforming compilers. Starting from Spirit v1.8.0, ill conforming compilers will not be supported. If you are still using one of these older compilers, you can still use Spirit v1.6.x.

• The docs for Spirit are located in the libs/spirit/doc subdirectory.
• The library is under the boost subdirectory.
• The examples are in libs/spirit/example
• The test suite is in libs/spirit/test.
• The Spirit homepage is http://spirit.sourceforge.net/
• Questions, comments, complaints, bug-fixes? Please send them to the Spirit mailing list: spirit-general@lists.sourceforge.net

Running the tests

The testsuite can be executed by using the Boost.Build v.2 system as described on the Boost pages: http://www.boost.org.

For example, using MSVC 8.0:

1. Download a prebuilt executable of bjam.exe. Put it somewhere in your path.
2. With the latest Boost Build, you don't have to configure the tool if you installed VC8.0 in the default location. Note , however, that MSVC 8.0 Express requires the Platform SDK from Microsoft. See the boost documentation.
3. Change (CD) the directory to libs/spirit/test.
4. Call bjam:
   
   bjam toolset=msvc-8.0 test

Note: Some compilers may not be able to compile all of the tests and examples.

Using the library

There are no libraries to build, Spirit is a header-only library. Simply point your compiler's include path to the spirit directory. The library is under the boost subdirectory

Building the examples

The examples can be built by using the Boost.Build system as described on the Boost pages: http://www.boost.org.

For example, using MSVC 8.0, follow the instructions above (Running the tests) except 3. CD to libs/spirit/example instead.

Notes

• If you want to build spirit as thread safe, you have to define the BOOST_SPIRIT_THREADSAFE macro. If that's the case, Spirit uses the boost thread library.
• Some compilers may not be able to compile all of the tests and examples.

Phoenix

Phoenix is a stand alone library that comes bundled in this distribution. If you wish to build the examples and run the testsuites for this library, the process is similar to what was outlined above. For example, using MSVC 8.0, follow the instructions above (Running the tests) except 3. CD to the appropriate test or example directory instead.