X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=Documentation%2Fgit-read-tree.txt;h=7db5fb579597373128c9cbb44ef02adf5e9da8a0;hb=c4c86f07d01bc4a05126b129f644e70dd9e244d0;hp=2178a0ae3ef1fd4e43ac557c6d14d6ec756d9552;hpb=a7154e916c6fab01dfb67629dae8c4430daff669;p=git.git diff --git a/Documentation/git-read-tree.txt b/Documentation/git-read-tree.txt index 2178a0ae..7db5fb57 100644 --- a/Documentation/git-read-tree.txt +++ b/Documentation/git-read-tree.txt @@ -1,6 +1,5 @@ git-read-tree(1) ================ -v0.1, May 2005 NAME ---- @@ -9,7 +8,7 @@ git-read-tree - Reads tree information into the directory cache SYNOPSIS -------- -'git-read-tree' ( | [-m [-u]] [ []]) +'git-read-tree' ( | [-m [-u|-i]] [ []]) DESCRIPTION @@ -35,6 +34,16 @@ OPTIONS After a successful merge, update the files in the work tree with the result of the merge. +-i:: + Usually a merge requires the index file as well as the + files in the working tree are up to date with the + current head commit, in order not to lose local + changes. This flag disables the check with the working + tree and is meant to be used when creating a merge of + trees that are not directly related to the current + working tree status into a temporary index file. + + :: The id of the tree object(s) to be read/merged. @@ -74,10 +83,10 @@ fast forward situation). When two trees are specified, the user is telling git-read-tree the following: - (1) The current index and work tree is derived from $H, but + 1. The current index and work tree is derived from $H, but the user may have local changes in them since $H; - (2) The user wants to fast-forward to $M. + 2. The user wants to fast-forward to $M. In this case, the "git-read-tree -m $H $M" command makes sure that no local change is lost as the result of this "merge".