Version control with Git: Difference between revisions

From Geos-chem
Jump to navigation Jump to search
Line 15: Line 15:
== Tutorials about Git ==
== Tutorials about Git ==


Here are some useful resources for learning the various Git commands:
This section has been moved to our ''[[Git and Github tutorials]]'' wiki page.
 
=== For beginners ===
 
; [https://git-scm.com/docs/user-manual.html Git user manual]: The official Git user manual
; [https://services.github.com/on-demand/downloads/github-git-cheat-sheet.pdf Github Cheat Sheet (PDF)]: Brief overview of commonly used Git commands
; [http://ndpsoftware.com/git-cheatsheet.html Visual Git Cheat Sheet]: Interactive guide for visual learners
;[http://excess.org/article/2008/07/ogre-git-tutorial/ Git tutorial video]: Excellent lecture given by Bart Trojanowski for the Ottawa Group of Ruby Enthusiasts.  '''''HIGHLY RECOMMENDED!'''''
 
=== For more advanced users ===
 
;[https://git-scm.com/book/en/v2 ''ProGit'']: Excellent online book that discusses many of Git's features, and how to use them like a pro.
;[http://www-cs-students.stanford.edu/~blynn/gitmagic/ GitMagic]: Descriptive online book that goes into the nitty-gritty of Git usage. A worthwhile read!


== Using Git with GEOS-Chem and GAMAP ==
== Using Git with GEOS-Chem and GAMAP ==

Revision as of 21:30, 18 June 2019

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

This section has been moved to our Git and Github tutorials wiki page.

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

  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)