doc: Make logical replication examples executable in bulk and legal sgml.

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: doc: Make logical replication examples executable in bulk and legal sgml.
Date: 2025-05-03 16:02:36
Message-ID: CAKFQuwbhbL1uaDTuo9shmo1rA-fX6XGotR7qZQ7rd-ia5ZDoQA@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

While responding to a "our documentation is buggy" complaint I got annoyed
in my attempt to reproduce the behavior by having to surgically copy
line-by-line the DDL and DML code involved. Let's strive for a more
copy-paste friendly example setup. No prompts and no interspersed command
tags (they are ok if the script is one block and the output is another).

In passing, the examples use < 5 and >= 5 in expressions - which in theory
are supposed to require the use of &lt; and &gt; entities...or enclosure in
a CDATA construct. The latter seems preferable.

David J.

Attachment Content-Type Size
v1-0001-doc-Make-logical-replication-examples-executable-in-.patch text/x-patch 38.8 KB

Browse pgsql-hackers by date

  From Date Subject
Next Message Bruce Momjian 2025-05-03 16:19:54 Re: PG 18 release notes draft committed
Previous Message Robert Treat 2025-05-03 15:42:09 Re: doc pg_constraint.convalidated column description need update