Git - Revision history

Kamil-braschke-0d3e@uni-wuppertal.de: /* Basic Usage */

2022-10-05T05:35:15Z

Basic Usage

Marc-andre-hermanns-bc32@rwth-aachen.de: Changing section title from "stuff" to "topics"

2022-09-23T09:50:51Z

Changing section title from "stuff" to "topics"

Kamil-braschke-0d3e@uni-wuppertal.de at 12:49, 21 September 2022

2022-09-21T12:49:38Z

Daniel-schurhoff-de23@rwth-aachen.de at 13:52, 3 September 2019

2019-09-03T13:52:46Z

Fabian-schlebusch-e0e3@rwth-aachen.de: Wrote first version of git article.

2018-10-01T11:43:53Z

Wrote first version of git article.

New page

Git is a version-control system, commonly used for managing source code and coordinating the work of multiple contributors on a software project.

From a user perspective, the workflow is divided into two stages: first, there are the changes you make to your local copy of the project.
This local copy is called the ''local repository''.
Then, there is also the ''remote repository'' to which the contributors ''push'', i.e., upload, their changes or ''pull'' the current version of the project.
The main advantage is that all contributors can work on their part of the project simultaneously and ''merge'' their changes later on.

The changes are organized as ''commits''.
Whenever you feel that you have reached a certain goal, e.g. you fixed a bug or implemented a new feature, you should commit your changes.
It is good practice to make only few changes per commit.

You can also organize the work in ''branches'', where each branch has it's own timeline of commits.
One branch can be branched from another, copying the state of the branch at this specific point.
From then on, they can be worked on independently.
Branches can later be merged again.
This feature is used e.g., if a new feature is implemented in your project.
Then, you would create a new branch where this feature is developed and merge it into the master branch as soon as the development is finished.

== Creating a Repository ==
Before you can start using git productively, you will have to create a git repository first.
You can create a git repository using a hosting service of your choice.
If you are a member of the RWTH Aachen, you can use the [https://git.rwth-aachen.de/ GitLab].
Otherwise, e.g. [https://github.com/ GitHub] is a free and popular hosting service.
Both provide you with a powerful web interface and rights management, so that you can control who can access or make changes to your project.
It might become necessary that you generate an [[SSH]] key to prove your identity when you access the remote repository.

== Basic Usage==
When you want to start working with your repository, you will have to clone it to your machine first.
Hosting services usually provide a button labeled 'clone' from which you can copy the repository's URL.
<syntaxhighlight lang="bash">
user@cluster.rz.rwth-aachen.de: $ git clone https://github.com/MyRepository.git
</syntaxhighlight>
Assuming that your repository is called MyRepository, git will automatically create a directory with this name and download all files in this repository to your machine.

If you already cloned your repository to your machine and you want to start working after a break, you should pull from the remote repository.
This will ensure that you have the most recent changes on your machine when you start working.
<syntaxhighlight lang="bash">
user@cluster.rz.rwth-aachen.de: $ git pull
</syntaxhighlight>

Before you start working, when you are done with your work or if you want to commit your changes, it is a good idea to request the repository's status from git.
<syntaxhighlight lang="bash">
user@cluster.rz.rwth-aachen.de: $ git status
</syntaxhighlight>

When you have worked on your source code and reached a point where you feel confident to commit your changes, you have to tell git which files you want to commit.
Ask git for the repository status and it will give you a list of all files that have changed.
Then, you can selectively ''stage'' files for your commit, i.e. add them to the list of files for your commit.
<syntaxhighlight lang="bash">
user@cluster.rz.rwth-aachen.de: $ git add File0 [File1 ...]
</syntaxhighlight>

Always confirm that you have staged the correct files by taking a look at the status!
If everything is correct, you can commit your changes and add a description of your changes.
<syntaxhighlight lang="bash">
user@cluster.rz.rwth-aachen.de: $ git commit -m "I changed everything."
</syntaxhighlight>

Git will confirm your commit and then you are ready to push your changes to the remote repository.
<syntaxhighlight lang="bash">
user@cluster.rz.rwth-aachen.de: $ git push
</syntaxhighlight>

== Advanced Stuff ==
If you and another contributor have worked on the same files and git cannot automatically resolve these conflicts, the merge conflicts have to be resolved manually.
A good tutorial on how to merge your changes can be found in the GitHub Documentation: [https://help.github.com/articles/resolving-a-merge-conflict-using-the-command-line/ Resolving a merge conflict using the command line].

A more detailed explanation of branches can be found here: [https://git-scm.com/book/en/v1/Git-Branching-What-a-Branch-Is Git - What a Branch Is].

If you have made a mistake and already commited your changes, you can resort to [https://www.atlassian.com/git/tutorials/undoing-changes/git-revert git revert] or [https://www.atlassian.com/git/tutorials/undoing-changes/git-reset git reset].
The latter should however be used very carefully.

== Git With GUI ==
For unexperienced users, using the shell can still be difficult.
Then, you might want to use a graphical user interface (GUI) for git.
Some of the most popular git GUIs are [https://tortoisegit.org/ TortoiseGit], the [https://desktop.github.com/ GitHub Desktop Client] or [https://www.sourcetreeapp.com/ SourceTree].
Further, some IDEs have a git integration, e.g. [http://www.vogella.com/tutorials/EclipseGit/article.html Eclipse's EGit]

== References ==
[https://git-scm.com/docs Git Docs]

← Older revision		Revision as of 12:49, 21 September 2022
Line 1:		Line 1:
	[[Category:Basics]][[Category:HPC-User]]		[[Category:Basics]][[Category:HPC-User]]
		+	[[Category:Tutorials\|Git Tutorials: Basic Git Overview]]<nowiki />
		+	{{DISPLAYTITLE:Git Tutorial: Basic Git Overview}}<nowiki />
		+	{{Syllabus Git Tutorials}}
	Git is a version-control system, commonly used for managing source code and coordinating the work of multiple contributors on a software project.		Git is a version-control system, commonly used for managing source code and coordinating the work of multiple contributors on a software project.

← Older revision		Revision as of 13:52, 3 September 2019
Line 1:		Line 1:
		+	[[Category:Basics]][[Category:HPC-User]]
	Git is a version-control system, commonly used for managing source code and coordinating the work of multiple contributors on a software project.		Git is a version-control system, commonly used for managing source code and coordinating the work of multiple contributors on a software project.

@@ Line 58: / Line 58: @@
 If everything is correct, you can commit your changes and add a description of your changes.
 <syntaxhighlight lang="bash">
-user@cluster.rz.rwth-aachen.de: $ git commit -m "I changed everything."
+user@cluster.rz.rwth-aachen.de: $ git commit -m "Change everything."
 </syntaxhighlight>

@@ Line 66: / Line 66: @@
 </syntaxhighlight>
-== Advanced Stuff ==
+== Advanced Topics ==
 If you and another contributor have worked on the same files and git cannot automatically resolve these conflicts, the merge conflicts have to be resolved manually.
 A good tutorial on how to merge your changes can be found in the GitHub Documentation: [https://help.github.com/articles/resolving-a-merge-conflict-using-the-command-line/ Resolving a merge conflict using the command line].