csx070 Intro to Game Programming
Procedures for Submitting Computer (done, tested on computer) Homework

Any time only a date is given for a computer assignment due time,
that means up to midnight that day (this time zone) is considered on time.

Here is how to send in computer files for an assignment:
[NOTE: it is a GOOD POLICY to always include a README file that
 explains the mapping between the parts of the assignment and your files.
 Sure, it is obvious to you, but is it clear to us?]
If there are no directions in the assignment for naming files,
it will help if you will observe the following naming convention,
so long as it is reasonable:
The files of proj1, part [A] can be named proj1a
Whenever filename extensions are used to identify the filetypes
(.c, .o, etc.); please retain these.

When setting up SDL and SDL components, place the library files in lib 
directory and the include files in the include\SDL directory. Thus, when 
you want to include a SDL header file, your include statement in your 
code would look like the following: #include <SDL/filename>, where 
filename is the name of the header file (e.g. SDL_TTF.h).

1. When you start your assignment, create a new directory called projN,
  where N is the number of the assignment (i.e., for project 4, N=4). Now,
  you will open Dev-C++ and click on File->New->Project. Click Empty Project,
  type projN for the name of the project, and click OK. Now Dev-C++ will
  ask you where you wish to create your new project. You should select the
  folder that you create (i.e., the projN.dev file should be saved to this
  directory) and click Save.

2. Once you have the project set up, you should put any existing source and/or
  data files in the directory you created in step 1. Now, you should include
  the source files in your project. (check if there are no source files)

3. Next, we will setup access to the libraries.
  Click on Project->Project Options.
  At the top of the screen you will see tabs, click on the parameters tab.
  Type the following in the box under Compiler:

  -Dmain=SDL_main

  Type the following in the box under Linker:

  -lmingw32 -lSDLmain -lSDL

  Now click OK.

4. Now you should have a project. You should make sure that your project
  compiles before submitting and make sure you have all the relevant files
  present.  [esp. be sure your code accesses the .dll properly.]

5. Once you are ready to submit,
  you should copy your directory (projN) to atlas.
  [NOTE: the rest of this procedure may be modified by the TA's]
  [NOTE: WinSCP is very useful for this step!]
  Make sure all your files are there before proceeding. After that,
  make sure you are in the parent directory of the projN assignment and type 
  % tar -cvf projN.tar projN
  This will create a .tar file that will recreate the directory
  projN when extracted.
  (NOTE: to check the path names, you can enter
  % tar -tvf projN.tar
  If the filenames printed out have a path name that begins with "/",
  this is an absolute path name and the file is incorrect.
  If you have followed the instructions above,
  every path name will be projN/filename, none beginning with "/".)

6. Get the .tar file ready to mail by the use of "uuencode".
  This is necessary because you cannot mail .tar files directly
  since they have binary portions.  Type
  % uuencode projN.tar projN.tar >projN.uu
  This will create a file that can be mailed.
  (If there are problems with this procedure, consult the man page
  for uuencode (%man uuencode) to overcome them.)

7. Type
  % mail csx070 <projN.uu
  This will send your assignment in, with your name and the time attached.
  This method has created scratch files which you might now delete.
  Another method (one less intermediate file) is to type
  % tar -cvf projN.tar projN
  % uuencode projN.tar projN.tar | mail csx070

8. If you have second thoughts, send any corrections in, same method.
  We will score the last file received (including any deductions for late),
  assuming that (you think that) it is an improvement.

jws.