pg.ddx.io pgsql-bugs@postgresql.org mailing list archive
help / color / mirror / Atom feedBUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of
4+ messages / 4 participants
[nested] [flat]
* BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of
@ 2024-12-31 09:01 PG Bug reporting form <noreply@postgresql.org>
2025-03-20 01:32 ` Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of David G. Johnston <david.g.johnston@gmail.com>
0 siblings, 1 reply; 4+ messages in thread
From: PG Bug reporting form @ 2024-12-31 09:01 UTC (permalink / raw)
To: pgsql-bugs@lists.postgresql.org; +Cc: thomas.petazzoni@bootlin.com
The following bug has been logged on the website:
Bug reference: 18760
Logged by: Thomas Petazzoni
Email address: thomas.petazzoni@bootlin.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">
^
../doc/src/sgml/postgres.sgml:25: element title: validity error : No
declaration for element title
<title>PostgreSQL &version; Documentation</title>
and many other similar failures. Complete build log available at
http://autobuild.buildroot.net/results/378/378027db50fdcb311b420ad6886795dd8c2888f6/build-end.log.
Passing -Ddocs=disabled -Ddocs_pdf=disabled does not fix the issue: indeed
despite those options, the PostgreSQL build system detects that xmllint and
xsltproc are available, and uses them nevertheless. Passing bogus
-DXMLLINT=/nowhere -DXSLTPROC=/nowhere options prevents PostgreSQL from
finding xmllint and xsltproc, which makes it skip build the documentation,
and gets a successful build, but that's really more a hack than a correct
solution.
It looks like doc/src/sgml/meson.build would need some changes to properly
obey to the "docs" and "docs_pdf" meson options.
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of
2024-12-31 09:01 BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of PG Bug reporting form <noreply@postgresql.org>
@ 2025-03-20 01:32 ` David G. Johnston <david.g.johnston@gmail.com>
2025-03-20 03:19 ` Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of Tom Lane <tgl@sss.pgh.pa.us>
0 siblings, 1 reply; 4+ messages in thread
From: David G. Johnston @ 2025-03-20 01:32 UTC (permalink / raw)
To: thomas.petazzoni@bootlin.com; pgsql-bugs@lists.postgresql.org
On Tue, Dec 31, 2024 at 4:45 AM PG Bug reporting form <
noreply@postgresql.org> wrote:
> The following bug has been logged on the website:
>
> Bug reference: 18760
> Logged by: Thomas Petazzoni
> Email address: thomas.petazzoni@bootlin.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.
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of
2024-12-31 09:01 BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of PG Bug reporting form <noreply@postgresql.org>
2025-03-20 01:32 ` Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of David G. Johnston <david.g.johnston@gmail.com>
@ 2025-03-20 03:19 ` Tom Lane <tgl@sss.pgh.pa.us>
2025-09-11 14:34 ` Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of Andrey Teplitskiy <a.teplitskiy@postgrespro.ru>
0 siblings, 1 reply; 4+ messages in thread
From: Tom Lane @ 2025-03-20 03:19 UTC (permalink / raw)
To: David G. Johnston <david.g.johnston@gmail.com>; +Cc: thomas.petazzoni@bootlin.com; pgsql-bugs@lists.postgresql.org
"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 entity "
> 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=disabled -Ddocs_pdf=disabled 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%3DEQsVGiSDe-TstP4EsSvDHd7DSRsP40PgGA%40m...
^ permalink raw reply [nested|flat] 4+ messages in thread
* Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of
2024-12-31 09:01 BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of PG Bug reporting form <noreply@postgresql.org>
2025-03-20 01:32 ` Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of David G. Johnston <david.g.johnston@gmail.com>
2025-03-20 03:19 ` Re: BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of Tom Lane <tgl@sss.pgh.pa.us>
@ 2025-09-11 14:34 ` Andrey Teplitskiy <a.teplitskiy@postgrespro.ru>
0 siblings, 0 replies; 4+ messages in thread
From: Andrey Teplitskiy @ 2025-09-11 14:34 UTC (permalink / raw)
To: Tom Lane <tgl@sss.pgh.pa.us>; David G. Johnston <david.g.johnston@gmail.com>; +Cc: thomas.petazzoni@bootlin.com; pgsql-bugs@lists.postgresql.org
This error occurs because the docbook-xsl package is missing, which is
required in the documentation. After installation, the build is
performed correctly.
> "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 entity "
>> 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=disabled -Ddocs_pdf=disabled 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%3DEQsVGiSDe-TstP4EsSvDHd7DSRsP40PgGA%40m...
>
>
>
>
--
Andrey Teplitskiy
Postgres Professional
^ permalink raw reply [nested|flat] 4+ messages in thread
end of thread, other threads:[~2025-09-11 14:34 UTC | newest]
Thread overview: 4+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2024-12-31 09:01 BUG #18760: ../doc/src/sgml/postgres.sgml:24: element book: validity error : No declaration for attribute id of PG Bug reporting form <noreply@postgresql.org>
2025-03-20 01:32 ` David G. Johnston <david.g.johnston@gmail.com>
2025-03-20 03:19 ` Tom Lane <tgl@sss.pgh.pa.us>
2025-09-11 14:34 ` Andrey Teplitskiy <a.teplitskiy@postgrespro.ru>
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