From: | Alexander Law <exclusion(at)gmail(dot)com> |
---|---|
To: | Alvaro Herrera <alvherre(at)2ndquadrant(dot)com> |
Cc: | Jürgen Purtz <juergen(at)purtz(dot)de>, pgsql-docs(at)postgresql(dot)org, Michael Meskes <meskes(at)postgresql(dot)org> |
Subject: | Re: Docbook 5.x |
Date: | 2016-09-14 16:56:32 |
Message-ID: | 22cf9006-691a-9d9d-5594-82270d012816@gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
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.
From | Date | Subject | |
---|---|---|---|
Next Message | thomas.deboben.ext | 2016-09-16 08:36:35 | Software Engineer |
Previous Message | Alvaro Herrera | 2016-09-14 16:41:05 | Re: Docbook 5.x |