14.09.2016 19:41, Alvaro Herrera wrote:
Alexander Law wrote:

14.09.2016 18:30, Alvaro Herrera wrote:
What's up with 30?
ecpg.sgml contains "<remark>The scope of the allocated descriptor is
WHAT?.</remark>", which is printed with XSLT but ignored with DSSSL.

Maybe we can just remove such remarks.
I added Michael on CC.  Maybe he can clarify what the scope of the
descriptor is, so that we can add some proper sentence, and remove the
<remark> tag.


It's strange that the xslt prints the <remark> text, when the historical
behavior was to ignore it.  Maybe OASIS changed their mind as to what it
meant.

In fact it's controlled by show.comments variable in XSLT, which is defined in doc/src/sgml/stylesheet-common.xsl as:

<xsl:param name="show.comments">
  <xsl:choose>
    <xsl:when test="contains($pg.version, 'devel')">1</xsl:when>
    <xsl:otherwise>0</xsl:otherwise>
  </xsl:choose>
</xsl:param>

And it's just inconsistent with the DSSSL definition ((define %show-comments% draft-mode)). So we can just ignore the difference. Though question that is still open since 2003 could be answered at the end of the day.




--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

Reply via email to