Update docs to ref sorting order of list/freeze

docs/reference/pip_freeze.rst

@@ -32,10 +32,11 @@ Examples
  ::
 
   $ pip freeze
-  Jinja2==2.6
-  Pygments==1.5
-  Sphinx==1.1.3
-  docutils==0.9.1
+  docutils==0.11
+  Jinja2==2.7.2
+  MarkupSafe==0.19
+  Pygments==1.6
+  Sphinx==1.2.2
 
 
 2) Generate a requirements file and then install from it in another environment.

docs/reference/pip_list.rst

@@ -31,15 +31,16 @@ Examples
  ::
 
   $ pip list
-  Pygments (1.5)
-  docutils (0.9.1)
-  Sphinx (1.1.2)
-  Jinja2 (2.6)
+  docutils (0.10)
+  Jinja2 (2.7.2)
+  MarkupSafe (0.18)
+  Pygments (1.6)
+  Sphinx (1.2.1)
 
 2) List outdated packages (excluding editables), and the latest version available
 
  ::
 
   $ pip list --outdated
-  docutils (Current: 0.9.1 Latest: 0.10)
-  Sphinx (Current: 1.1.2 Latest: 1.1.3)
+  docutils (Current: 0.10 Latest: 0.11)
+  Sphinx (Current: 1.2.1 Latest: 1.2.2)

docs/user_guide.rst

@@ -180,10 +180,10 @@ To list installed packages:
 ::
 
   $ pip list
-  Pygments (1.5)
   docutils (0.9.1)
-  Sphinx (1.1.2)
   Jinja2 (2.6)
+  Pygments (1.5)
+  Sphinx (1.1.2)
 
 To list outdated packages, and show the latest version available:
 

pip/commands/freeze.py

@@ -13,7 +13,11 @@ freeze_excludes = stdlib_pkgs + ['setuptools', 'pip', 'distribute']
 
 
 class FreezeCommand(Command):
-    """Output installed packages in requirements format."""
+    """
+    Output installed packages in requirements format.
+
+    packages are listed in a case-insensitive sorted order.
+    """
     name = 'freeze'
     usage = """
       %prog [options]"""

pip/commands/list.py

@@ -8,7 +8,11 @@ from pip.cmdoptions import make_option_group, index_group
 
 
 class ListCommand(Command):
-    """List installed packages, including editables."""
+    """
+    List installed packages, including editables.
+
+    Packages are listed in a case-insensitive sorted order.
+    """
     name = 'list'
     usage = """
       %prog [options]"""