Re: [Boost-docs] Quick script for quickbook builds?

Subject: Re: [Boost-docs] Quick script for quickbook builds?
From: John Maddock (john_at_[hidden])
Date: 2008-08-22 08:42:12

Daryle Walker wrote:
> On Aug 19, 2008, at 4:54 PM, Eric Niebler wrote:
>
>> Daryle Walker wrote:
>>> Is there a quick script out there I can stick in my XCode (2.5,
>>> still on Mac OS X 10.4) project file, under a run-script phase,
>>> that can convert a *.qbk file to an HTML file?  In other words, I
>>> want to "compile" any QuickBook files so I can check my progress
>>> without a big trip to the command line and messing around with bjam.
>>
>> None that I'm aware of, but if you make such a thing I'm sure
>> others would find it useful.
>
>
> The point was for someone else to do it for me, but....
>
> I read up on how files with a specific extension that don't have a
> default compiler assigned to them can get one, and how said custom
> compiler can be a user-developed script program.  So I added the
> QuickBook sources to my project (and the ones for Boost.FileSystem,
> System, and ProgramOptions) to make the tool.  Then I added a rule
> for *.qbk files to run a single-line script to create a corresponding
> *.qbk.xml file.
>
> I added another rule to convert that file (trivially) to a *.txt
> file.  But what really want to do is convert that *.qbk.xml file,
> which is in BoostBook format, into a *.html (or *.pdf) file.  There's
> a Boost.Build/Jam procedure for doing this, but how do I do it
> manually?  In other words, does someone know what the command line
> instructions that the Jamfiles are converted to?  I think there's a
> verbose mode for bJam, but I don't think that will help since I've
> never been able to get the documentation building stuff working.

Take a look at: 
http://svn.boost.org/trac/boost/browser/sandbox/math_toolkit/libs/math/doc/sf_and_dist/win32_nmake.mak 
as an example of the command lines involved.

HTH, John.