diff options
| author |  Junio C Hamano <gitster@pobox.com> | 2012-11-27 13:28:31 -0800 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2012-11-27 13:28:31 -0800 |
| commit | a7c940edce6554cb57468a8a9936277b709cc7fc (patch) | |
| tree | 5556a5f0c1ddd9a0006d6a1bbe356a5a8b0a2047 /Documentation/git-fast-import.txt | |
| parent | Merge branch 'wtk/submodule-doc-fixup' into maint (diff) | |
| parent | doc/fast-import: clarify how content states are built (diff) | |
| download | tgif-a7c940edce6554cb57468a8a9936277b709cc7fc.tar.xz | |
Merge branch 'esr/maint-doc-fast-import' into maint
* esr/maint-doc-fast-import:
doc/fast-import: clarify how content states are built
Diffstat (limited to 'Documentation/git-fast-import.txt')
| -rw-r--r-- | Documentation/git-fast-import.txt | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/Documentation/git-fast-import.txt b/Documentation/git-fast-import.txt index 6603a7ab73..959e4d3aee 100644 --- a/Documentation/git-fast-import.txt +++ b/Documentation/git-fast-import.txt @@ -442,7 +442,9 @@ their syntax. ^^^^^^ The `from` command is used to specify the commit to initialize this branch from. This revision will be the first ancestor of the -new commit. +new commit. The state of the tree built at this commit will begin +with the state at the `from` commit, and be altered by the content +modifications in this commit. Omitting the `from` command in the first commit of a new branch will cause fast-import to create that commit with no ancestor. This @@ -492,7 +494,9 @@ existing value of the branch. `merge` ^^^^^^^ -Includes one additional ancestor commit. If the `from` command is +Includes one additional ancestor commit. The additional ancestry +link does not change the way the tree state is built at this commit. +If the `from` command is omitted when creating a new branch, the first `merge` commit will be the first ancestor of the current commit, and the branch will start out with no files. An unlimited number of `merge` commands per |