summaryrefslogtreecommitdiff
path: root/Doc/distutils
diff options
context:
space:
mode:
Diffstat (limited to 'Doc/distutils')
-rw-r--r--Doc/distutils/apiref.rst3
-rw-r--r--Doc/distutils/builtdist.rst9
2 files changed, 12 insertions, 0 deletions
diff --git a/Doc/distutils/apiref.rst b/Doc/distutils/apiref.rst
index 2601d30f63..937f19f57b 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 8c65d9d591..b814f2e950 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.