Thread

  1. [PATCH] doc: Remove stray trailing whitespace in xref linkend attribute

    Erik Wienhold <ewie@ewie.name> — 2025-09-22T00:58:16Z

    Commit 205db0114e03 extended the pg_combinebackup docs with markup that
    fails to validate with xmllint 2.15.0 when building the docs, producing
    the following error:
    
        /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
                                                                      ^
    
    This is, however, just a regression in xmllint that is already fixed [1]
    but not yet released.  Fix the markup anyway because the trailing
    whitespace is insignificant.
    
    [1] https://gitlab.gnome.org/GNOME/libxml2/-/commit/da45a190f718e8e2f0e3d2a6325ffa23abc8b90c
    ---
     doc/src/sgml/ref/pg_combinebackup.sgml | 2 +-
     1 file changed, 1 insertion(+), 1 deletion(-)
    
    diff --git a/doc/src/sgml/ref/pg_combinebackup.sgml b/doc/src/sgml/ref/pg_combinebackup.sgml
    index 330a598f701..9a6d201e0b8 100644
    --- a/doc/src/sgml/ref/pg_combinebackup.sgml
    +++ b/doc/src/sgml/ref/pg_combinebackup.sgml
    @@ -314,7 +314,7 @@ PostgreSQL documentation
     
       <para>
        To avoid this problem, taking a new full backup after changing the checksum
    -   state of the cluster using <xref linkend="app-pgchecksums "/> is
    +   state of the cluster using <xref linkend="app-pgchecksums"/> is
        recommended. Otherwise, you can disable and then optionally reenable
        checksums on the directory produced by <literal>pg_combinebackup</literal>
        in order to correct the problem.
    -- 
    2.51.0
    
    
    --lfehubie4pse7hhe--