| Deletions are marked like this. | Additions are marked like this. |
| Line 37: | Line 37: |
| That is enough information to get started. | That is enough information to get started. Policies and conventions to use for the Starlink repository itself are discussed [[GitPolicies | elsewhere]]. |
Git Primer
To obtain a read-only copy of the Starlink git repository:
% git clone git://starlink.jach.hawaii.edu/starlink.git
If you have small one-off patches and do not need write access to the repository you can use git-send-email and mail the patch to mailto:stardev@jiscmail.ac.uk.
To clone a read/write version of the repository you will need to request an account. The repository can be cloned with:
% git clone ssh://ssh.jach.hawaii.edu/jac_sw/gitroot/starlink.git
To find out what has been changed:
% git status % git diff
After editing, if you want to commit all changes (in the entire repository, not just your current working directory):
% git commit -a
You will be placed into an editor to enter your commit message. Note that this will not send your work back to the Joint Astronomy Centre. To do that you should first synchronize with the JAC server and then push your changes out:
% git pull % git push
To obtain the history of a particular file:
% git log --follow -- filename
or browse the repository using gitk.
Each commit is given a unique identifier (an SHA1) and can be used in many commands to indicate a single revision. Only the first few characters are required (usually about 6).
That is enough information to get started. Policies and conventions to use for the Starlink repository itself are discussed elsewhere.
Further Reading
There are many documents available to help learn git: