Generating PDF from QuickBook?
I'm sorry, this must be a FAQ, but my Google search turned up mail from 2009 advising me to cd to libs/xxx/doc and run ../../../b2 pdf When I do that in a new modular Boost tree, I get the following errors: /Users/nat/boost-git/tools/build/src/tools/boostbook.jam:704: in construct from module object(boostbook-target-class)@1466 error: Cannot build documentation type 'pdf'. /Users/nat/boost-git/tools/build/src/build/targets.jam:1332: in class@basic-target.generate from module object(boostbook-target-class)@1466 /Users/nat/boost-git/tools/build/src/build/targets.jam:757: in generate-really from module object(main-target)@1471 /Users/nat/boost-git/tools/build/src/build/targets.jam:729: in class@main-target.generate from module object(main-target)@1471 /Users/nat/boost-git/tools/build/src/build/targets.jam:272: in class@project-target.generate from module object(project-target)@1460 /Users/nat/boost-git/tools/build/src/build-system.jam:707: in load from module build-system /Users/nat/boost-git/tools/build/src/kernel/modules.jam:289: in import from module modules /Users/nat/boost-git/tools/build/src/kernel/bootstrap.jam:139: in boost-build from module /Users/nat/boost-git/boost-build.jam:17: in module scope from module Is there some incantation I can apply to produce PDF output?
AMDG On 02/07/2014 08:44 AM, Nat Goodspeed wrote:
I'm sorry, this must be a FAQ, but my Google search turned up mail from 2009 advising me to cd to libs/xxx/doc and run ../../../b2 pdf
When I do that in a new modular Boost tree, I get the following errors:
/Users/nat/boost-git/tools/build/src/tools/boostbook.jam:704: in construct from module object(boostbook-target-class)@1466 error: Cannot build documentation type 'pdf'. <snip>
Is there some incantation I can apply to produce PDF output?
You need to set up fop. I think there's a wiki page: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted In Christ, Steven Watanabe
On Fri, Feb 7, 2014 at 12:02 PM, Steven Watanabe <watanabesj@gmail.com> wrote:
On 02/07/2014 08:44 AM, Nat Goodspeed wrote:
error: Cannot build documentation type 'pdf'.
You need to set up fop. I think there's a wiki page: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted
Thank you! Um -- would it make any sense to allude to that Wiki page in the error message? I didn't know whether to interpret "Cannot build documentation type 'pdf'" to mean: * This is not supported at all. * We used to support this but it's currently broken with modular Boost. * This is supported, but you're missing an essential tool. I now realize it's the last, of course, but it was hard to deduce that from the original message.
On 7 February 2014 17:02, Steven Watanabe <watanabesj@gmail.com> wrote:
AMDG
On 02/07/2014 08:44 AM, Nat Goodspeed wrote:
I'm sorry, this must be a FAQ, but my Google search turned up mail from 2009 advising me to cd to libs/xxx/doc and run ../../../b2 pdf
When I do that in a new modular Boost tree, I get the following errors:
/Users/nat/boost-git/tools/build/src/tools/boostbook.jam:704: in construct from module object(boostbook-target-class)@1466 error: Cannot build documentation type 'pdf'. <snip>
Is there some incantation I can apply to produce PDF output?
You need to set up fop. I think there's a wiki page: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted
We usually use XEP as it gives better results. I'm not sure how well FOP will work as I haven't tried it for years.
On Fri, Feb 7, 2014 at 12:26 PM, Daniel James <dnljms@gmail.com> wrote:
On 7 February 2014 17:02, Steven Watanabe <watanabesj@gmail.com> wrote:
On 02/07/2014 08:44 AM, Nat Goodspeed wrote:
Is there some incantation I can apply to produce PDF output?
You need to set up fop. I think there's a wiki page: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted
We usually use XEP as it gives better results. I'm not sure how well FOP will work as I haven't tried it for years.
Yes - the cited Wiki page gives a pretty strong nudge in the direction of XEP.
-----Original Message----- From: Boost-users [mailto:boost-users-bounces@lists.boost.org] On Behalf Of Nat Goodspeed Sent: Friday, February 07, 2014 6:20 PM To: boost-users@lists.boost.org Subject: Re: [Boost-users] Generating PDF from QuickBook?
On Fri, Feb 7, 2014 at 12:26 PM, Daniel James <dnljms@gmail.com> wrote:
On 7 February 2014 17:02, Steven Watanabe <watanabesj@gmail.com> wrote:
On 02/07/2014 08:44 AM, Nat Goodspeed wrote:
Is there some incantation I can apply to produce PDF output?
You need to set up fop. I think there's a wiki page: https://svn.boost.org/trac/boost/wiki/BoostDocs/GettingStarted
We usually use XEP as it gives better results. I'm not sure how well FOP will work as I haven't tried it for years.
Yes - the cited Wiki page gives a pretty strong nudge in the direction of XEP.
I believe that RenderX XEP has been the only one that has worked on Quickbook toolchain to produce PDFs. It is a hassle to set up (as I have been rediscovering on moving to new hardware and Windows 8.1 and 64-bit). The user-config.jam values # XSLT-FO processor from RenderX.com using fop : # XEP batch filename # Note you may need to increase the Java heap size. "C:/Progra~1/renderx/xep/xep.bat" # OK : # Java executable called by xep.bat. "C:\\Program files\\Java\\jre7" # OK changed from jre6 and on 8 Feb 2014 is OK. ; *and* the program locations *inside* xep.bat must be edited (awkward if in program file/renderX). If anyone wants help doing this setup, do ask, privately if preferred. HTML docs are essential, but PDFs are a single file and easily emailed, and can be *searched* using your favorite PDF reader, a useful feature if the docs are unindexed, or the term chosen by the authors to be indexed is not the term you expect. We continue to be grateful to RenderX for permission to use this software to generate these useful PDFs. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
On 8 Feb 2014 at 14:41, Paul A. Bristow wrote:
I believe that RenderX XEP has been the only one that has worked on Quickbook toolchain to produce PDFs.
I nearly got a very old Apache FOP to work, but yes newer FOPs just don't even try to work. Be aware that RenderX PDF output has many formatting errors, especially in the API reference section (on AFIO's PDF at least, you can see our CI generated one at https://ci.nedprod.com/view/All/job/Boost.AFIO%20Build%20Documentation %20PDF/lastSuccessfulBuild/artifact/boost-trunk/bin.v2/libs/afio/doc/g cc-4.6/debug/afio.pdf).
HTML docs are essential, but PDFs are a single file and easily emailed, and can be *searched* using your favorite PDF reader, a useful feature if the docs are unindexed, or the term chosen by the authors to be indexed is not the term you expect.
I wouldn't underestimate the utility of Quickbook single HTML page output. That is also very easily searchable in your web browser, and saveable as a standalone web archive. Niall -- Currently unemployed and looking for work in Ireland. Work Portfolio: http://careers.stackoverflow.com/nialldouglas/
-----Original Message----- From: Boost-users [mailto:boost-users-bounces@lists.boost.org] On Behalf Of Niall Douglas Sent: Saturday, February 08, 2014 4:25 PM To: boost-users@lists.boost.org Subject: Re: [Boost-users] Generating PDF from QuickBook?
On 8 Feb 2014 at 14:41, Paul A. Bristow wrote:
I believe that RenderX XEP has been the only one that has worked on Quickbook toolchain to produce PDFs.
I nearly got a very old Apache FOP to work, but yes newer FOPs just don't even try to work.
Be aware that RenderX PDF output has many formatting errors, especially in the API reference
section
(on AFIO's PDF at least, you can see our CI generated one at https://ci.nedprod.com/view/All/job/Boost.AFIO%20Build%20Documentation %20PDF/lastSuccessfulBuild/artifact/boost-trunk/bin.v2/libs/afio/doc/g cc-4.6/debug/afio.pdf).
HTML docs are essential, but PDFs are a single file and easily emailed, and can be *searched* using your favorite PDF reader, a useful feature if the docs are unindexed, or the term chosen by the authors to be indexed is not the term you expect.
I wouldn't underestimate the utility of Quickbook single HTML page output. That is also very easily searchable in your web browser, and saveable as a standalone web archive.
True - but if you are searching Boost.Math docs and you don't know/remember which section it is in, searching the PDF is your best hope. It's probably a sign of senescence, but even though I wrote lots of it - I still search the Boost.Math PDF! Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com
participants (1)
-
Daniel James -
Nat Goodspeed -
Niall Douglas -
Paul A. Bristow -
Steven Watanabe