Subject: Re: backpatching documentation after conversion to XML
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>,
 pgsql-docs <pgsql-docs@postgresql.org>
References: <609dc528-6eab-522d-5b7d-842bd83159e5@2ndquadrant.com>
 <dec8f417-4b42-4e4f-8dfd-d8256bb437b4@gmail.com>
 <14052.1508690564@sss.pgh.pa.us>
From: Alexander Lakhin <exclusion@gmail.com>
Message-ID: <8bb5a579-5a9d-3aad-7b27-275b0b9bb4c2@gmail.com>
Date: Sun, 22 Oct 2017 21:00:06 +0300
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101
 Thunderbird/52.4.0
MIME-Version: 1.0
In-Reply-To: <14052.1508690564@sss.pgh.pa.us>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
Content-Language: en-US
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org

22.10.2017 19:42, Tom Lane writes:
>> I think we should make a script to backport doc/-related commits.
> That's an interesting idea, but I really doubt that you'll be able
> to make a script that copes with this without having back-patched
> the changes we're discussing.  As an example, any given closing tag
> might've already been spelled out in the back branches; we've never
> been consistent about that.  So you couldn't just automatically
> shorten all the closing tags and expect to have a patch that applies.
I understand the major difficulties we have to deal with. I have the 
following plan in mind:
1. Get a diff for a single xml.
2. Find corresponding sgml in the old target branch.
3. Convert the sgml to xml following the same procedure that we applied 
for the master branch.
4. Try to apply the diff.
5. If it's applied successfully, detect the lines where changes occured 
(sgml->xml conversion doesn't move the lines) and
modify corresponding lines in sgml with the content modified for sgml 
(<xref .../> changed to <xref > and so on.)

I think this should work for 90% of cases.


------
Alexander Lakhin
Postgres Professional: http://www.postgrespro.com
The Russian Postgres Company


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