[PATCH STABLE] tag: add detail description about that local tag may hide global one

FUJIWARA Katsunori foozy at lares.dti.ne.jp
Fri Apr 26 10:32:48 CDT 2013


# HG changeset patch
# User FUJIWARA Katsunori <foozy at lares.dti.ne.jp>
# Date 1366988052 -32400
#      Fri Apr 26 23:54:12 2013 +0900
# Branch stable
# Node ID 1f68ea7d2f395fe35452d633d23ed72247865e35
# Parent  be207d9b7e4bc222f4ba72ad9a266df83d939ca4
tag: add detail description about that local tag may hide global one

In this patch, use "regular" instead of "global", because original
help document of "hg tags" uses the former, even though "global" is
usually used in source code.

diff --git a/mercurial/commands.py b/mercurial/commands.py
--- a/mercurial/commands.py
+++ b/mercurial/commands.py
@@ -5538,6 +5538,11 @@
     ".hg/localtags" is used for local tags (not shared among
     repositories).
 
+    .. container:: verbose
+
+      In many cases, local tag has higher priority than regular one.
+      See :hg:`help tags` with --verbose for details.
+
     Tag commits are usually made at the head of a branch. If the parent
     of the working directory is not a branch head, :hg:`tag` aborts; use
     -f/--force to force the tag commit to be based on a non-head
@@ -5624,6 +5629,20 @@
     This lists both regular and local tags. When the -v/--verbose
     switch is used, a third column "local" is printed for local tags.
 
+    .. container:: verbose
+
+      In many cases, local tag has higher priority than regular one.
+
+      For example, existing local tag may be kept visible, even after
+      successful creation of the regular one overwriting it.
+
+      Or, Local tag removal, which is achieved by re-tagging with null id,
+      may hide same name regular tag in the future.
+
+      Please check ".hg/localtags" and edit it manually, if certain regular
+      tag is not visible or hidden by existing local one in the output
+      of this command.
+
     Returns 0 on success.
     """
 


More information about the Mercurial-devel mailing list