Clarify wal_sync_method options in documentation.

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 7aa1ea037b300e55519586f86e550b9d51992ef4..7bc69392a39eabe81e838cba8f899074c6c4c110 100644 (file)
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1724,13 +1724,38 @@ SET ENABLE_SEQSCAN TO OFF;
       <listitem>
        <para>
         Method used for forcing WAL updates out to disk.  Possible
-        values are
-        <literal>fsync</> (call <function>fsync()</> at each commit),
-        <literal>fdatasync</> (call <function>fdatasync()</> at each commit),
-        <literal>fsync_writethrough</> (force write-through of any disk write cache),
-        <literal>open_sync</> (write WAL files with <function>open()</> option <symbol>O_SYNC</>), and
-        <literal>open_datasync</> (write WAL files with <function>open()</> option <symbol>O_DSYNC</>).
+        values are:
+       </para>
+       <itemizedlist>
+        <listitem>
+        <para>
+         <literal>open_datasync</> (write WAL files with <function>open()</> option <symbol>O_DSYNC</>)
+        </para>
+        </listitem>
+        <listitem>
+        <para>
+         <literal>fdatasync</> (call <function>fdatasync()</> at each commit),
+        </para>
+        </listitem>
+        <listitem>
+        <para>
+         <literal>fsync</> (call <function>fsync()</> at each commit)
+        </para>
+        </listitem>
+        <listitem>
+        <para>
+         <literal>open_sync</> (write WAL files with <function>open()</> option <symbol>O_SYNC</>)
+        </para>
+        </listitem>
+        <listitem>
+        <para>
+         <literal>fsync_writethrough</> (force write-through of any disk write cache)
+        </para>
+        </listitem>
+       </itemizedlist>
+       <para>
         Not all of these choices are available on all platforms.
+        The top-most supported option is used as the default.
         If <varname>fsync</varname> is off then this setting is irrelevant.
         This option can only be set at server start or in the
         <filename>postgresql.conf</filename> file.

diff --git a/src/interfaces/libpq/fe-connect.c b/src/interfaces/libpq/fe-connect.c
index 2f3af197de4a88904edc7abe30a679a109988450..d04ec63cbd6e1f3b35d795f18f7c1ccbc47b0cd6 100644 (file)
--- a/src/interfaces/libpq/fe-connect.c
+++ b/src/interfaces/libpq/fe-connect.c
@@ -1,4 +1,4 @@
-/*-------------------------------------------------------------------------
+conninfo_parse/*-------------------------------------------------------------------------
  *
  * fe-connect.c
  *       functions related to setting up a connection to the backend