University of California at Berkeley
           Department of Electrical Engineering & Computer Sciences
                         Instructional Support Group


/share/b/pub/eclipse.help
								Feb 1 2010

CONTENTS
	Eclipse 
	PyDev and the PyDev Extensions
	MuClipse
	Junit
	Troubleshooting

Eclipse 
-------
  Eclipse (http://eclipse.org) is a suite of Java development tools.

  Eclipse is installed in /usr/sww/bin/eclipse on the EECS Instructional 
  SPARC and x86 systems.   For a current list of computers, please see
  http://inst.eecs.berkeley.edu/~inst/iesglabs.html
  
  To run it, type

    eclipse

  Eclipse requires that you have an XWindows manager running on your local
  computer.  See http://inst.eecs.berkeley.edu/connecting.html#xwindows
  for information about using XWindows.

  The Eclipse Project (Platform, Java tools, Plug-in) was installed under 
  ~cs164 in Fall 2003.  It ran on the Instructional UNIX SPARC systems.
  To run it, students typed

    set path = (/usr/sww/lang/java/bin $path)
    ~cs164/bin/eclipse

  Please see http://eclipse.org for help.
  For some on-line tutorials, see the links at the bottom of
  http://eclipse.org/community/


PyDev and the PyDev Extensions
------------------------------

  PyDev (http://pydev.sourceforge.net/) and the PyDev Extensions 
  (http://www.fabioz.com/pydev/) are installed in /usr/sww/pkg/eclipse/plugins.
  These plugins provide make Ecplise an IDE for Python.   A 1-year license for
  the Berkeley site was purchased in Fall 2007 by Prof Klein.

MuClipse
--------

  MuClipse (http://muclipse.sourceforge.net/) is an Eclipse Plugin which 
  provides a bridge between the existing MuJava mutation engine and the 
  Eclipse IDE.  It is installed into the Eclipse instllation on sww on our 
  Solaris x86 and Solaris SPARC computers.  For the computer names, see
  http://inst.eecs.berkeley.edu/~inst/iesglabs.html.

Junit
-----

  JUnit (http://www.junit.org/) is a unit testing framework for the Java.
  It is installed as an Eclipse plugin.   For more information, please see 
  http://inst.eecs.berkeley.edu/cgi-bin/pub.cgi?file=junit.help#3 .
  
 
Troubleshooting
---------------
  If you get an error such as 

	Could not connect to:  : 2910
	java.net.ConnectException: Connection refused: connect

  it may be have one of these causes:

  1) Maybe something is already running that is using port 2910.  It would 
     probably be your application or Eclipse itself.  This could have 
     started after a code change that prevented a clean termination of 
     your app.  List all processes and kill any that should not be there.  
     (Or reboot the computer).

  2) The contents of your .eclipse directory may have become corrupted.  
     The directory can be deleted; it will be re-created when Eclipse is 
     re-started.

  Other errors may be corrected by deleting a lock file or the entire
  'configuration' sub-directory, which will be re-created when you start 
  Eclipse again:

	rm -i  ~/workspace/.metadata/.lock
	rm -ri ~/.eclipse/org.eclipse.platform*/configuration

  (Aug 2008) Here is a script that removes Eclipse lock and configuration 
  files from your directory: 	~cs61b/fixes/remove.eclipse-files


   					EECS Instructional Support 
   					378/384/386 Cory Hall, 333 Soda Hall
   					inst@eecs.berkeley.edu