pg.ddx.io pgsql-committers@postgresql.org mailing list archive
help / color / mirror / Atom feedpgsql: Stop recommending auto-download of DTD files, and indeed disable
8+ messages / 2 participants
[nested] [flat]
* pgsql: Stop recommending auto-download of DTD files, and indeed disable
@ 2023-02-08 22:15 Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 8+ messages in thread
From: Tom Lane @ 2023-02-08 22:15 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
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
------
master
Details
-------
https://git.postgresql.org/pg/commitdiff/969509c3f2e3b4c32dcf264f9d642b5ef01319f3
Modified Files
--------------
doc/src/sgml/Makefile | 8 +++-
doc/src/sgml/docguide.sgml | 88 +++++++++++++++++++++++++++++---------------
doc/src/sgml/images/Makefile | 2 +-
doc/src/sgml/meson.build | 8 ++--
4 files changed, 70 insertions(+), 36 deletions(-)
^ permalink raw reply [nested|flat] 8+ messages in thread
* pgsql: Stop recommending auto-download of DTD files, and indeed disable
@ 2023-02-08 22:15 Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 8+ messages in thread
From: Tom Lane @ 2023-02-08 22:15 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
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(-)
^ permalink raw reply [nested|flat] 8+ messages in thread
* pgsql: Stop recommending auto-download of DTD files, and indeed disable
@ 2023-02-08 22:15 Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 8+ messages in thread
From: Tom Lane @ 2023-02-08 22:15 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
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_14_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/7f8778fcf3428756c1c9ab1ee26ff328e00bf608
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(-)
^ permalink raw reply [nested|flat] 8+ messages in thread
* pgsql: Stop recommending auto-download of DTD files, and indeed disable
@ 2023-02-08 22:15 Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 8+ messages in thread
From: Tom Lane @ 2023-02-08 22:15 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
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_13_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/c7b608600547426b1a3181f9b6d4d2e117624e1e
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(-)
^ permalink raw reply [nested|flat] 8+ messages in thread
* pgsql: Stop recommending auto-download of DTD files, and indeed disable
@ 2023-02-08 22:15 Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 8+ messages in thread
From: Tom Lane @ 2023-02-08 22:15 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
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_12_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/11f1f9f4fa309d2592acd71de01765a333a435bb
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(-)
^ permalink raw reply [nested|flat] 8+ messages in thread
* pgsql: Stop recommending auto-download of DTD files, and indeed disable
@ 2023-02-08 22:15 Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 0 replies; 8+ messages in thread
From: Tom Lane @ 2023-02-08 22:15 UTC (permalink / raw)
To: pgsql-committers@lists.postgresql.org
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_11_STABLE
Details
-------
https://git.postgresql.org/pg/commitdiff/36a646d99c3fb5262aff00fe7d3d40c2cdbb6d34
Modified Files
--------------
doc/src/sgml/Makefile | 8 +++++--
doc/src/sgml/docguide.sgml | 55 +++++++++++++++++++++++-----------------------
2 files changed, 33 insertions(+), 30 deletions(-)
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: pgsql: Stop recommending auto-download of DTD files, and indeed disable
@ 2023-03-21 20:45 Robert Haas <robertmhaas@gmail.com>
parent: Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 8+ messages in thread
From: Robert Haas @ 2023-03-21 20:45 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-hackers@postgresql.org <pgsql-hackers@postgresql.org>
On Wed, Feb 8, 2023 at 5:16 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
> Stop recommending auto-download of DTD files, and indeed disable it.
According to this commit:
<para>
The Homebrew-supplied programs require the following environment variable
to be set:
<programlisting>
export XML_CATALOG_FILES=/usr/local/etc/xml/catalog
</programlisting>
Without it, <command>xsltproc</command> will throw errors like this:
<programlisting>
I/O error : Attempt to load network entity
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
postgres.sgml:21: warning: failed to load external entity
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd";
...
</programlisting>
</para>
I use MacPorts, rather than Homebrew, but still found it necessary to
do something similar, specifically:
export XML_CATALOG_FILES=/opt/local/etc/xml/catalog
--
Robert Haas
EDB: http://www.enterprisedb.com
^ permalink raw reply [nested|flat] 8+ messages in thread
* Re: pgsql: Stop recommending auto-download of DTD files, and indeed disable
@ 2023-03-21 20:52 Robert Haas <robertmhaas@gmail.com>
parent: Robert Haas <robertmhaas@gmail.com>
0 siblings, 0 replies; 8+ messages in thread
From: Robert Haas @ 2023-03-21 20:52 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; +Cc: pgsql-hackers@postgresql.org <pgsql-hackers@postgresql.org>
On Tue, Mar 21, 2023 at 4:45 PM Robert Haas <robertmhaas@gmail.com> wrote:
> I use MacPorts, rather than Homebrew, but still found it necessary to
> do something similar, specifically:
>
> export XML_CATALOG_FILES=/opt/local/etc/xml/catalog
Ah, never mind. I had an incorrect value in my environment. If I unset
it completely, it works just as well as setting a correct value.
Sorry for the noise.
--
Robert Haas
EDB: http://www.enterprisedb.com
^ permalink raw reply [nested|flat] 8+ messages in thread
end of thread, other threads:[~2023-03-21 20:52 UTC | newest]
Thread overview: 8+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2023-02-08 22:15 pgsql: Stop recommending auto-download of DTD files, and indeed disable Tom Lane <tgl@sss.pgh.pa.us>
2023-02-08 22:15 pgsql: Stop recommending auto-download of DTD files, and indeed disable Tom Lane <tgl@sss.pgh.pa.us>
2023-03-21 20:45 ` Robert Haas <robertmhaas@gmail.com>
2023-03-21 20:52 ` Robert Haas <robertmhaas@gmail.com>
2023-02-08 22:15 pgsql: Stop recommending auto-download of DTD files, and indeed disable Tom Lane <tgl@sss.pgh.pa.us>
2023-02-08 22:15 pgsql: Stop recommending auto-download of DTD files, and indeed disable Tom Lane <tgl@sss.pgh.pa.us>
2023-02-08 22:15 pgsql: Stop recommending auto-download of DTD files, and indeed disable Tom Lane <tgl@sss.pgh.pa.us>
2023-02-08 22:15 pgsql: Stop recommending auto-download of DTD files, and indeed disable Tom Lane <tgl@sss.pgh.pa.us>
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