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:
--Bob Y. 09:43, 16 March 2010 (EDT)
References
- Git web page
- Git Cheat Sheet
- Google "Tech Talk" by Linus Torvalds, the creator of Git (Video on Youtube)
- Google "Tech talk" by Randal Schwartz (Video on Youtube)
- Setting up your .gitconfig file (Link)
--Bob Y. 15:35, 26 January 2011 (EST)