Skip to content

Conversation

@sdarwin
Copy link

@sdarwin sdarwin commented Feb 17, 2023

Per a request, this updates DOCBOOK_XSL_VERSION from 1.75.2 to 1.79.1, and switches to the zip file download because the tar.gz archive isn't available.

As far as the general topic of installing the docs toolchain, these scripts at https://github.com/boostorg/release-tools/tree/develop/build_docs are able to install necessary apt, gem, and pip packages, and build docs for boost libraries. So it's probably not necessary to extensively enhance setup_boostbook.sh, just use the build_docs scripts.

@vinniefalco
Copy link
Member

build_docs is interesting, didn't know about that.

@vinniefalco
Copy link
Member

Someone got errors building the docs for Boost.Core, and this pull request would fix it.

@Lastique
Copy link
Member

Lastique commented May 5, 2024

and switches to the zip file download because the tar.gz archive isn't available.

There is a .tar.bz2 archive.

@Lastique
Copy link
Member

Lastique commented May 5, 2024

And by the way, the project moved to GitHub, and there already was a 1.79.2 release:

https://github.com/docbook/xslt10-stylesheets/releases/tag/release%2F1.79.2

@vinniefalco
Copy link
Member

Anyway... since it has been over a year with no progress merging this, I think it is safe to close it. Note that we are moving away from the Quickbook toolchain because it is not being actively maintained and developed. Instead we are focusing on Asciidoctor.

@Lastique
Copy link
Member

Lastique commented May 6, 2024

I'm certainly not moving away from QuickBook.

@vinniefalco
Copy link
Member

I'm certainly not moving away from QuickBook.

No one is asking you to. The "we" in my statement above refers to myself, Peter Dimov, Glen Fernandes, Rene Morell, all C++ Alliance Staff Engineers, and any other library author or maintainers who want to update to a modern, well-supported toolchain.

# User configuration
# (MAINTANERS: please, keep in synch with setup_boostbook.sh)
DOCBOOK_XSL_VERSION = "1.75.2"
DOCBOOK_XSL_VERSION = "1.79.1"
Copy link

@barendgehrels barendgehrels Sep 22, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Version 1.79.2 (the newest) gives errors in the chunking. The documentation is not correct anymore with the parameters supplied in current Jamfiles (at least, not for Boost.Geometry). It misses all tables of contents (apart from the one on the main page). Effectively it's completely broken.

That's likely the case with 1.79.1 as well, given that it is one patch lower.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With version 1.79.1 , generation of Boost.Geometry is correct!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants