On Wed, Aug 06, 2014 at 10:41:10AM -0700, Junio C Hamano wrote:
> Linus Arver <linusar...@gmail.com> writes:
> > On Tue, Aug 05, 2014 at 03:14:48PM -0700, Junio C Hamano wrote:
> >> Linus Arver <linusar...@gmail.com> writes:
> >> > Signed-off-by: Linus Arver <linusar...@gmail.com>
> >> > ---
> >> > Documentation/git-init.txt | 6 ++++--
> >> > 1 file changed, 4 insertions(+), 2 deletions(-)
> >> >
> >> > diff --git a/Documentation/git-init.txt b/Documentation/git-init.txt
> >> > index b94d165..16e9f9c 100644
> >> > --- a/Documentation/git-init.txt
> >> > +++ b/Documentation/git-init.txt
> >> > @@ -138,10 +138,12 @@ Start a new Git repository for an existing code
> >> > base::
> >> > $ cd /path/to/my/codebase
> >> > $ git init <1>
> >> > $ git add . <2>
> >> > +$ git commit <3>
> >> I agree it is a good discipline to make the initial "pristine"
> >> import immediately after "git add ." without doing anything else.
> >> Perhaps the description below wants to make it more explicit?
> > I could add a comment like the following:
> > For new repositories, creating a commit immediately after "git add
> > ." is good practice as it will cleanly separate any preexisting work
> > (done under some other VCS, for example) from any new work done with
> > git.
> > Does this make sense? I am not sure how explicit you want it to be, or
> > whether I captured what you wanted to be explained.
> I was thinking more along the lines of
> <3> Record the pristine state as the first commit in the history.
> which should suffice without becoming excessively verbose.
Ah yes, I like the brevity.
> > Actually, I would like to know if anything is special about the
> > "root-commit"...
> As far as Git is concerned, they are just ordinary commits without
> any parents. A commit in Git can have zero or more parents, so from
> that "structural" point of view, they are not that special.
> They are considered special by users because they represent the
> beginning of the project history.
Thank you for the insight. I won't bother adding a blurb about
"root-commit" and what it means because they are not that special, as
you said so yourself.
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html