Set up the Eclipse ptII project .classpath for Ptolemy II

1. In the Ptolemy II source tree, copy .classpath.default to .classpath. This choice is the simpler choice, but might exclude optional third party packages.
2. Run ./configure. This choice is more complex, but this choice will include optional third party software that is already installed on your machine.

1. Choose one of the options below

   A. Copy .classpath to .classpath.default

   • Unfortunately, by default the Mac OS X Finder hides files whose names begin with a period, such as .classpath, so we use the Terminal application.
     1. Start up the Terminal application, which may be found as Applications -> Utilities -> Terminal.app
     2. In the Terminal, change to the directory where the Ptolemy II source code was installed.
        • If you downloaded the source code via the Mac OS X installer or the source tar file (see Eclipse is unaware of the version control aspects of the project), then your source could would be at /Applications/Ptolemy/ptII8.1.devel.
        • If you downloaded the source code via Subversion, then the source could be inside the Eclipse workspace, which defaults to ~/Documents/workspace/ptII/
        Assuming that the source was downloaded via the Mac OS X installer or the source tar file:

        		  cd /Applications/Ptolemy/ptII8.1.devel
        		

     3. Copy the files:

        		  cp .classpath.default .classpath
        		

   OR

   B. Run ./configure

   Ptolemy II includes a number of packages that rely on software that you may or may not have installed, such as MATLAB, the rxtx package (for serial port connections), Java Advanced Imaging (JAI), the Java Media Framework (JMF), and Java 3D. If you wish to use or extend these features, you will need to perform a few extra steps. These steps require execution of a script called configure in the Ptolemy II home directory.

   The procedure below will modify the .classpath file that is provided in the version control repository to customize it for the software that you have installed.

   Using the Terminal to run ./configure

   1. Start up the Terminal application, which may be found as Applications -> Utilities -> Terminal.app
   2. In the Terminal, change to the directory where the Ptolemy II source code was installed. For example:

      	      cd /Applications/Ptolemy/ptII8.1.devel
      	    

   3. Set $PTII to the location of the source tree:

      	      export PTII=`pwd`  
      	    

   4. Optional: The PTII environment variable needs to be set each time you run configure To make this setting available after reboot, edit ~/.bashrc file and add the command so that you do not need to enter it each time. For example, if your workspace was in /Users/MrPtolemy/Documents/workspacePt, then edit ~/.bashrc and add:

      	      export PTII=/Users/MrPtolemy/Documents/workspacePt
      	    

   5. Make configure executable.

      	      chmod a+x configure
      	    

   6. Run ./configure

      	      ./configure
                  

2. Choose one of the choices above.
3. Once you have configured .classpath, go back to Eclipse and do File | Refresh so that Eclipse gets the updated .classpath file.
4. Build Ptolemy II by doing Project | Build All.
   Note that you may want to select Project | Build Automatically..
5. Go on to Running Ptolemy II.