[Yanel-commits] rev 48209 - in
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development:
. build_setup_eclipse_ide.html.yarep
build_setup_eclipse_ide.html.yarep/revisions
build_setup_eclipse_ide.html.yarep/revisions/1268846925920
build_setup_eclipse_ide.html.yarep/revisions/1268848011605
build_setup_eclipse_ide.html.yarep/revisions/1268848340388
build_setup_eclipse_ide.html.yarep/revisions/1268848562909
build_setup_eclipse_ide.html.yarep/revisions/1268848719045
build_setup_eclipse_ide.html.yarep/revisions/1268849343829
build_setup_eclipse_ide.html.yarep/revisions/1268900177106
build_setup_eclipse_ide.html.yarep/revisions/1268901004171
build_setup_eclipse_ide.html.yarep/revisions/1268909135640
build_setup_eclipse_ide.html.yarep/revisions/1268909625494
build_setup_eclipse_ide.html.yarep/revisions/1268917096525
build_setup_eclipse_ide.html.yarep/revisions/1268919329045
build_setup_eclipse_ide.html.yarep/revisions/1268919899096
build_setup_eclipse_ide.html.yarep! /revisions/1268920841572
build_setup_eclipse_ide.html.yarep/revisions/1268920904538
build_setup_eclipse_ide.html.yarep/revisions/1268920959543
build_setup_eclipse_ide.html.yarep/revisions/1268922928093
build_setup_eclipse_ide.html.yarep/revisions/1268923022817
build_setup_eclipse_ide.html.yarep/revisions/1268923220107
build_setup_eclipse_ide.html.yarep/revisions/1268923770911
memo at wyona.com
memo at wyona.com
Mon Mar 22 11:55:12 CET 2010
Author: memo
Date: 2010-03-22 11:55:12 +0100 (Mon, 22 Mar 2010)
New Revision: 48209
Added:
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268846925920/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268846925920/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268846925920/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848011605/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848011605/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848011605/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848340388/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848340388/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848340388/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848562909/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848562909/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848562909/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848719045/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848719045/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848719045/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268849343829/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268849343829/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268849343829/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268900177106/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268900177106/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268900177106/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268901004171/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268901004171/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268901004171/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909135640/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909135640/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909135640/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909625494/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909625494/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909625494/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268917096525/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268917096525/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268917096525/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919329045/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919329045/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919329045/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919899096/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919899096/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919899096/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920841572/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920841572/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920841572/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920904538/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920904538/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920904538/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920959543/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920959543/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920959543/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268922928093/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268922928093/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268922928093/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923022817/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923022817/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923022817/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923220107/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923220107/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923220107/meta
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923770911/
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923770911/content
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923770911/meta
Modified:
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html
public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/meta
Log:
documentation for setting up yanel for use with eclipse added
Modified: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html 2010-03-22 10:33:07 UTC (rev 48208)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html 2010-03-22 10:55:12 UTC (rev 48209)
@@ -1,68 +1,70 @@
-<?xml version="1.0"?>
-<html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <title>Setup Yanel in Eclipse IDE</title>
- </head>
- <body>
- <h1>Setup Yanel in Eclipse IDE</h1>
- <dl>
- <dt>Project setup</dt>
- <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd>
- </dl>
- <dl>
- <dt>BUILD</dt>
- <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is
- turned off in Eclipse. alternative: one can also use the "run external tools" to build
- inside eclipse. which is handy because you don't have to switch between shell and eclipse.
- Go to the menu Run -> External Tools -> Open External Tools Dialog... click
- "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of
- your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target
- which you want to configure on the targets-tab. IMPORTANT: choose the target before you set
- the ant-home (see: <a class="external"
- href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6</a>).
- On the classpath tab add the ant shipped with yanel as ant-home.</dd>
- </dl>
- <dl>
- <dt>CLASSPATH</dt>
- <dd> Add libraries to classpath of the project. The libraries are located in
- $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add
- all libraries except the ones starting with yanel-*.</dd>
- </dl>
- <dl>
- <dt>CORRECT</dt>
- <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src.
- Remove this folder from build path and add src/resources/testing-times/src/java. Perform
- project cleanup.</dd>
- </dl>
- <dl>
- <dt>DEBUG</dt>
- <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which
- registers Tomcat process to Eclipse debugger.
- <br/>
- To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the
- source of the resource automatically. After it fails the first time you can use the button
- displayed "attach source" and then attach the whole resource folder of a realm.<p>also set in
- the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
- <pre>
- log4j.appender.A1=org.apache.log4j.ConsoleAppender
- #log4j.appender.A1 = org.apache.log4j.RollingFileAppender
- #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log
- </pre> this way you can see the output
- of the logging in the eclipse console.
- </dd>
- </dl>
-
- <dl>
- <dt>Other projects depending on Yanel</dt>
- <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as
- project dependency to this project.</dd>
- </dl>
- <dl>
- <dt>For Windows user:</dt>
- <dd>
- The files should have LF as end character.
- Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix".
- </dd>
- </dl>
- </body>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<div class="instructions">
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug your Yanel project. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate directory from the Yanel source, follow these steps to import it as a project into Eclipse:</p>
+<ol> <a name="point1"> </a>
+<li>Check out Yanel and the external realm, and <a href="../how-to-add-a-new-realm.html">add the realm to Yanel</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.</p>
+</li>
+<a name="point3"> </a>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in the Package Explorer view in Eclipse's Java perspective.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points <a href="#point1">#1-2</a> above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point <a href="#point3">#3</a> above in case you have not already done so. If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/.../{resource-directory}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either a directory containing all the resource-types of your realm (they may be imported all at once), or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/.../{resource-directory}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as projects in the Package Explorer view in Eclipse's Java perspective.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer view in Eclipse's Java perspective.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher or other Tomcat plugins. If you succeed in this, please document it here, or send a description to the <a href="http://yanel.wyona.org/mailing-lists.html">Yanel developers mailing list</a>.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>"Unix"</em>.</p>
+<p>
+<hr />
+</p>
+<p>TODO: Document how to create a debug configuration andhow to debug across multiple resource-types, which may still be tricky.</p>
+</div>
+</body>
</html>
\ No newline at end of file
Modified: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/meta 2010-03-22 10:33:07 UTC (rev 48208)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -1 +1,7 @@
+yarep_size<long>:6027
+yarep_checkinDate<date>:2010-03-18T15:55:39:217+0100
yarep_type<string>:resource
+yarep_lastModifed<long>:1268923770000
+yarep_checkoutUserID<string>:lenya
+yarep_checkoutDate<date>:2010-03-18T15:55:06:056+0100
+yarep_isCheckedOut<boolean>:false
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268846925920/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268846925920/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268846925920/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,14 @@
+<?xml version="1.0"?>
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <title>Setup Yanel in Eclipse IDE</title>
+ </head>
+ <body>
+<h1>Setup Yanel in Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel.</p>
+<dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl> <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a class="external" href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/show_bug.cg!
i?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl> <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl> <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl> <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can use the butto!
n displayed "attach source" and then attach the whole reso!
urce fol
der of a realm.
+<p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+<pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender <br /> #log4j.appender.A1 = org.apache.log4j.RollingFileAppender <br /> #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log<br /> </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl> <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl> <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268846925920/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268846925920/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268846925920/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,11 @@
+yarep_size<long>:3180
+workflow-state<string>:draft
+yarep_lastModifed<long>:1268846925000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-17T18:28:46:072+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-17T18:27:32:224+0100
+yarep_revisionCreationDate<date>:2010-03-17T18:28:45:960+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848011605/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848011605/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848011605/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,21 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<h1>Setup Yanel in Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse.</p>
+<ol>
+<li>Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{Yanel-Root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, this will open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+</ol> <dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl> <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a class="external" href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/show_!
bug.cgi?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl> <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl> <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl> <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can use the!
button displayed "attach source" and then attach the whol!
e resour
ce folder of a realm.
+<p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+<pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender <br /> #log4j.appender.A1 = org.apache.log4j.RollingFileAppender <br /> #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log<br /> </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl> <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl> <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848011605/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848011605/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848011605/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:3754
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-17T18:28:46:053+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268848011000
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-17T18:46:51:699+0100
+yarep_checkoutDate<date>:2010-03-17T18:29:29:893+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-17T18:46:51:615+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848340388/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848340388/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848340388/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<h1>Setup Yanel in Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse.</p>
+<ul>
+<li>Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>.</li>
+<li>Build an Eclipse project using the specific target "eclipse":</li>
+</ul>
+<pre>{Yanel-Root}/build.sh eclipse<br /></pre>
+<ul>
+<li>In Eclipse, select <em>File -> Import</em>, this will open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li></li>
+</ul>
+<ol> </ol> <dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl> <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a class="external" href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/!
show_bug.cgi?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl> <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl> <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl> <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can us!
e the button displayed "attach source" and then attach the!
whole r
esource folder of a realm.
+<p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+<pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender <br /> #log4j.appender.A1 = org.apache.log4j.RollingFileAppender <br /> #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log<br /> </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl> <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl> <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848340388/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848340388/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848340388/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:3788
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-17T18:46:51:646+0100
+yarep_lastModifed<long>:1268848340000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-17T18:52:20:483+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-17T18:50:17:881+0100
+yarep_revisionCreationDate<date>:2010-03-17T18:52:20:399+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848562909/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848562909/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848562909/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,29 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<h1>Setup Yanel in Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse.</p>
+<ul>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>.</li>
+<li>Build an Eclipse project using the specific target "eclipse":</li>
+<li>
+<pre>{Yanel-Root}/build.sh eclipse<br /></pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, this will open the Import dialog. </li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+</ul>
+<p> </p>
+<p> </p>
+<p> </p>
+<p> </p>
+<ul>
+</ul>
+<ol> </ol> <dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl> <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a class="external" href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/!
show_bug.cgi?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl> <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl> <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl> <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can us!
e the button displayed "attach source" and then attach the!
whole r
esource folder of a realm.
+<p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+<pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender <br /> #log4j.appender.A1 = org.apache.log4j.RollingFileAppender <br /> #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log<br /> </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl> <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl> <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848562909/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848562909/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848562909/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:3852
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-17T18:52:20:454+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268848562000
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-17T18:56:03:003+0100
+yarep_checkoutDate<date>:2010-03-17T18:54:03:917+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-17T18:56:02:920+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848719045/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848719045/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848719045/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,46 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html><head> <title>Untitled document</title>
+ </head>
+ <body>
+ <h1>Setup Yanel in Eclipse IDE</h1>
+ <p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse.</p>
+ <ul>
+ <li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>.</li>
+ </ul>
+ <ul>
+ <li>Build an Eclipse project using the specific target "eclipse": <br />
+ <pre>{Yanel-Root}/build.sh eclipse</pre>
+ </li>
+ </ul>
+ <ul>
+ <li>In Eclipse, select <em>File -> Import</em>, this will open the Import dialog. </li>
+ </ul>
+ <ul>
+ <li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+ </ul>
+ <ul>
+ <li><br /></li>
+ </ul>
+ <ul> </ul>
+ <p> </p>
+ <p> </p>
+ <p> </p>
+ <p> </p>
+ <ul> </ul>
+ <ol> </ol>
+ <dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl>
+ <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6" class="external">https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl>
+ <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl>
+ <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl>
+ <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can use the button displayed "attach source" and then attach the whole resource folder of a realm.
+
+ <p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+ <pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender
+ #log4j.appender.A1 = org.apache.log4j.RollingFileAppender
+ #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log
+ </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl>
+ <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl>
+ <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+ </body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848719045/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848719045/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268848719045/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:3852
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-17T18:56:02:980+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268848562000
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-17T18:58:39:179+0100
+yarep_checkoutDate<date>:2010-03-17T18:56:32:642+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-17T18:58:39:099+0100
+yarep_revisionComment<string>:Updated with Xinha
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268849343829/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268849343829/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268849343829/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,34 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html><head> <title>Untitled document</title>
+ </head>
+ <body>
+<h1>Setup Yanel in Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse.</p>
+<ul>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>.</li>
+<li>Build an Eclipse project using the specific target "eclipse": <br />
+<pre>{Yanel-Root}/build.sh eclipse</pre>
+</li>
+</ul>
+<ul>
+<li>In Eclipse, select <em>File -> Import</em>, this will open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Click on <em>Browse</em>, and select the Yanel root directory (where build.sh is located)</li>
+</ul>
+<ul>
+</ul>
+<p> </p>
+<p> </p>
+<p> </p>
+<p> </p>
+<ul>
+</ul>
+<ol> </ol> <dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl> <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a class="external" href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/!
show_bug.cgi?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl> <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl> <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl> <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can us!
e the button displayed "attach source" and then attach the!
whole r
esource folder of a realm.
+<p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+<pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender
+ #log4j.appender.A1 = org.apache.log4j.RollingFileAppender
+ #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log
+ </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl> <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl> <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268849343829/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268849343829/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268849343829/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:3958
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-17T18:58:39:145+0100
+yarep_lastModifed<long>:1268849343000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-17T19:09:03:915+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-17T18:59:33:458+0100
+yarep_revisionCreationDate<date>:2010-03-17T19:09:03:837+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268900177106/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268900177106/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268900177106/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,41 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html><head> <title>Untitled document</title>
+ </head>
+ <body>
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse.</p>
+<h2>Importing the Yanel core<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{Yanel-Root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, this will open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), and <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<ul>
+</ul>
+<h2>Importing external realms</h2>
+<p>Realms that have a separate repository from the Yanel source can be imported as additional projects.</p>
+<ul>
+<li></li>
+</ul>
+<p> </p>
+<p> </p>
+<p> </p>
+<ul>
+</ul>
+<ol> </ol> <dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl> <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a class="external" href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/!
show_bug.cgi?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl> <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl> <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl> <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can us!
e the button displayed "attach source" and then attach the!
whole r
esource folder of a realm.
+<p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+<pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender
+ #log4j.appender.A1 = org.apache.log4j.RollingFileAppender
+ #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log
+ </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl> <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl> <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268900177106/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268900177106/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268900177106/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:4466
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-17T19:09:03:874+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268900177000
+yarep_revisionCreator<string>:null
+yarep_checkoutUserID<string>:null
+workflow-date<date>:2010-03-18T09:16:17:203+0100
+yarep_checkoutDate<date>:2010-03-18T09:07:51:405+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-18T09:16:17:116+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268901004171/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268901004171/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268901004171/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,40 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html><head> <title>Untitled document</title>
+ </head>
+ <body>
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse.</p>
+<h2>Importing the Yanel core<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{path/to/yanel/root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, this will open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), and <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<ul>
+</ul>
+<h2>Importing external realms</h2>
+<p>Realms that have a separate repository from the Yanel source can be imported as additional projects.</p>
+<ul>
+</ul>
+<p> </p>
+<p> </p>
+<p> </p>
+<ul>
+</ul>
+<ol> </ol> <dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl> <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a class="external" href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/!
show_bug.cgi?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl> <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl> <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl> <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can us!
e the button displayed "attach source" and then attach the!
whole r
esource folder of a realm.
+<p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+<pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender
+ #log4j.appender.A1 = org.apache.log4j.RollingFileAppender
+ #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log
+ </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl> <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl> <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268901004171/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268901004171/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268901004171/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:4463
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T09:16:17:156+0100
+yarep_lastModifed<long>:1268901004000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T09:30:04:292+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-18T09:17:32:716+0100
+yarep_revisionCreationDate<date>:2010-03-18T09:30:04:180+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909135640/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909135640/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909135640/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,68 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat").</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate repository from the Yanel source, i.e. that is not one of the realms included with Yanel, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Check out Yanel and the external realm, and add the realm to Yanel by following <a href="../how-to-add-a-new-realm.html">this example</a>.</li>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in the Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow point #1 above if you have not already done so. </li>
+<li>Build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in the Package Explorer.</p>
+<h2></h2>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{path/to/yanel/root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p> </p>
+<p> </p>
+<p> </p>
+<p> </p>
+<p> </p>
+<ul>
+</ul>
+<ol> </ol> <dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl> <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a class="external" href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/!
show_bug.cgi?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl> <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl> <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl> <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can us!
e the button displayed "attach source" and then attach the!
whole r
esource folder of a realm.
+<p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+<pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender <br /> #log4j.appender.A1 = org.apache.log4j.RollingFileAppender <br /> #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log<br /> </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl> <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl> <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909135640/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909135640/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909135640/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:7265
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T09:30:04:210+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268909135000
+yarep_revisionCreator<string>:null
+yarep_checkoutUserID<string>:null
+workflow-date<date>:2010-03-18T11:45:35:733+0100
+yarep_checkoutDate<date>:2010-03-18T10:59:01:930+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-18T11:45:35:650+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909625494/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909625494/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909625494/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,68 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate repository from the Yanel source, i.e. that is not one of the realms included with Yanel, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Check out Yanel and the external realm, and add the realm to Yanel by following <a href="../how-to-add-a-new-realm.html">this example</a>.</li>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in the Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow point #1 above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point #2 above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "res-types" (if you are importing an external realm's resources) or Yanel's </li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in the Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{path/to/yanel/root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p> </p>
+<p> </p>
+<p> </p>
+<p> </p>
+<p> </p>
+<ul>
+</ul>
+<ol> </ol> <dl> <dt>Project setup</dt> <dd>Create new Java Project in Eclipse workspace. Use the option "Create project from existing source".</dd> </dl> <dl> <dt>BUILD</dt> <dd>To build yanel, use ./build.sh in the console. Make sure Option "Build Automatically" is turned off in Eclipse. alternative: one can also use the "run external tools" to build inside eclipse. which is handy because you don't have to switch between shell and eclipse. Go to the menu Run -> External Tools -> Open External Tools Dialog... click "new Lanuch Configuration" to add a new launcher. In the main tab choose the build.xml of your yanel. (e.g. ${workspace_loc:/yanel-projects/src/build/build.xml}). Choose the target which you want to configure on the targets-tab. IMPORTANT: choose the target before you set the ant-home (see: <a class="external" href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=143008#c6">https://bugs.eclipse.org/bugs/!
show_bug.cgi?id=143008#c6</a>). On the classpath tab add the ant shipped with yanel as ant-home.</dd> </dl> <dl> <dt>CLASSPATH</dt> <dd> Add libraries to classpath of the project. The libraries are located in $ECLIPSE_WORKSPACE$/yanel-trunk/local/apache-tomcat-5.5.20/webapps/yanel/WEB-INF/lib. Add all libraries except the ones starting with yanel-*.</dd> </dl> <dl> <dt>CORRECT</dt> <dd> Eclipse import source wizzard mixes up something with src/resources/testing-times/src. Remove this folder from build path and add src/resources/testing-times/src/java. Perform project cleanup.</dd> </dl> <dl> <dt>DEBUG</dt> <dd> Use the Eclipse Tomcat Lanucher (http://www.eclipsetotale.com/tomcatPlugin.html) which registers Tomcat process to Eclipse debugger. <br /> To debug Resources of a project, set a breakpoint in a resource. Eclipse will not find the source of the resource automatically. After it fails the first time you can us!
e the button displayed "attach source" and then attach the!
whole r
esource folder of a realm.
+<p>also set in the log4j.properties the ConsoleAppender insted of the RollingFileAppender</p>
+<pre> log4j.appender.A1=org.apache.log4j.ConsoleAppender <br /> #log4j.appender.A1 = org.apache.log4j.RollingFileAppender <br /> #log4j.appender.A1.File = /home/simon/src/yanel-projects/build/logs/log4j-cnode1.log<br /> </pre>
+this way you can see the output of the logging in the eclipse console. </dd> </dl> <dl> <dt>Other projects depending on Yanel</dt> <dd> To develop projects depending on yanel, like "Yanel contributions", add yanel-trunk as project dependency to this project.</dd> </dl> <dl> <dt>For Windows user:</dt> <dd> The files should have LF as end character. Menu: Window -> Preferences -> General -> Workspace -> New text file line delimiter. Set to "Unix". </dd> </dl>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909625494/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909625494/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268909625494/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:7484
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T11:45:35:694+0100
+yarep_lastModifed<long>:1268909625000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T11:53:45:603+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-18T11:45:57:424+0100
+yarep_revisionCreationDate<date>:2010-03-18T11:53:45:508+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268917096525/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268917096525/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268917096525/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,61 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate repository from the Yanel source, i.e. that is not one of the realms included with Yanel, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Check out Yanel and the external realm, and add the realm to Yanel by following <a href="../how-to-add-a-new-realm.html">this example</a>.</li>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in Eclipse's Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow point #1 above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point #2 above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "{path/to/realm}/res-types" (if you are importing an external realm's resources, they will be imported all at once) or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/resources/{resource-to-import}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as a projects in Eclipse's Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{path/to/yanel/root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher. If you succeed in this, please document it here.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>Unix</em>.</p>
+<p> </p>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268917096525/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268917096525/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268917096525/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:5087
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T11:53:45:581+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268917096000
+yarep_revisionCreator<string>:null
+yarep_checkoutUserID<string>:null
+workflow-date<date>:2010-03-18T13:58:16:629+0100
+yarep_checkoutDate<date>:2010-03-18T13:45:31:386+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-18T13:58:16:543+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919329045/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919329045/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919329045/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,67 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Before you start</h2>
+<p>Before you can import the projects as described below, you need to compile and deploy a jar file that is not automatically compiled by default</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate repository from the Yanel source, i.e. that is not one of the realms included with Yanel, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Check out Yanel and the external realm, and add the realm to Yanel by following <a href="../how-to-add-a-new-realm.html">this example</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.</p>
+</li>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in Eclipse's Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points #1-2 above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point #3 above in case you have not already done so.</li>
+<li>If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "{path/to/realm}/res-types" (if you are importing an external realm's resources, they will be imported all at once) or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/resources/{resource-to-import}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as a projects in Eclipse's Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{path/to/yanel/root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher. If you succeed in this, please document it here.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>Unix</em>.</p>
+<p> </p>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919329045/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919329045/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919329045/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:5743
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T13:58:16:598+0100
+yarep_lastModifed<long>:1268919329000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T14:35:29:423+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-18T14:24:38:940+0100
+yarep_revisionCreationDate<date>:2010-03-18T14:35:29:061+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919899096/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919899096/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919899096/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate repository from the Yanel source, i.e. that is not one of the realms included with Yanel, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Check out Yanel and the external realm, and add the realm to Yanel by following <a href="../how-to-add-a-new-realm.html">this example</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.</p>
+</li>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in Eclipse's Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points #1-2 above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point #3 above in case you have not already done so.</li>
+<li>If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "{path/to/realm}/res-types" (if you are importing an external realm's resources, they will be imported all at once) or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/resources/{resource-to-import}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as a projects in Eclipse's Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{path/to/yanel/root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher. If you succeed in this, please document it here.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>Unix</em>.</p>
+<p> </p>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919899096/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919899096/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268919899096/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:5565
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T14:35:29:127+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268919899000
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T14:44:59:214+0100
+yarep_checkoutDate<date>:2010-03-18T14:44:32:471+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-18T14:44:59:111+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920841572/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920841572/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920841572/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,66 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Developing Yanel in Eclipse</title>
+</head>
+<body>
+<div class="instructions">
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate repository from the Yanel source, i.e. that is not one of the realms included with Yanel, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Check out Yanel and the external realm, and add the realm to Yanel by following <a href="../how-to-add-a-new-realm.html">this example</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.</p>
+</li>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in Eclipse's Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points #1-2 above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point #3 above in case you have not already done so.</li>
+<li>If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "{path/to/realm}/res-types" (if you are importing an external realm's resources, they will be imported all at once) or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/resources/{resource-to-import}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as a projects in Eclipse's Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{path/to/yanel/root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher. If you succeed in this, please document it here.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>Unix</em>.</p>
+</div>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920841572/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920841572/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920841572/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:5596
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T14:44:59:156+0100
+yarep_lastModifed<long>:1268920841000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T15:00:41:647+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-18T14:58:15:289+0100
+yarep_revisionCreationDate<date>:2010-03-18T15:00:41:581+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920904538/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920904538/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920904538/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,66 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Setting up Yanel in Eclipse</title>
+</head>
+<body>
+<div class="instructions">
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate repository from the Yanel source, i.e. that is not one of the realms included with Yanel, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Check out Yanel and the external realm, and add the realm to Yanel by following <a href="../how-to-add-a-new-realm.html">this example</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.</p>
+</li>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in Eclipse's Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points #1-2 above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point #3 above in case you have not already done so.</li>
+<li>If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "{path/to/realm}/res-types" (if you are importing an external realm's resources, they will be imported all at once) or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/resources/{resource-to-import}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as a projects in Eclipse's Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{path/to/yanel/root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher. If you succeed in this, please document it here.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>Unix</em>.</p>
+</div>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920904538/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920904538/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920904538/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:5596
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T15:00:41:621+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268920904000
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T15:01:44:612+0100
+yarep_checkoutDate<date>:2010-03-18T15:01:16:902+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-18T15:01:44:546+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920959543/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920959543/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920959543/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,66 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Setting up Yanel in Eclipse</title>
+</head>
+<body>
+<div class="instructions">
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug Yanel. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate repository from the Yanel source, i.e. that is not one of the realms included with Yanel, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Check out Yanel and the external realm, and add the realm to Yanel by following <a href="../how-to-add-a-new-realm.html">this example</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.</p>
+</li>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in Eclipse's Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points #1-2 above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point #3 above in case you have not already done so.</li>
+<li>If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>{path/to/yanel/root}/build.sh -f {path/to/yanel/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "{path/to/realm}/res-types" (if you are importing an external realm's resources, they will be imported all at once) or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/resources/{resource-to-import}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as a projects in Eclipse's Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>{path/to/yanel/root}/build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher. If you succeed in this, please document it here.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>"Unix"</em>.</p>
+</div>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920959543/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920959543/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268920959543/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:5598
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T15:01:44:577+0100
+yarep_lastModifed<long>:1268920959000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T15:02:39:928+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-18T15:02:17:272+0100
+yarep_revisionCreationDate<date>:2010-03-18T15:02:39:552+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268922928093/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268922928093/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268922928093/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<div class="instructions">
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug your Yanel project. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate directory from the Yanel source, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li><a href="http://yanel.org/download/source-repository.html"><a name="point1"></a>Check out Yanel</a> and the external realm, and <a href="../how-to-add-a-new-realm.html">add the realm to Yanel</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.</p>
+</li>
+<li><a name="point3"></a>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in Eclipse's Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points <a href="#point1">#1-2</a> above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point <a href="#point3">#3</a> above in case you have not already done so. If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/.../{resource-directory}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "{path/to/realm}/res-types" (if you are importing an external realm's resources, they will be imported all at once) or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/.../{resource-directory}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as a projects in Eclipse's Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer view in Eclipse's Java perspective.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher. If you succeed in this, please document it here.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>"Unix"</em>.</p>
+</div>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268922928093/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268922928093/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268922928093/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:5755
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T15:02:39:908+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268922927000
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T15:35:28:166+0100
+yarep_checkoutDate<date>:2010-03-18T15:10:48:436+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-18T15:35:28:100+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923022817/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923022817/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923022817/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,65 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<div class="instructions">
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug your Yanel project. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate directory from the Yanel source, follow these steps to import it as a project into Eclipse:<a name="point1"></a></p>
+<ol>
+<li>Check out Yanel and the external realm, and <a href="../how-to-add-a-new-realm.html">add the realm to Yanel</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.<a name="point3"></a></p>
+</li>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in Eclipse's Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points <a href="#point1">#1-2</a> above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point <a href="#point3">#3</a> above in case you have not already done so. If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/.../{resource-directory}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "{path/to/realm}/res-types" (if you are importing an external realm's resources, they will be imported all at once) or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/.../{resource-directory}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as a projects in Eclipse's Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer view in Eclipse's Java perspective.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher. If you succeed in this, please document it here.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>"Unix"</em>.</p>
+</div>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923022817/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923022817/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923022817/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:5692
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T15:35:28:128+0100
+yarep_lastModifed<long>:1268923022000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T15:37:02:891+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-18T15:36:11:237+0100
+yarep_revisionCreationDate<date>:2010-03-18T15:37:02:825+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923220107/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923220107/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923220107/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,66 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<div class="instructions">
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug your Yanel project. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate directory from the Yanel source, follow these steps to import it as a project into Eclipse:</p>
+<ol> <a name="point1"> </a>
+<li>Check out Yanel and the external realm, and <a href="../how-to-add-a-new-realm.html">add the realm to Yanel</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.</p>
+</li>
+<a name="point3"> </a>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in Eclipse's Package Explorer.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points <a href="#point1">#1-2</a> above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point <a href="#point3">#3</a> above in case you have not already done so. If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/.../{resource-directory}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either "{path/to/realm}/res-types" (if you are importing an external realm's resources, they will be imported all at once) or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/.../{resource-directory}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as a projects in Eclipse's Package Explorer.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer view in Eclipse's Java perspective.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher. If you succeed in this, please document it here.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>"Unix"</em>.</p>
+</div>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923220107/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923220107/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923220107/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:5697
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T15:37:02:862+0100
+yarep_type<string>:resource
+yarep_lastModifed<long>:1268923220000
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T15:40:20:166+0100
+yarep_checkoutDate<date>:2010-03-18T15:38:04:047+0100
+yarep_isCheckedOut<boolean>:false
+yarep_revisionCreationDate<date>:2010-03-18T15:40:20:116+0100
+yarep_revisionComment<string>:Updated with tinyMCE
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923770911/content
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923770911/content (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923770911/content 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,70 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html>
+<head>
+<title>Untitled document</title>
+</head>
+<body>
+<div class="instructions">
+<h1>Setting up Yanel in the Eclipse IDE</h1>
+<p>This document will get you started using Eclipse to develop/debug your Yanel project. To keep things simple and reliable, building and SVN access will be done outside of Eclipse. Also, it is assumed that you are using a unix-like shell for command line processing, if you are using the windows command line, replace the references to the shell scripts below with their aequivalent dos batch files (e.g. replace "build.sh" with "build.bat") and "/" with "\".</p>
+<p>Depending on what you will be working on, you might need to import several projects into Eclipse. In this context, there are 3 types of projects: realms, resources, and Yanel itself. Please note that importing Yanel into Eclipse as a project will <strong>not</strong> automatically import Yanel's resource types, they have to be imported separately, and one by one, as described below.</p>
+<h2>Importing a realm</h2>
+<p>If you want to work on a realm that has a separate directory from the Yanel source, follow these steps to import it as a project into Eclipse:</p>
+<ol> <a name="point1"> </a>
+<li>Check out Yanel and the external realm, and <a href="../how-to-add-a-new-realm.html">add the realm to Yanel</a>.</li>
+<li>Compile and deploy "yanel-test-1.0-dev-rREVISION.jar":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/test/build.xml install-jar<br /></pre>
+<p>This will build the jar file and deploy it automatically to your maven repository.</p>
+</li>
+<a name="point3"> </a>
+<li>Build an Eclipse project using the specific "eclipse" target with the realm's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/realm/root}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the realm's root directory (i.e. where build.xml is located)</li>
+<li>Make sure the realm project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The realm should now be visible as a project in the Package Explorer view in Eclipse's Java perspective.</p>
+<h2>Importing resource types<br /></h2>
+<p>If you want to work on a specific resource type that is either a resource type of Yanel, or one belonging to another realm, follow these steps to import it as a project into Eclipse:</p>
+<ol>
+<li>Follow points <a href="#point1">#1-2</a> above if you have not already done so.</li>
+<li>If the resource type you are importing belongs to an external realm, follow point <a href="#point3">#3</a> above in case you have not already done so. If the resource type you are importing belongs to Yanel, build an Eclipse project using the specific "eclipse" target with the resource's build file:<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh -f {path/to/yanel/root}/src/.../{resource-directory}/build.xml eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select either a directory containing all the resource-types of your realm (they may be imported all at once), or the directory of the Yanel resource that you want to import ({path/to/yanel/root}/src/.../{resource-directory}, in this case you have to import them one by one).</li>
+<li>Select the resources that you want to import as projects, make sure <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<p>The resources should now be visible as projects in the Package Explorer view in Eclipse's Java perspective.</p>
+<h2>Importing Yanel<br /></h2>
+<ol>
+<li> Check out and build Yanel as <a href="http://yanel.org/download/source-repository.html">usual</a>, if you have not yet done so.</li>
+<li>Build an Eclipse project using the specific target "eclipse":<br />
+<pre>cd {path/to/yanel/root}<br />./build.sh eclipse</pre>
+</li>
+<li>In Eclipse, select <em>File -> Import</em>, to open the Import dialog.</li>
+<li>Select <em>General -> Existing Projects into Workspace</em>, then click on <em>Next</em>.</li>
+<li>Check <em>"Select root directory"</em>, click on <em>Browse</em>, and select the Yanel root directory (i.e. where build.sh is located)</li>
+<li>Make sure the Yanel project is selected (should be the only one), <em>"Copy projects into workspace"</em> is <strong>not</strong> selected, and click on <em>Finish</em>.</li>
+</ol>
+<ul>
+</ul>
+<p>The project "yanel" should now be visible in the Package Explorer view in Eclipse's Java perspective.</p>
+<h2>Debugging<br /></h2>
+<ul>
+</ul>
+<p>To start debugging with Eclipse, start Tomcat in debug mode:</p>
+<pre>{path/to/yanel/root}/local/apache-tomcat-5.5.20/bin/catalina.sh jpda start</pre>
+<p>Alternatively, you can (theoretically) also use the Eclipse Tomcat Launcher or other Tomcat plugins. If you succeed in this, please document it here, or send a description to the <a href="http://yanel.wyona.org/mailing-lists.html">Yanel developers mailing list</a>.</p>
+<h2>Notes</h2>
+<p>Windows users, please configure your line endings as LF by setting <em>Preferences -> General -> Workspace -> New text file line delimiter</em> to <em>"Unix"</em>.</p>
+<p>
+<hr />
+</p>
+<p>TODO: Document how to create a debug configuration andhow to debug across multiple resource-types, which may still be tricky.</p>
+</div>
+</body>
+</html>
\ No newline at end of file
Added: public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923770911/meta
===================================================================
--- public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923770911/meta (rev 0)
+++ public/yanel/trunk/src/realms/yanel-website/content/en/documentation/development/build_setup_eclipse_ide.html.yarep/revisions/1268923770911/meta 2010-03-22 10:55:12 UTC (rev 48209)
@@ -0,0 +1,12 @@
+yarep_size<long>:6027
+workflow-state<string>:draft
+yarep_checkinDate<date>:2010-03-18T15:40:20:146+0100
+yarep_lastModifed<long>:1268923770000
+yarep_type<string>:resource
+yarep_revisionCreator<string>:lenya
+yarep_checkoutUserID<string>:lenya
+workflow-date<date>:2010-03-18T15:49:30:984+0100
+yarep_isCheckedOut<boolean>:false
+yarep_checkoutDate<date>:2010-03-18T15:41:09:903+0100
+yarep_revisionCreationDate<date>:2010-03-18T15:49:30:919+0100
+yarep_revisionComment<string>:Updated with tinyMCE
More information about the Yanel-commits
mailing list