diff options
| author | Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua> | 2019-05-25 12:28:35 +0200 |
|---|---|---|
| committer | Sviatoslav Sydorenko <wk@sydorenko.org.ua> | 2020-01-14 12:09:13 +0100 |
| commit | 9e4e2e0e4d9ea3a0f26cc1dd05c975f4cc660f11 (patch) | |
| tree | fa951d3f8a16bc74832b7d2e11f6a1b82ace6bb5 /docs/setuptools.txt | |
| parent | 5399c8597bcb86a08db4b423f914c474cd125c31 (diff) | |
| download | external_python_setuptools-9e4e2e0e4d9ea3a0f26cc1dd05c975f4cc660f11.tar.gz external_python_setuptools-9e4e2e0e4d9ea3a0f26cc1dd05c975f4cc660f11.tar.bz2 external_python_setuptools-9e4e2e0e4d9ea3a0f26cc1dd05c975f4cc660f11.zip | |
Mark PEP mentions as :pep: SphinX refs
Diffstat (limited to 'docs/setuptools.txt')
| -rw-r--r-- | docs/setuptools.txt | 13 |
1 files changed, 7 insertions, 6 deletions
diff --git a/docs/setuptools.txt b/docs/setuptools.txt index 3a2028ce..e2a7bb1c 100644 --- a/docs/setuptools.txt +++ b/docs/setuptools.txt @@ -2200,22 +2200,23 @@ setup.cfg-only projects .. versionadded:: 40.9.0 -If ``setup.py`` is missing from the project directory when a PEP 517 +If ``setup.py`` is missing from the project directory when a :pep:`517` build is invoked, ``setuptools`` emulates a dummy ``setup.py`` file containing only a ``setuptools.setup()`` call. .. note:: - PEP 517 doesn't support editable installs so this is currently + :pep:`517` doesn't support editable installs so this is currently incompatible with ``pip install -e .``. This means that you can have a Python project with all build configuration specified in ``setup.cfg``, without a ``setup.py`` file, if you **can rely -on** your project always being built by a PEP 517/518 compatible frontend. +on** your project always being built by a :pep:`517`/:pep:`518` compatible +frontend. To use this feature: -* Specify build requirements and PEP 517 build backend in +* Specify build requirements and :pep:`517` build backend in ``pyproject.toml``. For example: @@ -2228,11 +2229,11 @@ To use this feature: ] build-backend = "setuptools.build_meta" -* Use a PEP 517 compatible build frontend, such as ``pip >= 19`` or ``pep517``. +* Use a :pep:`517` compatible build frontend, such as ``pip >= 19`` or ``pep517``. .. warning:: - As PEP 517 is new, support is not universal, and frontends that + As :pep:`517` is new, support is not universal, and frontends that do support it may still have bugs. For compatibility, you may want to put a ``setup.py`` file containing only a ``setuptools.setup()`` invocation. |