| Commit message (Collapse) | Author | Age | Files | Lines |
|---|
| | |
|
| | |
|
| |
|
|
| |
that's all :)
|
| | |
|
| |
|
|
| |
Also add a not about modern ways of generating ``sdists`` and ``wheel``.
|
| | |
|
| |\ \ \
| | | |
| | | |
| | | |
| | | |
| | | | |
- Improve docs by avoiding confusion with distutils
- Update dependency management docs
- Update userguide on miscellaneous and extension
|
| | | | | |
|
| | |_|/
|/| |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | |
| | | |
This is a continuation of the update effort to de-emphasize `distutils`
and make the documentation more consistent.
The main targets of the changes are the files
`docs/userguide/miscellaneous` and `docs/userguide/extension`.
Changes:
- Extracted text about automatic resource extraction and the zip-safe flag
from `userguide/miscellaneous` to `deprecated/resource_extraction` and
`deprecated/zip_safe`.
- These configuration parameters are commonly associated with
``eggs``/``easy_install``/``pkg_resources``, and therefore are
obsolete. Leaving them around in the main parts of the documentation
just confuses users.
- The text in the new files were updated.
- Extracted text about additional metadata from
`userguide/miscellaneous` into the existing `userguide/extension`
document.
- Updated `userguide/extension` to better reflect the status of the
setuptools project.
The text was also changed to explain a little bit more what is the
relationship between ``setuptools`` and ``distutils``.
- Removed `userguide/functionalities_rewrite`.
This file was virtually empty and not bringing any extra value to the
docs.
|
| | |/
|/|
| |
| |
| |
| |
| |
| |
| |
| | |
- Extract `depencency_liks` section to a new file:
`deprecated/dependency_links.rst`
- Add note about directly URLs not being accepted in PyPI.
- Simplify intro about build system requirement.
- Simplify intro about optional dependencies.
- Fix confusion in example about "Project" and "Package".
- "Demote" section about extras in entry-points to a note.
|
| | | |
|
| |/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
The existing docs seem to assume that the user is familiar with the
history of packaging in the Python ecosystem (or at least know what is
`distutils`).
Since that is not always the case and that `distutils` is in the process
of being adopted by `setuptools`, the documentation should be changed
to minimize mentions to `distutils` and avoid expecting too much
knowledge from the users.
The benefit of this approach is that it can make the docs more
accessible and easier to understand.
Changes:
- Modify landing page to clarify what `setuptools` does (making it more
clear to understand for beginners).
- Remove mentions to `distutils`, `transition to PEP 517` from
`userguide/index`.
- Instead the text is changed to have a more "introductory" tone.
- Remove mentions to `distutils` from the Quickstart.
- Remove `python2` from the intersphinx mapping - it was causing trouble
redirecting glossary terms to Python2 docs, instead of Python3.
- Modify documentation about development mode to be more aligned with
current practices (i.e. using `pip install -e .`)
- In this process all documentation about running `setuptools` commands
in `distutils` projects was moved to a new file in `docs/deprecated/running_commands.rst`
|
| |\ |
|
| | | |
|
| | | |
|
| |/ |
|
| | |
|
| | |
|
| | |
|
| | |
|
| | |
|
| | |
|
| | |
|
| | |
|
| | |
|
| | |
|
| | |
|
| |\ |
|
| | | |
|
| | | |
|
| |/
|
|
| |
This is included in the sidebar, as part of Furo.
|
| | |
|
| | |
|
| | |
|
| |
|
|
| |
egg-secutable section moved from userguide/functionalities to deprecated/functionalities
|
| | |
|
| | |
|
| | |
|
| |
|
