[release] nightly generated docs?
Once upon a time, Boost's docs were built nightly and publicly hosted. Have we fallen out of that practice? Beman, have you tried building the documentation for the release yet? It'd be nice to get a regular build going again so we can work any kinks out of the system. Any volunteers? -- Eric Niebler BoostPro Computing http://www.boostpro.com
Eric Niebler wrote:
Once upon a time, Boost's docs were built nightly and publicly hosted. Have we fallen out of that practice? Beman, have you tried building the documentation for the release yet? It'd be nice to get a regular build going again so we can work any kinks out of the system. Any volunteers?
A release snapshot is still being built every night. See http://boost.cowic.de/rc/ There is a link to the snapshot on http://beta.boost.org/development/testing.html I haven't actually looked at the contents in quite a while. From the file sizes, it looks like the Windows flavors aren't complete. Since the latest release tests are looking plenty good enough to ship a beta, my focus this coming week will shift in that direction. Thanks, --Beman
Beman Dawes wrote:
Eric Niebler wrote:
Once upon a time, Boost's docs were built nightly and publicly hosted. Have we fallen out of that practice? Beman, have you tried building the documentation for the release yet? It'd be nice to get a regular build going again so we can work any kinks out of the system. Any volunteers?
A release snapshot is still being built every night.
See http://boost.cowic.de/rc/ <snip>
OK, this helps. I'll download the snapshot and inspect my docs. But it would be much easier all around if the nightly generated docs were hosted online someplace, like they used to be. Thanks, -- Eric Niebler BoostPro Computing http://www.boostpro.com
Beman Dawes wrote:
Eric Niebler wrote:
Once upon a time, Boost's docs were built nightly and publicly hosted. <snip.
A release snapshot is still being built every night.
See http://boost.cowic.de/rc/ <snip>
Sorry Beman, but it looks to me like the docs are not being built for these snapshots. At least, I just downloaded: http://boost.cowic.de/rc/boost-posix-2008-07-20.tar.bz2 And in that snapshot, the docs have not been built. Try navigating to the docs for accumulators, foreach or xpressive ... they're not there. I haven't checked the other snapshots. -- Eric Niebler BoostPro Computing http://www.boostpro.com
Eric Niebler wrote:
Beman Dawes wrote:
Eric Niebler wrote:
Once upon a time, Boost's docs were built nightly and publicly hosted. <snip.
A release snapshot is still being built every night.
See http://boost.cowic.de/rc/ <snip>
Sorry Beman, but it looks to me like the docs are not being built for these snapshots. At least, I just downloaded:
http://boost.cowic.de/rc/boost-posix-2008-07-20.tar.bz2
And in that snapshot, the docs have not been built. Try navigating to the docs for accumulators, foreach or xpressive ... they're not there. I haven't checked the other snapshots.
Grrr... It will be a day or two before I can check this out. Tomorrow looks really busy. Thanks, --Beman
Eric Niebler wrote:
Beman Dawes wrote:
Eric Niebler wrote:
Once upon a time, Boost's docs were built nightly and publicly hosted. <snip.
A release snapshot is still being built every night.
See http://boost.cowic.de/rc/ <snip>
Sorry Beman, but it looks to me like the docs are not being built for these snapshots. At least, I just downloaded:
http://boost.cowic.de/rc/boost-posix-2008-07-20.tar.bz2
And in that snapshot, the docs have not been built. Try navigating to the docs for accumulators, foreach or xpressive ... they're not there. I haven't checked the other snapshots.
The doc build is failing:
cd doc bjam --version Boost.Build V2 (Milestone 12) Boost.Jam 03.1.16 bjam warning: Graph library does not contain optional GraphML reader. note: to enable GraphML support, set EXPAT_INCLUDE and EXPAT_LIBPATH to the note: directories containing the Expat headers and libraries, respectively. warning: skipping optional Message Passing Interface (MPI) library. note: to enable MPI support, add "using mpi ;" to user-config.jam. note: to suppress this message, pass "--without-mpi" to bjam. note: otherwise, you can safely ignore this message. Building Boost.Regex with the optional Unicode/ICU support disabled. Please refer to the Boost.Regex documentation for more information (don't panic: this is a strictly optional feature). error: Unable to find file or target named error: 'object(file-target)@3310' error: referred from project at error: '/D:/boost/release/tools/quickbook'
I don't know anything about quickbook, so help is needed to debug this failure. Thanks, --Beman
Beman Dawes wrote:
The doc build is failing:
cd doc bjam --version Boost.Build V2 (Milestone 12) Boost.Jam 03.1.16 bjam warning: Graph library does not contain optional GraphML reader. note: to enable GraphML support, set EXPAT_INCLUDE and EXPAT_LIBPATH to the note: directories containing the Expat headers and libraries, respectively. warning: skipping optional Message Passing Interface (MPI) library. note: to enable MPI support, add "using mpi ;" to user-config.jam. note: to suppress this message, pass "--without-mpi" to bjam. note: otherwise, you can safely ignore this message. Building Boost.Regex with the optional Unicode/ICU support disabled. Please refer to the Boost.Regex documentation for more information (don't panic: this is a strictly optional feature). error: Unable to find file or target named error: 'object(file-target)@3310' error: referred from project at error: '/D:/boost/release/tools/quickbook'
I don't know anything about quickbook, so help is needed to debug this failure.
I see the same error when building from doc/. Strangely, I can build quickbook from tools/quickbook. I don't know bjam well enough to debug this problem. Can a BBv2 expert look into this? -- Eric Niebler BoostPro Computing http://www.boostpro.com
2008/7/23 Beman Dawes <bdawes@acm.org>:
error: Unable to find file or target named error: 'object(file-target)@3310' error: referred from project at error: '/D:/boost/release/tools/quickbook'
I don't know anything about quickbook, so help is needed to debug this failure.
This appears to be a problem with boost build. It should build quickbook automatically if you haven't specified the location of a prebuilt executable. But something is going wrong. I don't think the quickbook build tool has been changed, so the problem might be somewhere else in boost build. As a workaround, you can first build quickbook separately. You can do this by going to '$BOOST_ROOT/tools/quickbook', running 'bjam dist-bin', and adding to your user-config.jam: using quickbook : $BOOST_ROOT/dist/bin/quickbook ; Replacing $BOOST_ROOT with the appropriate directory. Daniel
AMDG Daniel James wrote:
2008/7/23 Beman Dawes <bdawes@acm.org>:
error: Unable to find file or target named error: 'object(file-target)@3310' error: referred from project at error: '/D:/boost/release/tools/quickbook'
I don't know anything about quickbook, so help is needed to debug this failure.
This appears to be a problem with boost build. It should build quickbook automatically if you haven't specified the location of a prebuilt executable. But something is going wrong. I don't think the quickbook build tool has been changed, so the problem might be somewhere else in boost build.
This is a known bug. http://svn.boost.org/trac/boost/ticket/1584 I created a patch, but someone who knows more bbv2 than me should check that it is actually right. In Christ, Steven Watanabe
Steven Watanabe wrote:
AMDG
Daniel James wrote:
2008/7/23 Beman Dawes <bdawes@acm.org>:
error: Unable to find file or target named error: 'object(file-target)@3310' error: referred from project at error: '/D:/boost/release/tools/quickbook'
I don't know anything about quickbook, so help is needed to debug this failure.
This appears to be a problem with boost build. It should build quickbook automatically if you haven't specified the location of a prebuilt executable. But something is going wrong. I don't think the quickbook build tool has been changed, so the problem might be somewhere else in boost build.
This is a known bug. http://svn.boost.org/trac/boost/ticket/1584 I created a patch, but someone who knows more bbv2 than me should check that it is actually right.
Oh, I did not realize it's one-liner. I think it's perfectly fine, that's how property propagation generally works. Steven, feel free to commit this. OTOH, it seems like we have *two* workarounds: 1. Explicitly specify the location of quickbook binary in "using quickbook". 2. Do not use the <dependency> feature in doc Jamfile of accumulators library, as the ticket claims such <dependency> is not actually necessary. So, if anybody wants to get doc building working sooner than the fix is checked in, you know what to do ;-) - Volodya
Vladimir Prus wrote:
Steven Watanabe wrote:
This is a known bug. http://svn.boost.org/trac/boost/ticket/1584 I created a patch, but someone who knows more bbv2 than me should check that it is actually right.
Oh, I did not realize it's one-liner. I think it's perfectly fine, that's how property propagation generally works. Steven, feel free to commit this.
Excellent.
OTOH, it seems like we have *two* workarounds:
1. Explicitly specify the location of quickbook binary in "using quickbook".
IMO, users should be able to build Boost's docs without hacking their user-config.jam, so I'd rather see BBv2 patched.
2. Do not use the <dependency> feature in doc Jamfile of accumulators library, as the ticket claims such <dependency> is not actually necessary.
This supposed workaround doesn't work, AFAICT.
So, if anybody wants to get doc building working sooner than the fix is checked in, you know what to do ;-)
Steven? -- Eric Niebler BoostPro Computing http://www.boostpro.com
AMDG Eric Niebler wrote:
Vladimir Prus wrote:
Oh, I did not realize it's one-liner. I think it's perfectly fine, that's how property propagation generally works. Steven, feel free to commit this.
Excellent.
<snip>
So, if anybody wants to get doc building working sooner than the fix is checked in, you know what to do ;-)
Steven?
Done in the trunk. Should I merge to the release branch? Beman? In Christ, Steven Watanabe
Steven Watanabe wrote:
AMDG
Eric Niebler wrote:
Vladimir Prus wrote:
Oh, I did not realize it's one-liner. I think it's perfectly fine, that's how property propagation generally works. Steven, feel free to commit this.
Excellent.
<snip>
So, if anybody wants to get doc building working sooner than the fix is checked in, you know what to do ;-)
Steven?
Done in the trunk. Should I merge to the release branch? Beman?
Seems to be working in trunk, so go ahead and merge to release. Thanks for figuring out the problem! --Beman
Daniel James wrote:
2008/7/23 Beman Dawes <bdawes@acm.org>:
error: Unable to find file or target named error: 'object(file-target)@3310' error: referred from project at error: '/D:/boost/release/tools/quickbook'
I don't know anything about quickbook, so help is needed to debug this failure.
This appears to be a problem with boost build. It should build quickbook automatically if you haven't specified the location of a prebuilt executable. But something is going wrong. I don't think the quickbook build tool has been changed, so the problem might be somewhere else in boost build.
As a workaround, you can first build quickbook separately. You can do this by going to '$BOOST_ROOT/tools/quickbook', running 'bjam dist-bin', and adding to your user-config.jam:
using quickbook : $BOOST_ROOT/dist/bin/quickbook ;
I can look into Steven's patch, but only tomorrow. The above workaround can be used if having this working during the reminder of today is desirable. (Reminder of today is 1 hour here, but is up to 13 hours in US). - Volodya
Eric Niebler wrote:
Beman Dawes wrote:
Eric Niebler wrote:
Once upon a time, Boost's docs were built nightly and publicly hosted. <snip.
A release snapshot is still being built every night.
See http://boost.cowic.de/rc/ <snip>
Sorry Beman, but it looks to me like the docs are not being built for these snapshots. At least, I just downloaded:
http://boost.cowic.de/rc/boost-posix-2008-07-20.tar.bz2
And in that snapshot, the docs have not been built. Try navigating to the docs for accumulators, foreach or xpressive ... they're not there. I haven't checked the other snapshots.
For snapshots built last night, the docs bjam ran normally. Those three libraries do have docs, although reference.html in accumulators and xpressive looks suspicious as far as content. Please let me know if you spot any problems caused by the build process. If anyone needs to see the bjam log, I'll post it or email a copy on request. Thanks, --Beman
2008/7/24 Beman Dawes <bdawes@acm.org>:
For snapshots built last night, the docs bjam ran normally. Those three libraries do have docs, although reference.html in accumulators and xpressive looks suspicious as far as content.
The reference documentation for interprocess and intrusive is also missing, so it's probably a problem with doxygen. If you can't work it out, send me your user-config.jam and the bjam log and I'll see if I can spot anything. thanks, Daniel
participants (5)
-
Beman Dawes -
Daniel James -
Eric Niebler -
Steven Watanabe -
Vladimir Prus