From: Tom Lane <tgl@sss.pgh.pa.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
cc: thomas.petazzoni@bootlin.com, pgsql-bugs@lists.postgresql.org
Subject: Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book:
 validity error : No declaration for attribute id of
In-reply-to: 
 <CAKFQuwYFzrWgUn460zBXyvnN3QGCeNbskDJArZvnj2Jj00v8RQ@mail.gmail.com>
References: <18760-82d1b83da31b898d@postgresql.org>
 <CAKFQuwYFzrWgUn460zBXyvnN3QGCeNbskDJArZvnj2Jj00v8RQ@mail.gmail.com>
Comments: In-reply-to "David G. Johnston" <david.g.johnston@gmail.com>
	message dated "Wed, 19 Mar 2025 18:32:58 -0700"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <909780.1742440783.1@sss.pgh.pa.us>
Content-Transfer-Encoding: quoted-printable
Date: Wed, 19 Mar 2025 23:19:43 -0400
Message-ID: <909781.1742440783@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/909781.1742440783%40sss.pgh.pa.us>
Precedence: bulk

"David G. Johnston" <david.g.johnston@gmail.com> writes:
> The only error that really matters here is:

> I/O error : Attempt to load network entity:
> http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
> ../doc/src/sgml/postgres.sgml:22: warning: failed to load external entit=
y "
> http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"

> Everything else stems from that.

Ah, indeed.  Our docs are fairly clear[1] that you need a
locally-installed copy of the DocBook DTDs to build the docs.
It used to be the case that xmllint and friends could pull down
the DTDs using the given URL, but that stopped working a couple
of years ago[2].  (Experimenting just now by removing the -nonet
switches, it seems like the failure symptoms are a bit different than
they were in 2023.  But it still fails, so the details are academic,
except maybe to someone who could fix www.oasis-open.org.  Which is
not us.)

>> Passing -Ddocs=3Ddisabled -Ddocs_pdf=3Ddisabled does not fix the issue:

If real, that's a bug in our Meson scripts, but evidence seems lacking.

			regards, tom lane

[1] https://www.postgresql.org/docs/current/docguide-toolsets.html
[2] https://www.postgresql.org/message-id/flat/CAJ7c6TO8Aro2nxg%3DEQsVGiSD=
e-TstP4EsSvDHd7DSRsP40PgGA%40mail.gmail.com