Changes

1,214 bytes added ,  09:26, 29 December 2010
Line 41: Line 41:  
===General overview of git===
 
===General overview of git===
   −
Start with James Cameron's [[Activity Team/Git Tutorial|git tutorial]].
+
Read this brief overview and then '''start''' with James Cameron's [[Activity Team/Git Tutorial|git tutorial]].
 +
 
 +
====Setup (once per machine you're working on):====
 +
git clone git://git.sugarlabs.org/whatever/mainline.git whatever
 +
 
 +
====Regular usage:====
 +
cd whatever
 +
[hack away and test your changes]
 +
git diff
 +
[review your changes, go back to hacking if you notice a mistake]
 +
git status
 +
git add NameOfNewFile # if you created any file you want included
 +
git commit -a
 +
[describe your changes - by convention the first line is a summary and the remaining lines are long description]
 +
[start again at hacking if you're offline]
 +
git log origin/master..master # shows you all commits not pushed yet
 +
git push # if/once you are online
 +
 
 +
Git offers a lot more commands and features that can make your life
 +
easier, but it's best to start off small and use only those mentioned
 +
above. It's very easy to get confused if you're unfamiliar with git.
 +
 
 +
Even if you use the more advanced features, git does a pretty good job at
 +
allowing you to recover from your mistakes.
 +
So if you ever mess up and don't know how to fix it yourself, please
 +
stop (at least for me that's usually the hardest part ;) ), try to
 +
recollect the exact sequence of actions (e.g. from shell history) and ask
 +
for help.
 +
 
 +
----
    
Once you have [[Activity Team/How_to_migrate_from_OLPC|migrated]] your project, you may have some more detailed [[Activity Team/Git FAQ|questions regarding how Sugar Labs uses git]], particularly in regard to patch management.
 
Once you have [[Activity Team/How_to_migrate_from_OLPC|migrated]] your project, you may have some more detailed [[Activity Team/Git FAQ|questions regarding how Sugar Labs uses git]], particularly in regard to patch management.