document issue in ticket #2209 in FAQ. Probably only affects me, but who knows.

git-svn-id: http://svn.osgeo.org/postgis/trunk@11105 b70326c6-7e19-0410-871a-916f4a2858ee

diff --git a/doc/faq_raster.xml b/doc/faq_raster.xml
index f1d200b70f4030592dc72c53537c4c3d608ede40..48391a4d5219d2c31370f67b6eabf3dd07c66a3c 100644 (file)
--- a/doc/faq_raster.xml
+++ b/doc/faq_raster.xml
@@ -247,8 +247,6 @@ END
       </answer>
     </qandaentry>
     
-   
-    
     <qandaentry>
       <question>
         <para>How is PostGIS Raster different from Oracle GeoRaster (SDO_GEORASTER) and SDO_RASTER types?</para>
@@ -270,4 +268,23 @@ END
       </answer>
     </qandaentry> 
   </qandaset>
+  
+  <qandaentry>
+      <question>
+        <para>raster2pgsql load of large file fails with String of 388800145 bytes is too long for encoding conversion?</para>
+      </question>
+
+      <answer>
+       <para>raster2pgsql doesn't make any connections to your database when generating the file to load. If your database has set an explicit client encoding different
+       from your database encoding, then when loading large raster files (above 30 MB in size), you may run into a <code>bytes is too long for encoding conversion</code>.
+       This generally happens if for example you have your database in UTF8, but to support windows apps, you have the client encoding set to <code>WIN1252</code>.</para>
+       <para>To work around this make sure the client encoding is the same as your database encoding during load.  You can do this by explicitly setting the encoding in your load script.  Example, if you are on windows:</para>
+               <programlisting>set PGCLIENTENCODING=UTF8</programlisting>
+       <para>If you are on Unix/Linux</para>
+       <programlisting>export PGCLIENTENCODING=UTF8</programlisting>
+       <para>Gory details of this issue are detailed in <ulink url="http://trac.osgeo.org/postgis/ticket/2209">http://trac.osgeo.org/postgis/ticket/2209</ulink></para>
+      </answer>
+    </qandaentry> 
+  </qandaset>
+
 </chapter>