From 8f2977b3ec2fbb98ee36045d4e2be81ca4c293e0 Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Thu, 22 Oct 2015 13:59:58 -0400
Subject: [PATCH] doc: Add advice on updating checkpoint_segments to
 max_wal_size

with suggestion from Michael Paquier
---
 doc/src/sgml/release-9.5.sgml | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/src/sgml/release-9.5.sgml b/doc/src/sgml/release-9.5.sgml
index d5b68e73ef5..92443e43c19 100644
--- a/doc/src/sgml/release-9.5.sgml
+++ b/doc/src/sgml/release-9.5.sgml
@@ -152,6 +152,22 @@
      </para>
     </listitem>
 
+    <listitem>
+     <para>
+      The configuration parameter <varname>checkpoint_segments</varname> has
+      been removed.  Its place is taken by the new
+      setting <xref linkend="guc-max-wal-size">.  If you had previously
+      tuned <varname>checkpoint_segments</varname>, the following formula will
+      give you an approximately equivalent setting:
+<programlisting>
+max_wal_size = (3 * checkpoint_segments) * 16MB
+</programlisting>
+      Note that the default setting for <varname>max_wal_size</varname> is
+      much higher than the default <varname>checkpoint_segments</varname> used
+      to be, so setting this might no longer be necessary.
+     </para>
+    </listitem>
+
     <listitem>
 <!--
 2015-07-28 [6087d95] Andres..: Remove ssl renegotiation support.
-- 
2.39.5