Subject: [Boost-commit] svn:boost r54280 - trunk/libs/spirit/doc
From: hartmut.kaiser_at_[hidden]
Date: 2009-06-23 11:22:16
Author: hkaiser
Date: 2009-06-23 11:22:15 EDT (Tue, 23 Jun 2009)
New Revision: 54280
URL: http://svn.boost.org/trac/boost/changeset/54280
Log:
Spirit: Added FAQ entry wrt DBOOST_SPIRIT_DONT_USE_MPL_ASSERT_MSG
Text files modified:
trunk/libs/spirit/doc/faq.qbk | 22 ++++++++++++++++++++++
trunk/libs/spirit/doc/spirit2.qbk | 2 +-
2 files changed, 23 insertions(+), 1 deletions(-)
Modified: trunk/libs/spirit/doc/faq.qbk
==============================================================================
--- trunk/libs/spirit/doc/faq.qbk (original)
+++ trunk/libs/spirit/doc/faq.qbk 2009-06-23 11:22:15 EDT (Tue, 23 Jun 2009)
@@ -8,6 +8,28 @@
[section FAQ]
+[heading I'm getting multiple symbol definition errors while using Visual C++. Anything I could do about that?]
+
+Do you see strange multiple symbol definition linker errors mentioning
+`boost::mpl::failed` and `boost::spirit::qi::rule`? Then this FAQ entry might
+be for you.
+
+__mpl__ implements a macro `BOOST_MPL_ASSERT_MSG()` which essentially is a
+more powerfull version of static_assert. Unfortunately under certain
+circumstances using this macro may lead to the aformentioned linker errors.
+
+__spirit__ allows you to define a preprocessor constant disabling the usage
+of `BOOST_MPL_ASSERT_MSG()`, while switching to `BOOST_STATIC_ASSRT()` instead.
+If you define BOOST_SPIRIT_DONT_USE_MPL_ASSERT_MSG=1 (either by adding a
+`-DBOOST_SPIRIT_DONT_USE_MPL_ASSERT_MSG=1` on the compiler command line or by
+inserting a `#define BOOST_SPIRIT_DONT_USE_MPL_ASSERT_MSG 1` into your code
+before any spirit headers get included).
+
+Using this trick has no adverse effects on any of the functionality of
+__spirit__. The only change you might see while using this workaround are less
+verbose error messages generated from static_assert.
+
+
[heading I'm very confused about the header hell in my boost/spirit directory. What's all this about?]
The boost/spirit directory currently holds two versions of the Spirit library:
Modified: trunk/libs/spirit/doc/spirit2.qbk
==============================================================================
--- trunk/libs/spirit/doc/spirit2.qbk (original)
+++ trunk/libs/spirit/doc/spirit2.qbk 2009-06-23 11:22:15 EDT (Tue, 23 Jun 2009)
@@ -28,7 +28,7 @@
[def __phoenix__ [@../../phoenix/doc/html/index.html Phoenix]]
[def __phoenix2__ [@../../phoenix/doc/html/index.html Phoenix2]]
[def __fusion__ [@http://spirit.sourceforge.net/dl_more/fusion_v2/libs/fusion/doc/html/index.html Fusion]]
-[def __mpl__ [@http://www.boost.org/libs/mpl/index.html MPL]]
+[def __mpl__ [@http://www.boost.org/libs/mpl/index.html Boost.Mpl]]
[def __boost__ [@http://www.boost.org/ Boost]]
[def __boost_tools__ [@http://www.boost.org/tools/index.html Boost Tools]]
[def __spirit_list__ [@https://lists.sourceforge.net/lists/listinfo/spirit-general Spirit Mailing List]]