Differences between revisions 6 and 7
Deletions are marked like this. Additions are marked like this.
Line 39: Line 39:
== Who are you? ==

Make sure that git knows who you are before you push any changes:
{{{
git config --global user.name "Your Name Comes Here"
git config --global user.email you@yourdomain.example.com
}}}

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.

Who are you?

Make sure that git knows who you are before you push any changes:

git config --global user.name "Your Name Comes Here"
git config --global user.email you@yourdomain.example.com

Seeing what changed yesterday

There are a number of ways to see what changed recently.

  • Use the web interface to list the most recent commits

  • Use gitk on your local machine after doing a git-pull to sync with the remote repository

  • Use the RSS feature of the web interface to view recent commits via a RSS new reader

There is currently no nightly email job indicating recent commits.

Further Reading

There are many documents available to help learn git:

Starlink: GitPrimer (last edited 2013-03-15 02:29:06 by GrahamBell)