pack-objects: use reachability bitmap index when generating non-stdout pack
[gitweb.git] / Documentation / merge-options.txt
index e1343155fad7b2709d2f3700ea3d5b4c4d1a7a89..5b4a62e93624bc8289c835631aab5d5f13dff708 100644 (file)
@@ -63,14 +63,13 @@ merge.
 
 --squash::
 --no-squash::
-       Produce the working tree and index state as if a real
-       merge happened (except for the merge information),
-       but do not actually make a commit or
-       move the `HEAD`, nor record `$GIT_DIR/MERGE_HEAD` to
-       cause the next `git commit` command to create a merge
-       commit.  This allows you to create a single commit on
-       top of the current branch whose effect is the same as
-       merging another branch (or more in case of an octopus).
+       Produce the working tree and index state as if a real merge
+       happened (except for the merge information), but do not actually
+       make a commit, move the `HEAD`, or record `$GIT_DIR/MERGE_HEAD`
+       (to cause the next `git commit` command to create a merge
+       commit).  This allows you to create a single commit on top of
+       the current branch whose effect is the same as merging another
+       branch (or more in case of an octopus).
 +
 With --no-squash perform the merge and commit the result. This
 option can be used to override --squash.
@@ -90,8 +89,11 @@ option can be used to override --squash.
 
 --verify-signatures::
 --no-verify-signatures::
-       Verify that the commits being merged have good and trusted GPG signatures
-       and abort the merge in case they do not.
+       Verify that the tip commit of the side branch being merged is
+       signed with a valid key, i.e. a key that has a valid uid: in the
+       default trust model, this means the signing key has been signed by
+       a trusted key.  If the tip commit of the side branch is not signed
+       with a valid key, the merge is aborted.
 
 --summary::
 --no-summary::
@@ -115,3 +117,11 @@ ifndef::git-pull[]
        reporting.
 
 endif::git-pull[]
+
+--allow-unrelated-histories::
+       By default, `git merge` command refuses to merge histories
+       that do not share a common ancestor.  This option can be
+       used to override this safety when merging histories of two
+       projects that started their lives independently. As that is
+       a very rare occasion, no configuration variable to enable
+       this by default exists and will not be added.