docs: Validation error with xmllint 2.15.0

From: Erik Wienhold <ewie(at)ewie(dot)name>
To: pgsql-hackers(at)lists(dot)postgresql(dot)org
Subject: docs: Validation error with xmllint 2.15.0
Date: 2025-09-22 01:50:51
Message-ID: f4c4661b-4e60-4c10-9336-768b7b55c084@ewie.name
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

I just upgraded to libxml2 2.15.0 and now the docs no longer validate
with the following error when running make html:

/usr/bin/xmllint --nonet --path . --path . --output postgres-full.xml --noent --valid postgres.sgml
ref/pg_combinebackup.sgml:317: validity error : standalone: normalization of attribute linkend on xref by external subset declaration
state of the cluster using <xref linkend="app-pgchecksums "/> is
^

Downgrading to libxml2 2.14.6 fixes the validation. There's also an
unreleased fix [1] for this regression. But I figure that it's best to
just remove the insignificant whitespace with the attached patch.

[1] https://gitlab.gnome.org/GNOME/libxml2/-/commit/da45a190f718e8e2f0e3d2a6325ffa23abc8b90c

--
Erik Wienhold

Attachment Content-Type Size
0001-doc-Remove-stray-trailing-whitespace-in-xref-linkend.patch text/plain 1.8 KB

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Chao Li 2025-09-22 02:46:35 Re: Fix wrong filename in header comment of gin_tuple.h
Previous Message Yang Oreo 2025-09-22 01:48:10 Re: Meson0.57.2 setup failed with option -Duuid=ossp