mirrors
/
cpython
mirror of https://github.com/python/cpython.git
2
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[3.10] bpo-46044: Annotate deprecated sdists formats (GH-30043) (#30154) 

(cherry picked from commit ecdc0ccede)

Co-authored-by: Matthias Bussonnier <bussonniermatthias@gmail.com>
Co-authored-by: Brett Cannon <brett@python.org>
Co-authored-by: Éric <merwok@netwok.org>
This commit is contained in:
Miss Islington (bot) 2021-12-17 15:32:02 -08:00 committed by GitHub
parent 251d2eadc7
commit dbd1dc23f6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 22 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
Doc/distutils/sourcedist.rst
View File

@ -23,25 +23,25 @@ option, for example::
to create a gzipped tarball and a zip file. The available formats are: to create a gzipped tarball and a zip file. The available formats are:
+-----------+-------------------------+---------+ +-----------+-------------------------+-------------+
| Format | Description | Notes | | Format | Description | Notes |
+===========+=========================+=========+ +===========+=========================+=============+
| ``zip`` | zip file (:file:`.zip`) | (1),(3) | | ``zip`` | zip file (:file:`.zip`) | (1),(3) |
+-----------+-------------------------+---------+ +-----------+-------------------------+-------------+
| ``gztar`` | gzip'ed tar file | \(2) | | ``gztar`` | gzip'ed tar file | \(2) |
| | (:file:`.tar.gz`) | | | | (:file:`.tar.gz`) | |
+-----------+-------------------------+---------+ +-----------+-------------------------+-------------+
| ``bztar`` | bzip2'ed tar file | | | ``bztar`` | bzip2'ed tar file | \(5) |
| | (:file:`.tar.bz2`) | | | | (:file:`.tar.bz2`) | |
+-----------+-------------------------+---------+ +-----------+-------------------------+-------------+
| ``xztar`` | xz'ed tar file | | | ``xztar`` | xz'ed tar file | \(5) |
| | (:file:`.tar.xz`) | | | | (:file:`.tar.xz`) | |
+-----------+-------------------------+---------+ +-----------+-------------------------+-------------+
| ``ztar`` | compressed tar file | \(4) | | ``ztar`` | compressed tar file | (4),(5) |
| | (:file:`.tar.Z`) | | | | (:file:`.tar.Z`) | |
+-----------+-------------------------+---------+ +-----------+-------------------------+-------------+
| ``tar`` | tar file (:file:`.tar`) | | | ``tar`` | tar file (:file:`.tar`) | \(5) |
+-----------+-------------------------+---------+ +-----------+-------------------------+-------------+
.. versionchanged:: 3.5 .. versionchanged:: 3.5
Added support for the ``xztar`` format. Added support for the ``xztar`` format.
@ -61,6 +61,9 @@ Notes:
(4) (4)
requires the :program:`compress` program. Notice that this format is now requires the :program:`compress` program. Notice that this format is now
pending for deprecation and will be removed in the future versions of Python. pending for deprecation and will be removed in the future versions of Python.
(5)
deprecated by `PEP 527 <https://www.python.org/dev/peps/pep-0527/>`_;
`PyPI <https://pypi.org>`_ only accepts ``.zip`` and ``.tar.gz`` files.
When using any ``tar`` format (``gztar``, ``bztar``, ``xztar``, ``ztar`` or When using any ``tar`` format (``gztar``, ``bztar``, ``xztar``, ``ztar`` or
``tar``), under Unix you can specify the ``owner`` and ``group`` names ``tar``), under Unix you can specify the ``owner`` and ``group`` names