Ticket #14777: csv-unicode.diff

docs/howto/outputting-csv.txt

@@ -56 +56 @@
       about escaping strings with quotes or commas in them. Just pass
       ``writerow()`` your raw strings, and it'll do the right thing.
 
+Handling Unicode
+~~~~~~~~~~~~~~~~
+
+Python's ``csv`` module expects to be passed strings, not Unicode objects, but
+strings read from ``HttpRequest`` and databases in Django will typically be
+Unicode. There are a few options for handling this.
+
+    * Manually encode all Unicode objects before saving. This is, obviously,
+      a hassle and error-prone.
+
+    * Use the ``UnicodeWriter`` provided in the `csv module's examples section`_.
+
+    * Use the `python-unicodecsv module`_, which aims to be a drop-in
+      replacement for ``csv`` that does gracefully handle Unicode.
+
+.. _`csv module's examples section`: http://docs.python.org/library/csv.html#examples
+.. _`python-unicodecsv module`: https://github.com/jdunck/python-unicodecsv
+
 Using the template system
 =========================