Note : This instructions are very important. You will lose a lot of marks if the instructions are not followed. Ensure you follow these instructions for EVERY assignment.

1. Directory Names:  For each assignment, create a new directory and store all files relating to the assignment  in that  directory.  The name of the directory should  have the pattern "<your_last_name><assignment_number>". For example the directory for first assignment written by John Smith would be called "smith1". Note that  you must use all small letters in creating this directory.  This directory should contain no files other than those that relate to the assignment.

Note: In the points below, I will be using John Smith as an example. You must use your last name and replace the name "smith1".

2. File Names: The source file each assignment should be named by using the word "assignment" followed by the number for the assignment. For example, the source file for first assignment  should be called  "assignment1.java". Ensure that the class containing the "main()" method, is called "MainClass" and is in the file "assignment1.java". Later, you will have several files that constitute an assignment. Even then,  you should call the class that contains the "main" method, the "MainClass" and the file that contains the "MainClass" as "assignment<number>.java".

3. Readme file: You should create a file called "README" (text file) , containing instructions to the grader on how to run your program.  It is important that the instructions you provide work correctly. For example, for the first assignment you will provide the following instructions in your "README " file :

javac  assignment1.java
java MainClass
 

4. If you did everything mentioned in 1, 2 and 3 above, you should have the files  "README" and "assignment1.java" in the directory "smith1".  You will also need the "ReadUtility.java"  file in the "smith1" directory.  Now you are ready to ship the first assignment to me.

5. Creating tar file: All assignements must be sent as a single file. No mutiple files will be accepted. To create a single file that contains all the files relating to an assignment, you should create a "tar" file of the directory "smith1".   The name of tar file should again  have the pattern "<your_last_name>_assignment<assignment_number>.tar". Use  the following command from the parent directory of  "smith1". (In order to check if you are in the parent  directory  of  "smith1", issue the command "ls". You should see "smith1" in the listing.  "ls")

      %tar     cvf      smith_assignment1.tar     smith1

This command creates a file called "smith_assignement1.tar", which contains all the files in "smith1". Note that there is a space between all of the words above: "tar", "cvf",   "smith_assignment1.tar" and "smith1". The "%" is the prompt by the system and is not to be typed by you.

6. Submission: In order to submit an assignment you need to mail the tar file before the midnight deadline of the due date and give paper copies the following class period. The paper c

7. Mailing the tar file: Now mail the "smith_assignment1.tar" file to the  userid  "skanchi" You may do this using any the mailers that you are familiar with. Send the file as an attachment. Your mail must contain the Subject heading
cs101: assignment#, all small letters and must contain the assignment number.

8. Hard-copy Submission:  Submit a hard copy of all the source files  and README file, and also a copy of the sample  run. Generally the sample input is available along with your assignment.
Make sure you also show several sample runs to demonstrate that the program works.

To  capture the interation at the terminal  to a file,  use the command

  %script tt

This will capture the terminal interaction into a file named "tt" until you type <CTRL-D>. You can then print the file "tt".
 

9. Verifying   your  submission: You must send a copy of the above mail to yourself (by using the Cc facility in the mail tool) to ensure that your submission reached correctly.  You must keep this email in your mail buffer until the assignment is graded.

10. Checking if your tar file works correctly: In order to check if your file was created and submitted correctly execute the following steps.

Open the mail tool and save the "smith_assignment1.tar" in your home directory.  Issue the following command

%tar   xvf   smith_assignment1.tar

 (this is the command that extracts the files from the "tar" file. At this point you should see that "smith1" directory has been  created and all the assignment related files are inside "smith1").

%cd smith1

%ls

(you should see all the files related to your assignment)

%javac assignment1.java

(your program should compile successfully)

%java MainClass

(your program should run successfully)
 

If your checking fails in any of the above steps, this means that your file is NOT sent properly. You must re-submit the assignment before the deadline.  Note that if any of the above instructions are not followed properly you will receive zero points for the assignment.