New submission from Pablo Galindo Salgado <pablog...@gmail.com>:

In the documentation, there are a lot of mismatches regarding function and 
method signatures that use positional-only arguments with respect to the 
docstrings (that properly use PEP570 syntax for documenting positional-only 
parameters).

Not that the official syntax for positional-only parameters is accepted (the 
"/"), the documentation needs to be updated to reflect positional-only 
parameters in the functions and methods that use them as covered in the PEP 
document.

----------
assignee: docs@python
components: Documentation
messages: 344295
nosy: docs@python, pablogsal
priority: normal
severity: normal
status: open
title: Use PEP570 syntax in the documentation
versions: Python 3.8

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue37134>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to