Subject: Re: [DOCS] Docbook 5.x
To: Alexander Lakhin <exclusion@gmail.com>, =?UTF-8?Q?J=c3=bcrgen_Purtz?=
 <juergen@purtz.de>
References: <57179283.6080704@purtz.de>
 <c7e45017-c918-d2ec-a7e5-f696e41c5314@gmail.com>
 <e4e972b8-425b-164b-031e-f6db2daef9d2@2ndquadrant.com>
 <8f227b2a-5093-8d99-85da-ea00e18343f6@gmail.com>
 <aab72af9-928c-e116-d342-804bf78911c6@gmail.com>
 <449e34c4-9cc8-d17d-5ebe-be92b4c0a87a@gmail.com>
 <09b13d85-e259-2464-723a-467210264afe@2ndquadrant.com>
 <f00bf53f-e6b5-a033-69be-0c63878f0d30@gmail.com>
 <9e8cafe4-7cfd-59be-6856-172c15dc758f@2ndquadrant.com>
 <ac8351bf-a97a-5ff7-1df5-747a3962efb8@purtz.de>
 <11c0be48-6125-bbe1-1d02-6d61e889bd5e@gmail.com>
 <cc211497-deed-6fa8-d47e-9bbb23504ca1@2ndquadrant.com>
 <2162400e-e279-94fc-c47f-bfab18ceb700@gmail.com>
 <07342223-4eec-6523-2de2-11587f3f0920@2ndquadrant.com>
 <18ed8940-ae84-09c9-1236-d8a9648b2417@gmail.com>
 <b4fd6932-8d44-3210-48ab-bbc393bf9a23@gmail.com>
 <047254d2-d46c-94af-1933-4551633a909b@2ndquadrant.com>
 <e2639041-41bd-ce00-f4fd-a5d945ce37ba@2ndquadrant.com>
 <7a6cc69f-c8b9-686b-9c00-0e10866ee163@gmail.com>
Cc: pgsql-docs@postgresql.org, Tom Lane <tgl@sss.pgh.pa.us>
From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Organization: 2ndQuadrant
Message-ID: <90b1cc0c-eb1d-65ec-5fd9-8e2d0b707584@2ndquadrant.com>
Date: Tue, 28 Nov 2017 11:02:14 -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
In-Reply-To: <7a6cc69f-c8b9-686b-9c00-0e10866ee163@gmail.com>
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: 8bit
Precedence: bulk

On 11/25/17 00:50, Alexander Lakhin wrote:
> Please, consider applying the attached patch. It produces the same
> INSTALL and is much better in the following aspects.
> 
> 1. All the INSTALL content is placed in two files (installation.sgml and
> installation-single.xsl) instead of three (installation.sgml,
> standalone-install.xml, standalone-profile.xsl).
> 2. There are no unreadable and untranslatable (in context) constructions
> such as
> <xsl:template match="xref[@linkend='plpython-python23']">
>   <xsl:text>the
> </xsl:text><application>PL/Python</application><xsl:text>
> documentation</xsl:text>
> </xsl:template>
> (Sometimes translators need to replace larger fragments.)
> 3. It uses only XSLT (which we use already), no xi:include.
> 4. It doesn't generate complete postgres.sgml to process only the
> installation section.

What is the standalonetext attribute?  I don't see that in the DTD.
Wouldn't that fail validation?

Also, the makefile fragments need to be written differently.  You can't
use pipes; that would not catch any errors.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services