On 7 February 2014 17:02, Steven Watanabe 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.

-----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 wrote:

...

On 7 February 2014 17:02, Steven Watanabe 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

-----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