Remove outdated recommendation for manual VACUUM

We have had a working and tunable autovacuum
for at least a decade now, so remove the recommendation to
manually vacuum tables at least every night.
Autovacuum is now also triggered by INSERTs, so we can also
remove the recommendation to run VACUUM (ANALYZE) after lots
of INSERTs or DELETEs.

Instead, suggest using autovacuum by moving the respective
paragraph up to where the importance of VACUUM is emphasized.

Author: Laurenz Albe 
Reviewed-By: Magnus Hagander, Peter Geoghegan
Discussion: https://postgr.es/m/6f5e3da98fec14640f389d7b84c3b413833697f4[email protected]

diff --git a/doc/src/sgml/ref/vacuum.sgml b/doc/src/sgml/ref/vacuum.sgml
index 3df32b58ee696a5f3d71bd436c3fc62a2380b4d4..c582021d29d66431b384c72834b4445f7f066ecb 100644 (file)
--- a/doc/src/sgml/ref/vacuum.sgml
+++ b/doc/src/sgml/ref/vacuum.sgml
@@ -377,15 +377,11 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ 
    
 
    
-    We recommend that active production databases be
-    vacuumed frequently (at least nightly), in order to
-    remove dead rows. After adding or deleting a large number
-    of rows, it might be a good idea to issue a VACUUM
-    ANALYZE command for the affected table. This will update the
-    system catalogs with
-    the results of all recent changes, and allow the
-    PostgreSQL query planner to make better
-    choices in planning queries.
+    We recommend that all databases be vacuumed regularly in
+    order to remove dead rows.  PostgreSQL includes
+    an autovacuum facility which can automate routine vacuum
+    maintenance.  For more information about automatic and manual vacuuming,
+    see .
    
 
    
@@ -412,12 +408,6 @@ VACUUM [ FULL ] [ FREEZE ] [ VERBOSE ] [ ANALYZE ] [ 
     details.
    
 
-   
-    PostgreSQL includes an autovacuum
-    facility which can automate routine vacuum maintenance.  For more
-    information about automatic and manual vacuuming, see
-    .
-   
    
     Each backend running VACUUM without the
     FULL option will report its progress in the