COMP SCI 2OO3 Object Oriented Programming - Assignments

Assignment Policy

• Assignments will be distributed in printed form in class only, but may need further downloads. Downloads can be accessed only within the mcmaster.ca domain.
• Discussions among participants of the course are expected and encouraged. However, the submitted solution must be must be based on your own work or your work with your partner. If two submissions are (partly) identical, then this is considered academic dishonesty and will be treated according to University regulations; see the Organization page about academic dishonesty. In addition, all students involved in identical submissions will get zero on all assignments.
• Requests for remarking can only be submitted two weeks after the assignment is returned. Most requests like correcting the addition of the marks can be handled by the TA. Requests for remarking by the instructor must be accompanied with a written note detailing the reason.
• All assignments must be submitted electronically using subversion. Your repository is at https://websvn.mcmaster.ca/cs2o03/username. Use your Unix username and password to log in with svn and import your files in directories assignmentX, where X is 1, 2, 3, 4, or 5. Please do not compress the files, but you can use subdirectories as you wish. You are encouraged to use the repository for backing up intermediate versions. The last version that was checked in before the due date will be taken for grading.
• Code that does not compile receives a mark of zero. Documentation that cannot be processed by javadoc receives a mark of zero. It is not the TA's job to figure out what needs to be corrected to make your submission work.

Subversion Cheat Sheet

• Checking out your repository: svn checkout https://websvn.mcmaster.ca/cs2o03/username
• Your username is your muss account name, and your password is your student number
• Adding a file/dir to your repository: svn add filename
• Removing a file/dir from your repository: svn delete filename
• Committing changes to your repository: svn commit -m "description of changes"
• Pulling changes from your repository: svn update

Assignment 1 (downloads accessible only within mcmaster.ca domain)

• Due date extended to Tuesday, 10 February, any time.
• CharacterCount.java

• Due date extended to Thursday, 26 February, any time.
• Poly.java, IntSet.java; you have to use an editor that understands Unicode, otherwise the assertions will appear as garbage.

Assignment 3

• Due: Tuesday, 10 March, any time
• For Q1:
  • Color.java, Line.java, NotImplementedException.java, Shape.java: these files are to be used as they are, i.e. should not be modified.
  • Polygon.java, Rectangle.java: these are templates, code as well as class level and method level documentation need to be added.
  • You have to generate the javdoc documentation with the command:

  • javadoc -encoding UTF-8 -tag requires:cm:"Requires:" -tag modifies:cm:"Modifies:" -tag ensures:cm:"Ensures:" -tag todo:a:"To Do:" -tag absvar:t:"Abstract Variables:" -tag absinv:t:"Abstract Invariant:" -tag concinv:t:"Concrete Invariant:" -tag absfun:t:"Abstraction Function:" -tag throws -tag see <filenames>

  • Two web pages from Sun on javadoc; note that we are not using the standard documentation tags, as Java and javadoc don't come with support for abstraction facilities; you have to use the tags as above, but these pages are still useful:
    • javadoc - The Java API Documentation Generator
    • How to Write Doc Comments for the Javadoc Tool
• For Q2:
  • Sorting.java

Assignment 4

• Due: Thursday, 26 March, any time
• all files; from the command line, cd to the docs directory and run "javadoc @docargs".

Assignment 5

• Due: Wednesday, 8 April, any time
• Bag.java; following line is to be used for JavaDoc options (one line, no line breaks):

  • -private -encoding UTF-8 -charset UTF-8 -tag requires:cm:Requires: -tag modifies:cm:Modifies: -tag ensures:cm:Ensures: -tag todo:a:To Do: -tag absvar:t:Abstract Variables: -tag absinv:t:Abstract Invariant: -tag concinv:t:Concrete Invariant: -tag absfun:t:Abstraction Function: -tag absrel:t:Abstraction Relation: -tag initially:t:Initially: -tag throws -tag see