PLI Assignment 1 Assessment and Submission

Assessment

Assessment of Assignment 1 will be based on functionality, implementation, documentation, overall quality, and submission as indicated in the specification and below.

Submission

Please read the following instructions carefully. Marks will be deducted if the following instructions are not followed exactly.

• The due date for submission is 4pm on Monday 23 April 2007. Late submissions will not be accepted, except for medical or other similar reasons.
• Your solution must be stored in a single directory (subdirectories within this directory are OK).
• Your solution must be constructible using a makefile on host dwarf.ict.griffith.edu.au and must run on this host. Check early that you are able to do this.
• Your directory must contain all relevant files.
• Relevant files include all documentation files, header files, source files, lex and yacc specification files, test data files, etc. Use logical and consistent file names.
• The documentation must be provided as a PDF file called documentation.pdf or as an HTML file called documentation.html, in this directory. Microsoft Word files will not be accepted. Try to ensure that any PDF files are of a reasonable size!
• Include a makefile to construct an executable parser from your specifications and source files, and to clean your directory. More specifically, the makefile must enable at least the following options:
  • $ make
    Process your specifications, compile your source files, and create an executable file called jmc.
  • $ make clean
    Remove all executable, object and other temporary files from the directory.
• Your directory must not contain any irrelevant files. I.e., do a "make clean" before submission.
• Once you have your submission the way you want it (or you have run out of time), leave it alone. We will read your submission and archive it.
• Submit your solution by creating a tarball and emailing it as an attachment to me, at the address below. Suppose, e.g., your solution is in directory ~/pli/submission1/. Create the tarball as follows:

  $ cd ~/pli/submission1/
  $ cd ..
  $ tar czf s1234567.tgz submission1
  

  (Here, s1234567 is your student id.) This should create a tarball called s1234567.tgz in the directory ~/pli/, i.e., in the directory above the submission directory.
• You can view the contents of your tarball with the following command:

  $ tar tzf s1234567.tgz
  

• Ensure that your tarball does not contain executable, object, or other temporary files.
• Check, in some temporary directory, not your submission directory, that you can untar the tarball with a command:

  $ tar xzf s1234567.tgz
  

• After you've done all this, email r.topor@griffith.edu.au a short message with subject line exactly as follows (for my email filter):

  PLI Assignment 1 Submission

  The body of this message should contain the following items, each on a separate line:

  • Your name.
  • Your student number.
  • Any variations from the above submission instructions. (There should not be any).
  • The tarball created above as an attachment.