Add note to the shared memory sizing table about needing to use page count in

shared_buffers and wal_buffers, not size in bytes.  Per discussion.

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index d2bd9af274ade445cf864469846a33e808cfc710..f07f69343f1472177c22b64d96aed54bb2921eaf 100644 (file)
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1124,6 +1124,16 @@ set semsys:seminfo_semmsl=32
      </tbody>
     </tgroup>
    </table>
+
+   <note>
+    <para>
+     The multipliers for <varname>shared_buffers</> and
+     <varname>wal_buffers</> should be the number of buffers, not the
+     amount in bytes.  To find out the number of shared or wal buffers, divide
+     the amount in bytes by <xref linkend="guc-block-size"> and
+     <xref linkend="guc-wal-block-size">, respectively.
+    </para>
+   </note>
   </sect2>