[boost] [spirit] spirit2 PDF docs.

Subject: [boost] [spirit] spirit2 PDF docs.
From: John Maddock (john_at_[hidden])
Date: 2009-08-27 08:42:52

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.