[New-bugs-announce] [issue27577] tuple and list parameter name conflicts between doc and implementation

[Xiang Zhang]

New submission from Xiang Zhang:

For tuple and list, their signatures are tuple([iterable]) and list([iterable]). But actually they support keyword argument *sequence*. The parameter names in doc are sometimes just placeholders but sometimes are real parameter names. So I suggest make the implementation and doc more compliant. One method is make the parameter name in implementation *iterable*. The other is totally suppress keyword argument since it is never documented. This is not a necessary change but I think the compliment is not a bad idea.

----------
components: Interpreter Core
messages: 270858
nosy: serhiy.storchaka, xiang.zhang
priority: normal
severity: normal
status: open
title: tuple and list parameter name conflicts between doc and implementation
type: enhancement
versions: Python 3.6

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