Doc: improve v13 release note item about autovacuum and INSERTs.
authorTom Lane
Mon, 21 Sep 2020 17:30:18 +0000 (13:30 -0400)
committerTom Lane
Mon, 21 Sep 2020 17:30:18 +0000 (13:30 -0400)
The previous text was confusing, per off-list discussion with
Bruce Momjian.

doc/src/sgml/release-13.sgml

index 593b35824516f54902dcd44f3211313315998aaa..418397bda1f57bbd1b2c880b8988e87efb8d9bfc 100644 (file)
@@ -762,16 +762,28 @@ Author: David Rowley 
 -->
 
        
-        Allow inserts, not only updates and deletes, to
-        trigger autovacuum activity
+        Allow inserts, not only updates and deletes, to trigger vacuuming
+        activity in autovacuum
         (Laurenz Albe, Darafei Praliaskouski)
        
 
        
-        This new behavior reduces the work that will be necessary later
-        when the table needs to be frozen, and it allows pages to be
-        marked as all-visible sooner.  All-visible pages allow index-only
-        scans to access fewer heap rows.
+        Previously, insert-only activity would trigger auto-analyze but
+        not auto-vacuum, on the grounds that there could not be any dead
+        tuples to remove.  However, a vacuum scan has other useful
+        side-effects such as setting page-all-visible bits, which improves
+        the efficiency of index-only scans.  Also, allowing an insert-only
+        table to receive periodic vacuuming helps to spread out the work
+        of freezing old tuples, so that there is not
+        suddenly a large amount of freezing work to do when the entire
+        table reaches the anti-wraparound threshold all at once.
+       
+
+       
+        If necessary, this behavior can be adjusted with the new
+        parameters 
+        and , or
+        the equivalent table storage options.
        
       
 
@@ -782,8 +794,8 @@ Author: Thomas Munro 
 -->
 
        
-        Add  to control I/O
-        concurrency for maintenance operations (Thomas Munro)
+        Add  parameter to
+        control I/O concurrency for maintenance operations (Thomas Munro)