Update docs/changes/authors for pip show

AUTHORS.txt

@@ -47,6 +47,7 @@ Clark Boylan <clark.boylan@gmail.com>
 Clay McClure <clay@daemons.net>
 Cody Soyland <codysoyland@gmail.com>
 Colin Watson <cjwatson@debian.org>
+Connor Osborn <cdosborn@email.arizona.edu>
 Cory Benfield <lukasaoz@gmail.com>
 Cory Wright <corywright@gmail.com>
 Craig Kerstiens <craig.kerstiens@gmail.com>

CHANGES.txt

@@ -1,5 +1,7 @@
 **8.2.0 (unreleased)**
 
+* Pip show is less verbose by default. `--verbose` prints multiline fields
+
 * Added optional column formatting to ``pip list`` (:issue:`3651`).
 
 * Fix the build on systems with symlinked /tmp directory for custom

docs/reference/pip_show.rst

@@ -5,11 +5,13 @@ pip show
 
 .. contents::
 
+
 Usage
 *****
 
 .. pip-command-usage:: show
 
+
 Description
 ***********
 
@@ -30,8 +32,55 @@ Examples
     ::
 
       $ pip show sphinx
-      ---
       Name: Sphinx
-      Version: 1.1.3
-      Location: /my/env/lib/pythonx.x/site-packages
-      Requires: Pygments, Jinja2, docutils
+      Version: 1.4.5
+      Summary: Python documentation generator
+      Home-page: http://sphinx-doc.org/
+      Author: Georg Brandl
+      Author-email: georg@python.org
+      License: BSD
+      Location: /my/env/lib/python2.7/site-packages
+      Requires: docutils, snowballstemmer, alabaster, Pygments, imagesize, Jinja2, babel, six
+
+#. Show all information about a package
+
+    ::
+
+      $ pip show --verbose sphinx
+      Name: Sphinx
+      Version: 1.4.5
+      Summary: Python documentation generator
+      Home-page: http://sphinx-doc.org/
+      Author: Georg Brandl
+      Author-email: georg@python.org
+      License: BSD
+      Location: /my/env/lib/python2.7/site-packages
+      Requires: docutils, snowballstemmer, alabaster, Pygments, imagesize, Jinja2, babel, six
+      Metadata-Version: 2.0
+      Installer:
+      Classifiers:
+        Development Status :: 5 - Production/Stable
+        Environment :: Console
+        Environment :: Web Environment
+        Intended Audience :: Developers
+        Intended Audience :: Education
+        License :: OSI Approved :: BSD License
+        Operating System :: OS Independent
+        Programming Language :: Python
+        Programming Language :: Python :: 2
+        Programming Language :: Python :: 3
+        Framework :: Sphinx
+        Framework :: Sphinx :: Extension
+        Framework :: Sphinx :: Theme
+        Topic :: Documentation
+        Topic :: Documentation :: Sphinx
+        Topic :: Text Processing
+        Topic :: Utilities
+      Entry-points:
+        [console_scripts]
+        sphinx-apidoc = sphinx.apidoc:main
+        sphinx-autogen = sphinx.ext.autosummary.generate:main
+        sphinx-build = sphinx:main
+        sphinx-quickstart = sphinx.quickstart:main
+        [distutils.commands]
+        build_sphinx = sphinx.setup_command:BuildDoc