# HG changeset patch
# User Matt Mackall <mpm@selenic.com>
# Date 1373588963 18000
# Node ID 9013f2930a4ac5974f1bc1f35b862dc95a9f02b1
# Parent  c7a7bae3cfa3cad16fa51ce84f64e8b2ed337283
tip: deprecate the tip command

diff -r c7a7bae3cfa3 -r 9013f2930a4a mercurial/commands.py
--- a/mercurial/commands.py	Thu Jul 11 19:28:54 2013 -0500
+++ b/mercurial/commands.py	Thu Jul 11 19:29:23 2013 -0500
@@ -5692,7 +5692,7 @@
     ] + 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 @@
     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 -r c7a7bae3cfa3 -r 9013f2930a4a tests/test-globalopts.t
--- a/tests/test-globalopts.t	Thu Jul 11 19:28:54 2013 -0500
+++ b/tests/test-globalopts.t	Thu Jul 11 19:29:23 2013 -0500
@@ -332,7 +332,6 @@
    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 @@
    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 -r c7a7bae3cfa3 -r 9013f2930a4a tests/test-help.t
--- a/tests/test-help.t	Thu Jul 11 19:28:54 2013 -0500
+++ b/tests/test-help.t	Thu Jul 11 19:29:23 2013 -0500
@@ -97,7 +97,6 @@
    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 @@
    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 @@
    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 @@
   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>