diff options
| author | Alan Coopersmith <alan.coopersmith@oracle.com> | 2016-01-05 15:15:41 -0800 |
|---|---|---|
| committer | Alan Coopersmith <alan.coopersmith@oracle.com> | 2016-01-05 15:29:40 -0800 |
| commit | aa97249b332f23fec7b0575ab5d634b8180dcada (patch) | |
| tree | 52a45bc53339dcaf6402f0bc4d3f7dfbcb09a181 | |
| parent | 667bbabad33d034cdf20f215ad5110e92ba9d41a (diff) | |
Set generate.consistent.ids in xsl stylesheets for more repeatable builds
Causes auto-generation of id attributes to use values based on position in
document, such as id="id-1.5.9.5.2", instead of based on memory address of
parse tree, such as id="idm140664351287904", so that generated documents
end up with the same contents across rebuilds & platforms (especially on
platforms using address space layout randomization).
Does not guarantee long-term stability of links across releases, just
repeatability when building the same release multiple times - values
will change when documents are edited to add/remove/reorder sections.
Only effective when used with version 1.77 or later of the
DocBook XSL stylesheets (released in 2012).
Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
| -rw-r--r-- | xorg-chunk.xsl | 7 | ||||
| -rw-r--r-- | xorg-fo.xsl | 7 | ||||
| -rw-r--r-- | xorg-xhtml.xsl | 6 | ||||
| -rw-r--r-- | xorg.xsl | 6 |
4 files changed, 26 insertions, 0 deletions
diff --git a/xorg-chunk.xsl b/xorg-chunk.xsl index 93b18b5..2e7f7b5 100644 --- a/xorg-chunk.xsl +++ b/xorg-chunk.xsl @@ -44,6 +44,13 @@ <!-- Index links should point to indexterm location, not start of section --> <xsl:param name="index.links.to.section" select="0"/> + <!-- + Use element count instead of random number for id generation, for more + repeatable builds + --> + <xsl:param name="generate.consistent.ids" select="1"/> + + <!-- HTML Parameters --> <!-- Uses XSLT Extension to provide more valid and better formatted elements--> diff --git a/xorg-fo.xsl b/xorg-fo.xsl index 4680db3..41fb3f3 100644 --- a/xorg-fo.xsl +++ b/xorg-fo.xsl @@ -41,6 +41,13 @@ <xsl:attribute name="break-after">page</xsl:attribute> </xsl:attribute-set> + <!-- + Use element count instead of random number for id generation, for more + repeatable builds + --> + <xsl:param name="generate.consistent.ids" select="1"/> + + <!-- Pagination and General Styles FO Parameters --> <!-- Speed up ps & pdf creation by not creating pages with "draft" image, diff --git a/xorg-xhtml.xsl b/xorg-xhtml.xsl index d9b7b3e..502aafc 100644 --- a/xorg-xhtml.xsl +++ b/xorg-xhtml.xsl @@ -44,6 +44,12 @@ <!-- Index links should point to indexterm location, not start of section --> <xsl:param name="index.links.to.section" select="0"/> + <!-- + Use element count instead of random number for id generation, for more + repeatable builds + --> + <xsl:param name="generate.consistent.ids" select="1"/> + <!-- HTML Parameters --> <!-- Uses XSLT Extension to provide more valid and better formatted elements--> @@ -41,6 +41,12 @@ DEALINGS IN THE SOFTWARE. <!-- Index links should point to indexterm location, not start of section --> <xsl:param name="index.links.to.section" select="0"/> + <!-- + Use element count instead of random number for id generation, for more + repeatable builds + --> + <xsl:param name="generate.consistent.ids" select="1"/> + <!-- PDF bookmarks extensions for FOP version 0.90 and later will be used. --> <xsl:param name="fop.extensions" select="0"></xsl:param> <xsl:param name="fop1.extensions" select="1"></xsl:param> |