Mention Linux syslog will sync lines to disk, and describe how to

disable it.

diff --git a/doc/TODO b/doc/TODO
index 8400395..6da74a7 100644 (file)
--- a/doc/TODO
+++ b/doc/TODO
@@ -1,6 +1,6 @@
 TODO list for PostgreSQL
 ========================
-Last updated:          Sat Mar 13 18:17:39 EST 2004
+Last updated:          Mon Mar 15 09:06:53 EST 2004
 
 Current maintainer:    Bruce Momjian (pgman@candle.pha.pa.us)
 

diff --git a/doc/src/sgml/maintenance.sgml b/doc/src/sgml/maintenance.sgml
index f8372b4..e1af27c 100644 (file)
--- a/doc/src/sgml/maintenance.sgml
+++ b/doc/src/sgml/maintenance.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.30 2003/12/14 00:10:32 neilc Exp $
+$PostgreSQL: pgsql/doc/src/sgml/maintenance.sgml,v 1.31 2004/03/15 14:15:45 momjian Exp $
 -->
 
 <chapter id="maintenance">
@@ -464,13 +464,19 @@ VACUUM
    rotation, the <application>logrotate</application> program can be
    configured to work with log files from
    <application>syslog</application>.
+  </para>
 
+  <para>
+   On many systems, however, <application>syslog</> is not very reliable,
+   particularly with large log messages; it may truncate or drop messages
+   just when you need them the most.  Also, on <productname>linux</>,
+   <appication>syslog</> will sync each message to disk, yielding poor
+   performance.  Use a <literal>-</> at the start of the file name
+   in the <application>syslog</> config file to disable this behavior.
   </para>
 
   <para>
-   On many systems, however, <application>syslog</> is not very reliable, particularly
-   with large log messages; it may truncate or drop messages just when
-   you need them the most. You may find it more useful to pipe the
+   You may find it more useful to pipe the
    <systemitem>stderr</> of the <command>postmaster</> to some type of
    log rotation program. If you start the server with
    <command>pg_ctl</>, then the <systemitem>stderr</> of the <command>postmaster</command>