Eric Ridgeway
64 lines
1.6 KiB
Markdown
64 lines
1.6 KiB
Markdown
## Introduction
|
|
|
|
git-tfs is a two-way bridge between TFS and git, similar to git-svn.
|
|
|
|
## Usage
|
|
|
|
### Cloning a repository
|
|
|
|
git tfs clone http://tfs:8080/tfs/DefaultCollection $/some_project
|
|
(wait for git-tfs to pull your history)
|
|
|
|
-or-
|
|
|
|
git tfs quick-clone http://tfs:8080/tfs/DefaultCollection $/some_project
|
|
|
|
(`cd some_project` and hack away, using only git, until you need to share with TFS...)
|
|
|
|
### Pushing your changes to TFS
|
|
|
|
#### Check-in
|
|
|
|
git tfs checkintool
|
|
|
|
-or-
|
|
|
|
git tfs checkin -m "Did stuff"
|
|
|
|
#### Shelveset
|
|
|
|
git tfs shelve A_SHELVESET_NAME
|
|
|
|
### Other commands
|
|
|
|
git tfs help
|
|
|
|
|
|
## Installing
|
|
|
|
[Download](https://github.com/git-tfs/git-tfs/downloads#uploaded_downloads) or build.
|
|
|
|
Add the directory that contains git-tfs.exe to your path.
|
|
in powershell : `$env:Path += ";c:\tools\git-tfs\"`
|
|
non-powershell users [see this](http://geekswithblogs.net/renso/archive/2009/10/21/how-to-set-the-windows-path-in-windows-7.aspx)
|
|
|
|
I've been using this with [msysgit 1.7.3.1](http://code.google.com/p/msysgit/) for a while.
|
|
|
|
You need .NET 4 and either the 2008 or 2010 version of Team Explorer installed.
|
|
|
|
|
|
## Building
|
|
|
|
msbuild (included in .NET 4) should be able to build the entire solution.
|
|
|
|
Use `msbuild GitTfs.sln /p:Configuration=Vs2010_Debug` to build for the 2010 version only.
|
|
|
|
You can also do `rake build:debug`.
|
|
|
|
If you contribute patches, please set `core.autocrlf` to `true`. (`git config core.autocrlf true`)
|
|
|
|
## Contributing
|
|
|
|
Contributions are always welcome. For more information about contributing,
|
|
please see [the wiki](http://github.com/git-tfs/git-tfs/wiki/Contributing).
|