Clarify wal_sync_method options in documentation.

bmomjian · bmomjian · commit 487b757b7a0b · 2005-08-09T04:50:44.000Z
diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.341 2005/07/30 17:15:35 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.342 2005/08/09 04:50:43 momjian Exp $
 -->
 
 <chapter Id="runtime">
@@ -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
@@ -1,4 +1,4 @@
-/*-------------------------------------------------------------------------
+conninfo_parse/*-------------------------------------------------------------------------
  *
  * fe-connect.c
  *	  functions related to setting up a connection to the backend
@@ -8,7 +8,7 @@
  *
  *
  * IDENTIFICATION
- *	  $PostgreSQL: pgsql/src/interfaces/libpq/fe-connect.c,v 1.314 2005/07/13 15:25:55 tgl Exp $
+ *	  $PostgreSQL: pgsql/src/interfaces/libpq/fe-connect.c,v 1.315 2005/08/09 04:50:44 momjian Exp $
  *
  *-------------------------------------------------------------------------
  */

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-/*-------------------------------------------------------------------------`
	`1`	`+conninfo_parse/*-------------------------------------------------------------------------`
`2`	`2`	`*`
`3`	`3`	`* fe-connect.c`
`4`	`4`	`* functions related to setting up a connection to the backend`
`@@ -8,7 +8,7 @@`
`8`	`8`	`*`
`9`	`9`	`*`
`10`	`10`	`* IDENTIFICATION`
`11`		`- * $PostgreSQL: pgsql/src/interfaces/libpq/fe-connect.c,v 1.314 2005/07/13 15:25:55 tgl Exp $`
	`11`	`+ * $PostgreSQL: pgsql/src/interfaces/libpq/fe-connect.c,v 1.315 2005/08/09 04:50:44 momjian Exp $`
`12`	`12`	`*`
`13`	`13`	`*-------------------------------------------------------------------------`
`14`	`14`	`*/`