X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=Documentation%2Fgit-read-tree.txt;h=e1be6cc0bcfded709bbd57a3ccd73e5ed241dd18;hb=06ec2b4bb4ab9096d1304ba5a2ec388078dcdf7f;hp=7665946f805c71ef38b1ed616108d189dbc2c1cf;hpb=89ab859e9452cbc8f1f15afab52257e9b789c899;p=git.git diff --git a/Documentation/git-read-tree.txt b/Documentation/git-read-tree.txt index 7665946f..e1be6cc0 100644 --- a/Documentation/git-read-tree.txt +++ b/Documentation/git-read-tree.txt @@ -41,7 +41,7 @@ OPTIONS Merging ------- -If '-m' is specified, "git-read-tree" can performs 3 kinds of +If '-m' is specified, "git-read-tree" can perform 3 kinds of merge, a single tree merge if only 1 tree is given, a fast-forward merge with 2 trees, or a 3-way merge if 3 trees are provided. @@ -51,9 +51,9 @@ Single Tree Merge ~~~~~~~~~~~~~~~~~ If only 1 tree is specified, git-read-tree operates as if the user did not specify '-m', except that if the original cache has an entry for a -given pathname; and the contents of the path matches with the tree +given pathname, and the contents of the path matches with the tree being read, the stat info from the cache is used. (In other words, the -cache's stat()s take precedence over the merged tree's) +cache's stat()s take precedence over the merged tree's). That means that if you do a "git-read-tree -m " followed by a "git-checkout-cache -f -u -a", the "git-checkout-cache" only checks out @@ -184,7 +184,7 @@ populated. Here is an outline of how the algorithm works: automatically collapse to "merged" state by git-read-tree. - a file that has _any_ difference what-so-ever in the three trees - will stay as separate entries in the index. It's up to "script + will stay as separate entries in the index. It's up to "porcelain policy" to determine how to remove the non-0 stages, and insert a merged version.