Re: Doc: Rework contrib appendix -- informative titles, tweaked sentences

Noah Misch <noah@leadboat.com>

From: Noah Misch <noah@leadboat.com>
To: "Karl O. Pinc" <kop@karlpinc.com>
Cc: Alvaro Herrera <alvherre@alvh.no-ip.org>, PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>
Date: 2023-03-30T04:32:05Z
Lists: pgsql-hackers
On Sun, Jan 22, 2023 at 02:42:46PM -0600, Karl O. Pinc wrote:
> v10-0001-List-trusted-and-obsolete-extensions.patch

> + <para id="contrib-obsolete">
> +   These modules and extensions are obsolete:
> +
> +   <simplelist type="inline">
> +     <member><xref linkend="intagg"/></member>
> +     <member><xref linkend="xml2"/></member>
> +   </simplelist>
> + </para>

Commit a013738 incorporated this change.  Since xml2 is the only in-tree way
to use XSLT from SQL, I think xml2 is not obsolete.  Some individual
functions, e.g. xml_valid(), are obsolete.  (There are years-old threats to
render the module obsolete, but this has never happened.)



Commits

  1. Remove new <para id="contrib-obsolete">.

  2. doc/PDF: Add page breaks for <sect1> in contrib appendix

  3. doc: Add lists of modules trusted/obsolete

  4. HTML docs: Add padding to table.simplelist for more readable output

  5. Describe each contrib module in its SGML section title