All Pandion source code is published using git, a free distributed revision control. For practical reasons all source code that goes into official builds is published on GitHub. The git clone URL is: git://github.com/pandion/pandion.git

Git Documentation and Tutorials

• http://developer.yahoo.com/yui/theater/video.php?v=prestonwerner-github (video)
• http://www.eecs.harvard.edu/~cduan/technical/git/
• http://www.kernel.org/pub/software/scm/git/docs/
• http://book.git-scm.com/index.html

Installing Git

Install git for Windows from the msysgit project. This is the command line git client for Windows.

http://code.google.com/p/msysgit/

Optionally you can also install a GUI git client like TortoiseGit. This will still require the command line git for Windows client to be installed but provides an easy to use interface.

http://code.google.com/p/tortoisegit/

Verify that git has been correctly installed by opening a cmd.exe command prompt and entering the following:

C:\Dev>git version

The output will be something like:

C:\Dev>git version
git version 1.6.3.2.1299.gee46c

Configuring Git

To avoid problems with newlines you need to configure Git as follows:

C:\Dev>git config --global core.autocrlf true

Details:

http://github.com/guides/dealing-with-newlines-in-git

Transferring the Source Code

Now get your own copy of the Pandion source code by issueing this command:

C:\Dev>git clone git://github.com/pandion/pandion.git pandion

This may take a minute as the entire repository is transferred. Upon success the output will look like:

C:\Dev>git clone git://github.com/pandion/pandion.git pandion
Initialized empty Git repository in C:/Dev/pandion/.git/
remote: Counting objects: 536, done.
remote: Compressing objects: 100% (450/450), done.
remote: Total 536 (delta 81), reused 536 (delta 81)
Receiving objects: 100% (536/536), 1.24 MiB | 276 KiB/s, done.
Resolving deltas: 100% (81/81), done.
Checking out files: 100% (487/487), done.

Now you have the source code and can begin developing.

If later on you want the latest changes from the GitHub repository brought into your local repository, simply issue this command:

C:\Dev\pandion>git pull origin master

The output will look like:

C:\Dev\pandion>git pull origin master
From git@github.com:pandion/pandion  * branch            master     -> FETCH_HEAD
Already up-to-date.

Contributing Changes

You need to publish your code in a public git repository so that others can inspect the changes. You can create a GitHub account or use any other public git service.

Issue a gut pull request through GitHub or simply contact the Pandion team directly with a link to your repository and branch.

If you have been granted contributor access to the Pandion GitHub repository, issue the following command:

C:\Dev>git push origin master