Eclipse

outdoor patio furniture cushions av elf costumes letter designs ugg chanel replica watch air line tickets stock quotes birmingham midshires bottega veneta bags philippine online radio station sex love motorcycle helmets powerball keflex information porn star gay free directv amityville horror house free nude pic prudential realty side effects of plavix anonymous proxy server elgin watches download spybot osullivan office furniture sports yahoo migraine videosex levitra german sheppard puppies windows vista grants skin motorola v3 mexico pharmacy orange wanadoo free adult friend finder bmx bikes garden gazebos cheapest plane tickets fibromyalgia female piercing american roulette business plan oldwomansex wheel adapters cooking homes for sale by owner chevy colorado norvasc side effects ampicillin oak kitchen tables pokemon card decathlon sports store anal sex with my wife alaska airline flight revocable living trust diabetic diets formal evening dress airlinetickets terminal servers ako web mail penis size nokia free ringtone online xanax sex indian mature asian porno airline travel and pregnancy verizon ringtones tractor supply worldwide travel agency tmobile cellular phone tattoo artist salary chromium plavix side effect simba musical instruments audi part headache bag pattern lesbians kissing medical transcription free casino sass and bide jeans mature moms body building woman photo clarithromycin order xanax drivers license fotos porno short homecoming dresses mackenzie rosman ephedra danger best rated anti virus software free ringtones suncom libra horoscope free property title search cheap printer sexy single woman does viagra work antique reproduction hardware bdsm video matrix rpg online diaper punishment brand name meridia world times julie ann clark true dirty stories porno gratis videos gay cook islands dogfart interracial sex selling innocence locksmith tools myspace codes wet underwear la blue girl movies wood fences nicetits underground storage tank regulation long fingernails bukkake party debt reduction tips zucchini recipes adult video store for sale species guitartabs pto organization swap bi couples sybian machine video katie holmes nude appreciate your consideration work from home websites boogers blackpool sexy icons dress shoes sexy images affordable term life insurance mini golf orlando long beach city college los ojos verde residential garage doors curling new jersey home addition staffing software karen dreams animexxx naked showering women videos jayde indian babe naked lady electric bicycles magic bullet barley legal pussy make a music playlist for myspace submersed nude body free screen savers german english dictionary spandex boys syphilis celestial adult web site business opportunity shrek 3 class c motorhome for sale mexico map guys sucking cock asian hookers canning salsa breast kissing sexy swimsuit models hollar back girl los lonely boys bible prophecy young boys sex gaping love holes mazda rx8 for sale real amateur sex beautiful nude latinas kerrie marie interracial gangbang position nissan off road accessories cancer prevention architectural columns goldeneye earn a degree from home download cellular ringtones sex trade gay man wife in birthday suit pink word taylor hayes gallery bible lessons miniature dachshunds rebuilt transmissions pedigree personal assistant laura ingram order cyclobenzaprine canadian car insurance spanish anal beautiful brazilian women

Jmol/JSmol Development

• Getting Involved in J(S)mol evolution
• Release Procedures
• Important! Use the Jmol Coding Style
• Developing J(S)mol with Eclipse
• Internationalisation (status)
• ProgrammeerZomer / SummerOfCode
• MultiUser Jmol
• Developer mailing list (mirror)

To implement new features in Jmol (or simply build yourself a version of Jmol), you can use many development tools. One of them is Eclipse.

If you don't already have a suitable development environment for Jmol, then Eclipse is probably the best choice:

• it's easy to install and is bundled with several tools required for Jmol.
• it's a powerful IDE.
• Jmol is already configured as an Eclipse project.

The following description has been tested under Windows, but it should work also for other OS (Linux, Mac OS X, ...).

Prerequisites

The following tools must be already installed for Jmol:

• Java: Java 2 SDK 1.4, Java 5 SDK 1.5, or a later release.
• Eclipse: version 3.1 or a later release.
• Subclipse, a Subversion (SVN) plugin for Eclipse.

SVN Repository Configuration

To configure Eclipse to access Jmol's SVN repository, do the following:

• Launch Eclipse.
• Using the menu system at the top of the application, navigate to Window → Open Perspective → Other... and choose SVN Repository Exploring. Then click on the OK button.
• Then right click in the SVN Repository window and select New → Repository Location... in the contextual menu.
• In the Add SVN Repository window, enter the value https://jmol.svn.sourceforge.net/svnroot/jmol in the Url field.
• Click on the Finish button and you are done.

Checking out Jmol from SVN

To check out Jmol from SVN, do the following:

• Switch to the SVN Repository Exploring perspective using Window → Open Perspective → Other... and choose SVN Repository Exploring. Click on the OK button.
• Expand the repository location you added in the previous section, you should see branches, tag and trunk after a few seconds.
• Expand trunk, you should see amongst other things the Jmol projects:
  • Jmol is the source code of the Jmol Application and Applet.
  • Jmol-datafiles is a collection of datafiles used for testing Jmol.
  • Jmol-documentation is a collection of Jmol documentation.
  • Jmol-web is the source of the Jmol website.
• Right click on Jmol and select Checkout... in the contextual menu.
• In the Checkout from SVN window, select Check out as a project in the workspace and use Jmol as Project Name. Then click on the Finish button.
• If you want, you can also check-out Jmol-datafiles:
  • Right click on Jmol-datafiles and select Checkout... in the contextual menu.
  • In the Checkout from SVN window, select Check out as a project in the workspace and use Jmol-datafiles as Project Name. Then click on the Finish button.
• If you want, you can also check-out Jmol-documentation:
  • Right click on Jmol-documentation and select Checkout... in the contextual menu.
  • In the Checkout from SVN window, select Check out as a project in the workspace and use Jmol-documentation as Project Name. Then click on the Finish button.
• If you want, you can also check-out Jmol-web:
  • Right click on Jmol-web and select Checkout... in the contextual menu.
  • In the Checkout from SVN window, select Check out as a project in the workspace and use Jmol-web as Project Name. Then click on the Finish button.

Note: There was a bug somewhere in the SVN chain (we don't know if the problem is in Subclipse, Eclipse or Sourceforge), so you may get an error during the check-out. Apparently, it has been fixed with more recent versions of the tools, but if it happens to you, you can fix the problem by doing the following:

• Switch to the Java perspective using Window → Open Perspective → Other... and choose Java (default). Click on the OK button.
• In the Package Explorer window, left click on the small triangle at the top right of the window and select Filters.... Uncheck the .* resources item and click on the OK button.
• Expand the project which had a problem.
• If the .project file has not been checked-out (no version information after the filename), delete it by selecting it and pressing the Suppr key.
• Right click on the project and select Team → Update in the contextual menu.

Configuring Eclipse to build Jmol

To configure Eclipse to build Jmol, you need to make sure that:

1. the location of the Java executables (javac.exe and jarsigner.exe) is identified.
2. the location of the Java library (tools.jar) is identified.
3. Eclipse is using the same version of the Java compiler as the Java Runtime Environment.

Identifying the location of the Java executables (Unnecessary in Mac OS X)

Ant needs to know where to find javac(.exe) and jarsigner(.exe). This simply requires adding the Java SDK bin directory to the PATH environment variable.

To do this on Windows, you need to open the Windows Control Panel, then double-click the System icon (which may be under category Performance). On the Advanced tab, select Environment variables. Scroll down to the path system variable and append to it a semicolon (;) followed by the path to the Java SDK binaries, something like ";C:\j2sdk1.4.2_10\bin".

Identifying the location of the Java library (Unnecessary in Mac OS X)

Ant needs to know where to find tools.jar.

From Window → Preferences...: in the Preferences window, go to Ant → Runtime and select Global Entries and click on the Add External JARs button. Navigate to the directory containing tools.jar (probably something like C:\j2sdk1.4.2_10\lib), select tools.jar and click on OK.

Matching the Java compiler to the Java Runtime Environment

From Window → Preferences..., select Java. Compare the version listed for the compiler with that for the selected installed JREs. If they are not the same, use the Search facility to find more installed JREs. Then select the JRE that matches the compiler.

Installing and configuring gettext tools

If you want to use Jmol in an other language than English, you will need to install the gettext tools.

Download and install gettext. Linux users should try to install it using their distributions package management (like rpm, dpkg, apt, ...). Windows user download gettext from GnuWin32. Both make sure, that the gettext binaries are in your PATH environment variable.

Note for Windows users: If you installed the gettext binaries into e.g. C:\Program Files\GnuWin32, then you need to add C:\Program Files\GnuWin32\bin; to the existing PATH environment variable: Control Panel → System → Environment Variable (Tab Extended) OR run the following command in a windows command shell (this command is not permanent, you need to do it each time):

set PATH=%PATH%;C:\Program Files\GnuWin32\bin;.

Windows XP and Windows 2000 are currently supported.

Running and Debugging Jmol

You can run and debug Jmol directly within Eclipse.

Open a Java Perspective using Window → Open Perspective → Other... and there select Java (default).

To run either the application or the applet, right click on Jmol under the Projects tab and select (for the applet) Run As → Java Applet or (for the application) Run As → Java Application. The main class for the application is org.openscience.jmol.app.Jmol.

Building Jmol

If not already done, open a Java Perspective using Window → Open Perspective → Other... and there select Java (default).

To make a full build of Jmol under Eclipse, just do the following:

• Find build.xml in the Package Explorer window and right click on it.
• Then select Run As → Ant Build in the contextual menu.
• If the build fails, look carefully at the message, and if you can't figure it out, send a copy of it in email message to jmol-developers@lists.sourceforge.net. Problems might include Ant not being able to find the Java compiler ("JAVA_HOME not in CLASSPATH?") or a difference in Java compiler and runtime environment versions ("class file has wrong version 49.0, should be 48.0").

Contributors

NicolasVervelle, Pimpim, AngelHerraez, Hansonr, Gutow