Index: doc/src/sgml/manage-ag.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/manage-ag.sgml,v
retrieving revision 2.55
retrieving revision 2.56
diff -c -r2.55 -r2.56
*** doc/src/sgml/manage-ag.sgml	4 Nov 2007 19:43:33 -0000	2.55
--- doc/src/sgml/manage-ag.sgml	4 Nov 2007 21:40:02 -0000	2.56
***************
*** 495,499 ****
--- 495,525 ----
     the old tablespace locations.)
    </para> 
  
+   <sect2 id="manage-ag-tablespaces-nfs">
+    <title>Network File Systems</title>
+ 
+    <indexterm zone="manage-ag-tablespaces-nfs">
+     <primary>Network File Systems</primary>
+    </indexterm>
+    <indexterm><primary><acronym>NFS</></><see>Network File Systems</></>
+    <indexterm><primary>Network Attached Storage (<acronym>NAS</>)</><see>Network File Systems</></>
+ 
+    <para>
+     Many installations create tablespace on network file systems.
+     Sometimes this is done directly via <acronym>NFS</>, or by using a
+     Network Attached Storage (<acronym>NAS</>) device that uses
+     <acronym>NFS</> internally.  <productname>PostgreSQL</> does nothing
+     special for <acronym>NFS</> file systems, meaning it assumes
+     <acronym>NFS</> behaves exactly like locally-connected drives.  If
+     client and server <acronym>NFS</> implementations have non-standard
+     semantics, this can cause reliability problems (see <ulink
+     url="http://www.time-travellers.org/shane/papers/NFS_considered_harmful.html"></ulink>).
+     Specifically, delayed (asynchonous) writes to the <acronym>NFS</>
+     server can cause reliability problems;   if possible, mount
+     <acronym>NFS</> file systems synchonously to avoid this.
+    </para>
+ 
+   </sect2>
+ 
   </sect1>
  </chapter>
Index: doc/src/sgml/runtime.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/runtime.sgml,v
retrieving revision 1.382
retrieving revision 1.383
diff -c -r1.382 -r1.383
*** doc/src/sgml/runtime.sgml	1 Nov 2007 19:06:01 -0000	1.382
--- doc/src/sgml/runtime.sgml	4 Nov 2007 21:48:03 -0000	1.383
***************
*** 159,164 ****
--- 159,170 ----
     for the database cluster.  Normally this should be chosen to match the
     locale setting.  For details see <xref linkend="multibyte">.
    </para>
+ 
+   <para>
+    If using non-local (network) file systems, see <xref
+    linkend="manage-ag-tablespaces-nfs">.
+   </para>
+ 
   </sect1>
  
   <sect1 id="server-start">