Archive:Development/Tutorials/Git

Warning

This page is yet to be reviewed for changes required by the migration to Git. Information and commands on this page may no longer be valid and should be used with care. Please see the KDE Git hub page for more details.

KDE is currently migrating from SVN to Git. As of 29 Jan 2011 kde-qt, kdelibs and kdebase are in Git along with many other KDE applications, available at projects.kde.org. The remaining KDE modules will be migrated in due course.

Your first resource for details on using Git with KDE should be the git.kde.org manual.

There are many resources available for learning about Git; the techbase pages below provide a kde-specific introduction, based on the most common tasks. After those links is a list of external documentation we've found useful.

Pages

Note: these pages are not complete. help would be appreciated. :) The idea is to provide information in more of a 'recipe' style than 'tutorial': first provide simple commands that people can use Right Now for straightforward tasks, then links to other pages or external git documentation for the tricky things.

Amarok has their own git tutorial, which has a fair amount of overlap with these git pages (we're copying from them ;)

Getting Started

Many of these links are now outdated or are incomplete, please refer to the git.kde.org manual as your primary resource.

• git.kde.org manual
• Using kde-qt (done)
• Using git-svn with kde's svn (needs cleanup)
• Accessing or setting up a KDE project on Gitorious.org (25% done)
• Basic git commands (greeneg)
• Handling common git error and information messages (todo)
• How to specify git file and directory version numbers (todo)
• How to organise branches, do comparisons between branches, minimize recompilation when switching branches, ... (todo)

Intermediate/Advanced

• things to avoid / best practices (10% done)
• Taking advantage of git's features (20% done)
• useful recipes

Further Reading

If you want to learn more about git, see the following resources:

• Illustrated git cheat sheet - Overview of the most commonly used commands
• Another git cheat sheet - Quick reference
• git <-> svn crash course - Maps git commands to svn commands
• The Git Parable - Essential reading if you want to truly understand git.
• Git Magic - A good intro to git (in several languages!)
• The official tutorial introduction to Git
• Pro Git - An easy to understand book on git (CC licensed).