====== Git ======

===== Links =====
  * Git Book [[https://git-scm.com/book/pl/v2 | PL ]] [[ https://git-scm.com/book/en/v2 | ENG ]]
  * [[ http://git.asic.fis.agh.edu.pl/ ]] 

===== Administrators =====
  * Git administrators : **Kuba Moron**, **Krzysztof Swientek**

===== Using Git =====

==== Help ====
It goes without saying that the book exists to be a source of information and assistance for GIT users new and old. Conveniently, though, the GIT command-line is self-documenting, alleviating the need to grab a book off the shelf (wooden, virtual, or otherwise). The git help command is your gateway to that built-in documentation:
<code>$ git help</code>
or for particular command
<code>$ git help COMMAND</code>

==== Starting svn/git shell ====
Before you start using git you have to start **svnshell**. It's not a mistake. You really should run svnshell to work with git! The main function of this script is to simplify key management, you will be asked only once to enter yours pass-phrase at script startup (if you don't like this script you may configure your ssh client in different way). Script is pre-installed on all production servers (koi, ibm). To start shell, just type:
<code> svnshell </code> 
You should see modified prompt :
<code> [SVN] promt$ </code> 

**Notes:**
  * script assumes existence of  public/private-key named **svn** and **svn.pub** in yours **.ssh** directory (''.ssh/svn'' and ''.ssh/svn.pub'')
  * script doesn't have any significant dependencies you may copy it to you workstation and use it 
  * script source is in ''svn : cds_etc/trunk/etc/svn_scripts/svnshell''



==== Getting repository ====
To get local copy (clone) of repository :
 <code> git clone git@asic.fis.agh.edu.pl:REPOSITORY_NAME </code> 
or optionally to have different local directory name
 <code> git clone git@asic.fis.agh.edu.pl:REPOSITORY_NAME LOCAL_DIRECTORY_NAME </code>

If you have local definition of asic server IP (most of machines) a short version will also work
 <code> git clone git@asic:REPOSITORY_NAME </code> 


==== Update/Pull ====

To download most recent version form repository use:
<code> git pull</code>

==== Adding ====
To add new resource (file or directory) use:
<code> git add file </code>
**NOTE:** Be careful, adding directory means adding directory itself and all files inside it.

**NOTE:** In fact this command only adds the files to next commit, so you can put here a new or already tracked files.

==== Committing ====
In Git all commits are local, so after committing you should send your data to server.

To commit (remember) yours changes use:
<code> git commit </code>
**NOTE:** It will remember only files added to commit by **git add**

You can commit all changed files (already tracked by git) without using **git add** by:
<code> git commit -a </code>

You may also commit only specific resource:
<code> svn commit filename </code>

In addition you may provide commit comment from command line using **-m** option:
<code> git commit -m "comment to my commit"</code>

==== Sending to server ====
To send all your commits to server use
<code> git push </code>

==== Deleting ====
To remove resource (file / directory) use:
<code> git rm file </code>

==== Reverting ====
To cancel your changes (revert to file version remembered in repository) use:
<code> git checkout -- file </code>

==== Checking status ====
To check the status of your local repository copy use
<code> git status </code>

To check changes done by you and other users do 
<code> git log </code>
or in graphical form
<code> gitk </code>