The repository contains a directory structure that splits content according to its nature. There is a directory hierarchy for source code, one for journal articles, etc. Below these top-level directories, new users should create a directory named after their user name and place all individual projects inside for safekeeping. Users may add new top-level directories if a particular theme is missing.
The CIRA repository uses subversion to keep track of all changes. Access to the repository requires a username and password, which can be obtained from Aidan Hotan – a [dot] hotan [at] curtin [dot] edu [dot] au
To access the repository, you must “check out” a working version onto a local machine. This would typically be your desktop computer, but could easily be a laptop or whatever is most convenient for you. In order to do this, you must have a copy of the subversion software on your local machine. If you run Linux, you should be able to install the subversion command line tools using the package management system included in your distribution. If you run Windows, try TortiseSVN. MacOS X binaries can be obtained from CollabNet.
The research repository itself is hosted on cuppa03.cira.curtin.edu.au. In order to check out your working copy of the repository from a Linux shell you should change to the directory in which you want to store the repository and then run the following command:
> svn checkout svn://cuppa03.cira.curtin.edu.au/research/trunk research
This assumes that your username is the same as the username assigned to you in the subversion server configuration file. If it is different, then you can specify the subversion username with an additional argument:
> svn checkout --username yourname svn://cuppa03.cira.curtin.edu.au/research/trunk research
You can add content to the repository by creating or moving a file into the appropriate directory and running the following command:
> svn add filename
You should see a list of the files you just added to the repository scroll up the terminal. You can add a whole new directory structure by adding the top level directory, subversion will recursively scan through the new directory and add all the files it contains.
Note that adding a new file or directory does not actually send it to the repository. In order to confirm your change and transmit the data, you must “commit” your changes using the following command:
> svn commit -m "Enter a comment describing the new files inside quotes here" filename
The comment argument is mandatory. If you forget it, subversion will open your default text editor and wait for you to save a new comment. Please use these comments wisely, they are important when tracking changes to the repository and provide a certain amount of accountability.
You can commit alterations to a file that already exists in the repository using the same command as above.