To compile and run the COMP-202 Music Player using DrJava:
  - Extract the contents of a5-full-lib.zip in a directory on your hard drive.
    This will create two new subdirectories in that directory; one will be
    called a5-full-code and the other will be called a5-full-licenses.
  - With DrJava, open the file called COMP202MusicPlayer.java, located in
    directory a5-full-code. Compile it. Compilation should generate three
    warnings; ignore them. Do not run the file (running the file within DrJava
    will display the user interface, for some reason, you may not be able to
    play the music).
  - With DrJava, open the file called COMP202MusicPlayerInstaller.java, also
    located in directory a5-full-code. Compile it and run it.
  - Using your file manager (My Documents / Windows Explorer if you are running
    Windows, Finder under Mac OS X), navigate to the folder where you extracted
    a5-full-lib, and go into the a5-full-code folder. After running
    COMP202MusicPlayerInterface, there should be a small script file in this
    folder (under Windows, it will be called comp202musicplayer.bat; under Mac
    OS X, it will be called comp202musicplayer); double-click on it to start the
    program.
  - Play and enjoy your music!
  - Brag!
    
To compile and run the COMP-202 Music Player using Eclipse:
  - Extract the contents of a5-full-lib.zip in a directory on your hard drive.
    This will create two new subdirectories in that directory; one will be
    called a5-full-code and the other will be called a5-full-licenses.
  - Create a new project under Eclipse.
  - Import every .java file in a5-full-code, as well as the comp202 folder
    inside a5-full-code, into your new project.
  - Add every .jar file inside the lib folder located in a5-full-code to your
    project as an external JAR.
  - Run COMP202MusicPlayer.java normally.
  
To run the COMP-202 Music Player using your Playlist.java and
MusicCollection.java files:
  - Replace the Playlist.java and MusicCollection.java files in a5-full-code by
    your files.
  - Compile and run using your chosen environment, as explained above.
    
The COMP-202 Music Player has been tested and is known to work under Windows XP
(using Java 6), Mac OS X 10.5 - Leopard (using Java 5), and Ubuntu 7.04 - Feisty
Fawn (using Java 6).

Notes:
- The COMP-202 Music Player may not be able to play music if you have another
  application running currently playing sound. If this other application is
  another music player, you need to stop playback in this other application
  (closing the application is usually not necessary, but simply putting the
  other player on pause is not sufficient) before starting playback using the
  COMP-202 Music Player.

License notes:
- The COMP-202 Music Player code is licensed to you under the GNU Lesser General
  Public license. A copy of the license is included in a5-full-licenses. In a
  nutshell, the terms of the license allow you to: use the program for any
  purpose, on any number of computers; view, study, and modify the source code
  as much as you want; and to redistribute the program as much as you want.
  There are, however, two small conditions / restrictions:
  1. If you redistribute the program (modified or not), you must
     - include an offer to make the source code of the program available to the
       person who receives the program.
     - redistribute the program under the GNU Lesser General Public license.
     If you write a program that uses (calls) any part of the COMP-202 Music
     Player, these conditions do not apply to the code that you write, but they
     still apply to the COMP-202 Music Player code.
  2. You cannot sue the author of the COMP-202 Music Player if something goes
     wrong (this should not happen, but there are no guarantees).
  Read the license for the full details.
- Libraries used by the COMP-202 Music Player are distributed under various
  licenses. read the appropriate licenses for full details.