summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorSkip Montanaro <skip.montanaro@gmail.com>2022-11-04 13:02:11 (GMT)
committerGitHub <noreply@github.com>2022-11-04 13:02:11 (GMT)
commitc0bf7607a1c215cd92f2976c9e915b913fc149d1 (patch)
tree5ef6b9879b0e23a615df1d6499a72be625169118 /Doc
parent2844aa6a8eb1d486b5c432f0ed33a2082998f41e (diff)
downloadcpython-c0bf7607a1c215cd92f2976c9e915b913fc149d1.zip
cpython-c0bf7607a1c215cd92f2976c9e915b913fc149d1.tar.gz
cpython-c0bf7607a1c215cd92f2976c9e915b913fc149d1.tar.bz2
minor edits to locale doc (#98537)
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/locale.rst29
1 files changed, 16 insertions, 13 deletions
diff --git a/Doc/library/locale.rst b/Doc/library/locale.rst
index 5bb09b6..1e46b0f 100644
--- a/Doc/library/locale.rst
+++ b/Doc/library/locale.rst
@@ -147,12 +147,12 @@ The :mod:`locale` module defines the following exception and functions:
| ``CHAR_MAX`` | Nothing is specified in this locale. |
+--------------+-----------------------------------------+
- The function sets temporarily the ``LC_CTYPE`` locale to the ``LC_NUMERIC``
+ The function temporarily sets the ``LC_CTYPE`` locale to the ``LC_NUMERIC``
locale or the ``LC_MONETARY`` locale if locales are different and numeric or
monetary strings are non-ASCII. This temporary change affects other threads.
.. versionchanged:: 3.7
- The function now sets temporarily the ``LC_CTYPE`` locale to the
+ The function now temporarily sets the ``LC_CTYPE`` locale to the
``LC_NUMERIC`` locale in some cases.
@@ -227,16 +227,18 @@ The :mod:`locale` module defines the following exception and functions:
Get a regular expression that can be used with the regex function to
recognize a positive response to a yes/no question.
- .. note::
-
- The expression is in the syntax suitable for the :c:func:`regex` function
- from the C library, which might differ from the syntax used in :mod:`re`.
-
.. data:: NOEXPR
Get a regular expression that can be used with the regex(3) function to
recognize a negative response to a yes/no question.
+ .. note::
+
+ The regular expressions for :const:`YESEXPR` and
+ :const:`NOEXPR` use syntax suitable for the
+ :c:func:`regex` function from the C library, which might
+ differ from the syntax used in :mod:`re`.
+
.. data:: CRNCYSTR
Get the currency symbol, preceded by "-" if the symbol should appear before
@@ -399,7 +401,7 @@ The :mod:`locale` module defines the following exception and functions:
Formats a number *val* according to the current :const:`LC_NUMERIC` setting.
The format follows the conventions of the ``%`` operator. For floating point
- values, the decimal point is modified if appropriate. If *grouping* is true,
+ values, the decimal point is modified if appropriate. If *grouping* is ``True``,
also takes the grouping into account.
If *monetary* is true, the conversion uses monetary thousands separator and
@@ -417,12 +419,14 @@ The :mod:`locale` module defines the following exception and functions:
Formats a number *val* according to the current :const:`LC_MONETARY` settings.
The returned string includes the currency symbol if *symbol* is true, which is
- the default. If *grouping* is true (which is not the default), grouping is done
- with the value. If *international* is true (which is not the default), the
+ the default. If *grouping* is ``True`` (which is not the default), grouping is done
+ with the value. If *international* is ``True`` (which is not the default), the
international currency symbol is used.
- Note that this function will not work with the 'C' locale, so you have to set a
- locale via :func:`setlocale` first.
+ .. note::
+
+ This function will not work with the 'C' locale, so you have to set a
+ locale via :func:`setlocale` first.
.. function:: str(float)
@@ -609,4 +613,3 @@ applications that link with additional C libraries which internally invoke
:c:func:`gettext` or :c:func:`dcgettext`. For these applications, it may be
necessary to bind the text domain, so that the libraries can properly locate
their message catalogs.
-