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

   1. In the Windows file browser, find the Ptolemy II source distribution,
      If you installed from the installer, the Ptolemy source distribution will be at c:\Ptolemy\ptII8.1.devel.
      If you downloaded Ptolemy II via Subversion, then the Ptolemy II source distribution will be at

      Windows 7:

      /Users/yourlogin/workspace/ptII

      Older versions of Windows:

      c:/Documents and Settings/yourlogin/Documents/workspace/ptII

   2. Right click on .classpath and select delete.
   3. Right click on .classpath.default, select copy.
   4. Right click on the background of the file browswer window and select paste and paste a copy of the file.
      You may need to change the file browser view from "List" to "Small Icons" so that it is possible to paste into the background.
   5. Right click on the copy, select rename and rename the file to .classpath.default.
      Windows 7 users: If you get a message "You must type a file name", then rename the file to .classpath. with a trailing dot. The "operating system" will delete the trailing dot.
      Windows XP users: Open the .classpath.default file with an editor such as Wordpad, Notepad or any other editor and then save the file as .classpath. Or, use a DOS prompt.

   Most users will choose the above option because running configure requires installing Cygwin.

   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.

   1. Unfortunately Windows does not ship with Unix shell commands like make. The workaround is to install Cygwin, see https://ptolemy.berkeley.edu/ptolemyII/ptIIlatest/cygwin.htm
   2. Start up the Cygwin Bash shell: Start | Run | Cygwin
   3. Change to the directory where the Ptolemy II source code was installed. For example:

      	      cd c:/Ptolemy/ptII8.1.devel
                  

      Note that if there are spaces in the path name to the directory where your Ptolemy installation is located, then you should use double quotes around the path:

      	      cd "c:/Documents and Settings/yourLogin/workspace/ptII"
      	  

   4. Set $PTII to the location of the Ptolemy II source tree:

      	      export PTII=c:/Ptolemy/ptII8.1.devel
      	    

      Again, if there are spaces in the path, use double quotes: export PTII="c:/Documents and Settings/yourLogin/workspace/ptII"
   5. Run:

      	      ./configure
      	    

      This will create $PTII/.classpath
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.