Issue 33300: Bad usage example in id() DocString
Created on 2018-04-17 20:02 by gneff, last changed 2022-04-11 14:58 by admin. This issue is now closed.
| Messages (2) | |||
|---|---|---|---|
| msg315410 - (view) | Author: Glen Neff (gneff) | Date: 2018-04-17 20:02 | |
The DocString for id() in 3.5.x & 3.6.x seems to have an incorrect usage example, specifically ``id(obj, /)``.
This is present in 3.5.x & 3.6.x. It does not appear to be present in 2.7.x or 3.4.x.:
Python 3.6.4 (v3.6.4:d48eceb, Dec 19 2017, 06:54:40) [MSC v.1900 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> help(id)
Help on built-in function id in module builtins:
id(obj, /)
Return the identity of an object.
This is guaranteed to be unique among simultaneously existing objects.
(CPython uses the object's memory address.)
>>>
|
|||
| msg315416 - (view) | Author: Martin Panter (martin.panter) * ![]() |
Date: 2018-04-17 20:52 | |
It is supposed to be a function signature, similar to the syntax when you define your own function, rather than a usage example of calling the function. In this case, the slash notation is described by PEP 457. It is supposed to indicate that “obj” is a positional-only parameter, and not a keyword parameter. If that is what you think is incorrect, perhaps you can suggest a place to explain the notation in Issue 21314. |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022-04-11 14:58:59 | admin | set | github: 77481 |
| 2020-10-31 15:16:34 | iritkatriel | set | status: pending -> closed stage: resolved |
| 2018-08-11 22:11:03 | martin.panter | set | status: open -> pending resolution: duplicate |
| 2018-04-17 20:52:05 | martin.panter | set | superseder: Document '/' in signatures messages:
+ msg315416 |
| 2018-04-17 20:02:15 | gneff | create | |
