# HG changeset patch
# User Matt Mackall <mpm@selenic.com>
# Date 2013-07-12 00:29:23
# Node ID 9013f2930a4ac5974f1bc1f35b862dc95a9f02b1
# Parent  c7a7bae3cfa3cad16fa51ce84f64e8b2ed337283

tip: deprecate the tip command

diff --git a/mercurial/commands.py b/mercurial/commands.py
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -5692,7 +5692,7 @@ 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 @@ 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)
diff --git a/tests/test-globalopts.t b/tests/test-globalopts.t
--- a/tests/test-globalopts.t
+++ b/tests/test-globalopts.t
@@ -332,7 +332,6 @@ 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 @@ 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
diff --git a/tests/test-help.t b/tests/test-help.t
--- a/tests/test-help.t
+++ b/tests/test-help.t
@@ -97,7 +97,6 @@ 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 @@ 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 @@ 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 @@ 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>