Introduction

You will be submitting your labs for this course using the department's SVN server. SVN is a professional version control system, you can learn more about it on the SVN Project Homepage if you are interested. It is possible to interact with SVN using a variety of tools including command line instructions and specialized applications. For this class you will interact with SVN using the Subclipse plugin for the Eclipse development environment. Below are instructions relevant to using Subclipse for this course. You can find a wealth of additional information about Subclipse on the Subclipse Project Homepage.

Installing Subclipse

The following steps are required to install Subclipse for use from your lab account:

1. Start Eclipse
2. Choose Help / Software Updates / Find and Install...
3. Select "Search for New Features"
4. Click "Next"
5. Click "New Remote Site" and add a new remote site with:

   Name: Subclipse

   URL: http://subclipse.tigris.org/update_1.2.x

6. Click "finish"
7. In the "Search Results" dialog box
   1. Expand the "Subclipse" option
   2. Check the box for "Subclipse"
   3. Make sure the the box for "Integrations" is not checked
8. Click "Next"
9. Select "Subclipse 1.2.4" and check the box to accept the license terms.
10. An error dialog will appear... click "Ok"
11. Change the location at which to install Subclipse
    Set it to be installed in a directory named Eclipse within the Library directory in your home directory. Note: You will need to create the Eclipse directory.
12. Click "Install All" option in the "Verification Dialog"
13. Restart Eclipse when given the option.

Connecting Subclipse to SVN

Before you can use Subclipse to interact with the department's svn server you will need to tell Subclipse about our SVN Repository. To do this:

1. Choose Window / Open Perspective / Other
2. Pick "SVN Repository Exploring"
3. Right click in the "SVN Repository Panel" that appears and choose New / Repository Location from the popup menu.
4. Create a new repository with the URL: svn://turing.dickinson.edu/CompSci
5. Enter the username and password that you have been given. You will only have to enter this information once.
6. You should now see a list of the directories that exist in the SVN repository.
7. Verify that the "COMP232" folder for the current semester contains a folder with your username.

Getting Started

Before starting your first lab, you will need to setup an Eclipse project for this course and import it into the SVN server. Once your project is in the SVN server it will be easy for you to submit your new code for each lab and to receive feedback.

To setup a project for this course:

1. Change to the "Java Perspective"
   1. Click on the >> icon in the upper right corner of the Eclipse window.
   2. Choose "Java"
2. Choose File / New / Project
3. Select the "Java Project" wizard
4. Click "Next"
5. Name your project COMP232
   Use the following options for everything else in this dialog:
   • "Create project in workspace"
   • Use default JRE
   • Use separate source and output folders
6. Click the "Libraries" tab in the dialog that appears
7. Click "Add Library"
8. Select "JUnit"
9. Set the version to "JUnit 4"
10. Click "Finish"
11. Click "Finish" again
12. In the Package Explorer, right click the new project and choose Team / Share Project... from the popup menu.
13. Choose "SVN" in the dialog
14. Click "Next"
15. Select "Use existing repository location
16. Click "Next"
17. Select "Use specified folder name"
18. Click "Browse" and select your folder on the SVN server.
19. Change "New Folder" at the end of the URL to be "COMP232"
20. Click "Finish"
21. Click "Select All"
22. Click "OK"
    After the operation completes, change to the "SVN Repository Browsing" perspective. Right click your SVN folder and choose "Refresh". Then verify that the project is now contained in your SVN directory.

Submitting Assignments

For each assignment you will be given a package name. All of the code for that assignment must be contained in the specified package within your COMP232 project.

To submit your code for an assignment:

1. Right click on the package for the assignment in the "Package Explorer" tab in the "Java" perspective.
2. Choose Team / Commit...
3. Click "Select All"
4. Click "OK"
   You can verify that your code was committed to the SVN repository by changing to the "SVN Repository Exploring" perspective and examining the contents of your directory on the SVN server.

Viewing Feedback

To provide feedback on your assignments I will check your code out from the SVN server, add comments to it and then commit the code with my comments back to the SVN server. You may then update your local copy from the server to see my comments.

To update your local copy of an assignment to see my comments:

1. Right click on the package for the assignment and choose "Update"
2. Opening the files in the package for the assignment will now show you the version containing my comments. Each of my comments will be prefaced with the string "GWB". You can use the "Search" feature of Eclipse to easily find all of my comments.