Subject: Re: Docbook 5.x
To: Alexander Lakhin <exclusion@gmail.com>, =?UTF-8?Q?J=c3=bcrgen_Purtz?=
 <juergen@purtz.de>
References: <57179283.6080704@purtz.de>
 <4adecfc6-2f2e-2ff2-bfa3-58b7d397227b@gmail.com>
 <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>
 <4317d27a-9f9c-dfeb-2758-446243c66ddf@gmail.com>
Cc: pgsql-docs@postgresql.org
From: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Organization: 2ndQuadrant
Message-ID: <45f75674-221b-1ec4-69ca-f9c00bd4bff6@2ndquadrant.com>
Date: Sat, 18 Nov 2017 12:24:38 -0500
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.12; rv:52.0)
 Gecko/20100101 Thunderbird/52.4.0
MIME-Version: 1.0
In-Reply-To: <4317d27a-9f9c-dfeb-2758-446243c66ddf@gmail.com>
Content-Type: text/plain; charset=utf-8
Content-Language: en-US
Content-Transfer-Encoding: 8bit
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

On 11/16/17 01:00, Alexander Lakhin wrote:
> 1. Can you share the exact scripts you use to generate 0002?

I used the script you (or Jürgen) provided.

> 2. Will you rename *.sgml to *.xml and move src/sgml to src/xml?

Not right now, but we should have that discussion at some point over the
next few months.

> 3. And I still think that hard-coding references and replacements in the
> standalone-profile is not good. Are you going to apply less hackish
> approach?
> (See
> https://www.postgresql.org/message-id/b4fd6932-8d44-3210-48ab-bbc393bf9a23%40gmail.com
> , patches/xml/installation.patch and patches/xml/installation-single.xsl)

The patches you send me are very confusing.  If you can send me a
separate patch of what you have in mind and why and so on, we can
consider it separately, but right now I don't have much interest in
revisiting this.  What is committed works well, stays out of the way,
and causes no problems AFAICT.

> 4. BTW, when making postgres-A4.pdf, I get
> [WARN] FOUserAgent - Destination: Unresolved ID reference
> "ecpg-type-timestamp-date" found.
> It can be fixed by moving the id from the title tag to sect4:
> -    <sect4>
> -     <title id="ecpg-type-timestamp-date">timestamp, date</title>
> +    <sect4 id="ecpg-type-timestamp-date">
> +     <title>timestamp, date</title>
> I wonder, what were the reasons to set id for the title tag?

In some cases the ids on the title tags were necessary for the DSSSL
stylesheets.  They can be removed now with some care.  I have some
partial patches for that.

These particular warnings seem harmless.  I have found the following
reference:
<https://lists.oasis-open.org/archives/docbook-apps/201510/msg00052.html>

But I see the same warnings in the PG10 build, so this does not appear
to be a regression from the XML conversion.

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


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