Setuptools

=======


Changes
-------
* 3347: Changed warnings and documentation notes about *experimental* aspect of ``pyproject.toml`` configuration:
now ``[project]`` is a fully supported configuration interface, but the ``[tool.setuptools]`` table
and sub-tables are still considered to be in **beta** stage.
* 3383: In _distutils_hack, suppress/undo the use of local distutils when select tests are imported in CPython.

Documentation changes
---------------------
* 3368: Added documentation page about extension modules -- by :user:`mkoeppe`
* 3371: Moved documentation from ``/userguide/commands`` to ``/depracted/commands``.
This change was motived by the fact that running ``python setup.py`` directly is
considered a deprecated practice.
* 3372: Consolidated sections about ``sdist`` contents and ``MANIFEST.in`` into a single page.

Added a simple ``MANIFEST.in`` example.
* 3373: Moved remarks about using :pypi:`Cython` to the newly created page for
extension modules.
* 3374: Added clarification that using ``python setup.py egg_info`` commands to
manage project versions is only supported in a *transitional* basis, and
that eventually ``egg_info`` will be deprecated.

Reorganized sections with tips for managing versions.
* 3378: Updated ``Quickstart`` docs to make it easier to follow for beginners.

Misc
----
* 3385: Modules used to parse and evaluate configuration from ``pyproject.toml`` files are
intended for internal use only and that not part of the public API.

=======


Changes
-------
* 3256: Added setuptools.command.build command to match distutils.command.build -- by :user:`isuruf`
* 3366: Merge with pypa/distutils75ed79d including reformat using black, fix for Cygwin support (pypa/distutils139), and improved support for cross compiling (pypa/distutils144 and pypa/distutils145).

Documentation changes
---------------------
* 3355: Changes to the User Guide's Entry Points page -- by :user:`codeandfire`
* 3361: Further minor corrections to the Entry Points page -- by :user:`codeandfire`
* 3363: Rework some documentation pages to de-emphasize ``distutils`` and the history
of packaging in the Python ecosystem. The focus of these changes is to make the
documentation easier to read for new users.
* 3364: Update documentation about dependency management, removing mention to
the deprecated ``dependency_links`` and adding some small improvements.
* 3367: Extracted text about automatic resource extraction and the zip-safe flag
from ``userguide/miscellaneous`` to ``deprecated/resource_extraction`` and
``deprecated/zip_safe``.

Extracted text about additional metadata files from
``userguide/miscellaneous`` into the existing ``userguide/extension``
document.

Updated ``userguide/extension`` to better reflect the status of the
setuptools project.

Removed ``userguide/functionalities_rewrite`` (a virtually empty part of the
docs).

=======


Documentation changes
---------------------
* 3349: Fixed two small issues preventing docs from building locally -- by :user:`codeandfire`
* 3350: Added note explaining ``package_data`` glob pattern matching for dotfiles -- by :user:`comabrewer`
* 3358: Clarify the role of the ``package_dir`` configuration.

Misc
----
* 3354: Improve clarity in warning about unlisted namespace packages.

=======


Documentation changes
---------------------
* 3331: Replaced single backticks with double ones in ``CHANGES.rst`` -- by :user:`codeandfire`
* 3332: Fixed grammar/typos, modified example directory trees for src-layout and flat-layout -- by :user:`codeandfire`
* 3335: Changes to code snippets and other examples in the Data Files page of the User Guide -- by :user:`codeandfire`

Misc
----
* 3336: Modified ``test_setup_install_includes_dependencies`` to work with custom ``PYTHONPATH`` –- by :user:`hroncok`

=======


Misc
----
* 3328: Include a first line summary to some of the existing multi-line warnings.

=======


Misc
----
* 3320: Fixed typo which causes ``namespace_packages`` to raise an error instead of
warning.