Subject: Re: The two "XML Fixes" patches still in need of review
To: Tom Lane <tgl@sss.pgh.pa.us>
References: <5C81F8C0.6090901@anastigmatix.net>
 <12427.1553375114@sss.pgh.pa.us> <5C96B141.5050802@anastigmatix.net>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>,
 Markus Winand <markus.winand@winand.at>,
 Alvaro Herrera <alvherre@2ndquadrant.com>,
 Michael Paquier <michael@paquier.xyz>,
 Pavel Stehule <pavel.stehule@gmail.com>
From: Chapman Flack <chap@anastigmatix.net>
Message-ID: <5C96C54F.5090901@anastigmatix.net>
Date: Sat, 23 Mar 2019 19:46:23 -0400
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101
 Thunderbird/38.7.0
MIME-Version: 1.0
In-Reply-To: <5C96B141.5050802@anastigmatix.net>
Content-Type: text/plain; charset=windows-1252
Content-Transfer-Encoding: 7bit
Precedence: bulk

On 03/23/19 18:20, Chapman Flack wrote:
>> Perhaps it'd make sense under the XML section in datatype.sgml,
>> but I think I might lean to making it a new section in Appendix D
>> (SQL Conformance).
> 
> Sounds like the option (4) I proposed back in [1]. I suppose it won't
> be much trouble to move.

The current structure of that appendix is: a few introductory paragraphs
(not wrapped in any <sect... ...>), followed by two <sect1>s that are
both autogenerated (the supported and unsupported features tables).

The <sect1>s become independent pages, in the HTML version.

- Move the XML limits/conformance section to a new <sect1> there?

- Before the autogenerated tables, or after them?

The un-<sect>ed intro paragraphs are preceded (in HTML) by a table
of contents, so the new section should show up there.

- Also add a mention (say, in the next-to-last intro paragraph) that
  there are notes on the SQL/XML conformance that have their own
  section (and link to it)? Or just let the generated ToC link be enough?


Regards,
-Chap