Cloning (i.e. downloading for the first time): Difference between revisions
No edit summary |
|||
| Line 25: | Line 25: | ||
== Cloning an older GEOS-Chem version == | == Cloning an older GEOS-Chem version == | ||
You can also clone an older GEOS-Chem version by using the <tt>-b</tt> option with <tt>git clone</tt>. This will copy the GEOS-Chem source code to your folder, and point the code to the '''branch''' or the '''tag'' that you specify. (More about branches and tags in a few chapters). | You can also clone an older GEOS-Chem version by using the <tt>-b</tt> option with <tt>git clone</tt>. This will copy the GEOS-Chem source code to your folder, and point the code to the '''branch''' or the '''tag''' that you specify. (More about branches and tags in a few chapters). | ||
For example, to clone a copy of the GEOS-Chem 12.0.0 code, type: | For example, to clone a copy of the GEOS-Chem 12.0.0 code, type: | ||
Revision as of 15:14, 19 June 2019
Previous | Next | Guide to using Git with GEOS-Chem | Getting Started with GEOS-Chem | GEOS-Chem Main Page
Overview
On this page, we describe how to download (aka "clone") the GEOS-Chem source code with Git.
Cloning the current GEOS-Chem version
The GEOS-Chem source code repository is available for remote download via Git, from our Github repository:
The first time that you will download a new GEOS-Chem version to your disk space, you must use the git clone command. This will create an exact copy of the GEOS-Chem source code (including the complete version control history) to a folder on your disk.
To clone the current version of GEOS-Chem, type:
git clone https://github.com/geoschem/geos-chem.git LOCAL_DIR_NAME
where LOCAL-DIR-NAME is the name of the local directory on your disk into which the GEOS-Chem source code files will be placed. It is up to you to pick LOCAL-DIR-NAME.
The GEOS-Chem source code that you downloaded will be a copy of the master branch, which always points to the current stable GEOS-Chem version. (More about Git branches in a couple of chapters.)
Cloning an older GEOS-Chem version
You can also clone an older GEOS-Chem version by using the -b option with git clone. This will copy the GEOS-Chem source code to your folder, and point the code to the branch or the tag that you specify. (More about branches and tags in a few chapters).
For example, to clone a copy of the GEOS-Chem 12.0.0 code, type:
git clone -b 12.0.0 https://github.com/geoschem/geos-chem.git LOCAL_DIR_NAME git checkout 12.0.0
This will download the GEOS-Chem source code and point you to the state of the code corresponding to the GEOS-Chem 12.0.0 release.
Further reading
- The git clone command (Official Git documentation)
- Git basics: Getting a Git repository (Pro Git book)
- Git clone (Atlassian Git tutorial)
Previous | Next | Guide to using Git with GEOS-Chem | Getting Started with GEOS-Chem | GEOS-Chem Main Page