General Turnin information

For this class, homeworks will be turned in using Subversion (Wikipedia article). There are many resources available online if you want to learn more about subversion and its advanced features. For the purposes of this class, we will use only basic Subversion commands.

File names and Directories

• File names Files should be named with partner netIDs separated by a hyphen followed by a hyphen and the assignment abbreviation and the .scm extension. For example: gcw5217-gmalecha-hw01.scm. All assigned problems should be answered in this file. The file's name must follow this pattern. If it doesn't our automated tools won't be able to find it, and you may lose points.
• File locations Files should be in one partner's subversion directory. This directory should be kept relatively clean. If you need to make other temporary files and keep them under subversion, please place them in a subdirectory.

Repository information

Repository Url:	https://svn.rice.edu/r/comp210/
User Name:	[your rice netid]
Password:	[your rice password]

If you have questions about subversion, please contact one of the labbies (Gregory Malecha, Christopher Warrington) and we will respond as soon as we can.

Turnin in Linux

While some graphical clients may exist for Linux, subversion's command line interface is simple and powerful and is the recommended method for accessing subversion from a machine running Linux.

1. Install svn Installing subversion varies based on the linux distribution that you use. Simply check your package manager (apt-get, emerge, etc.) for a subversion or svn package and install it the same way that you install all other packages.
2. Check out the repository Once subversion is installed, you need to check out the repository. Run the command:

   svn --username <netid> checkout https://svn.rice.edu/r/comp210/

   This will create a directory called comp210 and check out the part of the repository visible to you.
3. Adding a file to the repository To add a file to the repository, save the file under your repository directory (the comp210/[netid] directory created by the svn checkout command) and, from the directory that it is saved in, execute the command.

   svn add [filename]

4. Committing a file to the server In order for other people (namely the graders) to view your local work, you must send it to the server (called committing your work). To do this, from the comp210 directory, execute

   svn commit -m "[message describing your change]"

5. Updating the repository You can update your copy of the repository by executing

   svn update

   Any work that has been committed to the repository will be copied to your disk and, if there are conflicts, you will have to resolve them.

A typical subversion session might look something like this.

/tmp $ svn --username gmalecha co https://svn.rice.edu/r/comp210/
A    comp210/gmalecha
Checked out revision 21.
/tmp $ cd comp210/gmalecha
/tmp/comp210/gmalecha $ touch test.file   
/tmp/comp210/gmalecha $ svn add test.file
A         test.file
/tmp/comp210/gmalecha $ cd ..
/tmp/comp210 $ svn commit -m "Added a test file"
Adding         gmalecha/test.file
Transmitting file data .
Committed revision 22.

Turnin in Windows

You can download a Windows version of the command line client from the Subversion site. However, you will probably want to use TortoiseSVN, a graphical client for Windows.

Creating your directory

1. Download and install the latest version of TortoiseSVN from: http://tortoisesvn.net/downloads
2. Check out the repository In the folder where you want to keep your COMP 210 work, right click and select "SVN Checkout...":
   
3. Enter the repository URL Enter https://svn.rice.edu/r/comp210/ as the repository URL.:
   
4. Accept the certificate Click "Accept permanently":
   
5. Enter your netID and password Enter your netID and password in the correct fields:
   

Adding a file to your directory

1. Adding a file to the repository To add a file to the repository, save the file under your repository directory (the comp210/[netid] directory created when you checked out the repository). Then, right click on it and select "Add..." from the "SVN" menu.
   
2. Select the files to add Click "OK".
   
3. Wait for the files to be added Click "OK".
   
4. Committing a file to the server In order for other people (namely the graders) to view your local work, you must send it to the server (called committing your work). To do this, from the comp210 directory, right click and select "SVN Commit...":
   
5. Enter a message Describe what changes you have made. Then click "OK":
   
6. Wait for the files to be sent to the server Click "OK":
   

Updating your directory

1. Updating the repository You can update your copy of the repository right clicking in the comp210 folder and selecting "SVN Update":
   
2. Wait for the files to synchronize Click "OK":
   
3. Assuming that there were no conflicts (changes made to the same file), you now have an up-to-date copy of your repository.

Turnin in Mac

You can download a command line client for the Mac. After installing it, it works just like the Linux command line client. See the Linux section for further instructions.

Subversion Resources

• The SVN Command Line Client Guide from COMP 314 http://www.owlnet.rice.edu/~comp314/svn.html

---

Access Permissions: (Please don't edit)

• Set ALLOWTOPICCHANGE = TeachersComp210Group