Re: [jamboost] Re: [BBv2] quickbook.jam and boostbook question

From: Vladimir Prus (ghost_at_[hidden])
Date: 2005-01-27 10:30:34

Hi Joao,

> Since I didn't get any answers on my previous post, I hereby reiterate
> my questions.

Sorry that it took so long!

>
> I wrote a quickbook toolset to generate boostbook documentation from
> quickbook sources. The toolset is attached to the original post. I would
> like to propose the addition of the toolset to BB v2, under the tools
> directory. Is this ok?
>
> And a question about the boostbook toolset...
>
> > boostbook.jam defines the BOOSTBOOK type. However, it's generators
> > are defined as XML -> <something>. Given this I found 2 ways to make
> > quickbook work:
> > a) define generator QUICKBOOK -> XML, which leaves me with the
> > feeling that the generator is not sufficiently "typed"...
> >
> > b) define generators BOOSTBOOK -> DOCBOOK (and BOOSTBOOK -> TESTS)
> > and QUICKBOOK -> BOOSTBOOK. This seems better, but I shouldn't
> > be messing with boostbook within the quickbook toolset.

That's right. I suggest that you take the same approach that doxygen.jam uses: 
you declare QUICKBOOK -> BOOSTBOOK generator, but do not define any other 
generator. Instead, you add "import bookbook ; " so that the declaration of 
BOOSTBOOK type is seen. 

> >
> > Are there other alternatives I am missing? How bad could it be to define
> > the generator as QUICKBOOK -> XML?

I don't think that's all that bad. I suggested another variant only because 
it's consistent with doxygen.jam. 

HTH,
Volodya