[docs] [issue19573] Fix the docstring of inspect.Parameter and the implementation of _ParameterKind

[Antony Lee]

New submission from Antony Lee:

The following patch corrects the docstring of `inspect.Parameter`, as the `default` and `annotation` attributes are in fact set to `empty` if no value is provided, and the `kind` attribute is in fact an `int` (more precisely, a `_ParameterKind`).  It also reimplements the `_ParameterKind` type as an `IntEnum`, as the previous implementation (which predates stdlib enums) was more or less a hand-rolled `IntEnum`.

----------
assignee: docs at python
components: Documentation
files: inspect.py.diff
keywords: patch
messages: 202773
nosy: Antony.Lee, docs at python
priority: normal
severity: normal
status: open
title: Fix the docstring of inspect.Parameter and the implementation of _ParameterKind
type: enhancement
Added file: http://bugs.python.org/file32600/inspect.py.diff

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19573>
_______________________________________