Re: basics... when reading docs doesn't help

From: Theodore Tso <tytso@mit.edu>
Date: Mar 30, 2007, 20:23 UTC
Message-ID: <20070330202312.GG3198@thunk.org>
In-Reply-To: <Pine.LNX.4.60.0703302135590.10784@poirot.grange>

On Fri, Mar 30, 2007 at 09:49:20PM +0200, Guennadi Liakhovetski wrote:

> Aha, so, that's how it is then! Why hasn't anybody explained this to me 
> strait away?!:-))))

A lot of this is in the git 1.5's User Manual:

	http://www.kernel.org/pub/software/scm/git/docs/user-manual.html

See also the man page for git-remote, or here:

	http://www.kernel.org/pub/software/scm/git/docs/git-remote.html

> Yeah, hopefully, I'll learn to at least use this thing efficiently enough. 
> Someone has to write a book on it though...

The user-manual and the git tutorials are pretty good --- just make sure you look at the ones that come with git 1.5.0, or the ones at http://www.kernel.org/pub/software/svm/git/docs (which reflects the Documentation as of the latest development version of git).

The problem is that there are some tutorials on the web which assume git 1.4.x, or cogito, and that has been listed as a defect by people who have been confused because those tutorials are out of date with respect to modern git.[1]

[1] http://changelog.complete.org/posts/594-More-on-Git,-Mercurial,-and-Bzr.html

Show 6 quoted lines

> And, so, it's a pity I cloned Paul's tree yesterday with the "old" git. 
> And from your answer above it seems like some features of the "new" git 
> will not be available with this tree, like equally named local and remote 
> branches, etc. There isn't a way to convert such a "old style" tree to the 
> "new style", is there? Not a big deal, will re-clone at some point, maybe 
> when we get local git mirrors...

Yeah, we need to really make sure the word gets out that new git users should really make sure they are using git 1.5, and not git 1.4.x; it is such an improvement in terms of usability over git 1.4.x that there really is no comparison. (Of course, guess what Debian is going to ship in their soon-to-be-release "stable" distribution? git 1.4.4. Sigh...)

It is possible to get the new style naming, by using the git remote command. Just do

	git remote add origin <url>

...and that will adjust your git configuration file appropriate. Check out the git 1.5.0 release notes, and the git-config man page, and there are some other adjustments you can make as well that will make git more efficiently, at the cost of breaking some level of compatibility with git 1.4.x tools which replicate via the "dumb" http protocol. But for local development repositories that generally isn't a concern.

						- Ted