Get Source Code through SVN

The Cairngorm framework is one of several open-source projects in a Subversion repository hosted by Source Forge. Subversion is an open-source revision control system used for many open-source projects. If you haven't used it before, please see the official documentation.

There are two ways to access the repository. You can use any web browser to see the structure of the project and view the latest version of each file. However, you must use a Subversion client to perform more complex operations such as reviewing the commit log, looking at older revisions or diffs, or checking out your own working copy to build and test.

SVN repositories

To browse the Cairngorm project via web access go to http://sourceforge.net/adobe/cairngorm/code/ or checkout from SVN* via:

1. http://svn.code.sf.net/adobe/cairngorm/code/cairngorm3/trunk/ for Cairngorm 3
2. http://svn.code.sf.net/adobe/cairngorm/code/cairngorm/trunk/ for Cairngorm 2

You can also subscribe to SVN changes here: https://sourceforge.net/adobe/cairngorm/code/feed
Within the projects are directories named trunk, branches, and tags, as is standard for Subversion projects.
The trunk is work-in-progress on the version under current development. The trunk should build and pass any basic tests in place but may be unstable and unsuitable for use.

Branches are created when projects need to stabilize code for a release.

Installing a Subversion client

To get your own working copy of the source code, you'll need a Subversion client. A client will also let you see the repository structure, look at the revision history of any file or directory, diff two versions of a file, etc.
The Adobe team has had good experience with TortoiseSVN on Windows and SmartSVN on Macintosh, both of which are GUI clients. (This is not an official endorsement of these products by Adobe.) Of course, you can use whatever client you prefer, including Subversion's official command-line tool svn. We'll assume you're using svn in our instructions.

You can get the Subversion installer, which includes svn, here:

• Windows: http://subversion.tigris.org/files/documents/15/39559/svn-1.4.5-setup.exe
• Mac: http://downloads.open.collab.net/binaries.html
• All OSes: http://subversion.tigris.org/project_packages.html

After installing svn using the Windows installer, you should be able to execute svn from any directory because it will be found on your PATH.

On Macintosh, test the installation by opening Terminal and executing:

svn --version

If you get svn: command not found , then you'll need to add the /usr/local/bin directory onto your PATH , since this is where svn lives. Assuming you're using the default bash shell in Terminal, you can do this by putting the following lines into a ~/.bash_profile file:

PATH="/usr/local/bin:$PATH"
export PATH

Otherwise, you'll have to invoke svn as /usr/local/bin/svn.

Contributing to Cairngorm

If you want to contribute to the project, see Cairngorm Project Roles and Submitting a Patch.

*for read-write access to the SVN repositories use the secure version:
1. https://svn.code.sf.net/adobe/cairngorm/code/cairngorm3/trunk/ for Cairngorm 3
2. https://svn.code.sf.net/adobe/cairngorm/code/cairngorm/trunk/ for Cairngorm 2

Change notifications

If you'd like to keep up-to-date on changes to the Cairngorm project, you may subscribe to the Commits forum. Every time anyone commits a change to Cairngorm, a description of that change is posted to this forum. You can request to receive an email for each commit, or to receive a digest on a regular basis.