diff --git a/Doc/lib/libcsv.tex b/Doc/lib/libcsv.tex
index 3278077bfc6d..0d0c1d71518c 100644
--- a/Doc/lib/libcsv.tex
+++ b/Doc/lib/libcsv.tex
@@ -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}