From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Subject: generate.consistent.ids
To: pgsql-docs <pgsql-docs@postgresql.org>
Organization: 2ndQuadrant
Message-ID: <9805774a-2e23-51fc-0ed0-afba91ee10ac@2ndquadrant.com>
Date: Fri, 1 Dec 2017 13:39:33 -0500
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.13; rv:52.0)
 Gecko/20100101 Thunderbird/52.4.0
MIME-Version: 1.0
Content-Type: multipart/mixed;
 boundary="------------02DA968B996E50BA3F603326"
Content-Language: en-US
Precedence: bulk

This is a multi-part message in MIME format.
--------------02DA968B996E50BA3F603326
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit

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

--------------02DA968B996E50BA3F603326
Content-Type: text/plain; charset=UTF-8; x-mac-type="0"; x-mac-creator="0";
 name="0001-doc-Turn-on-generate.consistent.ids-parameter.patch"
Content-Transfer-Encoding: base64
Content-Disposition: attachment;
 filename="0001-doc-Turn-on-generate.consistent.ids-parameter.patch"

RnJvbSBjMDNiMGY1NjU3ZDY0YjQ1N2U4NDRhN2E2ZGM0OWM3YTZhNzY4MWFlIE1vbiBTZXAg
MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBQZXRlciBFaXNlbnRyYXV0IDxwZXRlcl9lQGdteC5u
ZXQ+CkRhdGU6IEZyaSwgMSBEZWMgMjAxNyAxMzozMDoyMSAtMDUwMApTdWJqZWN0OiBbUEFU
Q0hdIGRvYzogVHVybiBvbiBnZW5lcmF0ZS5jb25zaXN0ZW50LmlkcyBwYXJhbWV0ZXIKCi0t
LQogZG9jL3NyYy9zZ21sL3N0eWxlc2hlZXQtY29tbW9uLnhzbCB8IDEgKwogMSBmaWxlIGNo
YW5nZWQsIDEgaW5zZXJ0aW9uKCspCgpkaWZmIC0tZ2l0IGEvZG9jL3NyYy9zZ21sL3N0eWxl
c2hlZXQtY29tbW9uLnhzbCBiL2RvYy9zcmMvc2dtbC9zdHlsZXNoZWV0LWNvbW1vbi54c2wK
aW5kZXggNjU4YTVhYzVlMS4uNmQyNmU3ZTVjOSAxMDA2NDQKLS0tIGEvZG9jL3NyYy9zZ21s
L3N0eWxlc2hlZXQtY29tbW9uLnhzbAorKysgYi9kb2Mvc3JjL3NnbWwvc3R5bGVzaGVldC1j
b21tb24ueHNsCkBAIC0zNiw2ICszNiw3IEBACiA8eHNsOnBhcmFtIG5hbWU9InJlZmVudHJ5
LmdlbmVyYXRlLnRpdGxlIiBzZWxlY3Q9IjEiPjwveHNsOnBhcmFtPgogPHhzbDpwYXJhbSBu
YW1lPSJyZWZlbnRyeS54cmVmLm1hbnZvbG51bSIgc2VsZWN0PSIwIi8+CiA8eHNsOnBhcmFt
IG5hbWU9ImZvcm1hbC5wcm9jZWR1cmVzIiBzZWxlY3Q9IjAiPjwveHNsOnBhcmFtPgorPHhz
bDpwYXJhbSBuYW1lPSJnZW5lcmF0ZS5jb25zaXN0ZW50LmlkcyIgc2VsZWN0PSIxIi8+CiA8
eHNsOnBhcmFtIG5hbWU9InB1bmN0Lmhvbm9yaWZpYyIgc2VsZWN0PSInJyI+PC94c2w6cGFy
YW0+CiA8eHNsOnBhcmFtIG5hbWU9InZhcmlhYmxlbGlzdC50ZXJtLmJyZWFrLmFmdGVyIj4x
PC94c2w6cGFyYW0+CiA8eHNsOnBhcmFtIG5hbWU9InZhcmlhYmxlbGlzdC50ZXJtLnNlcGFy
YXRvciI+PC94c2w6cGFyYW0+Ci0tIAoyLjE1LjAKCg==
--------------02DA968B996E50BA3F603326--