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-04-09T18:50:50Z
Lists: pgsql-hackers
On Thu, Mar 30, 2023 at 01:27:05AM -0500, Karl O. Pinc wrote: > On Wed, 29 Mar 2023 21:32:05 -0700 > Noah Misch <noah@leadboat.com> wrote: > > > 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.) > > Your point seems valid but this is above my station. > I have no idea as to how to best resolve this, or even how to make the > resolution happen now that the change has been committed. I'm inclined to just remove <para id="contrib-obsolete">. While intagg is indeed obsolete, having a one-entry list seems like undue weight.
Commits
-
Remove new <para id="contrib-obsolete">.
- 244ab8c00c42 16.0 landed
-
doc/PDF: Add page breaks for <sect1> in contrib appendix
- 30e9f2608adf 16.0 landed
-
doc: Add lists of modules trusted/obsolete
- a0137388cb64 16.0 landed
-
HTML docs: Add padding to table.simplelist for more readable output
- a7e584a7d68a 16.0 landed
-
Describe each contrib module in its SGML section title
- e86c8b728f3c 16.0 landed