Git for SVN Users

This page is a work in progress. If you find an error or feel that you can make a contribution, please edit the page or – if you are not comfortable editing page – press the "m" key to leave a comment at the bottom with suggested changes/additions. Thank you!

Most OpenMRS developers are comfortable with subversion and haven't had as much experience with Git. While there are a number of good tutorials on Git, we wanted to provide a quick reference for our developers.

Basic Tasks

Help

Git	SVN
`git help`______________	`svn help`{{______________

View content of remote repository (svn list)

Git	SVN
`Browse on github`______________	`svn list` `http://svn.openmrs.org/openmrs/trunk/`______________

You can browse files in your local repository with git show or git ls-files.

Checkout code

Git	SVN
`git clone git@github.com:username/openmrs-module-mymodule.git`_____	`svn checkout` `http://svn.openmrs.org/openmrs-modules/mymodule` `mymodule`_______

Get updates

Git	SVN
`git pull`______________	`svn update`______________

Compare working copy to head (what have I changed?)

Git	SVN
`git xxx`______________	`svn diff`______________

Add new file(s)/folder(s) to version control

Git	SVN
`git add myfile.txt`______________	`svn add myfile.txt`______________

Delete file(s)/folder(s)

Git	SVN
`rm myfile.txt` To remove from Git's index & add to Git ignore: `git rm --cached myfile.txt` To remove from Git's index (doesn't delete file): `git rm myfile.txt`______________	`svn rm myfile.txt`______________

Ignore certain file(s)/folder(s)

Git	SVN
`.gitignore`______________	`svn propset svn:ignore -F .svnignore .`______________

Commit changes with comment (all or some of changes in working copy)

Git

SVN

git commit -m "comment"______________
git push
Note: It is better to use the command "git commit -a --signoff", which will open an editor using which you should write the commit comment.
This commit would be used as an email message and a subject and the format goes something like:
* First line is used as the subject
* Second line onwards is used as the body of the message
The --signoff option add the text:
"Signed-off-by: My Name <myemail@example.com>"
This signoff statement becomes part of the comment and will be used to track the changes done and also the copyright owners of the changes

svn commit -m "comment"______________

Get basic information about working copy (svn info)

Git	SVN
`cat .git/config` ______________	`svn info`______________

Revert changes (all or some changes in working copy)

Git	SVN
`git xxx`______________	`svn xxx`______________

Create a patch (diff of working copy from head)

Git	SVN
`git format-patch master --stdout > my_change.patch`______________	`svn xxx`______________

Apply a patch

Git	SVN
`git apply --stat my_change.patch`______________	`svn xxx`______________

Resolve conflicts

Git	SVN
`git xxx`______________	`svn xxx`______________

Create a branch (e.g., space for new module)

Git	SVN
`git xxx`______________	`svn xxx`______________

Close a branch

Git	SVN
`git xxx`______________	`svn xxx`______________

Tag a release

Git	SVN
`git xxx`______________	`svn xxx`______________

Advanced Tasks

Switch working copy to new repository location

Git	SVN
`git xxx`______________	`svn xxx`______________

Detach working copy

Git	SVN
`git xxx`______________	`svn export newlocation`______________

Blame (show annotations / show who changed what line in what commit)

Git	SVN
`git xxx`______________	`svn xxx`______________

Show history

Git	SVN
`git log`______________	`svn log`______________

Switch to earlier revision

Git	SVN
`git xxx`______________	`svn xxx`______________

Correct/change old commit message

Git	SVN
`git xxx`______________	`svn xxx`______________