doc: Adjust note about pg_upgrade's --jobs option.
authorNathan Bossart
Sat, 8 Mar 2025 20:28:16 +0000 (14:28 -0600)
committerNathan Bossart
Sat, 8 Mar 2025 20:28:16 +0000 (14:28 -0600)
commit3c472a18296e473270b6ff611b898592263a6ed1
tree94aa4d1bc6eb68ddc7af88641e273322e7b954d9
parent1852aea3f526b124b95585f7b1f655f3af04afd5
doc: Adjust note about pg_upgrade's --jobs option.

Presently, this section lists a couple of parallelized parts of
pg_upgrade and suggests a starting point for setting the --jobs
option.  The list of parallelized tasks is not particularly
actionable, and the phrasing for the --jobs recommendation is
confusing to some readers.

This commit attempts to improve this section by eliminating the
list of parallelized tasks and instead highlighting that --jobs is
most useful for clusters with multiple databases or tablespaces.
Additionally, the recommendation for setting --jobs is simplified
to suggest starting with the number of CPU cores.

Reported-by: Magnus Hagander
Reviewed-by: Daniel Gustafsson
Reviewed-by: Magnus Hagander
Discussion: https://postgr.es/m/Z8dBn_5iGLNuYiPo%40nathan
doc/src/sgml/ref/pgupgrade.sgml