Explain unaccounted for space in pgstattuple.

In addition to space accounted for by tuple_len, dead_tuple_len and
free_space, the table_len includes page overhead, the item pointers
table and padding bytes.

Backpatch to live branches.

diff --git a/doc/src/sgml/pgstattuple.sgml b/doc/src/sgml/pgstattuple.sgml
index 9ada5d209afcbab8b2c1edab6119033211ce947f..d2fa524d6ec7edf7b8a8b394218ddc7f952aa126 100644 (file)
--- a/doc/src/sgml/pgstattuple.sgml
+++ b/doc/src/sgml/pgstattuple.sgml
@@ -117,6 +117,16 @@ free_percent       | 1.95
      
     
 
+    
+      
+        The table_len will always be greater than the sum
+        of the tuple_len, dead_tuple_len
+        and free_space. The difference is accounted for by
+        fixed page overhead, the per-page table of pointers to tuples, and
+        padding to ensure that tuples are correctly aligned. 
+      
+    
+
     
      pgstattuple acquires only a read lock on the
      relation. So the results do not reflect an instantaneous snapshot;