Restricting Files Students Can Submit
-------------------------------------

We strongly recommend instructors use the feature of gsubmit that
restricts what files students can submit.  (Note: it works on CSA,
but older versions of gsubmit on other machines may not enforce this
feature.)

All you need to do to take advantage of this is to create a
"submittable" directory under your homework directory (e.g., under
/cs/course/cs111/current/homework).

Then, just create files and directories representing what students
should submit.  For example, suppose you want students only to submit
files named "prob1.cpp" and "prob2.cpp" in a directory named "hw1".
Then, under the "submittable" directory, create a directory named
"hw1".  In that directory "hw1", create 2 files "prob1.cpp" and
"prob2.cpp" (doesn't matter what is in them).

Then, if a student tries to submit something not listed, like "HWA",
gsubmit will complain and list all the files they can actually submit:

% gsubmit cs111 HWA
Path ./HWA is not submittable.
Submittable files:
    hw1/
        prob1.cpp
        prob2.cpp

You can do this for each homework.

Note:
----
Submission may fail if the submitted directory contains any incorrect
files.  For example, suppose that the "hw1" directory mentioned above
also had a "prob1.cpp~" file (an Emacs backup).  When the person tries
to submit "hw1", gsubmit will stop when it sees "prob1.cpp~".

The implication is that when a directory contains incorrect files, some
of the correct ones may get submitted and some of them may not, it just
depends on in what order gsubmit goes through those files.

Bottom line: Don't include incorrect files in the directory.