Archive:Development/Tutorials/Git: Difference between revisions
No edit summary |
|||
| Line 1: | Line 1: | ||
KDE is currently [[Projects/MovetoGit|migrating from SVN to Git]]. As of 29 Jan 2011 kde-qt, kdelibs and kdebase are in Git along with many other KDE applications. The remaining KDE modules will be migrated in due course. | |||
Your first resource for details on using Git with KDE should be the [http://community.kde.org/Sysadmin/GitKdeOrgManual git.kde.org manual]. | |||
There are many resources available for learning about [http://git-scm.com/ 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. | There are many resources available for learning about [http://git-scm.com/ 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. | ||
| Line 9: | Line 11: | ||
====Getting Started==== | ====Getting Started==== | ||
Many of these links are now outdated or are incomplete, please refer to the [http://community.kde.org/Sysadmin/GitKdeOrgManual git.kde.org manual] as your primary resource. | |||
*[http://community.kde.org/Sysadmin/GitKdeOrgManual git.kde.org manual] | |||
*[[/kde-qt|Using kde-qt]] (done) | *[[/kde-qt|Using kde-qt]] (done) | ||
*[[/git-svn|Using git-svn with kde's svn]] (needs cleanup) | *[[/git-svn|Using git-svn with kde's svn]] (needs cleanup) | ||
| Line 17: | Line 22: | ||
*How to specify git file and directory version numbers (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) | *How to organise branches, do comparisons between branches, minimize recompilation when switching branches, ... (todo) | ||
====Intermediate/Advanced==== | ====Intermediate/Advanced==== | ||
Revision as of 15:42, 31 January 2011
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. 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)
- Contributing to KDE projects on gitorious (85% done)
- 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).