Updates on Docbook information

From: Matemática A3K <matematica(dot)a3k(at)gmail(dot)com>
To: "pgsql-docs(at)lists(dot)postgresql(dot)org" <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Updates on Docbook information
Date: 2026-10-23 20:40:29
Message-ID: CA+FDnhJFvFGk7Kdc=yX9=3aeRC3p4bdfYLX+x5GbOcGNKtWwkw@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

In https://www.postgresql.org/docs/18/docguide-docbook.html it says:
"...
DocBook is maintained by the OASIS group. The [official DocBook site]
has good introductory and reference documentation and a complete
O'Reilly book for your online reading pleasure. The [FreeBSD
Documentation Project] also uses DocBook and has some good
information, including a number of style guidelines that might be
worth considering.
"
which caught my attention with:
- "DocBook is maintained by the OASIS group.": No longer true, see
https://docbook.org/
- [official DocBook site] points to
https://www.oasis-open.org/docbook/, and "has good introductory and
reference documentation and a complete O'Reilly book for your online
reading pleasure" seems not appropriate for the page
- "The [FreeBSD Documentation Project] also uses DocBook and has some
good information, including a number of style guidelines that might be
worth considering.": No longer true, it currently use asciidoc and
there are no references to docbook in the current website

I think those sentences should be replaced with:
"...
The [DocBook site] has good introductory and reference documentation,
a complete O'Reilly book for your online reading pleasure, and an
archive with previously released versions.
"

Also, in https://www.postgresql.org/docs/18/docguide-toolsets.html says:
"...
[DocBook DTD]
This is the definition of DocBook itself. We currently use version
4.5; you cannot use later or earlier versions. You need the XML
variant of the DocBook DTD, not the SGML variant.
"
where [DocBook DTD] points to https://www.oasis-open.org/docbook/ and
it is not found there. It should point to
https://archive.docbook.org/schemas/ where you can find the 4.5 DTD.

I attach a patch with the proposed changes for review / further refinement.

Thanks!

Attachment Content-Type Size
0001_doc_docbook_fix.patch text/x-patch 1.6 KB

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Daniel Gustafsson 2026-10-24 20:38:50 Re: Updates on Docbook information
Previous Message Bruce Momjian 2026-10-23 19:06:13 Re: E.6.3.2.1. Constraints