threads / patch / 14885

patchDocumentation: commit-tree: remove 16 parents restriction

Subject: [PATCH] Documentation: commit-tree: remove 16 parents restriction

## tl;dr

3 messages between Aug 8, 2008 and Aug 8, 2008. Diffs are folded; open one to read it.

replies: 2people: 2as markdown or json

Thomas Rast· Aug 8, 2008, 07:52 UTC · lore

ef98c5ca lifted the 16 parents restriction in builtin-commit-tree.c, but forgot to update the documentation.

Signed-off-by: Thomas Rast <trast@student.ethz.ch>
---
 Documentation/git-commit-tree.txt |   10 +++++-----
 1 files changed, 5 insertions(+), 5 deletions(-)
Show changes to Documentation/git-commit-tree.txt +5 −5
diff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt
index feec584..92ab3ab 100644
--- a/Documentation/git-commit-tree.txt
+++ b/Documentation/git-commit-tree.txt
@@ -16,12 +16,12 @@ This is usually not what an end user wants to run directly.  See
 linkgit:git-commit[1] instead.
 
 Creates a new commit object based on the provided tree object and
-emits the new commit object id on stdout. If no parent is given then
-it is considered to be an initial tree.
+emits the new commit object id on stdout.
 
-A commit object usually has 1 parent (a commit after a change) or up
-to 16 parents.  More than one parent represents a merge of branches
-that led to them.
+A commit object may have any number of parents. With exactly one
+parent, it is an ordinary commit. Having more than one parent makes
+the commit a merge between several lines of history. Initial (root)
+commits have no parents.
 
 While a tree represents a particular directory state of a working
 directory, a commit represents that state in "time", and explains how

-- 
1.6.0.rc2.19.g3c9ba
Johannes Schindelin· Aug 8, 2008, 10:38 UTC · re: Thomas Rast · lore

Re: [PATCH] Documentation: commit-tree: remove 16 parents restriction

Hi,
On Fri, 8 Aug 2008, Thomas Rast wrote:
Show 19 quoted lines
> ef98c5ca lifted the 16 parents restriction in builtin-commit-tree.c,
> but forgot to update the documentation.
> 
> Signed-off-by: Thomas Rast <trast@student.ethz.ch>
> ---
>  Documentation/git-commit-tree.txt |   10 +++++-----
>  1 files changed, 5 insertions(+), 5 deletions(-)
> 
> diff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt
> index feec584..92ab3ab 100644
> --- a/Documentation/git-commit-tree.txt
> +++ b/Documentation/git-commit-tree.txt
> @@ -16,12 +16,12 @@ This is usually not what an end user wants to run directly.  See
>  linkgit:git-commit[1] instead.
>  
>  Creates a new commit object based on the provided tree object and
> -emits the new commit object id on stdout. If no parent is given then
> -it is considered to be an initial tree.
> +emits the new commit object id on stdout.
Oops.

Ciao, Dscho

Thomas Rast· Aug 8, 2008, 11:41 UTC · re: Johannes Schindelin · lore

Re: [PATCH] Documentation: commit-tree: remove 16 parents restriction

Johannes Schindelin wrote:
Show 9 quoted lines
> 
> On Fri, 8 Aug 2008, Thomas Rast wrote:
> 
> >  Creates a new commit object based on the provided tree object and
> > -emits the new commit object id on stdout. If no parent is given then
> > -it is considered to be an initial tree.
> > +emits the new commit object id on stdout.
> 
> Oops.

I deliberately removed that sentence because I wanted to enumerate all options in the new second paragraph (0, 1, or many), and felt it would be redundant.

- Thomas
-- 
Thomas Rast
trast@student.ethz.ch

← back to recent threads