[date_time] catalog.xml in CVS
Hi, the date_time, specifically the libs/date_time/xmldoc directory, includes the catalog.xml file: File: catalog.xml Status: Up-to-date Working revision: 1.1 Repository revision: 1.1 /cvsroot/boost/boost/libs/date_time/xmldoc/catalog.xml,v I think it should not, as the file is generated by Boost.Build, and placing a version which includes paths like: file:///usr/local/src/bart is likely to lead to errors. - Volodya
On Wed, 29 Dec 2004 16:00:12 +0300, Vladimir Prus wrote
On Wednesday 29 December 2004 13:04, Vladimir Prus wrote:
Hi, the date_time, specifically the libs/date_time/xmldoc directory, includes the catalog.xml file:
This is an internally used file, so it shouldn't cause errors - but perhaps an error has crept in? Are you seeing a problem when you try and generate the overall boost results? I noted before that for the 1.32 pdf date-time was excluded and no one explained why/how that happened since the html was clearly generated :-(
And date_time_autodoc.boostbook/ and other *.boostbook files should not be in CVS, too.
Yes, well, since we haven't been sucessful in getting all of the doxygen to boost-book bridge to work well for date-time we have to slightly modify the generated files for our purpose. So that's why those are there. Jeff
Jeff Garland wrote:
On Wed, 29 Dec 2004 16:00:12 +0300, Vladimir Prus wrote
On Wednesday 29 December 2004 13:04, Vladimir Prus wrote:
Hi, the date_time, specifically the libs/date_time/xmldoc directory, includes the catalog.xml file:
This is an internally used file, so it shouldn't cause errors - but perhaps an error has crept in? Are you seeing a problem when you try and generate the overall boost results?
No, I see a problem when trying to build date_time docs.
I noted before that for the 1.32 pdf date-time was excluded and no one explained why/how that happened since the html was clearly generated :-(
I recall it was some kind of fop -> pdf convert bug, but I'm not sure.
And date_time_autodoc.boostbook/ and other *.boostbook files should not be in CVS, too.
Yes, well, since we haven't been sucessful in getting all of the doxygen to boost-book bridge to work well for date-time we have to slightly modify the generated files for our purpose. So that's why those are there.
You mean that each time after modifying headers, you have to manually tweak the generated files? - Volodya
On Wed, 29 Dec 2004 17:32:44 +0300, Vladimir Prus wrote
Jeff Garland wrote:
On Wed, 29 Dec 2004 16:00:12 +0300, Vladimir Prus wrote
On Wednesday 29 December 2004 13:04, Vladimir Prus wrote:
Hi, the date_time, specifically the libs/date_time/xmldoc directory, includes the catalog.xml file:
This is an internally used file, so it shouldn't cause errors - but perhaps an error has crept in? Are you seeing a problem when you try and generate the overall boost results?
No, I see a problem when trying to build date_time docs.
Maybe you can be more explicit about what you are doing and the errors you are seeing. BTW, we haven't been able to build docs for quite awhile now and our requests for help have gone unanswered on the boost-doc list. We weren't sure what magic was applied to do the 1.32 release.
I noted before that for the 1.32 pdf date-time was excluded and no one explained why/how that happened since the html was clearly generated :-(
I recall it was some kind of fop -> pdf convert bug, but I'm not sure.
Ok.
And date_time_autodoc.boostbook/ and other *.boostbook files should not be in CVS, too.
Yes, well, since we haven't been sucessful in getting all of the doxygen to boost-book bridge to work well for date-time we have to slightly modify the generated files for our purpose. So that's why those are there.
You mean that each time after modifying headers, you have to manually tweak the generated files?
That's correct -- although I think we actually use a script to do it. Sorry to say I've been hands-off of this for awhile so I don't know the details. Hopefully Bart will post later and describe the details. Jeff
Jeff Garland wrote:
On Wed, 29 Dec 2004 17:32:44 +0300, Vladimir Prus wrote
Jeff Garland wrote:
On Wed, 29 Dec 2004 16:00:12 +0300, Vladimir Prus wrote
On Wednesday 29 December 2004 13:04, Vladimir Prus wrote:
Hi, the date_time, specifically the libs/date_time/xmldoc directory, includes the catalog.xml file:
This is an internally used file, so it shouldn't cause errors - but perhaps an error has crept in? Are you seeing a problem when you try and generate the overall boost results?
No, I see a problem when trying to build date_time docs.
Maybe you can be more explicit about what you are doing and the errors you are seeing.
Sure. 1. I have up-to-date CVS tree. 2. I run "bjam --v2" in libs/date_time/xmldocs and get: xslt-xsltproc bin/gcc/debug/date_time.docbook ../../../tools/boostbook/dtd/boostbook.dtd:412: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" %DocBook; ^ Entity: line 1: (many screens of similar errors omitted). 3. I remove catalog.xml and run bjam again. Everything works.
BTW, we haven't been able to build docs for quite awhile now
I know it was broken for about a week (because I broke it), but it should be working now.
and our requests for help have gone unanswered on the boost-doc list. We weren't sure what magic was applied to do the 1.32 release.
I'm not sure what problems you refer too, sorry.
And date_time_autodoc.boostbook/ and other *.boostbook files should not be in CVS, too.
Yes, well, since we haven't been sucessful in getting all of the doxygen to boost-book bridge to work well for date-time we have to slightly modify the generated files for our purpose. So that's why those are there.
You mean that each time after modifying headers, you have to manually tweak the generated files?
That's correct -- although I think we actually use a script to do it. Sorry to say I've been hands-off of this for awhile so I don't know the details. Hopefully Bart will post later and describe the details.
Ok. - Volodya
On Wed, 29 Dec 2004 07:58:38 -0700, Jeff Garland wrote:
On Wed, 29 Dec 2004 17:32:44 +0300, Vladimir Prus wrote
Jeff Garland wrote:
On Wed, 29 Dec 2004 16:00:12 +0300, Vladimir Prus wrote
On Wednesday 29 December 2004 13:04, Vladimir Prus wrote:
Hi, the date_time, specifically the libs/date_time/xmldoc directory, includes the catalog.xml file:
This is an internally used file, so it shouldn't cause errors - but perhaps an error has crept in? Are you seeing a problem when you try and generate the overall boost results?
No, I see a problem when trying to build date_time docs.
Maybe you can be more explicit about what you are doing and the errors you are seeing. BTW, we haven't been able to build docs for quite awhile now and our requests for help have gone unanswered on the boost-doc list. We weren't sure what magic was applied to do the 1.32 release.
I noted before that for the 1.32 pdf date-time was excluded and no one explained why/how that happened since the html was clearly generated :-(
I recall it was some kind of fop -> pdf convert bug, but I'm not sure.
Ok.
And date_time_autodoc.boostbook/ and other *.boostbook files should not be in CVS, too.
Yes, well, since we haven't been sucessful in getting all of the doxygen to boost-book bridge to work well for date-time we have to slightly modify the generated files for our purpose. So that's why those are there.
You mean that each time after modifying headers, you have to manually tweak the generated files?
That's correct -- although I think we actually use a script to do it. Sorry to say I've been hands-off of this for awhile so I don't know the details. Hopefully Bart will post later and describe the details.
Jeff
We wanted the doxygen created reference to have three sections: date_time, gregorian, & posix_time with a fourth to be added later (local_time). Boostbook generated a boostbook file for each section, however, all three boostbook files had the same section and title tags. Our script rewrites those tags and adds a copyright notice. It's a bit of extra work but we have a nicely nested set of reference docs as a result. Building the docs from anywhere other than boost_root/libs/date_time/xmldoc will not produce the boostbook files but simply uses them. Bart
On Wed, 29 Dec 2004 17:32:44 +0300, Vladimir Prus wrote:
Jeff Garland wrote:
On Wed, 29 Dec 2004 16:00:12 +0300, Vladimir Prus wrote
On Wednesday 29 December 2004 13:04, Vladimir Prus wrote:
Hi, the date_time, specifically the libs/date_time/xmldoc directory, includes the catalog.xml file:
This is an internally used file, so it shouldn't cause errors - but perhaps an error has crept in? Are you seeing a problem when you try and generate the overall boost results?
No, I see a problem when trying to build date_time docs.
I noted before that for the 1.32 pdf date-time was excluded and no one explained why/how that happened since the html was clearly generated :-(
I recall it was some kind of fop -> pdf convert bug, but I'm not sure.
Does this mean you specifically excluded date_time or it was automatically dropped? Bart
Bart wrote:
I recall it was some kind of fop -> pdf convert bug, but I'm not sure.
Does this mean you specifically excluded date_time or it was automatically dropped?
I did nothing. IIRC, Aleksey mentioned this problem during release preparation. I think date_time was manually excluded when building PDF. - Volodya
participants (3)
-
Bart -
Jeff Garland -
Vladimir Prus