[New-bugs-announce] [issue26699] locale.str docstring is incorrect: "Convert float to integer"

[Mark Dickinson]

New submission from Mark Dickinson:

[Observed by one of my colleagues]

The locale.str docstring currently looks like this (and apparently has been
this way since the dawn of time):

    def str(val):
        """Convert float to integer, taking the locale into account."""

The output of str doesn't *look* like an integer on my machine. :-)

    Python 2.7.10 |Master 2.1.0.dev1829 (64-bit)| (default, Oct 21 2015, 09:09:19) 
    [GCC 4.2.1 (Based on Apple Inc. build 5658) (LLVM build 2335.6)] on darwin
    Type "help", "copyright", "credits" or "license" for more information.
    >>> import locale
    >>> locale.setlocale(locale.LC_NUMERIC, 'fr_FR')
    'fr_FR'
    >>> locale.str(34.56)
    '34,56'

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 262936
nosy: docs at python, mark.dickinson
priority: normal
severity: normal
stage: needs patch
status: open
title: locale.str docstring is incorrect: "Convert float to integer"
type: behavior
versions: Python 2.7, Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26699>
_______________________________________