fast-import doc: remove suggested 16-parent limit
authorJonathan Nieder <jrnieder@gmail.com>
Tue, 31 Mar 2015 23:18:07 +0000 (16:18 -0700)
committerJunio C Hamano <gitster@pobox.com>
Wed, 1 Apr 2015 00:02:29 +0000 (17:02 -0700)
Merges with an absurd number of parents are still a bad idea because
they do not render well in tools like gitk, but if they are present
in the repository being imported into git then there's no need to
avoid reproducing them faithfully.

In olden times, before v1.6.0-rc0~194 (2008-06-27), git commit-tree
and higher-level tools built on top of it were limited to writing 16
parents for a commit. Nowadays normal git operations are happy to
write more parents when asked, so the motivation for this note in the
fast-import documentation is gone and we can remove it.

Signed-off-by: Jonathan Nieder <jrnieder@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-fast-import.txt
index fd22a9a0c1312382a972a39e06063e7ff77b027d..e41f80ab96b44d578d9a8fb35fe7340dc188a035 100644 (file)
@@ -504,10 +504,6 @@ 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
 commit are permitted by fast-import, thereby establishing an n-way merge.
-However Git's other tools never create commits with more than 15
-additional ancestors (forming a 16-way merge).  For this reason
-it is suggested that frontends do not use more than 15 `merge`
-commands per commit; 16, if starting a new, empty branch.
 
 Here `<commit-ish>` is any of the commit specification expressions
 also accepted by `from` (see above).