Add a note about CSV lines with trailing spaces.
authorAndrew Dunstan <andrew@dunslane.net>
Mon, 5 Sep 2005 14:44:05 +0000 (14:44 +0000)
committerAndrew Dunstan <andrew@dunslane.net>
Mon, 5 Sep 2005 14:44:05 +0000 (14:44 +0000)
Suggestion by Darcy Buskermolen, reworded by me.

doc/src/sgml/ref/copy.sgml

index 188f892fa0f495a42caaf327fd51a667b7999f00..34f1b496ebf0425d3e9fafc68d4c3f4c776f488f 100644 (file)
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/ref/copy.sgml,v 1.66 2005/06/02 01:21:21 momjian Exp $
+$PostgreSQL: pgsql/doc/src/sgml/ref/copy.sgml,v 1.67 2005/09/05 14:44:05 adunstan Exp $
 PostgreSQL documentation
 -->
 
@@ -511,6 +511,19 @@ COPY <replaceable class="parameter">tablename</replaceable> [ ( <replaceable cla
     comparisons for specific columns.
    </para>
 
+   <note>
+       <para>
+        In <literal>CSV</> mode, all characters are significant. A quoted value 
+        surrounded by white space, or any characters other than 
+        <literal>DELIMITER</>, will include those characters. This can cause 
+        errors if  you import data from a system that pads <literal>CSV</> 
+        lines with white space out to some fixed width. If such a situation 
+        arises you might need to preprocess the <literal>CSV</> file to remove 
+        the trailing white space, before importing the data into 
+        <productname>PostgreSQL</>. 
+       </para>
+   </note>
+
    <note>
     <para>
      CSV mode will both recognize and produce CSV files with quoted