-
Notifications
You must be signed in to change notification settings - Fork 0
branch
The branch command permit to manage TFS branches. With this command, you can display, create, init, rename and delete branches.
Usage: git-tfs branch
* Display remote TFS branches:
git tfs branch -r
git tfs branch -r -all
* Create a TFS branch from current commit:
git tfs branch $/Repository/ProjectBranchToCreate <myWishedRemoteName> --comment="Creation of my branch"
* Rename a remote branch:
git tfs branch --move oldTfsRemoteName newTfsRemoteName
* Delete a remote branche:
git tfs branch --delete tfsRemoteName
* Initialise an existing remote TFS branch:
git tfs branch --init $/Repository/ProjectBranch
git tfs branch --init $/Repository/ProjectBranch myNewBranch
git tfs branch --init --all
git tfs branch --init --tfs-parent-branch=$/Repository/ProjectParentBranch $/Repository/ProjectBranch
-h, -H, --help
-V, --version
-d, --debug Show debug output about everything git-tfs does
-i, --tfs-remote, --remote, --id=VALUE
The remote ID of the TFS to interact with
default: default
-r, --remotes Display the TFS branches of the current TFS root
branch existing on the TFS server
--all Display (used with option --remotes) the TFS
branches of all the root branches existing on
the TFS server
or Initialize (used with option --init) all
existing TFS branches (For TFS 2010 and later)
--comment=VALUE Comment used for the creation of the TFS branch
-m, --move Rename a TFS remote
--delete Delete a TFS remote
--init Initialize an existing TFS branch
-b, --tfs-parent-branch=VALUE
TFS Parent branch of the TFS branch to clone
(TFS 2008 only! And required!!) ex:
$/Repository/ProjectParentBranch
-u, --username=VALUE TFS username
-p, --password=VALUE TFS password
-a, --authors=VALUE Path to an Authors file to map TFS users to Git
users## Examples
git tfs branch
git tfs branch -r
git tfs branch -r -all
First, checkout with git the revision from where you want to create the TFS branch. Then use the command :
git tfs branch $/Repository/ProjectBranchToCreate --comment="Creation of my branch"
You will now have a TFS branch (called $/Repository/ProjectBranchToCreate ) with a first commit with a the comment specified. The local git remote with the same name 'ProjectBranchToCreate' is created.
If you want to specify another name (but not recommended), use the command :
git tfs branch $/Repository/ProjectBranchToCreate myWishedRemoteName --comment="Creation of my branch"
The local git remote with the name 'myWishedRemoteName ' is created.
To use this command, you should have cloned only the trunk folder in TFS (and not the whole repository). See clone command. Suppose you have on TFS:
A <- B <- C <- D <- E $/Repository/ProjectTrunk
\
M <- N $/Repository/ProjectBranch
You should have done (to clone only the trunk) :
git tfs clone http://tfs:8080/tfs/DefaultCollection $/Repository/ProjectTrunk
Then use branch like this :
git tfs branch --init $/Repository/ProjectBranch
git tfs branch --init $/Repository/ProjectBranch myNewBranch
git tfs branch --init --all
This command init all the branches not already done and ignore existing ones.
TFS2008 doesn't permit to know the parent of a branch. You should find it yourself with TFS and use the parameter --tfs-parent-branch to give it to the init-branch command:
git tfs branch --init --tfs-parent-branch=$/Repository/ProjectParentBranch $/Repository/ProjectBranch
For the use of parameters --username and --password, see the clone command.
For the use of parameter --authors, see the clone command.
Note : It will not rename the TFS branch, just the local git remote.
git tfs branch --move oldTfsRemoteName newTfsRemoteName
Note : It will not delete the TFS branch, just the local git remote.
git tfs branch --delete tfsRemoteName