[thread] Docs don't build on release branch
Hi Anthony, The Jamfile.v2 in libs/thread/doc/ seems to be missing a 'using quickbook ;' I quite like the new organisation. Do you have any idea how stable this API is likely to be though, with it tracking the C++0x standard proposals? Regards, Darren
Darren Garvey <darren.garvey <at> gmail.com> writes:
The Jamfile.v2 in libs/thread/doc/ seems to be missing a 'using quickbook ;'
I didn't realise it needed one: it builds fine here.
I quite like the new organisation. Do you have any idea how stable this API is likely to be though, with it tracking the C++0x standard proposals?
It should be pretty stable. The C++0x API is now in the working paper, so shouldn't be subject to major changes. It's not guaranteed, though: theoretically, the committee could vote to take it all out again at the next meeting. In any case, I intend to try and maintain backwards compatibility in Boost.Thread where possible. Anthony -- Anthony Williams | Just Software Solutions Ltd Custom Software Development | http://www.justsoftwaresolutions.co.uk Registered in England, Company Number 5478976. Registered Office: 15 Carrallack Mews, St Just, Cornwall, TR19 7UL
Anthony Williams wrote:
Darren Garvey <darren.garvey <at> gmail.com> writes:
The Jamfile.v2 in libs/thread/doc/ seems to be missing a 'using quickbook ;'
I didn't realise it needed one: it builds fine here.
Usually, 'using quickbook ; ' is placed in user-config.jam, not in Jamfile. - Volodya
Vladimir Prus <ghost <at> cs.msu.su> writes:
Anthony Williams wrote:
Darren Garvey <darren.garvey <at> gmail.com> writes:
The Jamfile.v2 in libs/thread/doc/ seems to be missing a 'using quickbook ;'
I didn't realise it needed one: it builds fine here.
Usually, 'using quickbook ; ' is placed in user-config.jam, not in Jamfile.
That's where I have it. Am I therefore OK to leave it out of Jamfile.v2 for the thread docs? Anthony -- Anthony Williams | Just Software Solutions Ltd Custom Software Development | http://www.justsoftwaresolutions.co.uk Registered in England, Company Number 5478976. Registered Office: 15 Carrallack Mews, St Just, Cornwall, TR19 7UL
Anthony Williams wrote:
Vladimir Prus <ghost <at> cs.msu.su> writes:
Anthony Williams wrote:
Darren Garvey <darren.garvey <at> gmail.com> writes:
The Jamfile.v2 in libs/thread/doc/ seems to be missing a 'using quickbook ;'
I didn't realise it needed one: it builds fine here.
Usually, 'using quickbook ; ' is placed in user-config.jam, not in Jamfile.
That's where I have it. Am I therefore OK to leave it out of Jamfile.v2 for the thread docs?
I think so. Further, given that I personally have configure quickbook with a specific binary in my user-config.jam (to avoid waiting 5 mins for quickbook to recompile), adding default 'using quickbook ;' to Jamfile will be actually bad thing. - Volodya
On 19/03/2008, Vladimir Prus <ghost@cs.msu.su> wrote:
Anthony Williams wrote:
Vladimir Prus <ghost <at> cs.msu.su> writes:
Usually, 'using quickbook ; ' is placed in user-config.jam, not in Jamfile.
That's where I have it. Am I therefore OK to leave it out of Jamfile.v2for the thread docs?
I think so. Further, given that I personally have configure quickbook with a specific binary in my user-config.jam (to avoid waiting 5 mins for quickbook to recompile), adding default 'using quickbook ;' to Jamfile will be actually bad thing.
I didn't realise you could override user-config.jam bits like this. An 'import quickbook ;' would still help for those of us without a 'using quickbook ;' in our user-config.jam though, wouldn't it? -- Darren
Vladimir Prus wrote:
Anthony Williams wrote:
Darren Garvey <darren.garvey <at> gmail.com> writes:
The Jamfile.v2 in libs/thread/doc/ seems to be missing a 'using quickbook ;'
I didn't realise it needed one: it builds fine here.
Usually, 'using quickbook ; ' is placed in user-config.jam, not in Jamfile.
Right, there should be a: import quickbook ; in the Jamfile though? John.
John Maddock wrote:
Vladimir Prus wrote:
Anthony Williams wrote:
Darren Garvey <darren.garvey <at> gmail.com> writes:
The Jamfile.v2 in libs/thread/doc/ seems to be missing a 'using quickbook ;'
I didn't realise it needed one: it builds fine here.
Usually, 'using quickbook ; ' is placed in user-config.jam, not in Jamfile.
Right, there should be a:
import quickbook ;
in the Jamfile though?
Adding import quickbook ; will make it sure that Jamfile will be parsed without errors. But given that doc/Jamfile is only parsed if you're building docs, you better have 'using quickbook' somewhere. - Volodya
Vladimir Prus wrote:
Adding
import quickbook ;
will make it sure that Jamfile will be parsed without errors. But given that doc/Jamfile is only parsed if you're building docs, you better have 'using quickbook' somewhere.
No with no "using quickbook ;" then quickbook gets built from source. John.
John Maddock wrote:
Vladimir Prus wrote:
Adding
import quickbook ;
will make it sure that Jamfile will be parsed without errors. But given that doc/Jamfile is only parsed if you're building docs, you better have 'using quickbook' somewhere.
No with no "using quickbook ;" then quickbook gets built from source.
Yes (by accident/historical reasons, but anyway). Maybe, somebody can add it to Jamroot, so that it's not necessary to add to <each-library/doc/Jamfile.v2 ? - Volodya
participants (4)
-
Anthony Williams -
Darren Garvey -
John Maddock -
Vladimir Prus