python · miss-islington · Apr 12, 2023 · Nov 8, 2021 · Nov 1, 2022 · Nov 2, 2022
diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst
@@ -327,7 +327,7 @@ The :mod:`csv` module defines the following constants:
 
    Instructs :class:`writer` objects to quote all non-numeric fields.
 
-   Instructs the reader to convert all non-quoted fields to type *float*.
+   Instructs :class:`reader` to convert all non-quoted fields to type *float*.
 
 
 .. data:: QUOTE_NONE
@@ -342,14 +342,20 @@ The :mod:`csv` module defines the following constants:
 .. data:: QUOTE_NOTNULL
 
    Instructs :class:`writer` objects to quote all fields which are not
-   ``None``. If a field value is ``None`` an empty (unquoted) string
-   is written.
+   ``None``.  This is similar to QUOTE_ALL, except that if a
+   field value is ``None`` an empty (unquoted) string is written.
+
+   Instructs :class:`reader` to interpret an empty (unquoted) field as None, and
+   otherwise behave as QUOTE_ALL.
 
 .. data:: QUOTE_STRINGS
 
-   Instructs :class:`writer` quotes are always placed around fields
-   which are strings.  Note that ``None`` will be written as a
-   bar (unquoted) empty string.
+   Instructs :class:`writer` objects to always place quotes around fields
+   which are strings.  This is similar to QUOTE_NONNUMERIC, except that if a
+   field value is ``None`` an empty (unquoted) string is written.
+
+   Instructs :class:`reader` to interpret an empty (unquoted) string as None, and
+   otherwise behave as QUOTE_NONNUMERIC.
 
 The :mod:`csv` module defines the following exception:
 

diff --git a/Lib/test/test_csv.py b/Lib/test/test_csv.py
@@ -187,9 +187,9 @@ def test_write_quoting(self):
                          quoting = csv.QUOTE_ALL)
         self._write_test(['a\nb',1], '"a\nb","1"',
                          quoting = csv.QUOTE_ALL)
-        self._write_test(['a',None,1], '"a",,1',
+        self._write_test(['a','',None,1], '"a","",,1',
                          quoting = csv.QUOTE_STRINGS)
-        self._write_test(['a',None,1], '"a",,"1"',
+        self._write_test(['a','',None,1], '"a","",,"1"',
                          quoting = csv.QUOTE_NOTNULL)
 
     def test_write_escape(self):