Re: DOCS - Clarify the publication 'publish_via_partition_root' default value.

Peter Smith <smithpb2250@gmail.com>

From: Peter Smith <smithpb2250@gmail.com>

To: PostgreSQL Hackers <pgsql-hackers@lists.postgresql.org>

Date: 2025-12-11T20:22:07Z

Lists: pgsql-hackers

Commits

Same data as JSON: GET /api/v1/messages/:b64id/commits the thread's linked commits as JSON, with link sources. API reference →

doc: Improve description of publish_via_partition_root
- e2aae8d68f6b 19 (unreleased) landed
- d2c6ff7c525b 18.2 landed
- 862f83f3aa40 17.8 landed
- b95bdde5119d 16.12 landed
- 988612c9c27f 15.16 landed
- 5f43df007485 14.21 landed

Attachments

v1-0001-Plainly-say-the-default-value-of-publish_via_part.patch (application/octet-stream) patch v1-0001

On Thu, Dec 11, 2025 at 6:51 PM Peter Smith <smithpb2250@gmail.com> wrote:
>
> Hi,
>
> When reading the docs for the publication parameter
> 'publish_via_partition_root' [1], I felt there was too much mental
> gymnastics required to understand the meaning of "the latter is the
> default."
>
> Why not just say clearly what the default value is?
>
> PSA: a patch to do that.

Here is the patch accidentally omitted from the last post.

>
> ======
> [1] https://www.postgresql.org/docs/current/sql-createpublication.html#SQL-CREATEPUBLICATION-PARAMS-WITH-PUBLISH-VIA-PARTITION-ROOT
>
> Kind Regards,
> Peter Smith.
> Fujitsu Australia