on quickbook/docbook etc
Dear all, I have for the second time tried to compile a quickbook version of the docs for Boost.Range. Without luck. Is there an idiot proof procedure for getting this loooong toolchain to work on windows? My current error (after using the automatic install script) is: $ bjam --v2 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). ...patience... ...found 1052 targets... ...updating 2 targets... xslt-xsltproc ..\..\..\bin.v2\libs\range\doc\msvc-8.0\debug\threading-multi\boos t_range.docbook The system cannot find the path specified. set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml "/bin/xsltproc" --stringparam chunk.first.sections "7" --stringparam generate.s ection.toc.level "4" --stringparam toc.section.depth "10" --xinclude -o "..\..\. .\bin.v2\libs\range\doc\msvc-8.0\debug\threading-multi\boost_range.docbook" "d:\ boost\trunk\tools\boostbook\xsl\docbook.xsl" "..\..\..\bin.v2\libs\range\doc\msv c-8.0\debug\threading-multi\boost_range.xml" I'm getting kinda desparate here ... perhaps I should simply commit the docs and let them be generated on a test server. Do we have such a functionality in place? Thanks in advance -Thorsten
Thorsten Ottosen wrote:
Dear all,
I have for the second time tried to compile a quickbook version of the docs for Boost.Range. Without luck. Is there an idiot proof procedure for getting this loooong toolchain to work on windows?
My current error (after using the automatic install script) is:
$ bjam --v2 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). ...patience... ...found 1052 targets... ...updating 2 targets... xslt-xsltproc ..\..\..\bin.v2\libs\range\doc\msvc-8.0\debug\threading-multi\boos t_range.docbook The system cannot find the path specified.
set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml "/bin/xsltproc" --stringparam chunk.first.sections "7" --stringparam generate.s ection.toc.level "4" --stringparam toc.section.depth "10" --xinclude -o "..\..\. .\bin.v2\libs\range\doc\msvc-8.0\debug\threading-multi\boost_range.docbook" "d:\ boost\trunk\tools\boostbook\xsl\docbook.xsl" "..\..\..\bin.v2\libs\range\doc\msv c-8.0\debug\threading-multi\boost_range.xml"
You have a mixture of windows and Unix style paths there, make sure that the path to xsltproc is a windows one, and better still, you almost certainly need to use the windows build of xsltproc to get it to work. John.
John Maddock skrev:
Thorsten Ottosen wrote:
Dear all,
The system cannot find the path specified.
You have a mixture of windows and Unix style paths there, make sure that the path to xsltproc is a windows one, and better still, you almost certainly need to use the windows build of xsltproc to get it to work.
I have changed all my paths to windows style. Here's the portion of user-config.jam: using boostbook : D:\boost\documentation\docbook-xsl-1.73.2 : D:\boost\documentation\docbook-dtd-4.2 ; #using xsltproc : /bin/xsltproc ; using xsltproc ; using doxygen : E:\cygwin\bin ; using fop : D:\boost\documentation\fop-0.94 : : c:\WINDOWS\system32\java ; The version of xsltproc.exe is the a windows version. It should also be the bug-fixed one. I now get a bunch of errors of the type: xslt-xsltproc-dir html\standalone_HTML.manifest warning: failed to load external entity "http://docbook.sourceforge.net/release/ xsl/current/html/chunk.xsl" compilation error: file file:///D%3A/boost/trunk/tools/boostbook/xsl/html.xsl li ne 15 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/h tml/chunk.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/ xsl/current/html/math.xsl" compilation error: file file:///D%3A/boost/trunk/tools/boostbook/xsl/html.xsl li ne 17 element import Any ideas? Thanks -Thorsten
John Maddock skrev:
Thorsten Ottosen wrote:
Dear all,
The system cannot find the path specified.
You have a mixture of windows and Unix style paths there, make sure that the path to xsltproc is a windows one, and better still, you almost certainly need to use the windows build of xsltproc to get it to work.
I have changed all my paths to windows style. Here's the portion of user-config.jam: using boostbook : D:\boost\documentation\docbook-xsl-1.73.2 : D:\boost\documentation\docbook-dtd-4.2 ; #using xsltproc : /bin/xsltproc ; using xsltproc ; using doxygen : E:\cygwin\bin ; using fop : D:\boost\documentation\fop-0.94 : : c:\WINDOWS\system32\java ; The version of xsltproc.exe is the a windows version. It should also be the bug-fixed one. I now get a bunch of errors of the type: xslt-xsltproc-dir html\standalone_HTML.manifest warning: failed to load external entity "http://docbook.sourceforge.net/release/ xsl/current/html/chunk.xsl" compilation error: file file:///D%3A/boost/trunk/tools/boostbook/xsl/html.xsl li ne 15 element import xsl:import : unable to load http://docbook.sourceforge.net/release/xsl/current/h tml/chunk.xsl warning: failed to load external entity "http://docbook.sourceforge.net/release/ xsl/current/html/math.xsl" compilation error: file file:///D%3A/boost/trunk/tools/boostbook/xsl/html.xsl li ne 17 element import Any ideas? Thanks -Thorsten
Thorsten Ottosen wrote:
I have changed all my paths to windows style. Here's the portion of user-config.jam:
using boostbook : D:\boost\documentation\docbook-xsl-1.73.2 : D:\boost\documentation\docbook-dtd-4.2 ; #using xsltproc : /bin/xsltproc ; using xsltproc ; using doxygen : E:\cygwin\bin ; using fop : D:\boost\documentation\fop-0.94 : : c:\WINDOWS\system32\java ;
The version of xsltproc.exe is the a windows version. It should also be the bug-fixed one.
I now get a bunch of errors of the type:
Any ideas?
Yes: the paths in user-config.jam need to use *forward slashes* even when they're Windows paths, since \ is a Jam-language escape character :-( HTH, John.
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of John Maddock Sent: 24 October 2007 08:01 To: boost@lists.boost.org Subject: Re: [boost] on quickbook/docbook etc
I now get a bunch of errors of the type:
Any ideas?
Yes: the paths in user-config.jam need to use *forward slashes* even when they're Windows paths, since \ is a Jam-language escape character :-(
Right! I'm sure many users fall into this trap, including me. *Please* can we have a comment warning about this - and the bizarre 'you need spaces' syntax. I'm sure this simple addition would avoid a big load of grief - there's a lot of it about where bjam is involved. Paul --- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS pbristow@hetp.u-net.com
Paul A Bristow wrote:
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of John Maddock Sent: 24 October 2007 08:01 To: boost@lists.boost.org Subject: Re: [boost] on quickbook/docbook etc
I now get a bunch of errors of the type:
Any ideas?
Yes: the paths in user-config.jam need to use *forward slashes* even when they're Windows paths, since \ is a Jam-language escape character :-(
Right! I'm sure many users fall into this trap, including me.
*Please* can we have a comment warning about this - and the bizarre 'you need spaces' syntax.
I'm sure this simple addition would avoid a big load of grief - there's a lot of it about where bjam is involved.
Comment where? user-config.jam, or boost-build docs or getting started? - Volodya
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Vladimir Prus Sent: 24 October 2007 12:05 To: boost@lists.boost.org Subject: Re: [boost] on quickbook/docbook etc
*Please* can we have a comment warning about this - and the bizarre 'you need spaces' syntax.
I'm sure this simple addition would avoid a big load of grief - there's a lot of it about where bjam is involved.
Comment where? user-config.jam, or boost-build docs or getting started?
In every jam file!!! Well - at the very least user-config.jam, and preferably boost-build docs and getting started too ;-) Paul --- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS pbristow@hetp.u-net.com
Paul A Bristow wrote:
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Vladimir Prus Sent: 24 October 2007 12:05 To: boost@lists.boost.org Subject: Re: [boost] on quickbook/docbook etc
*Please* can we have a comment warning about this - and the bizarre 'you need spaces' syntax.
I'm sure this simple addition would avoid a big load of grief - there's a lot of it about where bjam is involved.
Comment where? user-config.jam, or boost-build docs or getting started?
In every jam file!!!
Well, I would expect that before changing random jam file, the person changing it would at least glance docs about syntax. Which happen to mention the 'spaces' issues right away, with big red sign: http://boost.org/boost-build2/doc/html/bbv2/advanced.html#bbv2.advanced.jam_... user-config.jam is special in that it's necessary to edit it even if you don't want to use boost.build proper, so I've just added various comments to tools/build/v2/user-config.jam Would you check if that's better?
Well - at the very least user-config.jam,
and preferably boost-build docs
The spaces issue is already documented. I have an action item to clarify '\' issue.
and getting started too ;-)
I'm not sure that's good idea -- it would be better to refer to boost.build docs. - Volodya
-----Original Message----- From: boost-bounces@lists.boost.org [mailto:boost-bounces@lists.boost.org] On Behalf Of Vladimir Prus Sent: 24 October 2007 12:38 To: boost@lists.boost.org Subject: Re: [boost] on quickbook/docbook etc
user-config.jam is special in that it's necessary to edit it even if you don't want to use boost.build proper, so I've just added various comments to tools/build/v2/user-config.jam
Would you check if that's better?
Much better. Thanks Paul --- Paul A Bristow Prizet Farmhouse, Kendal, Cumbria UK LA8 8AB +44 1539561830 & SMS, Mobile +44 7714 330204 & SMS pbristow@hetp.u-net.com
John Maddock skrev:
Thorsten Ottosen wrote:
I now get a bunch of errors of the type:
Any ideas?
Yes: the paths in user-config.jam need to use *forward slashes* even when they're Windows paths, since \ is a Jam-language escape character :-(
Ok. Thanks. I'm now down to this single error: ...updating 1 target... xslt-xsltproc-dir html\standalone_HTML.manifest set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml "xsltproc" --stringparam chunk.section.depth "2" --stringparam manifest "standa lone_HTML.manifest" --stringparam toc.max.depth "2" --stringparam toc.section.de pth "4" --xinclude -o "html/" "D:\boost\trunk\tools\boostbook\xsl\html.xsl" "..\ ..\..\bin.v2\libs\range\doc\msvc-8.0\debug\threading-multi\boost_range.docbook" ...failed xslt-xsltproc-dir html\standalone_HTML.manifest... ...failed updating 1 target... Does this mean I should try to reinstall xsltproc? ? Thanks -Thorsten
Thorsten Ottosen wrote:
Ok. Thanks. I'm now down to this single error:
...updating 1 target... xslt-xsltproc-dir html\standalone_HTML.manifest
set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml "xsltproc" --stringparam chunk.section.depth "2" --stringparam manifest "standa lone_HTML.manifest" --stringparam toc.max.depth "2" --stringparam toc.section.de pth "4" --xinclude -o "html/" "D:\boost\trunk\tools\boostbook\xsl\html.xsl" "..\ ..\..\bin.v2\libs\range\doc\msvc-8.0\debug\threading-multi\boost_range.docbook"
...failed xslt-xsltproc-dir html\standalone_HTML.manifest... ...failed updating 1 target...
Does this mean I should try to reinstall xsltproc?
I don't know: there's no error message to give a hint as to what the problem is. Try pasting the command line above into a cmd.exe command prompt and see if you get any more hints. Could be that you're missing one or more dll's used by xsltproc, or something? HTH, John.
On 24/10/2007, Thorsten Ottosen <thorsten.ottosen@dezide.com> wrote:
Ok. Thanks. I'm now down to this single error:
...updating 1 target... xslt-xsltproc-dir html\standalone_HTML.manifest
set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml "xsltproc" --stringparam chunk.section.depth "2" --stringparam manifest "standa lone_HTML.manifest" --stringparam toc.max.depth "2" --stringparam toc.section.de pth "4" --xinclude -o "html/" "D:\boost\trunk\tools\boostbook\xsl\html.xsl" "..\ ..\..\bin.v2\libs\range\doc\msvc-8.0\debug\threading-multi \boost_range.docbook"
...failed xslt-xsltproc-dir html\standalone_HTML.manifest... ...failed updating 1 target...
Does this mean I should try to reinstall xsltproc?
?
Are you using the meta-comm xsltproc? Using that one gave me this error message, whether it's the same error I have no idea. FWIW, I fixed this by just reinstalling from http://www.zlatkovic.com/pub/libxml/ -- Darren
Darren Garvey skrev:
On 24/10/2007, Thorsten Ottosen <thorsten.ottosen@dezide.com> wrote:
Ok. Thanks. I'm now down to this single error:
...updating 1 target... xslt-xsltproc-dir html\standalone_HTML.manifest
set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml "xsltproc" --stringparam chunk.section.depth "2" --stringparam manifest "standa lone_HTML.manifest" --stringparam toc.max.depth "2" --stringparam toc.section.de pth "4" --xinclude -o "html/" "D:\boost\trunk\tools\boostbook\xsl\html.xsl" "..\ ..\..\bin.v2\libs\range\doc\msvc-8.0\debug\threading-multi \boost_range.docbook"
...failed xslt-xsltproc-dir html\standalone_HTML.manifest... ...failed updating 1 target...
Does this mean I should try to reinstall xsltproc?
?
Are you using the meta-comm xsltproc?
Yes, I think that is the one. Somewhere it said that it fixed a bug and should be installed.
Using that one gave me this error message, whether it's the same error I have no idea. FWIW, I fixed this by just reinstalling from http://www.zlatkovic.com/pub/libxml/
Ok, I'll try that. -Thorsten
On 24/10/2007, Thorsten Ottosen <thorsten.ottosen@dezide.com> wrote:
Darren Garvey skrev:
On 24/10/2007, Thorsten Ottosen <thorsten.ottosen@dezide.com> wrote:
Ok. Thanks. I'm now down to this single error:
...updating 1 target... xslt-xsltproc-dir html\standalone_HTML.manifest
set XML_CATALOG_FILES=..\..\..\bin.v2/boostbook_catalog.xml "xsltproc" --stringparam chunk.section.depth "2" --stringparam manifest "standa lone_HTML.manifest" --stringparam toc.max.depth "2" --stringparam toc.section.de pth "4" --xinclude -o "html/" "D:\boost\trunk\tools\boostbook\xsl\html.xsl" "..\ ..\..\bin.v2\libs\range\doc\msvc-8.0\debug\threading-multi \boost_range.docbook"
...failed xslt-xsltproc-dir html\standalone_HTML.manifest... ...failed updating 1 target...
Does this mean I should try to reinstall xsltproc?
?
Are you using the meta-comm xsltproc?
Yes, I think that is the one. Somewhere it said that it fixed a bug and should be installed.
It did, but IIUC this has been fixed in the official repo and in the semi-official windows binaries on the page I linked to. I'm not sure why the meta-comm one won't work for me now, but there you go. :-) Regards, Darren
Darren Garvey skrev:
Are you using the meta-comm xsltproc? Yes, I think that is the one. Somewhere it said that it fixed a bug and should be installed.
It did, but IIUC this has been fixed in the official repo and in the semi-official windows binaries on the page I linked to. I'm not sure why the meta-comm one won't work for me now, but there you go. :-)
It worked! I have now compiled the docs for the first time! :-) Thanks to all of you! -Thorsten
On 23/10/2007, Thorsten Ottosen <thorsten.ottosen@dezide.com> wrote:
Dear all,
I have for the second time tried to compile a quickbook version of the docs for Boost.Range. Without luck. Is there an idiot proof procedure for getting this loooong toolchain to work on windows?
My current error (after using the automatic install script) is: <snip>
Did you use the setup_boostbook.py script? I just tried building the quickbook docs at SVN/sandbox/doc_test/libs/range/doc (after adding the attached project-root.jam to the doc folder and it worked OK. If you just need to see the docs, is it ok to add them temporarily to svn? (anyone?) Regards, Darren
Darren Garvey skrev:
On 23/10/2007, Thorsten Ottosen <thorsten.ottosen@dezide.com> wrote:
Dear all,
I have for the second time tried to compile a quickbook version of the docs for Boost.Range. Without luck. Is there an idiot proof procedure for getting this loooong toolchain to work on windows?
My current error (after using the automatic install script) is: <snip>
Did you use the setup_boostbook.py script?
no, the sh script.
I just tried building the quickbook docs at SVN/sandbox/doc_test/libs/range/doc (after adding the attached project-root.jam to the doc folder and it worked OK.
I did not see the attachment. Anyway, I have created my like the in eg. boost.bimap. -Thorsten
participants (6)
-
Darren Garvey -
Darren Garvey -
John Maddock -
Paul A Bristow -
Thorsten Ottosen -
Vladimir Prus