Merge pull request #7124 from gpiks/document_wheel_no_binary

Clarify `--no-binary` when enumerating packages and add an example
pypa · Oct 1, 2019 · e3f9a72 · e3f9a72
2 parents 7dc7b81 + f006a7b
commit e3f9a72
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 3 deletions.
diff --git a/docs/html/reference/pip_wheel.rst b/docs/html/reference/pip_wheel.rst
@@ -71,3 +71,9 @@ Examples
 
  $ pip wheel --wheel-dir=/tmp/wheelhouse SomePackage
  $ pip install --no-index --find-links=/tmp/wheelhouse SomePackage
+
+#. Build a wheel for a package from source
+
+ ::
+
+ $ pip wheel --no-binary SomePackage SomePackage
diff --git a/src/pip/_internal/cli/cmdoptions.py b/src/pip/_internal/cli/cmdoptions.py
@@ -454,9 +454,9 @@ def no_binary():
  help="Do not use binary packages. Can be supplied multiple times, and "
  "each time adds to the existing value. Accepts either :all: to "
  "disable all binary packages, :none: to empty the set, or one or "
- "more package names with commas between them. Note that some "
- "packages are tricky to compile and may fail to install when "
- "this option is used on them.",
+ "more package names with commas between them (no colons). Note "
+ "that some packages are tricky to compile and may fail to "
+ "install when this option is used on them.",
  )