From: Matthias Bussonnier <bussonniermatthias@gmail.com>
Date: Mon, 3 Jun 2019 00:43:22 +0000 (-0700)
Subject: bpo-36896: Clarify that some types constructors are unstable (GH-13271)
X-Git-Tag: v3.8.0b1~36
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=13136e83a637a9f1cfbada7e93097005296659b4;p=python

bpo-36896: Clarify that some types constructors are unstable (GH-13271)
---

diff --git a/Doc/library/types.rst b/Doc/library/types.rst
index e629c2935f..a21fb44dda 100644
--- a/Doc/library/types.rst
+++ b/Doc/library/types.rst
@@ -98,6 +98,9 @@ the types that arise only incidentally during processing such as the
 Typical use of these names is for :func:`isinstance` or
 :func:`issubclass` checks.
 
+
+If you instantiate any of these types, note that signatures may vary between Python versions.
+
 Standard names are defined for the following types:
 
 .. data:: FunctionType
diff --git a/Misc/NEWS.d/next/Documentation/2019-05-31-10-46-36.bpo-36896.wkXTW9.rst b/Misc/NEWS.d/next/Documentation/2019-05-31-10-46-36.bpo-36896.wkXTW9.rst
new file mode 100644
index 0000000000..d75fccad6c
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2019-05-31-10-46-36.bpo-36896.wkXTW9.rst
@@ -0,0 +1,2 @@
+Clarify that some types have unstable constructor signature between Python
+versions.