tip: deprecate the tip command

mercurial/commands.py

@@ -5692,7 +5692,7 b' def tags(ui, repo, **opts):'
     ] + templateopts,
     _('[-p] [-g]'))
 def tip(ui, repo, **opts):
-    """show the tip revision
+    """show the tip revision (DEPRECATED)
 
     The tip revision (usually just called the tip) is the changeset
     most recently added to the repository (and therefore the most
@@ -5703,6 +5703,8 b' def tip(ui, repo, **opts):'
     that repository becomes the current tip. The "tip" tag is special
     and cannot be renamed or assigned to a different changeset.
 
+    This command is deprecated, please use :hg:`heads` instead.
+
     Returns 0 on success.
     """
     displayer = cmdutil.show_changeset(ui, repo, opts)

tests/test-globalopts.t

@@ -332,7 +332,6 b' Testing -h/--help:'
    summary       summarize working directory state
    tag           add one or more tags for the current or given revision
    tags          list repository tags
-   tip           show the tip revision
    unbundle      apply one or more changegroup files
    update        update working directory (or switch revisions)
    verify        verify the integrity of the repository
@@ -416,7 +415,6 b' Testing -h/--help:'
    summary       summarize working directory state
    tag           add one or more tags for the current or given revision
    tags          list repository tags
-   tip           show the tip revision
    unbundle      apply one or more changegroup files
    update        update working directory (or switch revisions)
    verify        verify the integrity of the repository

tests/test-help.t

@@ -97,7 +97,6 b' Short help:'
    summary       summarize working directory state
    tag           add one or more tags for the current or given revision
    tags          list repository tags
-   tip           show the tip revision
    unbundle      apply one or more changegroup files
    update        update working directory (or switch revisions)
    verify        verify the integrity of the repository
@@ -175,7 +174,6 b' Short help:'
    summary       summarize working directory state
    tag           add one or more tags for the current or given revision
    tags          list repository tags
-   tip           show the tip revision
    unbundle      apply one or more changegroup files
    update        update working directory (or switch revisions)
    verify        verify the integrity of the repository
@@ -662,7 +660,6 b' Test that default list of commands omits'
    summary       summarize working directory state
    tag           add one or more tags for the current or given revision
    tags          list repository tags
-   tip           show the tip revision
    unbundle      apply one or more changegroup files
    update        update working directory (or switch revisions)
    verify        verify the integrity of the repository
@@ -1425,13 +1422,6 b' Dish up an empty repo; serve it cold.'
   list repository tags
   </td></tr>
   <tr><td>
-  <a href="/help/tip">
-  tip
-  </a>
-  </td><td>
-  show the tip revision
-  </td></tr>
-  <tr><td>
   <a href="/help/unbundle">
   unbundle
   </a>