Revamp REPACK doc refentry page

The page a bit of a mess, with notes interpersed in the list of
parameters, and two "notes" subsections that weren't in the Notes
section.

Limit the commentary under "Description" and "Parameters" to a minimum;
move the existing text to appear in the "Notes" section.  Both the
"Notes on Clustering" and "Notes on Resources" subsections, which were
under "Description", are moved to be under "Notes" instead.  Add a new
"Notes on Concurrent Operation" subsection there, which now carries some
text that was in "Parameters", and gets some additional text to
(hopefully) explain resource consumption more clearly -- notably, the
hard limit of 104 million tuples that can be concurrently updated/deleted
before running into the palloc size limit.

Add appropriate cross-links.

Author: Radim Marek <[email protected]>
Author: Álvaro Herrera <[email protected]>
Author: Shihao Zhong <[email protected]>
Backpatch-through: 19
Discussion: 
https://postgr.es/m/cajgolk+dodrwuwcuxergywgjqzswrkd+xgityrl32owdt39...@mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/6510d5253ec0a0c4c46341784b411f64f12e2e07

Modified Files
--------------
doc/src/sgml/ref/repack.sgml | 505 +++++++++++++++++++++++--------------------
1 file changed, 270 insertions(+), 235 deletions(-)

Reply via email to