Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of

On Tue, Dec 31, 2024 at 4:45 AM PG Bug reporting form <
noreply(at)postgresql(dot)org> wrote:

> The following bug has been logged on the website:
>
> Bug reference: 18760
> Logged by: Thomas Petazzoni
> Email address: thomas(dot)petazzoni(at)bootlin(dot)com
> PostgreSQL version: 17.2
> Operating system: Linux
> Description:
>
> When building PostgreSQL 17.2 on a Linux host machine (within a Debian
> Bullseye container), the build fails with:
>
> ../doc/src/sgml/postgres.sgml:24: element book: validity error : No
> declaration for attribute id of element book
> <book id="postgres">
>

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 entity "
http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"

Everything else stems from that.

Passing -Ddocs=disabled -Ddocs_pdf=disabled does not fix the issue:

This does seem like a bug but the build log you linked to (not inlining
only relevant content in the email may be part of why this went unresponded
to) doesn't show these disables and so it tried to build the documentation
and failed because of the above.

The IO error seems to be environmental, outside what we can fix from a bug
perspective. Following up on that in -general may yield fruit.

If you want to repost a current attempt at disabling documentation builds
then seeing the aforementioned error you can do that here. That is a bug
we'd be in a position to try and fix at least.

David J.