[Lenya Wiki] Update of "HowToLenyaInEclipseDebugger" by Ron Wheeler

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Lenya Wiki" for change notification.

The following page has been changed by Ron Wheeler:
http://wiki.apache.org/lenya/HowToLenyaInEclipseDebugger

------------------------------------------------------------------------------
  ## page was renamed from LenyaInEclipseDebugger
  = Creating a lenya Project in Eclipse =
  ''Instructions are specific to Eclipse 3.0.2 but should be similar in other version's. Also check out the instructions over at the [http://wiki.apache.org/cocoon/LoadInEclipse Cocoon wiki]''
+  * Download a Java Development Kit if you do not have one. Set up the JAVA_HOME environmental variable.
+  * Check your JAVA_HOME definition to make sure that it points to a JDK not just a run-time.
-  * Get eclipse from http://eclipse.org
+  * Get Eclipse from http://eclipse.org
   * Install Subclipse from http://subclipse.tigris.org (see instructions for adding "New Remote Site")
-  * Get Lenya source from svn if you don't already have it (see http://lenya.apache.org/1_4/installation/subversion.html)
+  * Get Lenya source from svn if you don't already have it (see http://lenya.apache.org/1_4/installation/subversion.html). You can also just download it and extract it to a directory if you are not intending to share your mods with the Lenya project.
   * Follow the install instructions (using the built-in Jetty) for lenya (see http://lenya.apache.org/1_4/installation/source_version.html)
   * Remove .classpath and .project from your Lenya source dist if you have already built Lenya (Apparently they fool Eclipse into thinking that a project has already been created)
+  * Get the latest Cocoon source and extract the files into a directory (eg. C:\Cocoon-2.1.7). It does not have to be in the Eclipse Workspace since it will only be referenced. Cocoon will not be built but pieces of it will be incorporated into the Lenya build.
+  * Create a local.build.properties file in the same directory as the lenya build.properties file.
+  * Modify the cocoon.src.dir to match the folder where you have extracted Cocoon (eg. cocoon.src.dir=C:\Cocoon-2.1.7).
+  * If you are using Java 1.5, you need to make sure that you download the latest xalan from apache.org and copy the jar files into the Java lib/endorsed folder. You may have to create the folder if you have not added libraries to this java release in the past.
   * Open Eclipse and create a new java project
    * file -> new project, select "Java Project" and click next
    * check "Create project at external location" and select your lenya source dist, click next
@@ -20, +26 @@

    * select all of the jar files from your cocoon/build/webapp/WEB-INF/lib directory and click "open"
    * click "ok", click "finish", click "finish" again
    * add the Lenya jars by clicking Add JARs on the Libraries tab, and including lib/ and tools/lib
+   * If you are using Java 1.5, you also need to add the xalan libraries to your Lenya project classpath as you did above for Cocoon.
    * wait while Eclipse builds your workspace (don't be surprised if you get some errors)
    * NOTE: Eclipse is simply compiling the files in your project, You will still need to "build" and "build clean" to build lenya (deploy publications)
    * if you got build errors in the Problems pane, make sure that jdk compliance is set to 1.4
@@ -29, +36 @@

     * be sure to uncheck "Use default compliance settings"
     * make sure "Compiler compliance level", "Generated .class files compatibility", and "Source compatibility" are set to 1.4
     * click "ok", your project should be re-built, hopefully you don't get any errors
-   * add svn support to your project
+   * add svn support to your project if you intend to share your project with the Lenya team.
    * right click on your project, select "Team"
    * select "Share Project..."
    * select "SVN" as the repository type and click next button, click "finish"

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@lenya.apache.org
For additional commands, e-mail: dev-help@lenya.apache.org