From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | pgsql-committers(at)lists(dot)postgresql(dot)org |
Subject: | pgsql: Stop recommending auto-download of DTD files, and indeed disable |
Date: | 2023-02-08 22:15:59 |
Message-ID: | E1pPsjO-0008ls-Du@gemulon.postgresql.org |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-committers pgsql-hackers |
Stop recommending auto-download of DTD files, and indeed disable it.
It appears no longer possible to build the SGML docs without a local
installation of the DocBook DTD, because sourceforge.net now only
permits HTTPS access, and no common version of xsltproc supports that.
Hence, remove the bits of our documentation suggesting that that's
possible or useful.
In fact, we might as well add the --nonet option to the build recipes
automatically, for a bit of extra security.
Also fix our documentation-tool-installation recipes for macOS to
ensure that xmllint and xsltproc are pulled in from MacPorts or
Homebrew. The previous recipes assumed you could use the
Apple-supplied versions of these tools; which still works, except that
you'd need to set an environment variable to ensure that they would
find DTD files provided by those package managers. Simpler and easier
to just recommend pulling in the additional packages.
In HEAD, also document how to build docs using Meson, and adjust
"ninja docs" to just build the HTML docs, for consistency with the
default behavior of doc/src/sgml/Makefile.
In a fit of neatnik-ism, I also made the ordering of the package
lists match the order in which the tools are described at the head
of the appendix.
Aleksander Alekseev, Peter Eisentraut, Tom Lane
Discussion: https://postgr.es/m/CAJ7c6TO8Aro2nxg=EQsVGiSDe-TstP4EsSvDHd7DSRsP40PgGA@mail.gmail.com
Branch
------
REL_15_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/2ee703c9d1c6bbbae8b19807c23f91d75d17271e
Modified Files
--------------
doc/src/sgml/Makefile | 8 +++++--
doc/src/sgml/docguide.sgml | 55 ++++++++++++++++++++++----------------------
doc/src/sgml/images/Makefile | 2 +-
3 files changed, 34 insertions(+), 31 deletions(-)
From | Date | Subject | |
---|---|---|---|
Next Message | Andres Freund | 2023-02-09 02:20:22 | pgsql: Fix bugs in GetSafeSnapshotBlockingPids(), introduced in 9600371 |
Previous Message | Andrew Dunstan | 2023-02-08 22:08:49 | pgsql: pgindent: more ways to find files to indent |
From | Date | Subject | |
---|---|---|---|
Next Message | Peter Smith | 2023-02-08 22:16:49 | Re: Support logical replication of DDLs |
Previous Message | Andres Freund | 2023-02-08 22:15:28 | Re: deadlock-hard flakiness |