Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2026-02-13 19:04:37 +00:00
Code Issues Projects Releases Packages Wiki Activity

bpo-46044: Annotate deprecated sdists formats (GH-30043)

Browse source 
While this page have deprecated informations it is still heavily index
by Google.

Discussed on twitter: https://twitter.com/brettsky/status/1469465729082662916
This commit is contained in:
Matthias Bussonnier 2021-12-16 20:57:39 +01:00 • committed by GitHub
parent 86f42851c0
commit ecdc0ccede
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 22 additions and 19 deletions
Download patch file Download diff file Expand all files Collapse all files

41
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:
+-----------+-------------------------+---------+
| Format | Description | Notes |
+===========+=========================+=========+
| ``zip`` | zip file (:file:`.zip`) | (1),(3) |
+-----------+-------------------------+---------+
| ``gztar`` | gzip'ed tar file | \(2) |
| | (:file:`.tar.gz`) | |
+-----------+-------------------------+---------+
| ``bztar`` | bzip2'ed tar file | |
| | (:file:`.tar.bz2`) | |
+-----------+-------------------------+---------+
| ``xztar`` | xz'ed tar file | |
| | (:file:`.tar.xz`) | |
+-----------+-------------------------+---------+
| ``ztar`` | compressed tar file | \(4) |
| | (:file:`.tar.Z`) | |
+-----------+-------------------------+---------+
| ``tar`` | tar file (:file:`.tar`) | |
+-----------+-------------------------+---------+
+-----------+-------------------------+-------------+
| Format | Description | Notes |
+===========+=========================+=============+
| ``zip`` | zip file (:file:`.zip`) | (1),(3) |
+-----------+-------------------------+-------------+
| ``gztar`` | gzip'ed tar file | \(2) |
| | (:file:`.tar.gz`) | |
+-----------+-------------------------+-------------+
| ``bztar`` | bzip2'ed tar file | \(5) |
| | (:file:`.tar.bz2`) | |
+-----------+-------------------------+-------------+
| ``xztar`` | xz'ed tar file | \(5) |
| | (:file:`.tar.xz`) | |
+-----------+-------------------------+-------------+
| ``ztar`` | compressed tar file | \(5) |
| | (:file:`.tar.Z`) | |
+-----------+-------------------------+-------------+
| ``tar`` | tar file (:file:`.tar`) | \(5) |
+-----------+-------------------------+-------------+
.. versionchanged:: 3.5
Added support for the ``xztar`` format.
@ -61,6 +61,9 @@ Notes:
(4)
requires the :program:`compress` program. Notice that this format is now
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
``tar``), under Unix you can specify the ``owner`` and ``group`` names