It would be helpful if the arguments to pip commands had explanations in the usage notes. Specifically, PACKAGE_NAMES could use just a little documentation of what is acceptable and possible. For example, I wasn't aware that a PACKAGE_NAME could contain a version specification until discovering this information from a third-party site http://guide.python-distribute.org/pip.html#installing-specific-versions. It would be convenient and helpful to have that information bundled in the usage help string.