doc: Adjust note about pg_upgrade's --jobs option.

Nathan Bossart <nathan@postgresql.org>

Commit: 3c472a18296e473270b6ff611b898592263a6ed1
Author: Nathan Bossart <nathan@postgresql.org>
Date: 2025-03-08T20:28:16Z
Releases: 18.0
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 <magnus@hagander.net>
Reviewed-by: Daniel Gustafsson <daniel@yesql.se>
Reviewed-by: Magnus Hagander <magnus@hagander.net>
Discussion: https://postgr.es/m/Z8dBn_5iGLNuYiPo%40nathan

Files

PathChange+/−
doc/src/sgml/ref/pgupgrade.sgml modified +5 −6

Documentation touched

Discussion