Apr 30, 2025 · May 20, 2025
diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst
 .. data:: QUOTE_MINIMAL

   Instructs :class:`writer` objects to only quote those fields which contain
   special characters such as *delimiter*, *quotechar* or any of the characters in
   *lineterminator*.
   special characters such as *delimiter*, *quotechar*, ``'\r'``, ``'\n'``
 or any of the characters in*lineterminator*.


 .. data:: QUOTE_NONNUMERIC

 .. data:: QUOTE_NONE

   Instructs :class:`writer` objects to never quote fields.  When the current
   *delimiter* occurs in output data it is preceded by the current *escapechar*
   character.  If *escapechar* is not set, the writer will raise :exc:`Error` if
   Instructs :class:`writer` objects to never quote fields.
   When the current *delimiter*, *quotechar*, *escapechar*, ``'\r'``, ``'\n'``
   or any of the characters in *lineterminator* occurs in output data
   it is preceded by the current *escapechar* character.
   If *escapechar* is not set, the writer will raise :exc:`Error` if
   any characters that require escaping are encountered.
   Set *quotechar* to ``None`` to prevent its escaping.

   Instructs :class:`reader` objects to perform no special processing of quote characters.


 .. attribute:: Dialect.escapechar

   A one-character string used by the writer to escape the *delimiter* if *quoting*
   is set to :const:`QUOTE_NONE` and the *quotechar* if *doublequote* is
   :const:`False`. On reading, the *escapechar* removes any special meaning from
   A one-character string used by the writer to escape characters that
   require escaping:

      * the *delimiter*, the *quotechar*, ``'\r'``, ``'\n'`` and any of the
        characters in *lineterminator* are escaped if *quoting* is set to
        :const:`QUOTE_NONE`;
      * the *quotechar* is escaped if *doublequote* is :const:`False`;
      * the *escapechar* itself.

   On reading, the *escapechar* removes any special meaning from
   the following character. It defaults to :const:`None`, which disables escaping.

   .. versionchanged:: 3.11

 .. attribute:: Dialect.quotechar

   A one-character string used to quote fields containing special characters, such
   as the *delimiter* or *quotechar*, or which contain new-line characters.  It
   defaults to ``'"'``.
   A one-character string used to quote fields containing special characters,
   such as the *delimiter* or the *quotechar*, or which contain new-line
   characters (``'\r'``, ``'\n'`` or any of the characters in *lineterminator*).
   It defaults to ``'"'``.
   Can be set to ``None`` to prevent escaping ``'"'`` if *quoting* is set
   to :const:`QUOTE_NONE`.

   .. versionchanged:: 3.11
      An empty *quotechar* is not allowed.

   Controls when quotes should be generated by the writer and recognised by the
   reader.  It can take on any of the :ref:`QUOTE_\* constants <csv-constants>`
   and defaults to :const:`QUOTE_MINIMAL`.
   and defaults to :const:`QUOTE_MINIMAL` if *quotechar* is not ``None``,
   and :const:`QUOTE_NONE` otherwise.


 .. attribute:: Dialect.skipinitialspace
Original file line number	Diff line number	Diff line change
Expand Up		@@ -323,8 +323,8 @@ The :mod:`csv` module defines the following constants:
		.. data:: QUOTE_MINIMAL

		Instructs :class:`writer` objects to only quote those fields which contain
		special characters such as delimiter, quotechar or any of the characters in
		lineterminator.
		special characters such as delimiter, quotechar, ``'\r'``, ``'\n'``
		or any of the characters inlineterminator.


		.. data:: QUOTE_NONNUMERIC
Expand All		@@ -336,10 +336,13 @@ The :mod:`csv` module defines the following constants:

		.. data:: QUOTE_NONE

		Instructs :class:`writer` objects to never quote fields. When the current
		delimiter occurs in output data it is preceded by the current escapechar
		character. If escapechar is not set, the writer will raise :exc:`Error` if
		Instructs :class:`writer` objects to never quote fields.
		When the current delimiter, quotechar, escapechar, ``'\r'``, ``'\n'``
		or any of the characters in lineterminator occurs in output data
		it is preceded by the current escapechar character.
		If escapechar is not set, the writer will raise :exc:`Error` if
		any characters that require escaping are encountered.
		Set quotechar to ``None`` to prevent its escaping.

		Instructs :class:`reader` objects to perform no special processing of quote characters.

Expand DownExpand Up		@@ -408,9 +411,16 @@ Dialects support the following attributes:

		.. attribute:: Dialect.escapechar

		A one-character string used by the writer to escape the delimiter if quoting
		is set to :const:`QUOTE_NONE` and the quotechar if doublequote is
		:const:`False`. On reading, the escapechar removes any special meaning from
		A one-character string used by the writer to escape characters that
		require escaping:

		* the delimiter, the quotechar, ``'\r'``, ``'\n'`` and any of the
		characters in lineterminator are escaped if quoting is set to
		:const:`QUOTE_NONE`;
		* the quotechar is escaped if doublequote is :const:`False`;
		* the escapechar itself.

		On reading, the escapechar removes any special meaning from
		the following character. It defaults to :const:`None`, which disables escaping.

		.. versionchanged:: 3.11
Expand All		@@ -430,9 +440,12 @@ Dialects support the following attributes:

		.. attribute:: Dialect.quotechar

		A one-character string used to quote fields containing special characters, such
		as the delimiter or quotechar, or which contain new-line characters. It
		defaults to ``'"'``.
		A one-character string used to quote fields containing special characters,
		such as the delimiter or the quotechar, or which contain new-line
		characters (``'\r'``, ``'\n'`` or any of the characters in lineterminator).
		It defaults to ``'"'``.
		Can be set to ``None`` to prevent escaping ``'"'`` if quoting is set
serhiy-storchaka marked this conversation as resolved. Show resolvedHide resolved
		to :const:`QUOTE_NONE`.

		.. versionchanged:: 3.11
		An empty quotechar is not allowed.
Expand All		@@ -441,7 +454,8 @@ Dialects support the following attributes:

		Controls when quotes should be generated by the writer and recognised by the
		reader. It can take on any of the :ref:`QUOTE_\* constants <csv-constants>`
		and defaults to :const:`QUOTE_MINIMAL`.
		and defaults to :const:`QUOTE_MINIMAL` if quotechar is not ``None``,
		and :const:`QUOTE_NONE` otherwise.


		.. attribute:: Dialect.skipinitialspace
Expand Down