Submitting Programs

All projects must be turned in by midnight on the due date given. You are responsible for ensuring that all files are turned in on time. When you are done with your project and are confident it is satisfactory, you should submit it electronically. You may submit an assignment as many times as necessary, but only the files included in the last submission will be graded. Thus, you should always submit all your project's source files -- even if they have not changed since a previous submission.

Files to Submit

You should submit any relevant code files (.cpp and .h or .java files), documentation about your project, and a Makefile that can be easily modified to work on the CS system (see a sample Makefile). In particular, it should not contain backup files, executables, or other binary files (.o or .class files). Points may be taken off if it is hard to determine which files are necessary to build the final version of your program. To facilitate cleaning up your working directory before you submit, two commands are provided for you in place of using rm directly (which can be error prone):

make clean --- defined in your Makefile, it removes binary files and executables specific to your project
rmbak --- defined in your .alias file, it removes backup files made by xemacs and other programs

You should submit only code, text, HTML, or PDF, and possibly image files (gif or jpeg) or sound files (.au or .wav). You are free to use any programming environment available to complete your work, however, you are responsible for converting it into one of the standard formats listed above (most current programs can save or print files to a variety of alternate formats). In general, every program submitted should include documentation in addition to your source code files.

Packaging your Submission

It is suggested you do your work in a directory named project_name within your cps108 course directory. When working on large programs, possibly in multiple directories, please submit all files in a single compressed file using the unix command tar.

Below is the Unix command to create a tar file, see the tar help page for more details.

tar cvzf <project_name>.tgz <project_name>

assuming you are in the directory above project_name when invoking tar and that the directory project_name contains only files you want to submit.

Submit Command

To submit a project, type the following Unix command at your shell prompt, where project_name will typically be provided on the project page:

submit_cps108 <project_name> <project_tarfile>

You should get a message printed in your terminal window if the submit was successful. If you receive an error message when you run this command, it indicates a problem outside of your control. Please mail the professor in this case, including both the command you typed and the error message it printed. Without these two pieces of information, we cannot provide assistance. (Note, if you get an error message from your terminal, "command not found", then you will need to type out the full command name /afs/acpub/project/cps/bin/submit_cps108).

You can check the status of your submissions at any time by typing

submit_cps108 <project_name>

with no additional arguments. This should show you a list of the files you submitted and when you submitted them.

Comments?