main icon indicating copy to clipboard operation
main copied to clipboard

__doc__ members should be in English (or consistent WRT the language)

Open ironpythonbot opened this issue 9 years ago • 1 comments

--------------------------------------------------------------------------


IP VERSION AFFECTED: 2.6 pre-alpha
BUILD TYPE: All
FLAGS PASSED TO IPY.EXE: None
OPERATING SYSTEM: 32-bit Vista SP1
CLR VERSION: .NET 2.0 SP1

--------------------------------------------------------------------------


BRIEF DESCRIPTION:
** doc ** members for Python builtin types which have a corresponding CLR BCL type (e.g., int) are
in the language of the OS. We don't do the same for Python types we had to implement
ourselves (e.g., long) though. Regardless, CPython appears to use English for all ** doc **
members.

--------------------------------------------------------------------------


REPRODUCTION SNIPPET:
C:\vsl\Merlin\Main>ipyd -c "print long. ** doc ** "

        arbitrary precision integers

long(long copy)
long(int sign, Array[UInt32] data)

C:\vsl\Merlin\Main>cpy -c "print long. ** doc ** "
long(x[, base]) -> integer
Convert a string or number to a long integer, if possible. A floating
point argument will be truncated towards zero (this does not include a
string representation of a floating point number!) When converting a
string, use the optional base. It is an error to supply a base when
converting a non-string.

C:\vsl\Merlin\Main>ipyd -c "print int. ** doc ** "

      Stellt eine 32-Bit-Ganzzahl mit Vorzeichen dar.

C:\vsl\Merlin\Main>cpy -c "print int. ** doc ** "
int(x[, base]) -> integer
Convert a string or number to an integer, if possible. A floating point
argument will be truncated towards zero (this does not include a string
representation of a floating point number!) When converting a string, use
the optional base. It is an error to supply a base when converting a
non-string. If the argument is outside the integer range a long object
will be returned instead.

Work Item Details

Original CodePlex Issue: Issue 21566 Status: Active Reason Closed: Unassigned Assigned to: Unassigned Reported on: Mar 10, 2009 at 5:18 PM Reported by: dfugate Updated on: Feb 22, 2013 at 2:13 AM Updated by: jdhardy Test: Needed

ironpythonbot avatar Dec 09 '14 17:12 ironpythonbot

On 2009-04-14 02:33:03 UTC, harrypierson commented:

Need to add IPy specific doc strings for str, int, float and object

ironpythonbot avatar Dec 09 '14 17:12 ironpythonbot