The atlas software is distributed via google code, using the git version control system. Here is the atlas code home page.

If all you want to do is download the software the main software download page is probably all you need. Here are instructions on installing the atlas software.

Git References

The software is maintained in a central repository (we're using code.google.come).
git differs from cvs in several critical respects.

• When you check out the software from the repository, you get a complete copy of the repository, including all revisions, branches, tagging, etc.
• cvs changes are per file, git works with the entire directory. When you do a commit in git, it takes a snapshot of the entire directory, and stores a commit object which is referenced by a 40 digit hex number (which is a hash of the contents). This object has a complete record of the directory (cvs, and subversion, just keep a record of diffs). See more on the git objects below.

There is a lot of browsing you can do at the Atlas page at google (click on Source), including looking at different branches and tags.

Primary git commands

%git clone https://code.google.com/p/atlasofliegroups

This downloads the software. One key difference between git and other version control systems like cvs and subversion, is that git downloads the entire repository, including all branches. Once you have done git clone, most other commands operate locally.

Everything is done from within the atlasofliegroups directory, using meta-information in the .git subdirectory. To update the software

%git pull origin

will update your local copy of the software with the any changes on code.google.com.

Branches

There are several branches (versions) of the atlas code. The main branch is named master. Most users never need any other branch.

%git branch

will show you which branch you are on (the default is master).

%git branch -r

lists the remote branches (on code.google.com). The primary are master, unitarity, and latest.

%git checkout unitarity  switches you to the unitarity branch, and
%git checkout master   switches you back again.

Other helpful commands

gives the status of your local repository, compared to the remote one.

%git log
%git log --oneline

give a lot of information about the repository (--oneline for more succint output).

%gitk

launches a graphical git browser.

%git tag

shows a list of tages, and

%git checkout version_0_4_4

checks out the code with this tag. Many commands have help options:

%git
%git --help
%git tag --help

give short git help, longer git help, and help on tagging. Some commands have dry-run versions:

%git pull origin --dry-run

says what the command will do, but doesn't do anything.

Getting unstuck

The main git object is a commit.

A commit contains a tree, which is a snapshot of a directory, together with some meta-information.
Here are some commands for working with git objects:

%git log
%git log --oneline [show list of commits]

You can refer to each commit by the first few letters of the hex name. For example:

%git log commit b1c0fddf14858da715379b1e2e59ab75c50cb696
Author: Jeffrey Adams
Date: Thu Nov 17 09:44:24 2011 -0500

Updated version to 0.4.6 in version.h

%git show b1c0 [information about the commit b1c0fddf14858da715379b1e2e59ab75c50cb696]
commit b1c0fddf14858da715379b1e2e59ab75c50cb696
Author: Jeffrey Adams
Date: Thu Nov 17 09:44:24 2011 -0500

Updated version to 0.4.6 in version.h ...
%git ls-tree b1c0 [information about the tree underlying this commit]
040000 tree 1cb381b8c7f24c1caea6128f9c35c7a751d4102f error
040000 tree e8ef0ed891294c6fd773c0162a2b950b7dc5aaaf gkmod
040000 tree d8eb4b0e05bba5db576d42eb7209f565e3f0b936 interface
...

Tagging and Branches