Version control with Git

Overview

Why use Git?

This section has been moved to our Introduction to Git web page.

--Bob Yantosca (talk) 21:24, 18 June 2019 (UTC)

Advantages of using Git

This section has been moved to our Introduction to Git web page.

--Bob Yantosca (talk) 21:24, 18 June 2019 (UTC)

Tutorials about Git

Here are some useful resources for learning the various Git commands:

For beginners

Git user manual

The official Git user manual

Github Cheat Sheet (PDF)

Brief overview of commonly used Git commands

Visual Git Cheat Sheet

Interactive guide for visual learners

Git tutorial video

Excellent lecture given by Bart Trojanowski for the Ottawa Group of Ruby Enthusiasts. HIGHLY RECOMMENDED!

For more advanced users

ProGit

Excellent online book that discusses many of Git's features, and how to use them like a pro.

GitMagic

Descriptive online book that goes into the nitty-gritty of Git usage. A worthwhile read!

Using Git with GEOS-Chem and GAMAP

Obtaining and installing Git

If you don't already have Git on your system then you (or your sysadmin) will have to install it. To check if it is already installed, you can ask for the version at the Unix prompt. Type:

git --version

If you get a string similar to:

git version 2.17.0

then you are good to go. (The actual version # doesn't matter.) If not, then you (or your sysadmin) may obtain the Git source code (or binaries) the Git website.

First-time setup

Before using Git for the first time, you need to set up your ~/.gitconfig file. Open a text editor and then cut & paste the text from this sample .gitconfig file. Then save it as ~/.gitconfig.

Be sure to change your name and email accordingly, this is how Git will know who you are!

Please see the following pages which describe how to download the GEOS-Chem and GAMAP source code packages via Git.

Downloading GEOS-Chem and GAMAP

Please see the following wiki pages which contain detailed information about how to use Git to download and modify the GEOS-Chem and GAMAP source code packages:

• Using Git with GEOS-Chem
• Using Git with GAMAP

--Bob Y. 09:43, 16 March 2010 (EDT)

References

1. Git web page
2. Git Cheat Sheet
3. Google "Tech Talk" by Linus Torvalds, the creator of Git (Video on Youtube)
4. Google "Tech talk" by Randal Schwartz (Video on Youtube)
5. Setting up your .gitconfig file (Link)

--Bob Y. 15:35, 26 January 2011 (EST)