[spirit] spirit2 PDF docs.

While trying to build the PDF's of the spirit2 quickbook documentation I've noticed a few SNAFU's: 1) In the release branch, the docs don't currently build: quickbook.quickbook-to-boostbook ..\..\bin.v2\libs\spirit\doc\msvc-9.0\debug\threading-multi\spirit2.xml Generating Output File: ..\..\bin.v2\libs\spirit\doc\msvc-9.0\debug\threading-multi\spirit2.xml d:/data/boost/branches/release/doc/pdf/../../libs/spirit/doc/qi_and_karma/../../example/qi/mini_xml3.cpp:133: error: Template Redefinition: tutorial_xml3_grammar IMO there's no need to fix this for the release, but if there's an easy fix I can apply locally, then I'll include spirit2 in the PDF doc build. 2) In trunk, there are some unresolved internal links: Making portrait pages on A4 paper (210mmx297mm) Error: no ID for constraint linkend: spirit.qi_and_karma.abstracts.attributes. XLink to nonexistent id: spirit.qi_and_karma.abstracts.attributes Error: no ID for constraint linkend: spirit.qi_and_karma.abstracts.parsing_and_generating.the_tokenize_and_phrase_parse___function. XLink to nonexistent id: spirit.qi_and_karma.abstracts.parsing_and_generating.the_tokenize_and_phrase_parse___function Error: no ID for constraint linkend: spirit.lex.lexer_tokenizing.the_generate_static_function. XLink to nonexistent id: spirit.lex.lexer_tokenizing.the_generate_static_function 3) I've also committed some minor fixes to the Jamfiles in Trunk to get the PDF's building from within doc/pdf OK: see https://svn.boost.org/trac/boost/changeset/55798/trunk Cheers, John.

While trying to build the PDF's of the spirit2 quickbook documentation I've noticed a few SNAFU's:
1) In the release branch, the docs don't currently build:
quickbook.quickbook-to-boostbook ..\..\bin.v2\libs\spirit\doc\msvc-9.0\debug\threading-multi\spirit2.xml Generating Output File: ..\..\bin.v2\libs\spirit\doc\msvc-9.0\debug\threading-multi\spirit2.xml d:/data/boost/branches/release/doc/pdf/../../libs/spirit/doc/qi_and_kar ma/../../example/qi/mini_xml3.cpp:133: error: Template Redefinition: tutorial_xml3_grammar
IMO there's no need to fix this for the release, but if there's an easy fix I can apply locally, then I'll include spirit2 in the PDF doc build.
That's something Joel must answer.
2) In trunk, there are some unresolved internal links:
Making portrait pages on A4 paper (210mmx297mm) Error: no ID for constraint linkend: spirit.qi_and_karma.abstracts.attributes. XLink to nonexistent id: spirit.qi_and_karma.abstracts.attributes Error: no ID for constraint linkend: spirit.qi_and_karma.abstracts.parsing_and_generating.the_tokenize_and_p hrase_parse___function. XLink to nonexistent id: spirit.qi_and_karma.abstracts.parsing_and_generating.the_tokenize_and_p hrase_parse___function Error: no ID for constraint linkend: spirit.lex.lexer_tokenizing.the_generate_static_function. XLink to nonexistent id: spirit.lex.lexer_tokenizing.the_generate_static_function
We're aware of this. The docs are currently being worked on and we'll fix those glitches before the next release.
3) I've also committed some minor fixes to the Jamfiles in Trunk to get the PDF's building from within doc/pdf OK: see https://svn.boost.org/trac/boost/changeset/55798/trunk
Thanks! Regards Hartmut

John Maddock wrote:
While trying to build the PDF's of the spirit2 quickbook documentation I've noticed a few SNAFU's:
1) In the release branch, the docs don't currently build:
quickbook.quickbook-to-boostbook ..\..\bin.v2\libs\spirit\doc\msvc-9.0\debug\threading-multi\spirit2.xml Generating Output File: ..\..\bin.v2\libs\spirit\doc\msvc-9.0\debug\threading-multi\spirit2.xml d:/data/boost/branches/release/doc/pdf/../../libs/spirit/doc/qi_and_karma/../../example/qi/mini_xml3.cpp:133: error: Template Redefinition: tutorial_xml3_grammar
IMO there's no need to fix this for the release, but if there's an easy fix I can apply locally, then I'll include spirit2 in the PDF doc build.
I'd rather leave spirit for now. See below.
2) In trunk, there are some unresolved internal links:
We are working hard to finally release spirit2 with Boost 1.41. Right now, the docs are in constant flux. I wouldn't bother having PDFs for them for now. I'll send you a message once we reach a stable state with the documentation. Regards, -- Joel de Guzman http://www.boostpro.com http://spirit.sf.net

We are working hard to finally release spirit2 with Boost 1.41. Right now, the docs are in constant flux. I wouldn't bother having PDFs for them for now. I'll send you a message once we reach a stable state with the documentation.
OK thanks, I saw the docs were present in the release branch, so thought I should at least try to build them... if 1.41 is OK with you then it's one less thing to fix for me too :-) John.

John Maddock wrote:
We are working hard to finally release spirit2 with Boost 1.41. Right now, the docs are in constant flux. I wouldn't bother having PDFs for them for now. I'll send you a message once we reach a stable state with the documentation.
OK thanks, I saw the docs were present in the release branch, so thought I should at least try to build them... if 1.41 is OK with you then it's one less thing to fix for me too :-)
And before anything else, I have to say: Thank you, John! Regards, -- Joel de Guzman http://www.boostpro.com http://spirit.sf.net
participants (3)
-
Hartmut Kaiser
-
Joel de Guzman
-
John Maddock