commands: deprecate the parents commands

It's replaced by 'hg summary' or hg log -r 'parents(foo)' and
doesn't need to take up space in our command list anymore.

mercurial/commands.py

@@ -4607,7 +4607,7 b' def outgoing(ui, repo, dest=None, **opts'
     _('[-r REV] [FILE]'),
     inferrepo=True)
 def parents(ui, repo, file_=None, **opts):
-    """show the parents of the working directory or revision
+    """show the parents of the working directory or revision (DEPRECATED)
 
     Print the working directory's parent revisions. If a revision is
     given via -r/--rev, the parent of that revision will be printed.
@@ -4615,6 +4615,8 b' def parents(ui, repo, file_=None, **opts'
     last changed (before the working directory revision or the
     argument to --rev if given) is printed.
 
+    See :hg:`summary` and :hg:`help revsets` for related information.
+
     Returns 0 on success.
     """
 

tests/test-globalopts.t

@@ -315,7 +315,6 b' Testing -h/--help:'
    manifest      output the current or given revision of the project manifest
    merge         merge working directory with another revision
    outgoing      show changesets not found in the destination
-   parents       show the parents of the working directory or revision
    paths         show aliases for remote repositories
    phase         set or show the current phase name
    pull          pull changes from the specified source
@@ -397,7 +396,6 b' Testing -h/--help:'
    manifest      output the current or given revision of the project manifest
    merge         merge working directory with another revision
    outgoing      show changesets not found in the destination
-   parents       show the parents of the working directory or revision
    paths         show aliases for remote repositories
    phase         set or show the current phase name
    pull          pull changes from the specified source

tests/test-help.t

@@ -80,7 +80,6 b' Short help:'
    manifest      output the current or given revision of the project manifest
    merge         merge working directory with another revision
    outgoing      show changesets not found in the destination
-   parents       show the parents of the working directory or revision
    paths         show aliases for remote repositories
    phase         set or show the current phase name
    pull          pull changes from the specified source
@@ -156,7 +155,6 b' Short help:'
    manifest      output the current or given revision of the project manifest
    merge         merge working directory with another revision
    outgoing      show changesets not found in the destination
-   parents       show the parents of the working directory or revision
    paths         show aliases for remote repositories
    phase         set or show the current phase name
    pull          pull changes from the specified source
@@ -698,7 +696,6 b' Test that default list of commands omits'
    manifest      output the current or given revision of the project manifest
    merge         merge working directory with another revision
    outgoing      show changesets not found in the destination
-   parents       show the parents of the working directory or revision
    paths         show aliases for remote repositories
    phase         set or show the current phase name
    pull          pull changes from the specified source
@@ -1521,13 +1518,6 b' Dish up an empty repo; serve it cold.'
   show changesets not found in the destination
   </td></tr>
   <tr><td>
-  <a href="/help/parents">
-  parents
-  </a>
-  </td><td>
-  show the parents of the working directory or revision
-  </td></tr>
-  <tr><td>
   <a href="/help/paths">
   paths
   </a>