[Python-checkins] r50953 - python/trunk/Doc/lib/libcsv.tex
skip.montanaro
python-checkins at python.org
Sat Jul 29 22:06:05 CEST 2006
Author: skip.montanaro
Date: Sat Jul 29 22:06:05 2006
New Revision: 50953
Modified:
python/trunk/Doc/lib/libcsv.tex
Log:
Add a comment to the csv reader documentation that explains why the
treatment of newlines changed in 2.5. Pulled almost verbatim from a comment
by Andrew McNamara in <http://python.org/sf/1465014>.
Modified: python/trunk/Doc/lib/libcsv.tex
==============================================================================
--- python/trunk/Doc/lib/libcsv.tex (original)
+++ python/trunk/Doc/lib/libcsv.tex Sat Jul 29 22:06:05 2006
@@ -70,6 +70,17 @@
All data read are returned as strings. No automatic data type
conversion is performed.
+
+\versionchanged[
+If literal newlines are important within a field, users need to read their
+file in a way that preserves the newlines. The behavior before 2.5 would
+introduce spurious characters into quoted fields, with no way for the user
+to control that behavior. The previous behavior caused considerable
+problems, particularly on platforms that did not use the unix line ending
+conventions, or with files that originated on those platforms - users were
+finding mysterious newlines where they didn't expect them.
+]{2.5}
+
\end{funcdesc}
\begin{funcdesc}{writer}{csvfile\optional{,
More information about the Python-checkins
mailing list