CS164: General Instructions for Handing In Homework and Projects

To hand in your solutions for a assignment named, say hwk, simply place a copy of all the files called for in the assignment in a subdirectory of your personal Subversion repository named tags/hwk-i. Choose i to make the tag name unique amongst your tags. To hand in a project named, say projk, place a copy of all the files in a repository directory named tags/projk-i in your team's repository (not your individual repository). In both cases, you've only succeeded in handing things in if you have committed all the necessary files into this tag repository (just copying things into a working directory has no effect on the repository).

The official best way to perform this copy is to do all your work in a trunk or branch directory, commit it there, and then copy the directory to your tags directory. Let's assume your personal login is LOGIN and your team name is TEAM. Let's also assume you use a local directory named "work" to hold your assignments. Usually, you'll start an assignment by copying a bunch of skeleton files we supply.

• To set up your local working directory the first time (do this once):

  cd
  svn co svn+ssh://cs164-ta@quasar.cs.berkeley.edu/LOGIN/trunk work
  

  This creates a directory named work and inserts some metadata that Subversion uses.
• To start an assignment "hwx" using our files:

  cd ~/work
  svn copy svn+ssh://cs164-ta@quasar.cs.berkeley.edu/staff/hwx hwx
  svn commit hwx -m "Create hwx directory from staff template."
  

  This creates a new hwx working directory for you and initializes it with our files.
• To save your work on hwx without submitting it (do this often):

  cd ~/work/hwx
  svn commit
  

  (You'll be asked to provide a log message. Be sure to do so.)
• To submit hwx, first be sure your work is all there and committed. Type

  cd ~/work/hwx
  svn status
  

  This will type out files and directories that you have modified, deleted, or added and not yet committed, and also files and directories that are not under version control (marked ?). Make sure that none of the ? files are ones you should be submitting! If they are, do an "svn add" on them first. Now commit your working directory. Finally, do the submission like this:

   
  svn copy svn+ssh://cs164-ta@quasar.cs.berkeley.edu/LOGIN/{trunk/hwx,tags/hwx-i} \
      -m "Submission #i of hwx"
  

  where the number i is as described above. This is actually Unix shorthand for

  svn copy svn+ssh://cs164-ta@quasar.cs.berkeley.edu/LOGIN/trunk/hwx \
           svn+ssh://cs164-ta@quasar.cs.berkeley.edu/LOGIN/tags/hwx-i \
      -m "Submission #i of hwx"
  

• To see what submissions you have made:

  svn ls svn+ssh://cs164-ta@quasar.cs.berkeley.edu/LOGIN/tags
  

• To see what files you submitted for hwx:

  svn ls -R svn+ssh://cs164-ta@quasar.cs.berkeley.edu/LOGIN/tags/hwx
  

• Finally, you can always check to see exactly what you submitted by checking out the appropriate tag (svn co).

Submitting projects is essentially the same, except that you should set up a different working directory (say teamwork or projects instead of work) and use TEAM in place of LOGIN. I suggest that you keep the working directory you use for homework separate from the one you use for projects.

You are responsible for making sure you have submitted what you are supposed. As described above, Subversion gives you everything you need to do so. We won't accept "the computer ate my homework" around here.