Difference between revisions of "Version control with Git"

From Geos-chem
Jump to: navigation, search
(Advantages of using Git)
(Redirected page to Guide to using Git with GEOS-Chem)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
== Overview ==
+
#REDIRECT [[Guide to using Git with GEOS-Chem]]
 
+
=== Why use Git? ===
+
 
+
This section has been moved to our [[Introduction to Git#Why_use_Git.3F|''Introduction to Git'']] web page.
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:24, 18 June 2019 (UTC)
+
 
+
=== Advantages of using Git ===
+
 
+
This section has been moved to our [[Introduction to Git#Advantages of using Git|''Introduction to Git'']] web page.
+
 
+
--[[User:Bmy|Bob Yantosca]] ([[User talk:Bmy|talk]]) 21:24, 18 June 2019 (UTC)
+
 
+
== Tutorials about Git ==
+
 
+
Here are some useful resources for learning the various Git commands:
+
 
+
=== 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 ==
+
 
+
=== 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) [http://git-scm.com/download the Git website].
+
 
+
=== First-time setup ===
+
 
+
Before using Git for the first time, you need to set up your <tt>~/.gitconfig</tt> file.  Open a text editor and then cut & paste the text from [http://docs.scipy.org/doc/numpy-1.6.0/dev/gitwash/configure_git.html this sample <tt>.gitconfig</tt> file].  Then save it as <tt>~/.gitconfig</tt>. 
+
 
+
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]]
+
 
+
--[[User:Bmy|Bob Y.]] 09:43, 16 March 2010 (EDT)
+
 
+
== References ==
+
 
+
# [http://git-scm.com/ Git web page]
+
# [http://zrusin.blogspot.com/2007/09/git-cheat-sheet.html Git Cheat Sheet]
+
# Google "Tech Talk" by Linus Torvalds, the creator of Git [http://www.youtube.com/watch?v=4XpnKHJAok8 (Video on Youtube)]
+
# Google "Tech talk" by Randal Schwartz [http://www.youtube.com/watch?v=8dhZ9BXQgc4 (Video on Youtube)]
+
# Setting up your <tt>.gitconfig</tt> file [http://stackoverflow.com/questions/267761/what-does-your-gitconfig-contain (Link)]
+
 
+
--[[User:Bmy|Bob Y.]] 15:35, 26 January 2011 (EST)
+

Latest revision as of 17:26, 21 June 2019