diff --git a/doc/src/sgml/ref/vacuumdb.sgml b/doc/src/sgml/ref/vacuumdb.sgml index d8cbf0e189..956c0f01cb 100644 --- a/doc/src/sgml/ref/vacuumdb.sgml +++ b/doc/src/sgml/ref/vacuumdb.sgml @@ -397,7 +397,7 @@ PostgreSQL documentation Only calculate statistics for use by the optimizer (no vacuum), - like . Run several (currently three) + like . Run three stages of analyze; the first stage uses the lowest possible statistics target (see ) to produce usable statistics faster, and subsequent stages build the @@ -405,10 +405,10 @@ PostgreSQL documentation - This option is only useful to analyze a database that current has - no statistics or wholly incorrect ones, such as if it is newly + This option is only useful to analyze a database that currently has + no statistics or has wholly incorrect ones, such as if it is newly populated from a restored dump or by pg_upgrade. - Be aware that running this option in a database with existing + Be aware that running with this option in a database with existing statistics may cause the query optimizer choices to become transiently worse due to the low statistics targets of the early stages.