pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedgenerate.consistent.ids
2+ messages / 1 participants
[nested] [flat]
* generate.consistent.ids
@ 2017-12-01 18:39 Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
0 siblings, 1 reply; 2+ messages in thread
From: Peter Eisentraut @ 2017-12-01 18:39 UTC (permalink / raw)
To: pgsql-docs
When the stylesheets create anchors on elements that don't have an id
attribute, they use some internal mechanism to make one up. With the
DSSSL stylesheets, those are the things like AEN112787. With the new
XSL stylesheets, you similarly get things like idm21497, but unlike the
DSSSL way, those are not consistent across builds, because they are made
from some internal memory locations. That makes it hard to diff build
results without resorting to a bunch of tricks that we have had to use
recently to manage the toolchain transition. And such links cannot be
shared, because they change on the next build.
I found that the setting
<xsl:param name="generate.consistent.ids" select="1"/>
also enables the XSL stylesheets to produce anchors that are consistent
across builds. I would have expected that to increase the build time,
but in my testing the penalty is barely noticeable. So I would like to
make this change in PG11 and also PG10. Patch attached.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
Attachments:
0001-doc-Turn-on-generate.consistent.ids-parameter.patch (text/plain, 949B) download
From c03b0f5657d64b457e844a7a6dc49c7a6a7681ae Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Fri, 1 Dec 2017 13:30:21 -0500
Subject: [PATCH] doc: Turn on generate.consistent.ids parameter
---
doc/src/sgml/stylesheet-common.xsl | 1 +
1 file changed, 1 insertion(+)
diff --git a/doc/src/sgml/stylesheet-common.xsl b/doc/src/sgml/stylesheet-common.xsl
index 658a5ac5e1..6d26e7e5c9 100644
--- a/doc/src/sgml/stylesheet-common.xsl
+++ b/doc/src/sgml/stylesheet-common.xsl
@@ -36,6 +36,7 @@
<xsl:param name="refentry.generate.title" select="1"></xsl:param>
<xsl:param name="refentry.xref.manvolnum" select="0"/>
<xsl:param name="formal.procedures" select="0"></xsl:param>
+<xsl:param name="generate.consistent.ids" select="1"/>
<xsl:param name="punct.honorific" select="''"></xsl:param>
<xsl:param name="variablelist.term.break.after">1</xsl:param>
<xsl:param name="variablelist.term.separator"></xsl:param>
--
2.15.0
* Re: generate.consistent.ids
@ 2017-12-05 14:07 Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
parent: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
0 siblings, 0 replies; 2+ messages in thread
From: Peter Eisentraut @ 2017-12-05 14:07 UTC (permalink / raw)
To: pgsql-docs
On 12/1/17 13:39, Peter Eisentraut wrote:
> I found that the setting
>
> <xsl:param name="generate.consistent.ids" select="1"/>
>
> also enables the XSL stylesheets to produce anchors that are consistent
> across builds. I would have expected that to increase the build time,
> but in my testing the penalty is barely noticeable. So I would like to
> make this change in PG11 and also PG10. Patch attached.
committed to master and PG10
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2017-12-05 14:07 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2017-12-01 18:39 generate.consistent.ids Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
2017-12-05 14:07 ` Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox