How to use Git

this page is a draft.It requires improvements. If you want to improve it, simply log in and click on the Edit tab. Please remove this {{Draft}}template, when you're sure the page is complete and correct. View the other draft pages, or other pages to improve and maintain.

How to use Git

Configure git

(make sure you've installed git and insert your own name and mageia email address)

[ ]$ git config --global user.name "Full Name"
[ ]$ git config --global user.email <foo>@mageia.org
[ ]$ git config --global url."git://git.mageia.org/".insteadof mga:
[ ]$ git config --global url."ssh://git@git.mageia.org/".pushInsteadof mga:

You can check some values:

[ ]$ git config user.name

now, we need to make sure for pushing that your ssh keys are setup properly, same for svn (for packagers) see https://wiki.mageia.org/en/Svn_for_translators#Adding_your_public_key

using git

using git is very easy, see https://wiki.mageia.org/en/Git_Migration#Using_Git

and more advanced help is actually here: https://help.github.com/

[ ]$ git clone mga:software/<foo>

(full list of repositories is http://gitweb.mageia.org/ )

will get you get all files and folders to your local copy

then make some changes

[ ]$ git pull --rebase

(if other people have been committing to it, you'll get a warning if that happens and you try to push)

you need to add changed files and commit for each change (you can have multiple unpushed commits)

[ ]$ git add @file - will add file to commit changes
[ ]$ git commit - you'll write changes description

to actually push all your commits, use this:

[ ]$ git push

but also there's a |gitk| visual interface to do all this and there's another guis to do that as well. so it is kinda more advanced ftp with more functions of describing changes (at first sight - but it's more than that) and ssh-auth and github do it for free for open-source projects providing very userfriendly web-gui with some nice team-management tools