HOWTO run the rating field cms in eclipse

Prerequisites:

  [ eclipse ]
  - run-jetty-run plugin (http://code.google.com/p/run-jetty-run/)
    add http://run-jetty-run.googlecode.com/svn/trunk/updatesite
    as an update site, and install the Run Jetty Run feature


Prepare project:

  [ command line ]
  - in rating-field root project
    mvn eclipse:eclipse

  * edit the version number in the eclipse.sh script

  * Run the eclipse.sh script

  [ eclipse ]
  - in Project -> Properties -> Java Build Path -> Source
    - remove existing source folders
    - enable "Allow output folders for source folders"
    - add source folders
      src/main/webapp/WEB-INF (output: target/classes/WEB-INF)
      quickstart/layout (output: target/classes/layout)
      quickstart/skin (output: target/classes/skin)
      quickstart/xinha (output: target/classes/xinha)

  * in Project -> Properties -> Java Build Path -> Libraries
    - remove all jars and class folders from the build path
    - add all libraries from the lib/ and jetty/ folders
    - add the classes/ folder as a Class folder


Create launch configuration:

  [ eclipse ]
  - navigate to Run -> Debug Configurations
    - add new Jetty Webapp
    - clear HTTPS port number
    - set Context to "/cms"
    - set WebApp dir to "target/classes"


Cleanup:

  [ command line ]
  * run clean.sh
  - in rating-field root project
    mvn eclipse:clean 


Keeping up:

  When a new version of the quickstart-war is used, the project can
  be updated with a small number of steps.  Execute the steps marked
  with a "*", in the order
  - run clean.sh
  - edit the version number in eclipse.sh script
  - run eclipse.sh
  - update library dependencies