Merge branch 'master' of git://git.kernel.org/pub/scm/gitk/gitk

[git.git] / Documentation / git-merge.txt
diff --git a/Documentation/git-merge.txt b/Documentation/git-merge.txt

index eae49c4876caf6b2e6a8bd9770b3981fb8133edd..ed3a92404b425e66caa9213e67c27f559af172e2 100644 (file)
--- a/Documentation/git-merge.txt
+++ b/Documentation/git-merge.txt
@@ -11,26 +11,27 @@ SYNOPSIS
  [verse]
  'git-merge' [-n] [--summary] [--no-commit] [--squash] [-s <strategy>]...
         [-m <msg>] <remote> <remote>...
+'git-merge' <msg> HEAD <remote>...
  
  DESCRIPTION
  -----------
  This is the top-level interface to the merge machinery
  which drives multiple merge strategy scripts.
  
+The second syntax (<msg> `HEAD` <remote>) is supported for
+historical reasons.  Do not use it from the command line or in
+new scripts.  It is the same as `git merge -m <msg> <remote>`.
+
  
  OPTIONS
  -------
  include::merge-options.txt[]
  
-<msg>::
+-m <msg>::
         The commit message to be used for the merge commit (in case
         it is created). The `git-fmt-merge-msg` script can be used
         to give a good default for automated `git-merge` invocations.
  
-<head>::
-       Our branch head commit.  This has to be `HEAD`, so new
-       syntax does not require it
-
  <remote>::
         Other branch head merged into our branch.  You need at
         least one <remote>.  Specifying more than one <remote>
@@ -41,7 +42,7 @@ include::merge-strategies.txt[]
  
  If you tried a merge which resulted in a complex conflicts and
  would want to start over, you can recover with
-gitlink:git-reset[1].
+linkgit:git-reset[1].
  
  CONFIGURATION
  -------------
@@ -58,6 +59,10 @@ merge.verbosity::
         above outputs debugging information.  The default is level 2.
         Can be overridden by 'GIT_MERGE_VERBOSITY' environment variable.
  
+branch.<name>.mergeoptions::
+       Sets default options for merging into branch <name>. The syntax and
+       supported options are equal to that of git-merge, but option values
+       containing whitespace characters are currently not supported.
  
  HOW MERGE WORKS
  ---------------
@@ -158,7 +163,8 @@ After seeing a conflict, you can do two things:
  
  SEE ALSO
  --------
-gitlink:git-fmt-merge-msg[1], gitlink:git-pull[1]
+linkgit:git-fmt-merge-msg[1], linkgit:git-pull[1],
+linkgit:gitattributes[5]
  
  
  Author
@@ -172,4 +178,4 @@ Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
  
  GIT
  ---
-Part of the gitlink:git[7] suite
+Part of the linkgit:git[7] suite