This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Tutorial Documentation for 4.7.3.2. Positional-Only Parameters, no "/" question?
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.9
process
Status: closed Resolution: not a bug
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, erlendaasland, thomaspcavalli, zach.ware
Priority: normal Keywords:

Created on 2021-04-05 00:59 by thomaspcavalli, last changed 2022-04-11 14:59 by admin. This issue is now closed.

Messages (2)
msg390218 - (view) Author: Thomas Cavalli (thomaspcavalli) Date: 2021-04-05 01:11
The last sentence of this section seems wrong to me:

"If there is no / in the function definition, there are no positional-only parameters."

Should this better be:

"If there is no / in the function definition, there are only positional-only parameters."

Reading further down does not seem to me to clarify this question.
msg390225 - (view) Author: Erlend E. Aasland (erlendaasland) * (Python triager) Date: 2021-04-05 07:21
Quoting https://docs.python.org/3.10/tutorial/controlflow.html#positional-only-parameters:
"Positional-only parameters are placed before a / (forward-slash). The / is used to logically separate the positional-only parameters from the rest of the parameters. If there is no / in the function definition, there are no positional-only parameters."

Note the preposition in the first sentence: Positional-only parameters are placed _before_ a forward slash.

See also the examples: https://docs.python.org/3.10/tutorial/controlflow.html#function-examples


AFAICS, the docs are clear and understandable.

Suggesting closing this as "not a bug".
History
Date User Action Args
2022-04-11 14:59:43adminsetgithub: 87896
2021-04-05 07:24:48serhiy.storchakasetstatus: open -> closed
resolution: not a bug
stage: resolved
2021-04-05 07:21:34erlendaaslandsetnosy: + erlendaasland, zach.ware
messages: + msg390225
2021-04-05 01:13:36thomaspcavallisettitle: Tutorial Documentation for 4.7.3.2. Positional-Only Parameters, no "/" question -> Tutorial Documentation for 4.7.3.2. Positional-Only Parameters, no "/" question?
2021-04-05 01:12:34thomaspcavallisettitle: Tutorial Documentation for 4.7.3.2. Positional-Only Parameters, no "/" ques -> Tutorial Documentation for 4.7.3.2. Positional-Only Parameters, no "/" question
2021-04-05 01:11:04thomaspcavallisetassignee: docs@python
type: enhancement
components: + Documentation
versions: + Python 3.9
nosy: + docs@python

messages: + msg390218
2021-04-05 00:59:54thomaspcavallicreate