agora inbox for pgsql-committers@postgresql.org  
help / color / mirror / Atom feed
From: Álvaro Herrera <alvherre@kurilemu.de>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: Rework REPACK's documentation on clustering
Date: Thu, 10 Sep 2026 15:58:27 +0000
Message-ID: <E1x4hAQ-00000004J2u-1Ujm@gemulon.postgresql.org> (raw)

Rework REPACK's documentation on clustering

Commit ac58465e0618 moved the discussion on clustering from CLUSTER's
refpage to REPACK's, but somehow introduced a mistake regarding when
exactly can the seqscan-and-sort strategy be used with respect to btrees
(spoiler: it was 100% backwards).  Fix that, but also restructure and
reword the whole subsection more fully to try and make it more coherent.

Author: Chao Li <li.evan.chao@gmail.com>
Author: Álvaro Herrera <alvherre@kurilemu.de>
Reported-by: Antonin Houska <ah@cybertec.at>
Backpatch-through: 19
Discussion: https://postgr.es/m/69CA7636-0359-42B6-B971-16A036698187@gmail.com

Branch
------
REL_19_STABLE

Details
-------
https://git.postgresql.org/pg/commitdiff/07aef52eba3c2b10fb706f2ac48819597a339067

Modified Files
--------------
doc/src/sgml/ref/repack.sgml  | 75 +++++++++++++++++++++++--------------------
src/backend/commands/repack.c | 10 +++---
2 files changed, 46 insertions(+), 39 deletions(-)



view thread (2+ messages)

Message-ID: <E1x4hAQ-00000004J2u-1Ujm@gemulon.postgresql.org>
Permalink:  ../E1x4hAQ-00000004J2u-1Ujm@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1x4hAQ-00000004J2u-1Ujm@gemulon.postgresql.org

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-committers@postgresql.org
  Cc: alvherre@kurilemu.de, pgsql-committers@lists.postgresql.org
  Subject: Re: pgsql: Rework REPACK's documentation on clustering
  In-Reply-To: <E1x4hAQ-00000004J2u-1Ujm@gemulon.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox