MP3 README - ECE 190 FALL 09

MP3.1
1. Create a folder called 'mp3' and change into it. Then download mp3.1.tar from the ECE190 website. Use wget as
   Example: wget http://courses.ece.illinois.edu/ECE190/machine_problems/fall09/mp3/mp3.1.tar

2. Now unzip the files using the command 'tar -xvf [file to unzip]'
   Example: tar -xvf mp3.1.tar
   This will unzip your file to the current folder. mp3.1.c is your skeleton file for MP3.1 that you need to fill in.

3. mp3.1.gold is the gold executable provided. You may run the executable, enter different inputs and verify that your 
   program's output matches the output of the gold executable. 

4. We also provide you some input files input1.gold, input2.gold and input3.gold. The expected output for each of these input 
   test files is provided in output1.gold, output2.gold and output3.gold respectively. You may check that your output matches 
   the provided gold outputs as:
   ./mp3.1 < input1.gold > output1.test. 
   If your program works correctly, then output1.test and output1.gold should match exactly. Test using vimdiff that output1.test 
   and output1.gold match exactly as
   vimdiff output1.test output1.gold
   Repeat the above steps to test for input2.gold and input3.gold as well. 

5. The file that you handin should be named mp3.1.c ONLY. 


MP3.2

Repeat all the above steps for mp3.2.tar and mp3.2.c. 

FAQ AND HINTS FOR MP3

1. For mp3.2, the warning: "gets function is dangerous and should not be used", can be neglected. No points will be deducted for this. 

2. The header file ctype.h included in the skeleton file may contain some interesting functions. For example:
the function isalpha(c) takes in a character c, and returns a true if the character is an alphabet, a false if it is not. Another interesting 
functions may be isdigit. However, be careful to check each of these functions to verify what they do before using them.

3. The function isspace in ctype.h MAY give you a wrong answer.The MP3.1 handout requires you to count only whitespaces and tabs, however, the isspace function 
counts carriage returns ('\r') as well. 

4. What is the correct handin command?

Checkpoint 1:
handin --MP 3.1 mp3.1.c

Checkpoint 2
handin --MP 3.2 mp3.2.c

5. No string specific functions should be used in either MP3.1 or Mp3.2.