https://github.com/python/cpython/commit/5210e307ae799a700633711f50768c5f08ca3d99
commit: 5210e307ae799a700633711f50768c5f08ca3d99
branch: 3.14
author: Miss Islington (bot) <[email protected]>
committer: hugovk <[email protected]>
date: 2025-09-11T15:18:25Z
summary:

[3.14] gh-138005: Document that CSV `skipinitialspace=True` and `delimiter=' '` 
require quotation for empty fields (GH-138006) (#138798)

Co-authored-by: Maurycy Pawłowski-Wieroński 
<[email protected]>

files:
M Doc/library/csv.rst

diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst
index d39c4ca4a5838b..4242fc51ab395c 100644
--- a/Doc/library/csv.rst
+++ b/Doc/library/csv.rst
@@ -467,7 +467,8 @@ Dialects support the following attributes:
 .. attribute:: Dialect.skipinitialspace
 
    When :const:`True`, spaces immediately following the *delimiter* are 
ignored.
-   The default is :const:`False`.
+   The default is :const:`False`.  When combining ``delimiter=' '`` with
+   ``skipinitialspace=True``, unquoted empty fields are not allowed.
 
 
 .. attribute:: Dialect.strict
@@ -636,7 +637,7 @@ done::
 .. rubric:: Footnotes
 
 .. [1] If ``newline=''`` is not specified, newlines embedded inside quoted 
fields
-   will not be interpreted correctly, and on platforms that use ``\r\n`` 
linendings
+   will not be interpreted correctly, and on platforms that use ``\r\n`` line 
endings
    on write an extra ``\r`` will be added.  It should always be safe to specify
    ``newline=''``, since the csv module does its own
    (:term:`universal <universal newlines>`) newline handling.

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to