Anand Kumria wrote: > I generally tend to use cogito -- it does all the heavy lifting, like > recovering from interrupted fetchs (usually) for me. One thing I haven't > really gotten my head around is the difference between a branch and a > remote. > > git-branch knows of 'remotes' (via the -r parameter) and these to be > unrelated to what cogito thinks remotes are (it seems to look for things > in .git/refs/head/<name> and then a corresponding .git/branches/<name>/ > which it then declares a remote). Not about 'remotes', but about 'remote [read-only] branches', i.e. refs not from .refs/heads/, but from .refs/remotes/<remotename>/ > Yet, git-init-db creates both .git/remotes and .git/branches > > What is the difference between the two. From my (na?ve) perspective the > two tools (git and cogito) regarded them very differently. > > Any explanation, or pointer to some documentation, would be helpful. Read Documentation/repository-layout.txt (ot it's HTML version, either locally ot at www.kernel.org). branches:: A slightly deprecated way to store shorthands to be used to specify URL to `git fetch`, `git pull` and `git push` commands is to store a file in `branches/'name'` and give 'name' to these commands in place of 'repository' argument. You can store only one branch to fetch per shorthand. I'm not sure about where it is stored which branch to download, and how to name this branch locally. remotes:: Stores shorthands to be used to give URL and default refnames to interact with remote repository to `git fetch`, `git pull` and `git push` commands. >From Documentation/urls.txt In addition to the above, as a short-hand, the name of a file in `$GIT_DIR/remotes` directory can be given; the named file should be in the following format: URL: one of the above URL format Push: <refspec> Pull: <refspec> Currently there is yet another way, by using config file: (also from Documentation/urls.txt): Or, equivalently, in the `$GIT_DIR/config` (note the use of `fetch` instead of `Pull:`): [remote "<remote>"] url = <url> push = <refspec> fetch = <refspec> where <refspec> is defined in Documentation/fetch-pull-param.txt <refspec>:: The canonical format of a <refspec> parameter is `+?<src>:<dst>`; that is, an optional plus `+`, followed by the source ref, followed by a colon `:`, followed by the destination ref. (or, simply, in git-pull(1), which includes those files, with exception of repository layout document). -- Jakub Narebski Warsaw, Poland ShadeHawk on #git - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html