Difference between revisions of "Development/Git/Recipes"

Jump to: navigation, search
m (typo)
(Git Recipes)
Line 3: Line 3:
 
Brief recipes for common use cases.
 
Brief recipes for common use cases.
  
=== Working with remote branches ===
+
=== Working with existing remote branches ===
  
 
Remote branches are branches created on the main KDE repository.  These may be a stable branch that you need to do bugfixes on, i.e. the 4.6 release, or a feature branch based on master.
 
Remote branches are branches created on the main KDE repository.  These may be a stable branch that you need to do bugfixes on, i.e. the 4.6 release, or a feature branch based on master.
  
 +
Create a local branch that tracks a remote branch:
 
  git branch --track <local-branch> <remote-branch>
 
  git branch --track <local-branch> <remote-branch>
 
  git checkout <local-branch>
 
  git checkout <local-branch>
 +
 +
When you want to add your commits to the local branch, first update your local to the current remote state, then push your commits:
 +
git pull --rebase
 
  git push origin <local-branch>:<remote-branch>
 
  git push origin <local-branch>:<remote-branch>
  
Line 38: Line 42:
  
 
  git push origin 4.6:4.6
 
  git push origin 4.6:4.6
 +
 +
=== Creating / Deleting Remote Branches ===
 +
 +
To create a new remote branch simply push your current branch to it:
 +
 +
git push origin <local-branch>:<remote-branch>
 +
 +
To delete a remote branch is a little obscure:
 +
 +
git push origin :<remote-branch>
  
 
=== Cherry Picking ===
 
=== Cherry Picking ===

Revision as of 10:02, 23 March 2011

Contents

Git Recipes

Brief recipes for common use cases.

Working with existing remote branches

Remote branches are branches created on the main KDE repository. These may be a stable branch that you need to do bugfixes on, i.e. the 4.6 release, or a feature branch based on master.

Create a local branch that tracks a remote branch:

git branch --track <local-branch> <remote-branch>
git checkout <local-branch>

When you want to add your commits to the local branch, first update your local to the current remote state, then push your commits:

git pull --rebase
git push origin <local-branch>:<remote-branch>

Working with stable branches

For kdelibs, kdepimlibs, kde-runtime, kate, konsole and kde-workspace, the remote stable branches are named as follows:

origin/KDE/4.6

For these modules, to set up a local stable branch to track the remote stable branch:

git branch --track KDE/4.6 origin/KDE/4.6
git checkout KDE/4.6

To then push changes to the remote stable branch:

git push origin KDE/4.6:KDE/4.6

In other projects the remote stable branches are named as follows:

origin/4.6

For these modules, to set up a local stable branch to track the remote stable branch:

git branch --track 4.6 origin/4.6
git checkout 4.6

To then push changes to the remote stable branch:

git push origin 4.6:4.6

Creating / Deleting Remote Branches

To create a new remote branch simply push your current branch to it:

git push origin <local-branch>:<remote-branch>

To delete a remote branch is a little obscure:

git push origin :<remote-branch>

Cherry Picking

Cherry picking is a way to copy a single commit from one branch to another.

When cherry picking between stable and unstable branches, use the following form:

git cherry-pick -e -x <original-commit>

Common Options

-e will allow you to edit the commit message to add any extra details and to change the BUG/CCBUG/FIXED-IN messages.

-x will automatically add the original commit number to the end of the commit message to enable better tracing and to simplify merging. Only do this if the original commit was already published in a public repository, e.g. your are forward porting or back porting the patch.

-n will cherry-pick the changes but not commit them to the new branch. This is very use full if you need to do further work on a commit.


KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal