]> granicus.if.org Git - python/commitdiff
Redo the comment about the 2.5 change in quoted-newline handling.
authorAndrew McNamara <andrewm@object-craft.com.au>
Mon, 31 Jul 2006 02:27:48 +0000 (02:27 +0000)
committerAndrew McNamara <andrewm@object-craft.com.au>
Mon, 31 Jul 2006 02:27:48 +0000 (02:27 +0000)
Doc/lib/libcsv.tex

index 3278077bfc6de3854acde79761df4d4246dc101d..0d0c1d71518cd9a02568d9f4b2853d91abd7fcb7 100644 (file)
@@ -72,13 +72,15 @@ 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}
+The parser is now stricter with respect to multi-line quoted
+fields. Previously, if a line ended within a quoted field without a
+terminating newline character, a newline would be inserted into the
+returned field. This behaviour caused problems when reading files
+that embed carriage-return characters within fields, so in 2.5 the
+behaviour was changed to return the field without inserting newlines. As
+a consequence, if newlines embedded within fields are important, the
+input should be split into lines in a manner which preserves the newline
+characters.]{2.5}
 
 \end{funcdesc}