summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohan Ouwerkerk <jm.ouwerkerk@gmail.com>2015-07-13 10:39:09 +0200
committerJohan Ouwerkerk <jm.ouwerkerk@gmail.com>2015-07-13 16:30:30 +0200
commitd77c25b1164f55fe3f9b5ad00c47c0e01243ad53 (patch)
treec50734137b723e5e52069290f5efa0e471323b0e
parente43a8393eaf058c4ecd2a5968f59d83b911d4f1f (diff)
doc: configure docbook stylesheet to generate reproducible IDs
This makes auto generated anchor tags in HTML output reproducible.
-rw-r--r--man/custom-html.xsl10
1 files changed, 10 insertions, 0 deletions
diff --git a/man/custom-html.xsl b/man/custom-html.xsl
index f51fda77e6..151276362c 100644
--- a/man/custom-html.xsl
+++ b/man/custom-html.xsl
@@ -22,6 +22,16 @@
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl"/>
+<!--
+ - The docbook stylesheet injects empty anchor tags into generated HTML, identified by an auto-generated ID.
+ - Ask the docbook stylesheet to generate reproducible output when generating (these) ID values.
+ - This makes the output of this stylesheet reproducible across identical invocations on the same input,
+ - which is an easy and significant win for achieving reproducible builds.
+ -
+ - It may be even better to strip the empty anchors from the document output in addition to turning on consistent IDs,
+ - for this stylesheet contains its own custom ID logic (for generating permalinks) already.
+ -->
+<xsl:param name="generate.consistent.ids" select="1"/>
<!-- translate man page references to links to html pages -->
<xsl:template match="citerefentry[not(@project)]">