CollaboratingWithGit

Basic

If you are new to Git, following are some of the resources you might find useful:

• GitHub's blog post
• http://try.github.com/
• http://sixrevisions.com/resources/git-tutorials-beginners/

Get latest code from hw's official branch

First you need to add the official repo to your remote repo list:

git remote add upstream git://github.com/hwhw/kindlepdfviewer.git

You can verify the remote repo is successfully added by using:

git remote -v show

Now you can pull the latest development code for the old code base:

git pull upstream master

Or latest development code for new ui code base:

git pull upstream new_ui_code

Get latest patches from other developer's branch

First you need to add his/her own repo to your remote repo list:

git remote add NAME REPO_ADDR

Where NAME is the alias name you want to give for the remote repo, for example:

git remote add dpavlin git://github.com/dpavlin/kindlepdfviewer.git

You can verify the remote repo is successfully added by using:

git remote -v show

Now you can merge their branch to your local branch. But before you do this, I recommend you create a new branch first and do experimental stuff on top of the new branch so you won't mess with the master branch:

git checkout -b NEW_TEST_BRANCH_NAME
git pull dpavlin REMOTE_BRANCH_NAME

Submitting code change

How to submit my change on top of current development (which is master branch at origin).

This assumes that your repository clone have origin which points to upstream hwhw's repository as shown below. If you did checkout from your forked copy, and origin points to your local fork, you can always add another remote and replace origin in this instructions with another remote name.

dpavlin@klin:/rest/cvs/kindlepdfviewer$ git remote -v | grep origin
origin  [email protected]:hwhw/kindlepdfviewer.git (fetch)
origin  [email protected]:hwhw/kindlepdfviewer.git (push)
dpavlin@klin:/rest/cvs/kindlepdfviewer$ git fetch origin
dpavlin@klin:/rest/cvs/kindlepdfviewer$ git checkout -b issue-235-toc-position origin/master
M       djvulibre
M       kpvcrlib/crengine
M       mupdf
Branch issue-235-toc-position set up to track remote branch master from origin.
Switched to a new branch 'issue-235-toc-position'

integrate changes from this issue (or diff, patch, git cherry-pick sha-commit)

dpavlin@klin:/rest/cvs/kindlepdfviewer$ git add -p unireader.lua

interactivly select just changes which are not whitespace

dpavlin@klin:/rest/cvs/kindlepdfviewer$ git commit --author NuPogodi -m 'TOC position on current place in the tree #235'
[issue-235-toc-position 25edd31] TOC position on current place in the tree #235
 Author: NuPogodi <[email protected]>
 1 file changed, 9 insertions(+), 5 deletions(-)
dpavlin@klin:/rest/cvs/kindlepdfviewer$ git show

verify that commit looks sane, if I wasn't happy I would do git --commit --amend

dpavlin@klin:/rest/cvs/kindlepdfviewer$ git push dpavlin issue-235-toc-position
Counting objects: 5, done.
Delta compression using up to 2 threads.
Compressing objects: 100% (3/3), done.
Writing objects: 100% (3/3), 489 bytes, done.
Total 3 (delta 2), reused 0 (delta 0)
To [email protected]:dpavlin/kindlepdfviewer.git
 * [new branch]      issue-235-toc-position -> issue-235-toc-position

This assumes that your copy of github source is named dpavlin as here:

dpavlin@klin:/rest/cvs/kindlepdfviewer$ git remote -v | grep dpavlin
dpavlin [email protected]:dpavlin/kindlepdfviewer.git (fetch)
dpavlin [email protected]:dpavlin/kindlepdfviewer.git (push)

Go to your github page and issue pull request