Skip to content

Commit e705288

Browse files
eric-s-raymondpeff
authored andcommitted
doc/fast-import: clarify how content states are built
Signed-off-by: Eric S. Raymond <[email protected]> Signed-off-by: Jeff King <[email protected]>
1 parent 7e20105 commit e705288

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

Documentation/git-fast-import.txt

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -442,7 +442,9 @@ their syntax.
442442
^^^^^^
443443
The `from` command is used to specify the commit to initialize
444444
this branch from. This revision will be the first ancestor of the
445-
new commit.
445+
new commit. The state of the tree built at this commit will begin
446+
with the state at the `from` commit, and be altered by the content
447+
modifications in this commit.
446448

447449
Omitting the `from` command in the first commit of a new branch
448450
will cause fast-import to create that commit with no ancestor. This
@@ -492,7 +494,9 @@ existing value of the branch.
492494

493495
`merge`
494496
^^^^^^^
495-
Includes one additional ancestor commit. If the `from` command is
497+
Includes one additional ancestor commit. The additional ancestry
498+
link does not change the way the tree state is built at this commit.
499+
If the `from` command is
496500
omitted when creating a new branch, the first `merge` commit will be
497501
the first ancestor of the current commit, and the branch will start
498502
out with no files. An unlimited number of `merge` commands per

0 commit comments

Comments
 (0)