Re: [Boost-build] build of documentation broken for HEAD?

From: Vladimir Prus (ghost_at_[hidden])
Date: 2006-12-29 11:57:44

On Friday 29 December 2006 02:23, Joel de Guzman wrote:

[follow-ups to the list, please]

> Roland Schwarz wrote:
> > When I try to build the documentation from
> > BOOST_ROOT/doc
> > by invoking bjam I get:
> > 
> > error: Unable to find file or target named
> > error:     'object(file-target)@1153'
> > error: referred from project at
> > error:     '/home/roland/projects/boost/HEAD/tools/quickbook'
> > 
> > The same works for RC_134_0
> > 
> > What I am missing?
> > 
> > My user-config.jam:
> > 
> > using boostbook
> >    : /usr/share/xml/docbook/stylesheet/nwalsh
> >    : /usr/share/xml/docbook/schema/dtd/4.2
> >    ;
> > 
> > using xsltproc : /usr/bin/xsltproc ;
> > 
> > using doxygen : /usr/bin/doxygen ;
> > 
> > using fop : /usr/bin/fop : : /usr/lib/jvm/java-1.5.0-sun-1.5.0.08 ;
> 
> Confirmed. Rene helped me investigate on the problem.
> We think that the build logic that tries to build quickbook is
> broken somehow. I could build quickbook just fine from 
> tools/quickbook/Jamfile.v2. Unfortunately, Joao, the author is
> not around ATM. I'm CC'ing Volodya. Perhaps he has some ideas
> on how it can be fixed.

Heh, to begin with, binary search in time indicates that doc generation
was broken since this checkin:

--- libs/xpressive/doc/Jamfile.v2       17 Apr 2006 19:47:33 -0000      1.9
+++ libs/xpressive/doc/Jamfile.v2       22 Oct 2006 03:28:00 -0000      1.10
@@ -25,6 +25,8 @@ doxygen autodoc
 xml xpressive
     :
         xpressive.qbk
+    :
+        <dependency>autodoc
     ;

Similar things were checked in MPI docs, and maybe others.

Looking at the code, I see where the problem comes from, and it looks more
like V2 that a quickbook support issue. I'll take a look at it, but a fix is not
likely to be checked in before Jan 4.

- Volodya