[boostbook] Building documentation with generate.consistent.ids
This was originally sent to the boost-docs list, but it doesn't seem
to be working, so I'm sending it here. Sorry if you receive it twice.
A while ago Gregor Jasny suggested building with the
generate.consistent.ids option to reduce the changes between snapshots
(as many elements in the documentation had random id numbers). I've
tried turning it on for the develop documentation build, and tweaked
boostbook a little to take advantage of it as well.
With this setting generated ids can change when the documentation is
edited, but not on every build. If you have standalone documentation
and you want to use this feature, you need to use
'<xsl:param>generate.consistent.ids=1' in the boostbook rule in your
This mainly affects boostbook reference documentation, such as: