bpo-33594: Add deprecation info in inspect.py module (GH-7036)

(cherry picked from commit ded87d8) Co-authored-by: Matthias Bussonnier <bussonniermatthias@gmail.com>

Author: miss-islington

Lib/inspect.py

@@ -1070,8 +1070,10 @@ def getargspec(func):
  Alternatively, use getfullargspec() for an API with a similar namedtuple
  based interface, but full support for annotations and keyword-only
  parameters.
+
+ Deprecated since Python 3.5, use `inspect.getfullargspec()`.
  """
- warnings.warn("inspect.getargspec() is deprecated, "
+ warnings.warn("inspect.getargspec() is deprecated since Python 3.0, "
  "use inspect.signature() or inspect.getfullargspec()",
  DeprecationWarning, stacklevel=2)
  args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, ann = \
@@ -2802,19 +2804,25 @@ def __init__(self, parameters=None, *, return_annotation=_empty,
 
  @classmethod
  def from_function(cls, func):
- """Constructs Signature for the given python function."""
+ """Constructs Signature for the given python function.
+
+ Deprecated since Python 3.5, use `Signature.from_callable()`.
+ """
 
- warnings.warn("inspect.Signature.from_function() is deprecated, "
- "use Signature.from_callable()",
+ warnings.warn("inspect.Signature.from_function() is deprecated since "
+ "Python 3.5, use Signature.from_callable()",
  DeprecationWarning, stacklevel=2)
  return _signature_from_function(cls, func)
 
  @classmethod
  def from_builtin(cls, func):
- """Constructs Signature for the given builtin function."""
+ """Constructs Signature for the given builtin function.
+
+ Deprecated since Python 3.5, use `Signature.from_callable()`.
+ """
 
- warnings.warn("inspect.Signature.from_builtin() is deprecated, "
- "use Signature.from_callable()",
+ warnings.warn("inspect.Signature.from_builtin() is deprecated since "
+ "Python 3.5, use Signature.from_callable()",
  DeprecationWarning, stacklevel=2)
  return _signature_from_builtin(cls, func)
 

Misc/NEWS.d/next/Documentation/2018-05-21-14-36-12.bpo-33594.-HRcyX.rst

@@ -0,0 +1,3 @@
+Document ``getargspec``, ``from_function`` and ``from_builtin`` as
+deprecated in their respective docstring, and include version since
+deprecation in DeprecationWarning message.