From: Chapman Flack <chap@anastigmatix.net>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Cc: Markus Winand <markus.winand@winand.at>
Cc: Alvaro Herrera <alvherre@2ndquadrant.com>
Cc: Michael Paquier <michael@paquier.xyz>
Cc: Pavel Stehule <pavel.stehule@gmail.com>
Subject: Re: The two "XML Fixes" patches still in need of review
Date: Sat, 23 Mar 2019 19:46:23 -0400
Message-ID: <5C96C54F.5090901@anastigmatix.net> (raw)
In-Reply-To: <5C96B141.5050802@anastigmatix.net>
References: <5C81F8C0.6090901@anastigmatix.net>
<12427.1553375114@sss.pgh.pa.us>
<5C96B141.5050802@anastigmatix.net>
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-hackers@postgresql.org
Cc: chap@anastigmatix.net, tgl@sss.pgh.pa.us, pgsql-hackers@lists.postgresql.org, markus.winand@winand.at, alvherre@2ndquadrant.com, michael@paquier.xyz, pavel.stehule@gmail.com
Subject: Re: The two "XML Fixes" patches still in need of review
In-Reply-To: <5C96C54F.5090901@anastigmatix.net>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox