Setting up the svn
The svn is located at:
/projects/WebWare7/nlp-svn/trunk/
You can check it out on a department machine with:
svn co file:///projects/WebWare7/nlp-svn/trunk/
Or for an external machine you can use:
svn co svn+ssh://USERNAME@coco.cs.washington.edu/projects/WebWare7/nlp-svn/trunk/
Contents
Folder Hierarchy
As subversion recommends, there are three folders in the svn (projects/WebWare7/nlp-svn/): "trunk", "branch", and "tags". The above code only checks out "trunk" (which you may or may not want). "branch" is for when some projects depend on occam, and Tony develops occam++ which is not backwards-compatible. When he is done, he merges his new code into trunk and fixes the dependencies he has broken. "tags" is for when we release occam version 1.0 so we can can always check out the tag named "occam1.0" instead of trying to figure out which version number it was.
If you add a project to the svn (it'll probably be clear that it goes in the "projects" folder), link it to libraries in the top-level "libraries" folder so multiple projects can use the same library. The libraries all have symlinks that cut off the version number. You should probably use the symlink so that we can just change the binary to upgrade the library.
Installing
I have a couple of options for checking out the svn and getting the project to work with Eclipse.
SVN Command Line
Create an Eclipse workspace folder and checkout the project inside of it:
svn co svn+ssh://USERNAME@turingc.cs.washington.edu/projects/WebWare7/nlp-svn/trunk/
If you need to specify a username, put it after the "//". Then you need to open your workspace in Eclipse, select the menu item "File -> Import...", select "General -> Existing Projects into Workspace" and add the project.
Subclipse Add-on
Install subclipse (http://subclipse.tigris.org/) by following the installation instruction on their homepage. Note that if you are checking it out on a non-network machine you will need to supply credentials. On Linux, this means you need to run Eclipse from the command line and it will ask for the password there when the time comes. Otherwise it won't work (or at least, I have not figured out how to make it work).
You should be able to get the project to compile from within Eclipse but you will need to add a project that links to Occam to execute an example. You can also compile from the command line by running "ant". Tony has an excellent README and example application (Example.java) in the root directory.
Further Reading
- If you would like to read more about subversion, I found this document to be short and informative: http://www.abbeyworkshop.com/howto/misc/svn01/
- If you want more information than you need, the subversion documentation is available at: http://svnbook.red-bean.com/en/1.4/
