From: Arnout Engelen <arnout@bzzt.net>
Date: Thu, 5 Nov 2020 20:27:02 +0000 (+0100)
Subject: docs: generate reproducible ids
X-Git-Tag: dbus-1.13.20~51^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=43e0188dbf6506f64150f3a9b2392e315b1bbdaf;p=thirdparty%2Fdbus.git

docs: generate reproducible ids

With this parameter, docbook will generate the same id's when generating the
same docs. This is helpful to get bit-by-bit 'reproducible' output, which
makes auditing the package easier.

Tested both the cmake output and the automake output
---

diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
index 8239c8e86..b7d020a88 100644
--- a/doc/CMakeLists.txt
+++ b/doc/CMakeLists.txt
@@ -129,7 +129,7 @@ macro(DOCBOOK _sources _format)
     set(_outfile ${CMAKE_CURRENT_BINARY_DIR}/${_outname})
     add_custom_command(
         OUTPUT ${_outfile}
-        COMMAND ${XSLTPROC_EXECUTABLE} --output ${_outfile} --nonet --xinclude  --param passivetex.extensions '1' ${STYLESHEET} ${_infile}
+        COMMAND ${XSLTPROC_EXECUTABLE} --output ${_outfile} --nonet --xinclude  --param passivetex.extensions '1' --param generate.consistent.ids '1' ${STYLESHEET} ${_infile}
         DEPENDS ${XSLTPROC_EXECUTABLE} ${_infile}
         WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
     )
diff --git a/doc/Makefile.am b/doc/Makefile.am
index b2a7b52ad..47bca32e2 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -84,7 +84,7 @@ if DBUS_XML_DOCS_ENABLED
 html_DATA += $(XMLTO_HTML)
 
 %.html: %.xml
-	$(XMLTO) html-nochunks $<
+	$(XMLTO) --stringparam generate.consistent.ids=1 html-nochunks $<
 
 %.1: %.1.xml
 	$(XMLTO) man $<