* As a means to make things easier for new users, quote everything in
a `pip install` command that is part of a package that isn't just
a bare package name.
* Use single quotes for Linux/Mac and use double quotes for Windows
to follow existing style conventions.
* Shells like zsh have glob qualifiers that will error if an extra
is not quoted. While the glob qualifiers can be disabled, adding
quotes guards against errors if people are copy-pasting or do not
know that they can disable the behavior.
* Use single quotes for Linux/Mac and use double quotes for Windows
to follow existing style conventions.
This makes further progress on moving content into dedeicated topic
pages, away from dumping it into `pip install`'s documentation or
as a part of the user guide.
This should make this information more discoverable, while also
providing clearer guidance on what the difference between a "regular"
install vs an "editable" install is.
Update documentation to state that using command line options on any
requirements will disable all usage of wheels. Since this is unexpected
behavior, move text to a warning.
This reworks a substantial portion of our existing build system related
documentation, putting it all in a single location.
There are certain areas that have been rephrased or rewritten:
- The setup.py interface is now considered an implementation detail.
- The setup.py interface is explicitly noted as a legacy interface, due
for removal.
- The pyproject.toml interface now has clearer documentation on how it
is used and how it operates.
- Clearer separation of `--use-pep-517` and `--no-build-isolation`, to
make the difference between the two clearer.