Document that analyzing an empty table doesn't update the statistics.

Per a suggestion from Sergey Konoplev

diff --git a/doc/src/sgml/ref/analyze.sgml b/doc/src/sgml/ref/analyze.sgml
index 7545fa5d869bb620a3d839dec8cd57c13cc71427..8c9057beb9190865e7cd0649eabea8119e07ebba 100644 (file)
--- a/doc/src/sgml/ref/analyze.sgml
+++ b/doc/src/sgml/ref/analyze.sgml
@@ -190,6 +190,12 @@ ANALYZE [ VERBOSE ] [ <replaceable class="PARAMETER">table</replaceable> [ ( <re
     or updated, the inheritance statistics will not be up to date unless you
     run <command>ANALYZE</command> manually.
   </para>
+
+  <para>
+    If the table being analyzed is completely empty, <command>ANALYZE</command>
+    will not record new statistics for that table.  Any existing statistics
+    will be retained.
+  </para>
  </refsect1>
 
  <refsect1>