Message169850
| Author |
chris.jerdonek |
| Recipients |
chris.jerdonek, docs@python, ezio.melotti |
| Date |
2012年09月05日.00:42:29 |
| SpamBayes Score |
-1.0 |
| Marked as misclassified |
Yes |
| Message-id |
<1346805751.63.0.697181229134.issue15865@psf.upfronthosting.co.za> |
| In-reply-to |
| Content |
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). |
|
History
|
|---|
| Date |
User |
Action |
Args |
| 2012年09月05日 00:42:31 | chris.jerdonek | set | recipients:
+ chris.jerdonek, ezio.melotti, docs@python |
| 2012年09月05日 00:42:31 | chris.jerdonek | set | messageid: <1346805751.63.0.697181229134.issue15865@psf.upfronthosting.co.za> |
| 2012年09月05日 00:42:30 | chris.jerdonek | link | issue15865 messages |
| 2012年09月05日 00:42:29 | chris.jerdonek | create |
|