summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorVictor Stinner <vstinner@redhat.com>2019-07-05 08:44:12 (GMT)
committerGitHub <noreply@github.com>2019-07-05 08:44:12 (GMT)
commit1da4462765b084dfa8d869b6cb5855e8f6014a11 (patch)
tree42e1203ee43a5d5da5da56ba489e76b3dddecb47 /Doc
parenta55f75a6e3e9cda5c7c30bd961386b1a8a2e9892 (diff)
downloadcpython-1da4462765b084dfa8d869b6cb5855e8f6014a11.zip
cpython-1da4462765b084dfa8d869b6cb5855e8f6014a11.tar.gz
cpython-1da4462765b084dfa8d869b6cb5855e8f6014a11.tar.bz2
bpo-37481: Deprecate distutils bdist_wininst command (GH-14553)
The distutils bdist_wininst command is now deprecated, use bdist_wheel (wheel packages) instead.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/distutils/apiref.rst3
-rw-r--r--Doc/distutils/builtdist.rst9
-rw-r--r--Doc/whatsnew/3.8.rst4
3 files changed, 16 insertions, 0 deletions
diff --git a/Doc/distutils/apiref.rst b/Doc/distutils/apiref.rst
index 2601d30..937f19f 100644
--- a/Doc/distutils/apiref.rst
+++ b/Doc/distutils/apiref.rst
@@ -1863,6 +1863,9 @@ Subclasses of :class:`Command` must define the following methods.
.. module:: distutils.command.bdist_wininst
:synopsis: Build a Windows installer
+.. deprecated:: 3.8
+ Use bdist_wheel (wheel packages) instead.
+
.. % todo
diff --git a/Doc/distutils/builtdist.rst b/Doc/distutils/builtdist.rst
index 8c65d9d..b814f2e 100644
--- a/Doc/distutils/builtdist.rst
+++ b/Doc/distutils/builtdist.rst
@@ -146,6 +146,9 @@ generated by each, are:
| :command:`bdist_msi` | msi |
+--------------------------+-------------------------------------+
+.. note::
+ bdist_wininst is deprecated since Python 3.8.
+
The following sections give details on the individual :command:`bdist_\*`
commands.
@@ -298,6 +301,9 @@ file winds up deep in the "build tree," in a temporary directory created by
Creating Windows Installers
===========================
+.. warning::
+ bdist_wininst is deprecated since Python 3.8.
+
Executable installers are the natural format for binary distributions on
Windows. They display a nice graphical user interface, display some information
about the module distribution to be installed taken from the metadata in the
@@ -459,3 +465,6 @@ Starting with Python 2.6, bdist_wininst supports a :option:`!--user-access-contr
option. The default is 'none' (meaning no UAC handling is done), and other
valid values are 'auto' (meaning prompt for UAC elevation if Python was
installed for all users) and 'force' (meaning always prompt for elevation).
+
+.. note::
+ bdist_wininst is deprecated since Python 3.8.
diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst
index 61e1d3d..95f25cd 100644
--- a/Doc/whatsnew/3.8.rst
+++ b/Doc/whatsnew/3.8.rst
@@ -1068,6 +1068,10 @@ Build and C API Changes
Deprecated
==========
+* The distutils ``bdist_wininst`` command is now deprecated, use
+ ``bdist_wheel`` (wheel packages) instead.
+ (Contributed by Victor Stinner in :issue:`37481`.)
+
* Deprecated methods ``getchildren()`` and ``getiterator()`` in
the :mod:`~xml.etree.ElementTree` module emit now a
:exc:`DeprecationWarning` instead of :exc:`PendingDeprecationWarning`.