diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/index.rst | 11 | ||||
| -rw-r--r-- | docs/story.rst | 25 |
2 files changed, 10 insertions, 26 deletions
diff --git a/docs/index.rst b/docs/index.rst index 23c0481..b00e5b6 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -16,10 +16,9 @@ packages will be properly installed with only the “Unpack” step preserves enough information to “Spread” (copy data and scripts to their final locations) at any later time. -The wheel project provides a `bdist_wheel` command -for setuptools (requiring a patched distribute from -https://bitbucket.org/dholth/distribute). Wheel files can be installed -with a patched `pip` from https://github.com/dholth/pip. +The wheel project provides a `bdist_wheel` command for setuptools +(requires distribute >= 0.6.28). Wheel files can be installed with a +patched `pip` from https://github.com/dholth/pip. Why not egg? ------------ @@ -60,8 +59,8 @@ wheeldemo.sh:: virtualenv --distribute /tmp/wheeldemo cd /tmp/wheeldemo - # Install wheel and patched pip, distribute - bin/pip install --upgrade --ignore-installed --no-index hg+https://bitbucket.org/dholth/distribute#egg=distribute \ + # Install wheel and patched pip + bin/pip install --upgrade --ignore-installed \ git+https://github.com/dholth/pip.git#egg=pip bin/pip install hg+https://bitbucket.org/dholth/wheel#egg=wheel diff --git a/docs/story.rst b/docs/story.rst index d1a0a96..2c150c2 100644 --- a/docs/story.rst +++ b/docs/story.rst @@ -49,29 +49,14 @@ archive.whl” somewhere on sys.path. If you’ve made it this far you probably wonder whether I’ve heard of eggs. Some comparisons: -* Wheel is an installation format; egg is importable. Wheel archives do -not need to include .pyc and are less tied to a specific Python version -or implementation. Wheel can install (pure Python) packages built with -previous versions of Python so you don’t always have to wait for the -packager to catch up. +* Wheel is an installation format; egg is importable. Wheel archives do not need to include .pyc and are less tied to a specific Python version or implementation. Wheel can install (pure Python) packages built with previous versions of Python so you don’t always have to wait for the packager to catch up. -* Wheel uses .dist-info directories; egg uses .egg-info. Wheel is -compatible with the new world of Python `packaging` and the new concepts -it brings. +* Wheel uses .dist-info directories; egg uses .egg-info. Wheel is compatible with the new world of Python `packaging` and the new concepts it brings. -* Wheel has a richer file naming convention for today’s -multi-implementation world. A single wheel archive can indicate -its compatibility with a number of Python language versions and -implementations, ABIs, and system architectures. Historically the ABI has -been specific to a CPython release, but when we get a longer-term ABI, -wheel will be ready. +* Wheel has a richer file naming convention for today’s multi-implementation world. A single wheel archive can indicate its compatibility with a number of Python language versions and implementations, ABIs, and system architectures. Historically the ABI has been specific to a CPython release, but when we get a longer-term ABI, wheel will be ready. -* Wheel is lossless. The first wheel implementation `bdist_wheel` always -generates `egg-info`, and then converts it to a `.whl`. Later tools will -allow for the conversion of existing eggs and bdist_wininst distributions. +* Wheel is lossless. The first wheel implementation `bdist_wheel` always generates `egg-info`, and then converts it to a `.whl`. Later tools will allow for the conversion of existing eggs and bdist_wininst distributions. -* Wheel is versioned. Every wheel file contains the version of the wheel -specification and the implementation that packaged it. Hopefully the -next migration can simply be to Wheel 2.0. +* Wheel is versioned. Every wheel file contains the version of the wheel specification and the implementation that packaged it. Hopefully the next migration can simply be to Wheel 2.0. I hope you will benefit from wheel. |