generate.consistent.ids

From: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>
To: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: generate.consistent.ids
Date: 2017-12-01 18:39:33
Message-ID: 9805774a-2e23-51fc-0ed0-afba91ee10ac@2ndquadrant.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: 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

Attachment Content-Type Size
0001-doc-Turn-on-generate.consistent.ids-parameter.patch text/plain 949 bytes

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message barbiomalefico 2017-12-03 09:35:46 followed by example doesn't work
Previous Message Aleksandr Parfenov 2017-12-01 11:12:36 Replication parameters in recovery.conf