doc: make HTML manual reproducible
Versions of docbook-xsl newer than 1.79.1 allows xsltproc to assign IDs to nodes in the generated HTML consistently, to make the output resulting from the same source stable and reproducible. Pass the generate.consistent.ids parameter from the command line to ask for this feature. Older versions of the tool simply ignores the parameter and produces their output the same way as before this change, so there is no need to check for toolchain version. Signed-off-by: Arnout Engelen <arnout@bzzt.net> Helped-by: brian m. carlson <sandals@crustytoothpaste.net> Helped-by: Todd Zullinger <tmz@pobox.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Arnout Engelen committed
Dec 1, 2020 at 09:50 UTC
3569e11d6999cf18549626356784c9fd74f3d43e
1 file changed
+4
-1
Documentation/Makefile
+4
-1
@@ -380,7 +380,10 @@ SubmittingPatches.txt: SubmittingPatches
380
$(QUIET_GEN) cp $< $@
381
382
XSLT = docbook.xsl
383
-XSLTOPTS = --xinclude --stringparam html.stylesheet docbook-xsl.css
383
+XSLTOPTS =
384
+XSLTOPTS += --xinclude
385
+XSLTOPTS += --stringparam html.stylesheet docbook-xsl.css
386
+XSLTOPTS += --param generate.consistent.ids 1
387
388
user-manual.html: user-manual.xml $(XSLT)
389
$(QUIET_XSLTPROC)$(RM) $@+ $@ && \