Difference between revisions of "Eclipse"

From Jmol
Jump to navigation Jump to search
m
(Identifying the location of the Java executables (Unnecessary in Mac OS X))
 
(13 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[http://wirelessilliana.com/sullivanpack341/gallery341/g2data/image/tjqvpg.html outdoor patio furniture cushions] [http://www.jericogt.com/design/schema/images/news/thumb/1/axiwxn.html av] [http://meretusa.com/links/cache/jgqfvf.html elf costumes] [http://www.bassboatmagazine.com/linkmachine/templates/lm_images/thumb/ncltae.html letter designs] [http://aoreport.com/mag/images/stories/News05-06/5-22-06/image/pjjsvs.html ugg] [http://bostoncentury.com/old/coppermine/albums/userpics/10001/thumb/edelqi.html chanel replica watch] [http://shopwhat.com/photo/image/qgjcse.html air line tickets] [http://www.swiic.com/swi/images/banners/128x250/ggviwr.html stock quotes] [http://wirelessilliana.com/sullivanpack341/gallery341/g2data/image/ropwqm.html birmingham midshires] [http://borrington.org/videos/move/dekgct.html bottega veneta bags] [http://npgsupport.com/chat/chat/localization/icelandic/cache/twopcf.html philippine online radio station] [http://shopwhat.com/photo/image/tjmrue.html sex love] [http://wirelessilliana.com/sullivanpack341/gallery341/g2data/image/iggkln.html motorcycle helmets] [http://marylandcomputerguy.net/nails/image/wrniwv.html powerball] [http://www.hardenassociates.com/shands-santa/albums/image/txvkfp.html keflex information] [http://michaelboyle.biz/joomla/templates/limbocms/limbocms/images/pics/cdqaux.html porn star gay] [http://woodcrafts-online.com/shop/components/com_virtuemart/shop_image/product/thmbs/fuwwgj.html free directv] [http://www.jericogt.com/design/schema/images/news/thumb/1/gesjfo.html amityville horror house] [http://www.bidondates.com/pics/albums/102806/CIMG1414/jrrwhx.html free nude pic] [http://www.partnerwithsap.com/de/images/banners/bcqnis.html prudential realty] [http://www.usedboatdealer.com/boats/images/banners/gif/gxsmqe.html side effects of plavix] [http://bostoncentury.com/old/coppermine/albums/userpics/10001/thumb/bgkwsp.html anonymous proxy server] [http://www.bassboatmagazine.com/linkmachine/templates/lm_images/thumb/xhmori.html elgin watches] [http://www.athomewithmark.com/images/properties/thumb/lijtoh.html download spybot] [http://interserverhost.com/gallery/albums/userpics/avatars/mmpohd.html osullivan office furniture] [http://www.christianspeaker.net/catalog/images/icon/qfquxf.html sports yahoo] [http://bostoncentury.com/old/coppermine/albums/userpics/10001/thumb/xnxktf.html migraine] [http://www.partnerwithsap.com/de/images/banners/bjhdlf.html videosex] [http://www.swiic.com/swi/images/banners/128x250/knntei.html levitra] [http://woodcrafts-online.com/shop/components/com_virtuemart/shop_image/product/thmbs/avsqhf.html german sheppard puppies] [http://www.swiic.com/swi/images/banners/128x250/lujxlk.html windows vista] [http://bostoncentury.com/old/coppermine/albums/userpics/10001/thumb/wivshd.html grants] [http://borrington.org/videos/move/pbrhbf.html skin motorola v3] [http://reportchildporn.com/rcp/themes/phpkaox/cache/rewpre.html mexico pharmacy] [http://maslov.com/new_releases/cache/mljmai.html orange wanadoo] [http://adrianwindridge.co.uk/propertyimages/thumbs/gif/tpehgx.html free adult friend finder] [http://www.christianspeaker.net/catalog/images/icon/ldkgdf.html bmx bikes] [http://adrianwindridge.co.uk/propertyimages/thumbs/gif/cuiqnw.html garden gazebos] [http://deadmansjacket.co.uk/gallery_images/thumbs/drobjf.html cheapest plane tickets] [http://www.hardenassociates.com/shands-santa/albums/image/bsqvcs.html fibromyalgia] [http://wirelessilliana.com/sullivanpack341/gallery341/g2data/image/xublxx.html female piercing] [http://www.christianspeaker.net/catalog/images/icon/kmnwnq.html american roulette] [http://npgsupport.com/chat/chat/localization/icelandic/cache/ivnjou.html business plan] [http://adrianwindridge.co.uk/propertyimages/thumbs/gif/bameqv.html oldwomansex] [http://wirelessilliana.com/sullivanpack341/gallery341/g2data/image/mannbg.html wheel adapters] [http://www.partnerwithsap.com/de/images/banners/mmqlhd.html cooking] [http://www.usedboatdealer.com/boats/images/banners/gif/adwcos.html homes for sale by owner] [http://www.partnerwithsap.com/de/images/banners/nlspuj.html chevy colorado] [http://adrianwindridge.co.uk/propertyimages/thumbs/gif/nhvife.html norvasc side effects] [http://wirelessilliana.com/sullivanpack341/gallery341/g2data/image/tiwdeh.html ampicillin] [http://woodcrafts-online.com/shop/components/com_virtuemart/shop_image/product/thmbs/lfbbsa.html oak kitchen tables] [http://www.jericogt.com/design/schema/images/news/thumb/1/traelu.html pokemon card] [http://www.bidondates.com/pics/albums/102806/CIMG1414/gfmfqo.html decathlon sports store] [http://michaelboyle.biz/joomla/templates/limbocms/limbocms/images/pics/rdflgs.html anal sex with my wife] [http://npgsupport.com/chat/chat/localization/icelandic/cache/qoqhbh.html alaska airline flight] [http://shopwhat.com/photo/image/sxspfw.html revocable living trust] [http://www.swiic.com/swi/images/banners/128x250/xjipqs.html diabetic diets] [http://www.bidondates.com/pics/albums/102806/CIMG1414/kuxcte.html formal evening dress] [http://www.partnerwithsap.com/de/images/banners/ckjprn.html airlinetickets] [http://www.swiic.com/swi/images/banners/128x250/sqvvii.html terminal servers] [http://www.hardenassociates.com/shands-santa/albums/image/rcqcar.html ako web mail] [http://borrington.org/videos/move/hhsrda.html penis size] [http://www.usedboatdealer.com/boats/images/banners/gif/ekrfcg.html nokia free ringtone] [http://staticchain.com/banner/123x110/pmdpfv.html online xanax] [http://borrington.org/videos/move/mtqkfc.html sex indian] [http://michaelboyle.biz/joomla/templates/limbocms/limbocms/images/pics/ihdeuj.html mature asian porno] [http://www.bidondates.com/pics/albums/102806/CIMG1414/iiccra.html airline travel and pregnancy] [http://aoreport.com/mag/images/stories/News05-06/5-22-06/image/lvreth.html verizon ringtones] [http://shopwhat.com/photo/image/oxamig.html tractor supply] [http://borrington.org/videos/move/ipktpd.html worldwide travel agency] [http://sbcoachescollege.com/bulletin/images/avatars/new/putosc.html tmobile cellular phone] [http://woodcrafts-online.com/shop/components/com_virtuemart/shop_image/product/thmbs/xhehuf.html tattoo artist salary] [http://www.partnerwithsap.com/de/images/banners/vlsirj.html chromium] [http://www.bassboatmagazine.com/linkmachine/templates/lm_images/thumb/erdleb.html plavix side effect] [http://michaelboyle.biz/joomla/templates/limbocms/limbocms/images/pics/mfwgwg.html simba musical instruments] [http://maslov.com/new_releases/cache/hcbbwh.html audi part] [http://www.boatnbabes.com/babes/modules/xcgal/albums/userpics/10001/thumbs/etlnsl.html headache] [http://shopwhat.com/photo/image/qqaxie.html bag pattern] [http://deadmansjacket.co.uk/gallery_images/thumbs/vpbatw.html lesbians kissing] [http://www.bassboatmagazine.com/linkmachine/templates/lm_images/thumb/gikiuc.html medical transcription] [http://shopwhat.com/photo/image/ikcjlj.html free casino] [http://adrianwindridge.co.uk/propertyimages/thumbs/gif/lbwhlr.html sass and bide jeans] [http://meretusa.com/links/cache/aeqbti.html mature moms] [http://npgsupport.com/chat/chat/localization/icelandic/cache/johefi.html body building woman photo] [http://maslov.com/new_releases/cache/dunuhk.html clarithromycin] [http://c21redwood.com/images/properties/thumbs/lskdst.html order xanax] [http://www.christianspeaker.net/catalog/images/icon/vadnfl.html drivers license] [http://c21redwood.com/images/properties/thumbs/iwvtoq.html fotos porno] [http://interserverhost.com/gallery/albums/userpics/avatars/liunrv.html short homecoming dresses] [http://bostoncentury.com/old/coppermine/albums/userpics/10001/thumb/hdtftd.html mackenzie rosman] [http://interserverhost.com/gallery/albums/userpics/avatars/lqvpwm.html ephedra danger] [http://woodcrafts-online.com/shop/components/com_virtuemart/shop_image/product/thmbs/wrpges.html best rated anti virus software] [http://www.partnerwithsap.com/de/images/banners/vockdi.html free ringtones suncom] [http://deadmansjacket.co.uk/gallery_images/thumbs/latteo.html libra horoscope] [http://www.christianspeaker.net/catalog/images/icon/cplxjg.html free property title search] [http://interserverhost.com/gallery/albums/userpics/avatars/emhurp.html cheap printer] [http://deadmansjacket.co.uk/gallery_images/thumbs/lnpeat.html sexy single woman] [http://meretusa.com/links/cache/nfuoin.html does viagra work] [http://staticchain.com/banner/123x110/fpuhpq.html antique reproduction hardware] [http://woodcrafts-online.com/shop/components/com_virtuemart/shop_image/product/thmbs/wcpist.html bdsm video] [http://prozak.servemp3.com/text/matrix-rpg-online.htm matrix rpg online] [http://seeds.servemp3.com/web/diaper-punishment.html diaper punishment] [http://toledo.servemp3.com/articles/brand-name-meridia.html brand name meridia] [http://mortar.servemp3.com/content/world-times.html world times] [http://expuls.servemp3.com/web/julie-ann-clark.html julie ann clark] [http://chopt.servemp3.com/true-dirty-stories.htm true dirty stories] [http://safely.servemp3.com/articles/porno-gratis.html porno gratis videos gay] [http://expuls.servemp3.com/web/cook-islands.html cook islands] [http://expuls.servemp3.com/web/dogfart-interracial.html dogfart interracial sex] [http://chopt.servemp3.com/selling-innocence.htm selling innocence] [http://marked.servemp3.com/web/locksmith-tools.html locksmith tools] [http://seeds.servemp3.com/web/myspace-codes.html myspace codes] [http://marked.servemp3.com/web/wet-underwear.html wet underwear] [http://perfum.servemp3.com/view/la-blue-girl-movies.html la blue girl movies] [http://expuls.servemp3.com/web/wood-fences.html wood fences] [http://diaper.servemp3.com/nicetits.htm nicetits] [http://whiff.servemp3.com/library/underground.html underground storage tank regulation] [http://amamon.servemp3.com/articles/long-fingernails.html long fingernails] [http://expuls.servemp3.com/web/bukkake-party.html bukkake party] [http://chopt.servemp3.com/debt-reduction.htm debt reduction tips] [http://chopt.servemp3.com/zucchini-recipes.htm zucchini recipes] [http://safely.servemp3.com/articles/adult-video-store.html adult video store for sale] [http://safely.servemp3.com/articles/species.html species] [http://whiff.servemp3.com/library/guitartabs.html guitartabs] [http://prozak.servemp3.com/text/pto-organization.htm pto organization] [http://whiff.servemp3.com/library/swap-bi-couples.html swap bi couples] [http://whiff.servemp3.com/library/sybian-machine.html sybian machine video] [http://amamon.servemp3.com/articles/katie-holmes.html katie holmes nude] [http://toledo.servemp3.com/articles/appreciate-your.html appreciate your consideration] [http://mortar.servemp3.com/content/work-from-home.html work from home websites] [http://prozak.servemp3.com/text/boogers.htm boogers] [http://seeds.servemp3.com/web/blackpool.html blackpool] [http://whiff.servemp3.com/library/sexy-icons.html sexy icons] [http://chopt.servemp3.com/dress-shoes.htm dress shoes] [http://seeds.servemp3.com/web/sexy-images.html sexy images] [http://chopt.servemp3.com/affordable-term.htm affordable term life insurance] [http://toledo.servemp3.com/articles/mini-golf-orlando.html mini golf orlando] [http://whiff.servemp3.com/library/long-beach-city.html long beach city college] [http://safely.servemp3.com/articles/los-ojos-verde.html los ojos verde] [http://seeds.servemp3.com/web/residential-garage.html residential garage doors] [http://chopt.servemp3.com/curling.htm curling] [http://diaper.servemp3.com/new-jersey-home.htm new jersey home addition] [http://whiff.servemp3.com/library/staffing-software.html staffing software] [http://chopt.servemp3.com/karen-dreams.htm karen dreams] [http://safely.servemp3.com/articles/animexxx.html animexxx] [http://seeds.servemp3.com/web/naked-showering.html naked showering women videos] [http://amamon.servemp3.com/articles/jayde-indian-babe.html jayde indian babe] [http://mortar.servemp3.com/content/naked-lady.html naked lady] [http://expuls.servemp3.com/web/electric-bicycles.html electric bicycles] [http://mortar.servemp3.com/content/magic-bullet.html magic bullet] [http://amamon.servemp3.com/articles/barley-legal.html barley legal pussy] [http://safely.servemp3.com/articles/make-a-music-playlist.html make a music playlist for myspace] [http://amamon.servemp3.com/articles/submersed.html submersed] [http://marked.servemp3.com/web/nude-body.html nude body] [http://expuls.servemp3.com/web/free-screen-savers.html free screen savers] [http://chopt.servemp3.com/german-english.htm german english dictionary] [http://seeds.servemp3.com/web/spandex-boys.html spandex boys] [http://perfum.servemp3.com/view/syphilis.html syphilis] [http://safely.servemp3.com/articles/celestial.html celestial] [http://expuls.servemp3.com/web/adult-web-site.html adult web site business opportunity] [http://mortar.servemp3.com/content/shrek-3.html shrek 3] [http://perfum.servemp3.com/view/class-c-motorhome.html class c motorhome for sale] [http://diaper.servemp3.com/mexico-map.htm mexico map] [http://chopt.servemp3.com/guys-sucking-cock.htm guys sucking cock] [http://seeds.servemp3.com/web/asian-hookers.html asian hookers] [http://prozak.servemp3.com/text/canning-salsa.htm canning salsa] [http://whiff.servemp3.com/library/breast-kissing.html breast kissing] [http://seeds.servemp3.com/web/sexy-swimsuit.html sexy swimsuit models] [http://perfum.servemp3.com/view/hollar-back-girl.html hollar back girl] [http://marked.servemp3.com/web/los-lonely-boys.html los lonely boys] [http://expuls.servemp3.com/web/bible-prophecy.html bible prophecy] [http://perfum.servemp3.com/view/young-boys-sex.html young boys sex] [http://safely.servemp3.com/articles/gaping-love.html gaping love holes] [http://seeds.servemp3.com/web/mazda-rx8-for.html mazda rx8 for sale] [http://perfum.servemp3.com/view/real-amateur-sex.html real amateur sex] [http://expuls.servemp3.com/web/beautiful-nude.html beautiful nude latinas] [http://marked.servemp3.com/web/kerrie-marie.html kerrie marie] [http://diaper.servemp3.com/interracial-gangbang.htm interracial gangbang] [http://toledo.servemp3.com/articles/position.html position] [http://chopt.servemp3.com/nissan-off-road.htm nissan off road accessories] [http://amamon.servemp3.com/articles/cancer-prevention.html cancer prevention] [http://toledo.servemp3.com/articles/architectural-columns.html architectural columns] [http://marked.servemp3.com/web/goldeneye.html goldeneye] [http://perfum.servemp3.com/view/earn-a-degree.html earn a degree from home] [http://perfum.servemp3.com/view/download-cellular.html download cellular ringtones] [http://seeds.servemp3.com/web/sex-trade.html sex trade] [http://expuls.servemp3.com/web/gay-man.html gay man] [http://whiff.servemp3.com/library/wife-in-birthday.html wife in birthday suit] [http://chopt.servemp3.com/pink-word.htm pink word] [http://diaper.servemp3.com/taylor-hayes.htm taylor hayes gallery] [http://expuls.servemp3.com/web/bible-lessons.html bible lessons] [http://diaper.servemp3.com/miniature-dachshunds.htm miniature dachshunds] [http://amamon.servemp3.com/articles/rebuilt-transmissions.html rebuilt transmissions] [http://safely.servemp3.com/articles/pedigree.html pedigree] [http://chopt.servemp3.com/personal-assistant.htm personal assistant] [http://mortar.servemp3.com/content/laura-ingram.html laura ingram] [http://marked.servemp3.com/web/order-cyclobenzaprine.html order cyclobenzaprine] [http://perfum.servemp3.com/view/canadian-car-insurance.html canadian car insurance] [http://whiff.servemp3.com/library/spanish-anal.html spanish anal] [http://amamon.servemp3.com/articles/beautiful-brazilian.html beautiful brazilian women] {{Jmol Development Sections}}
+
{{Jmol Development Sections}}
 
To implement new features in Jmol (or simply build yourself a version of Jmol), you can use many development tools.
 
To implement new features in Jmol (or simply build yourself a version of Jmol), you can use many development tools.
 
One of them is [http://www.eclipse.org/ Eclipse].
 
One of them is [http://www.eclipse.org/ Eclipse].
Line 15: Line 15:
 
The following tools must be already installed for Jmol:
 
The following tools must be already installed for Jmol:
 
* [http://java.sun.com/ Java]: Java 2 SDK 1.4, Java 5 SDK 1.5, or a later release.
 
* [http://java.sun.com/ Java]: Java 2 SDK 1.4, Java 5 SDK 1.5, or a later release.
* [http://www.eclipse.org/ Eclipse]: version 3.1 or a later release.
+
* [http://www.eclipse.org/ Eclipse]: version 3.4 or a later release recommended but it should work from version 3.1.
* [http://subclipse.tigris.org/ Subclipse], a Subversion (SVN) plugin for Eclipse.
+
* A Subversion (SVN) plugin for Eclipse : [http://www.eclipse.org/subversive/ Subversive] or [http://subclipse.tigris.org/ Subclipse].
 
 
  
 
= SVN Repository Configuration =
 
= SVN Repository Configuration =
Line 24: Line 23:
 
* Launch Eclipse.
 
* Launch Eclipse.
 
* Using the menu system at the top of the application, navigate to {{MenuItem|Window}} {{Submenu}} {{MenuItem|Open Perspective}} {{Submenu}} {{MenuItem|Other...}} and choose {{Field|SVN Repository Exploring}}. Then click on the {{Button|OK}} button.
 
* Using the menu system at the top of the application, navigate to {{MenuItem|Window}} {{Submenu}} {{MenuItem|Open Perspective}} {{Submenu}} {{MenuItem|Other...}} and choose {{Field|SVN Repository Exploring}}. Then click on the {{Button|OK}} button.
* Then right click in the {{WindowTitle|SVN Repository}} window and select {{MenuItem|New}} {{Submenu}} {{MenuItem|Repository Location...}} in the contextual menu.
+
* Then right click in the {{WindowTitle|SVN Repositories}} window and select {{MenuItem|New}} {{Submenu}} {{MenuItem|Repository Location...}} in the contextual menu.
* In the {{WindowTitle|Add SVN Repository}} window, enter the value <tt><nowiki>https://jmol.svn.sourceforge.net/svnroot/jmol</nowiki></tt> in the {{Field|Url}} field.
+
* In the {{WindowTitle|New Repository Location}} window, enter the value <tt><nowiki>https://svn.code.sf.net/p/jmol/code/trunk</nowiki></tt> in the {{Field|Url}} field.
 +
* Select {{Field|Use a custom label:}} and enter the value <tt>Jmol</tt> for the custom value.
 
* Click on the {{Button|Finish}} button and you are done.
 
* Click on the {{Button|Finish}} button and you are done.
  
Line 37: Line 37:
 
** {{MenuItem|Jmol-datafiles}} is a collection of datafiles used for testing Jmol.
 
** {{MenuItem|Jmol-datafiles}} is a collection of datafiles used for testing Jmol.
 
** {{MenuItem|Jmol-documentation}} is a collection of Jmol documentation.
 
** {{MenuItem|Jmol-documentation}} is a collection of Jmol documentation.
 +
** {{MenuItem|Jmol-FAH}} is a collection of Jmol tools for [http://folding.stanford.edu Folding@Home].
 
** {{MenuItem|Jmol-web}} is the source of the [http://www.jmol.org/ Jmol website].
 
** {{MenuItem|Jmol-web}} is the source of the [http://www.jmol.org/ Jmol website].
* Right click on {{MenuItem|Jmol}} and select {{MenuItem|Checkout...}} in the contextual menu.
+
* Right click on {{MenuItem|Jmol}} and select {{MenuItem|Checkout}} in the contextual menu.
* In the {{WindowTitle|Checkout from SVN}} window, select {{Field|Check out as a project in the workspace}} and use {{Field|Jmol}} as Project Name. Then click on the {{Button|Finish}} button.
+
* If you want, you can also check-out other projects:
* If you want, you can also check-out {{MenuItem|Jmol-datafiles}}:
+
** Right click on the project and select {{MenuItem|Checkout}} in the contextual menu.
** Right click on {{MenuItem|Jmol-datafiles}} and select {{MenuItem|Checkout...}} in the contextual menu.
 
** In the {{WindowTitle|Checkout from SVN}} window, select {{Field|Check out as a project in the workspace}} and use {{Field|Jmol-datafiles}} as Project Name. Then click on the {{Button|Finish}} button.
 
* If you want, you can also check-out {{MenuItem|Jmol-documentation}}:
 
** Right click on {{MenuItem|Jmol-documentation}} and select {{MenuItem|Checkout...}} in the contextual menu.
 
** In the {{WindowTitle|Checkout from SVN}} window, select {{Field|Check out as a project in the workspace}} and use {{Field|Jmol-documentation}} as Project Name. Then click on the {{Button|Finish}} button.
 
* If you want, you can also check-out {{MenuItem|Jmol-web}}:
 
** Right click on {{MenuItem|Jmol-web}} and select {{MenuItem|Checkout...}} in the contextual menu.
 
** In the {{WindowTitle|Checkout from SVN}} window, select {{Field|Check out as a project in the workspace}} and use {{Field|Jmol-web}} as Project Name. Then click on the {{Button|Finish}} button.
 
  
  
Line 57: Line 50:
 
* If the {{File|.project}} file has not been checked-out (no version information after the filename), delete it by selecting it and pressing the {{Keyboard|Suppr}} key.
 
* If the {{File|.project}} file has not been checked-out (no version information after the filename), delete it by selecting it and pressing the {{Keyboard|Suppr}} key.
 
* Right click on the project and select {{MenuItem|Team}} {{Submenu}} {{MenuItem|Update}} in the contextual menu.
 
* Right click on the project and select {{MenuItem|Team}} {{Submenu}} {{MenuItem|Update}} in the contextual menu.
 
  
 
= Configuring Eclipse to build Jmol =
 
= Configuring Eclipse to build Jmol =
Line 68: Line 60:
 
== Identifying the location of the Java executables (Unnecessary in Mac OS X) ==
 
== Identifying the location of the Java executables (Unnecessary in Mac OS X) ==
  
Ant needs to know where to find {{File|javac(.exe)}} and {{File|jarsigner(.exe)}}. This simply requires adding the Java SDK {{Directory|bin}} directory to the <tt>PATH</tt> environment variable.
+
Ant needs to know where to find {{File|javac(.exe)}} and {{File|jarsigner(.exe)}}.  
  
 +
This simply requires adding the Java SDK {{Directory|bin}} directory to the <tt>PATH</tt> environment variable.
 
To do this on Windows, you need to open the Windows {{WindowTitle|Control Panel}}, then double-click the {{WindowTitle|System}} icon (which may be under category {{WindowTitle|Performance}}). On the {{Field|Advanced}} tab, select {{Field|Environment variables}}. Scroll down to the <tt>path</tt> system variable and append to it a semicolon (<tt>;</tt>) followed by the path to the Java SDK binaries, something like "<tt>;C:\j2sdk1.4.2_10\bin</tt>".
 
To do this on Windows, you need to open the Windows {{WindowTitle|Control Panel}}, then double-click the {{WindowTitle|System}} icon (which may be under category {{WindowTitle|Performance}}). On the {{Field|Advanced}} tab, select {{Field|Environment variables}}. Scroll down to the <tt>path</tt> system variable and append to it a semicolon (<tt>;</tt>) followed by the path to the Java SDK binaries, something like "<tt>;C:\j2sdk1.4.2_10\bin</tt>".
 +
 +
''Alternative:'' adding the Java JDK directory to the <tt>JAVA_HOME</tt> environment variable.
 +
As above, select {{Field|Environment variables}} and edit or add the <tt>JAVA_HOME</tt> system variable with the path to the Java JDK files, something like "<tt>C:\Program Files (x86)\Java\jdk1.8.0_66</tt>".
  
 
== Identifying the location of the Java library (Unnecessary in Mac OS X)==
 
== Identifying the location of the Java library (Unnecessary in Mac OS X)==

Latest revision as of 20:31, 19 December 2015

Jmol/JSmol Development

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.4 or a later release recommended but it should work from version 3.1.
  • A Subversion (SVN) plugin for Eclipse : Subversive or Subclipse.

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 WindowOpen PerspectiveOther... and choose SVN Repository Exploring. Then click on the OK button.
  • Then right click in the SVN Repositories window and select NewRepository Location... in the contextual menu.
  • In the New Repository Location window, enter the value https://svn.code.sf.net/p/jmol/code/trunk in the Url field.
  • Select Use a custom label: and enter the value Jmol for the custom value.
  • 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 WindowOpen PerspectiveOther... 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-FAH is a collection of Jmol tools for Folding@Home.
    • Jmol-web is the source of the Jmol website.
  • Right click on Jmol and select Checkout in the contextual menu.
  • If you want, you can also check-out other projects:
    • Right click on the project and select Checkout in the contextual menu.


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 WindowOpen PerspectiveOther... 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 File icon.gif.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 TeamUpdate 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 (File icon.gifjavac.exe and File icon.gifjarsigner.exe) is identified.
  2. the location of the Java library (File icon.giftools.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 File icon.gifjavac(.exe) and File icon.gifjarsigner(.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".

Alternative: adding the Java JDK directory to the JAVA_HOME environment variable. As above, select Environment variables and edit or add the JAVA_HOME system variable with the path to the Java JDK files, something like "C:\Program Files (x86)\Java\jdk1.8.0_66".

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

Ant needs to know where to find File icon.giftools.jar.

From WindowPreferences...: in the Preferences window, go to AntRuntime and select Global Entries and click on the Add External JARs button. Navigate to the directory containing File icon.giftools.jar (probably something like C:\j2sdk1.4.2_10\lib), select File icon.giftools.jar and click on OK.

Matching the Java compiler to the Java Runtime Environment

From WindowPreferences..., 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. File icon.gifC:\Program Files\GnuWin32, then you need to add File icon.gifC:\Program Files\GnuWin32\bin; to the existing PATH environment variable: Control PanelSystemEnvironment 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 WindowOpen PerspectiveOther... 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 AsJava Applet or (for the application) Run AsJava Application. The main class for the application is org.openscience.jmol.app.Jmol.


Building Jmol

If not already done, open a Java Perspective using WindowOpen PerspectiveOther... and there select Java (default).

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

  • Find File icon.gifbuild.xml in the Package Explorer window and right click on it.
  • Then select Run AsAnt 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").