Boost C++ Libraries: Ticket #3842: PDF documents miss title

owner, status changed

Daniel James — Thu, 14 Jan 2010 21:27:49 GMT

owner changed from Matias Capeletto to Daniel James
status new → assigned

I'm not sure if I'll be able to get this into the new release, but I'll see what I can do.

cc set

John Maddock — Fri, 15 Jan 2010 12:33:05 GMT

cc John Maddock added

I'll look into this as well - I've never investigated where that meta-data come from exactly - but I think this will require editing the documentation source to ensure they have the necessary metadata in their headers.

John Maddock — Fri, 15 Jan 2010 12:45:40 GMT

The difference appears to be whether the documentation begins:

[library foobar

[article foobar

The latter seems to be correctly setting the required metadata in the docbook XML, while the former doesn't. Any ideas? I'm guessing it's because "[library" is intended to be part of a larger document where as "[article" isn't?

John.

Daniel James — Fri, 15 Jan 2010 12:59:26 GMT

That's what I first thought, but then I noticed that Boost.Unordered has the correct metadata. My second thought was that it was because libraries have their title in the wrong place ('library' is part of boostbook, not docbook, and the boostbook dtd requires that title and libraryinfo are in the opposite order to the normal docbook document types), but that doesn't make a difference either. As far as I can tell, it's the xml parameters that determine this.

John Maddock — Fri, 15 Jan 2010 13:45:01 GMT

If it's the xsl params that determine this, then it may be as simple as changing the project requirements in doc/pdf/Jamfile.v2, I'm running a rebuild with this change now, but it may take a while....

John.

John Maddock — Fri, 15 Jan 2010 13:54:21 GMT

Still building but...

Adding

project

: requirements <format>pdf:<xsl:param>xep.extensions=1 <format>pdf:<xsl:param>fop.extensions=0 <format>pdf:<xsl:param>fop1.extensions=0 ;

to the doc/pdf jammfile fixes things for array and any, but not accumulators or string_algo... unless something didn't get rebuilt maybe?

Will investigate some more, again... John.

anonymous — Fri, 15 Jan 2010 17:16:21 GMT

OK, I can fix this by either:

remembering to add the necessary xsl:param's to the command line when I build the docs.
Changing the default in our stylesheet wrappers to use xep rather than fop1 extensions.

I don't particularly like either option at present, I've asked on the Boost.Build list if there's a better way.

John.

rrafal@… — Fri, 15 Jan 2010 17:42:45 GMT

Thanks a lot for working on it. I never expected such a quick response. Many thanks! Rafal

cc, owner, status changed

Daniel James — Sun, 24 Jan 2010 20:04:10 GMT

cc daniel_james@… added
owner changed from Daniel James to John Maddock
status assigned → new

Reassigning to John as he's doing all the work.

status changed; resolution set

John Maddock — Sun, 07 Feb 2010 10:28:18 GMT

status new → closed
resolution → fixed

Fixed in TRunk by adding a build script to take care of the necessary options. I'll do the same on the release branch when it reopens. 1.42.0 PDF builds should have this fixed too.