cg-branch-add(1)
================

NAME
----
cg-branch-add - add new branch to the git repository

SYNOPSIS
--------
cg-branch-add BRANCH_NAME LOCATION

DESCRIPTION
-----------
Takes the branch name and source location as parameters.
After you add a branch, you can link:cg-pull.html[cg-pull(1)] it whenever you want and
it will keep your objects database in sync with it. Its latest
commit is accessible as `.git/refs/heads/branchname` (or - more
conveniently - as `$(commit-id branchname)`). For example, to make a
diff between Linus (after you added him) and your current tree, do:

	$ cg-pull linus
	$ cg-diff linus

The possible location specifiers are:

1. Local path - note that pulling will hardlink the objects, not copy them.
2. rsync - either `rsync://host/path` or `host:/path` (the latter can change)
3. HTTP - `http://host/path`
4. SSH - `git+ssh://host/path` or `git+ssh://user@host/path` - note that
the path must be absolute.

The URL can have a fragment part, which identifies a branch inside of
the repository. Therefore, if you have a repository
`rsync://host/path/repo.git` and you are interested in its 'testing'
branch, you can e.g.:

	$ cg-branch-add repo-testing rsync://host/path/repo.git#testing

and refer to it as 'repo-testing' anytime later.

OPTIONS
-------


-h, --help::
	Print usage help.



COPYRIGHT
---------
Copyright (C) Petr Baudis, 2005

SEE ALSO
--------
cg-branch-add command is part of link:cogito.html[cogito(7)],
a toolkit for managing link:git.html[git(7)] trees.
