# Spirit 1.6.2 stand-alone

This package comes bundled with miniboost: a re-packaged minimal subset of boost; just enough to use Spirit.

- 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

## Installing

This package requires at least boost 1.32.0 installed. Boost 1.32.0 and newer already has Spirit pre-installed. This package is a drop-in replacement. Just drop it in and rock and roll :-)

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.

## Running the tests

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

For example, using MSVC 7.1:

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 VC7.1 in the default location.
3. Change (CD) the directory to libs/spirit/test.
4. Call bjam:
   bjam -sTOOLS=vc-7_1 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 7.1, follow the instructions above (Running the tests) except 6. CD to libs/spirit/example instead.

## Notes

- Some examples might require other boost libraries. If this is the case, you'll have to get them.
- 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, which is not distributed together with spirit. You will have to add the boost headers to your include path. You will also need to link with the library and your platform threading library.
- None of the examples are built by default.
- If an example will require a library that you don't have, it will not be built.
- 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 7.1, follow the instructions above (Running the tests) except 6. CD to the appropriate test or example directory instead.