[Python-checkins] [3.9] Document func parameter of locale.atof (GH-18183) (GH-32261)

[JelleZijlstra]

https://github.com/python/cpython/commit/62da258a455974014ddc3a40466724bb815f862d
commit: 62da258a455974014ddc3a40466724bb815f862d
branch: 3.9
author: Jelle Zijlstra <jelle.zijlstra at gmail.com>
committer: JelleZijlstra <jelle.zijlstra at gmail.com>
date: 2022-04-02T15:59:57-07:00
summary:

[3.9] Document func parameter of locale.atof (GH-18183) (GH-32261)

The second parameter (named `func`) has been present since the `locale`
module was introduced in eef1d4e8b1, but has never been documented.

This commit updates the documentation for `locale.atof` to clarify the
behavior of the function and how the `func` parameter is used.

Signed-off-by: Kevin Locke <kevin at kevinlocke.name>.
(cherry picked from commit 208da6d508bb2683732151f4ae288dfc8001267c)

Co-authored-by: Kevin Locke <kevin at kevinlocke.name>

files:
M Doc/library/locale.rst

diff --git a/Doc/library/locale.rst b/Doc/library/locale.rst
index bf57a08355916..5b5a0c7552323 100644
--- a/Doc/library/locale.rst
+++ b/Doc/library/locale.rst
@@ -423,10 +423,10 @@ The :mod:`locale` module defines the following exception and functions:
     .. versionadded:: 3.5
 
 
-.. function:: atof(string)
+.. function:: atof(string, func=float)
 
-   Converts a string to a floating point number, following the :const:`LC_NUMERIC`
-   settings.
+   Converts a string to a number, following the :const:`LC_NUMERIC` settings,
+   by calling *func* on the result of calling :func:`delocalize` on *string*.
 
 
 .. function:: atoi(string)