Merge branch 'yd/doc-merge-annotated-tag'
authorJunio C Hamano <gitster@pobox.com>
Thu, 28 Mar 2013 21:38:17 +0000 (14:38 -0700)
committerJunio C Hamano <gitster@pobox.com>
Thu, 28 Mar 2013 21:38:17 +0000 (14:38 -0700)
Document the 1.7.9 feature to merge a signed tag and keep that in
the mergetag header in the resulting commit better.

* yd/doc-merge-annotated-tag:
Documentation: merging a tag is a special case

1  2 
Documentation/git-merge.txt
index c852a2677ab9e32801b0dc6ed8bc85b03982233d,7780863398435a91ef69095b47b8310d0ac64cf9..42391f2ae76aa579605470b6cad8cf4812f29aae
@@@ -170,6 -170,30 +170,30 @@@ happens
  If you tried a merge which resulted in complex conflicts and
  want to start over, you can recover with `git merge --abort`.
  
+ MERGING TAG
+ -----------
+ When merging an annotated (and possibly signed) tag, Git always
+ creates a merge commit even if a fast-forward merge is possible, and
+ the commit message template is prepared with the tag message.
+ Additionally, if the tag is signed, the signature check is reported
+ as a comment in the message template. See also linkgit:git-tag[1].
+ When you want to just integrate with the work leading to the commit
+ that happens to be tagged, e.g. synchronizing with an upstream
+ release point, you may not want to make an unnecessary merge commit.
+ In such a case, you can "unwrap" the tag yourself before feeding it
+ to `git merge`, or pass `--ff-only` when you do not have any work on
+ your own. e.g.
+ ---
+ git fetch origin
+ git merge v1.2.3^0
+ git merge --ff-only v1.2.3
+ ---
  HOW CONFLICTS ARE PRESENTED
  ---------------------------
  
@@@ -178,10 -202,10 +202,10 @@@ of the merge.  Among the changes made t
  non-overlapping ones (that is, you changed an area of the file while the
  other side left that area intact, or vice versa) are incorporated in the
  final result verbatim.  When both sides made changes to the same area,
 -however, git cannot randomly pick one side over the other, and asks you to
 +however, Git cannot randomly pick one side over the other, and asks you to
  resolve it by leaving what both sides did to that area.
  
 -By default, git uses the same style as the one used by the "merge" program
 +By default, Git uses the same style as the one used by the "merge" program
  from the RCS suite to present such a conflicted hunk, like this:
  
  ------------