https://github.com/python/cpython/commit/9b0179fa87fee39df0f75bd84fc2dd75f1d00553
commit: 9b0179fa87fee39df0f75bd84fc2dd75f1d00553
branch: main
author: Stan Ulbrych <[email protected]>
committer: ZeroIntensity <[email protected]>
date: 2025-11-09T19:43:03-05:00
summary:
gh-141004: Document `Py_DTSF_*` macros (GH-141310)
files:
M Doc/c-api/conversion.rst
diff --git a/Doc/c-api/conversion.rst b/Doc/c-api/conversion.rst
index cc7a3d9d9561a3..e9d866c647d9e0 100644
--- a/Doc/c-api/conversion.rst
+++ b/Doc/c-api/conversion.rst
@@ -128,18 +128,28 @@ The following functions provide locale-independent string
to number conversions.
must be 0 and is ignored. The ``'r'`` format code specifies the
standard :func:`repr` format.
- *flags* can be zero or more of the values ``Py_DTSF_SIGN``,
- ``Py_DTSF_ADD_DOT_0``, or ``Py_DTSF_ALT``, or-ed together:
+ *flags* can be zero or more of the following values or-ed together:
- * ``Py_DTSF_SIGN`` means to always precede the returned string with a sign
- character, even if *val* is non-negative.
+ .. c:macro:: Py_DTSF_SIGN
- * ``Py_DTSF_ADD_DOT_0`` means to ensure that the returned string will not
look
- like an integer.
+ Always precede the returned string with a sign
+ character, even if *val* is non-negative.
- * ``Py_DTSF_ALT`` means to apply "alternate" formatting rules. See the
- documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier for
- details.
+ .. c:macro:: Py_DTSF_ADD_DOT_0
+
+ Ensure that the returned string will not look like an integer.
+
+ .. c:macro:: Py_DTSF_ALT
+
+ Apply "alternate" formatting rules.
+ See the documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier
for
+ details.
+
+ .. c:macro:: Py_DTSF_NO_NEG_0
+
+ Negative zero is converted to positive zero.
+
+ .. versionadded:: 3.11
If *ptype* is non-``NULL``, then the value it points to will be set to one
of
``Py_DTST_FINITE``, ``Py_DTST_INFINITE``, or ``Py_DTST_NAN``, signifying
that
_______________________________________________
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]
