== Using git with MythTV ==

To work with MythTV source code, you may either create a read-only repository (allowing you to build MythTV and make local changes, only):

{{{
git clone git://github.com/MythTV/mythtv.git
}}}

Or you may create a github account and fork the repository into your account, allowing you to push your changes to your fork (for others to see/use) and to provide pull requests in tickets to get your changes incorporated:

{{{
git clone git@github.com:MythTV/mythtv.git
}}}

If you are a MythTV developer with commit access, you should use the following repository:

{{{
git clone git@code.mythtv.org:mythtv
}}}

To switch to another branch:

{{{
git checkout fixes/0.27
}}}

=== configuring git ===

If this is the only git repo you are using:

{{{
git config --global user.name "Your Name"
git config --global user.email you@example.com
}}}

If you do already have other repos going, you will be better off using (from the mythtv checked-out directory):

{{{
cd /path/to/mythtv-git/
git config user.name "Your Name"
git config user.email you@example.com
}}}

Please use your real name and a real email address.  If you are on the MythTV development team, please use the assigned canonical @mythtv.org email address.  This will be attached to each commit you make, and is needed for legality reasons (i.e. to clearly denote the contributors, which can be a life-saver if we have licensing issues later)

The default git push behaviour is inconvenient or dangerous. Without options it will push all matching branches (branches with the same name in the remote and local repository).  As above, use --global or run the commands in each repository's checked out directory if you use git for more than just MythTV.

{{{
git config --global --add push.default nothing
}}}

The first prevents any unwanted changes.

{{{
git config --global --add push.default tracking
}}}

This configures git to push only the current branch to it's remote tracking branch. That's useful if local branches don't have exactly the same name as the remote branch. mythtv-rec vs. dkristjansson/mythtv-rec for example.

git push -n should always verified before real pushing.

=== git for svn users ===

https://git.wiki.kernel.org/index.php/GitSvnCrashCourse

https://git.wiki.kernel.org/images-git/7/78/Git-svn-cheatsheet.pdf

http://git.or.cz/course/svn.html

||= svn command =||= git command =||= comments =||
|| svn checkout || git clone || ||
|| svn diff || git diff HEAD || pretty much identical ||
|| svn diff || git diff || show differences since last stage commit ||
|| svn stat || git status || ||
|| svn commit || git commit / git push || in git, git commit commits locally, git push pushes to the upstream repo. Additionally, changes must be staged before committing. ||
|| ---- || git add -i / git add -p || stage commits ||
|| svn update || git pull || technically, this is two steps combined (git fetch, git merge) git pull --rebase does a rebase instead of a merge ||
|| svn update (to recover a single file) || git checkout HEAD filename || ||
|| svn update (to recover all deleted files) || git ls-files -d | xargs git checkout -- || ||
|| svn copy (to create a branch) || git branch (or git checkout -b) || ||
|| svn copy (to create a tag) || git tag -a || ||
|| svn switch || git checkout branch ||  ||
|| svn merge || git merge || ||
|| svn revert || git checkout or git reset || specify a filename or a directory path for recursive updates ||
|| svn revert -R (for pristine index and working copy) || git reset --hard || applies to entire tree so no filename or directory allowed ||

=== Useful git commands ===

To cherry pick a commit from master to fixes/0.27 (this automatically commits to your local branch):
{{{
git checkout fixes/0.27; git cherry-pick -x {commitref} (retrieve commitref hash from git log, e-mail or github history)
}}}
Options to use for cherry-pick
* -s to signoff another person's fix with your name
* -x append a comment line that says "(cherry picked from commit ...)"
* -e to edit comment to add ticket number (e.g. Fixes !#12345, see below)
* -n to leave out commit so you can combine multiple cherry-picks into 1 commit.

To see log for specific branch
{{{
git log {branchname}
}}}
To produce a diff of last two commits in a branch
{{{
git diff HEAD~2..
}}}
To produce a diff of all changes done on top of origin/HEAD
{{{
git diff origin/master..HEAD
}}}
To credit a commit to the original author use:
{{{
git commit --author "Full Name <email@address>" -s
}}}
When committing a change that closes a ticket, add this to the commit comment, to automatically close the ticket:
{{{
Fixes #12345
}}}

Also, github has a wealth of good information.

== MythTV Git Repositories ==

||= Name =||= mirrored on !GitHub =||
||buildbot-config||no||
||extras||yes||
||mythtv||yes||
||mythweb||yes||
||nuvexport||yes||
||packaging||yes||

In addition there are multiple repositories for contributors at https://github.com/MythTV-Clients and https://github.com/MythTV-Themes, see http://mythtv-themes.github.io/