diff options
| author | Anderson Bravalheri <andersonbravalheri@gmail.com> | 2022-06-14 18:46:59 +0100 |
|---|---|---|
| committer | Anderson Bravalheri <andersonbravalheri@gmail.com> | 2022-06-14 21:36:38 +0100 |
| commit | 6690c1ce74b9761608e6e5d395c93e25180721eb (patch) | |
| tree | c9ee512e6a2a66e6e46e9808d76139644fcfff71 /docs | |
| parent | ec2d4e92cf66805b48a8868b00102555f7f46c8e (diff) | |
| download | python-setuptools-git-6690c1ce74b9761608e6e5d395c93e25180721eb.tar.gz | |
Add warning about calling setup.py directly
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/userguide/distribution.rst | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/userguide/distribution.rst b/docs/userguide/distribution.rst index 543e6296..a3c4245e 100644 --- a/docs/userguide/distribution.rst +++ b/docs/userguide/distribution.rst @@ -1,6 +1,19 @@ Tagging and "Daily Build" or "Snapshot" Releases ------------------------------------------------ +.. warning:: + Please note that running ``python setup.py ...`` directly is no longer + considered a good practice and that in the future the commands ``egg_info`` + and ``rotate`` will be deprecated. + + As a result, the instructions and information presented in this section + should be considered **transitional** while setuptools don't provide a + mechanism for tagging releases. + + Meanwhile, if you can also consider using :pypi:`setuptools-scm` to achieve + similar objectives. + + When a set of related projects are under development, it may be important to track finer-grained version increments than you would normally use for e.g. "stable" releases. While stable releases might be measured in dotted numbers |