[issue40646] Builtins in doc show signature in documentation

[Henk-Jaap Wagenaar]

New submission from Henk-Jaap Wagenaar <wagenaarhenkjaap at gmail.com>:

Due to a certain discussion on extending zip, I was having looking at this page:

https://docs.python.org/3/library/functions.html

It lists the builtins at the top as e.g. all() which I think is confusing: running all() will actually fail.

I think it should either (using "all" as example):
1. display as "all"
2. display as "all(iterable)" (what to do about 'overloaded' functions like e.g. range?)

I am happy to provide a PR for the preferred option.

----------
assignee: docs at python
components: Documentation
messages: 369053
nosy: cryvate, docs at python
priority: normal
severity: normal
status: open
title: Builtins in doc show signature in documentation
type: enhancement
versions: Python 3.9

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue40646>
_______________________________________