Documentation / merge-options.txton commit pull: pass --signoff/--no-signoff to "git merge" (3a4d2c7)
   1--commit::
   2--no-commit::
   3        Perform the merge and commit the result. This option can
   4        be used to override --no-commit.
   5+
   6With --no-commit perform the merge but pretend the merge
   7failed and do not autocommit, to give the user a chance to
   8inspect and further tweak the merge result before committing.
   9
  10--edit::
  11-e::
  12--no-edit::
  13        Invoke an editor before committing successful mechanical merge to
  14        further edit the auto-generated merge message, so that the user
  15        can explain and justify the merge. The `--no-edit` option can be
  16        used to accept the auto-generated message (this is generally
  17        discouraged).
  18ifndef::git-pull[]
  19The `--edit` (or `-e`) option is still useful if you are
  20giving a draft message with the `-m` option from the command line
  21and want to edit it in the editor.
  22endif::git-pull[]
  23+
  24Older scripts may depend on the historical behaviour of not allowing the
  25user to edit the merge log message. They will see an editor opened when
  26they run `git merge`. To make it easier to adjust such scripts to the
  27updated behaviour, the environment variable `GIT_MERGE_AUTOEDIT` can be
  28set to `no` at the beginning of them.
  29
  30--ff::
  31        When the merge resolves as a fast-forward, only update the branch
  32        pointer, without creating a merge commit.  This is the default
  33        behavior.
  34
  35--no-ff::
  36        Create a merge commit even when the merge resolves as a
  37        fast-forward.  This is the default behaviour when merging an
  38        annotated (and possibly signed) tag.
  39
  40--ff-only::
  41        Refuse to merge and exit with a non-zero status unless the
  42        current `HEAD` is already up to date or the merge can be
  43        resolved as a fast-forward.
  44
  45--log[=<n>]::
  46--no-log::
  47        In addition to branch names, populate the log message with
  48        one-line descriptions from at most <n> actual commits that are being
  49        merged. See also linkgit:git-fmt-merge-msg[1].
  50+
  51With --no-log do not list one-line descriptions from the
  52actual commits being merged.
  53
  54--signoff::
  55--no-signoff::
  56        Add Signed-off-by line by the committer at the end of the commit
  57        log message.  The meaning of a signoff depends on the project,
  58        but it typically certifies that committer has
  59        the rights to submit this work under the same license and
  60        agrees to a Developer Certificate of Origin
  61        (see http://developercertificate.org/ for more information).
  62+
  63With --no-signoff do not add a Signed-off-by line.
  64
  65--stat::
  66-n::
  67--no-stat::
  68        Show a diffstat at the end of the merge. The diffstat is also
  69        controlled by the configuration option merge.stat.
  70+
  71With -n or --no-stat do not show a diffstat at the end of the
  72merge.
  73
  74--squash::
  75--no-squash::
  76        Produce the working tree and index state as if a real merge
  77        happened (except for the merge information), but do not actually
  78        make a commit, move the `HEAD`, or record `$GIT_DIR/MERGE_HEAD`
  79        (to cause the next `git commit` command to create a merge
  80        commit).  This allows you to create a single commit on top of
  81        the current branch whose effect is the same as merging another
  82        branch (or more in case of an octopus).
  83+
  84With --no-squash perform the merge and commit the result. This
  85option can be used to override --squash.
  86
  87-s <strategy>::
  88--strategy=<strategy>::
  89        Use the given merge strategy; can be supplied more than
  90        once to specify them in the order they should be tried.
  91        If there is no `-s` option, a built-in list of strategies
  92        is used instead ('git merge-recursive' when merging a single
  93        head, 'git merge-octopus' otherwise).
  94
  95-X <option>::
  96--strategy-option=<option>::
  97        Pass merge strategy specific option through to the merge
  98        strategy.
  99
 100--verify-signatures::
 101--no-verify-signatures::
 102        Verify that the tip commit of the side branch being merged is
 103        signed with a valid key, i.e. a key that has a valid uid: in the
 104        default trust model, this means the signing key has been signed by
 105        a trusted key.  If the tip commit of the side branch is not signed
 106        with a valid key, the merge is aborted.
 107
 108--summary::
 109--no-summary::
 110        Synonyms to --stat and --no-stat; these are deprecated and will be
 111        removed in the future.
 112
 113ifndef::git-pull[]
 114-q::
 115--quiet::
 116        Operate quietly. Implies --no-progress.
 117
 118-v::
 119--verbose::
 120        Be verbose.
 121
 122--progress::
 123--no-progress::
 124        Turn progress on/off explicitly. If neither is specified,
 125        progress is shown if standard error is connected to a terminal.
 126        Note that not all merge strategies may support progress
 127        reporting.
 128
 129endif::git-pull[]
 130
 131--allow-unrelated-histories::
 132        By default, `git merge` command refuses to merge histories
 133        that do not share a common ancestor.  This option can be
 134        used to override this safety when merging histories of two
 135        projects that started their lives independently. As that is
 136        a very rare occasion, no configuration variable to enable
 137        this by default exists and will not be added.