New submission from Chris Jerdonek:
This issue is to make sure that the bare * in the function signatures of pure
Python functions is properly reflected in the documentation.
This will bring the signatures in the documentation closer to the signatures
that we have in the Python code -- a goal articulated by Ezio in a comment to
issue 15831.
For example, configparser.RawConfigParser() has this function signature:
def __init__(self, defaults=None, dict_type=_default_dict,
allow_no_value=False, *, delimiters=('=', ':'),
comment_prefixes=('#', ';'), inline_comment_prefixes=None,
strict=True, empty_lines_in_values=True,
default_section=DEFAULTSECT,
interpolation=_UNSET):
But its documentation has no *:
class configparser.RawConfigParser(defaults=None,
dict_type=collections.OrderedDict, allow_no_value=False, delimiters=('=', ':'),
comment_prefixes=('#', ';'), inline_comment_prefixes=None, strict=True,
empty_lines_in_values=True, default_section=configaparser.DEFAULTSECT,
interpolation=None)
(from
http://docs.python.org/dev/library/configparser.html#configparser.RawConfigParser
)
>From a search of the code, there are about 60 occurrences of a bare * in the
>signature of a pure Python function (not all of which will need to be updated).
----------
assignee: docs@python
components: Documentation
keywords: easy
messages: 169850
nosy: cjerdonek, docs@python, ezio.melotti
priority: normal
severity: normal
status: open
title: reflect bare star * in function signature documentation
type: behavior
versions: Python 3.3
_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue15865>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
