ARIES-529 Add the unmodified incubator site to trunk

git-svn-id: https://svn.apache.org/repos/asf/aries/site/trunk/content@1054972 13f79535-47bb-0310-9956-ffa450edef68

community/gettinginvolved.mdtext

@@ -0,0 +1,33 @@
+Title: GettingInvolved
+<a name="GettingInvolved-GettingInvolved"></a>
+## Getting Involved
+Getting involved with Aries is easy. First, any help is welcome and we
+welcome you on board. Here are some suggestions for how you can get
+involved in Aries:
+
+* Take a look at the existing modules 
+ to identify what areas you are interested in.
+* Take a look at the [Aries proposal](http://wiki.apache.org/incubator/AriesProposal)
+ to see if there are things there that you are interested in but we haven't
+created subprojects for yet. If you're not sure whether something is in
+scope for Aries or not, send a mail to the developers [mailing list|MailingLists]
+ and ask. 
+* Try out the [tutorials](/documentation/tutorials/blueprinthelloworldtutorial.html)
+ to get a feel for what Aries is about.
+* Subscribe to one (or more) of the [mailing lists](mailinglists.html)
+. If you want to get involved as a _user_, subscribe to user mailing list.
+If you want to get involved as a _contributer_, in the development of
+Aries, subscribe to the developer list.
+* Help answer questions posted to the user mailing list for areas that you
+are familiar with. Your real usage experience can be very valuable to other
+users as well as developers on the project.
+* Would like to get involved in development? Have new ideas? Start with the
+mailing list and share your thoughts.
+* Contribute to feature development. Just let the community know what you'd
+like to work on. It is as easy as that.
+* Identify [JIRA](https://issues.apache.org/jira/browse/ARIES)
+s and browse the [source](https://svn.apache.org/repos/asf/incubator/aries/)
+ in the area that you are interested in and provide patches.
+* If in doubt about where to start, send a note to the mailing list and
+mention your area of interest. Any question is welcomed. We'd like you to
+be involved!

community/mailinglists.mdtext

@@ -0,0 +1,38 @@
+Title: MailingLists
+The Aries User list is for general discussion or questions on using any of
+the Aries sub-projects. Aries developers monitor this list and provide
+assistance when needed.
+
+ * [Subscribe](mailto:aries-user-subscribe@incubator.apache.org.html)
+ to the Aries User list
+ * [Unsubscribe](mailto:aries-user-unsubscribe@incubator.apache.org.html)
+ from the Aries User list
+ * [Post](mailto:aries-user@incubator.apache.org.html)
+ to the Aries User list
+ * [View](http://mail-archives.apache.org/mod_mbox/incubator-aries-user/)
+ to the Aries User list archive
+
+The Aries Developer list is for developers to discuss ongoing work, make
+decisions and vote on technical issues. There is one list for all Aries
+sub-projects.
+
+ * [Subscribe](mailto:aries-dev-subscribe@incubator.apache.org.html)
+ to the Aries Developer list
+ * [Unsubscribe](mailto:aries-dev-unsubscribe@incubator.apache.org.html)
+ from the Aries Developer list
+ * [Post](mailto:aries-dev@incubator.apache.org.html)
+ to the Aries Developer list
+ * [View](http://mail-archives.apache.org/mod_mbox/incubator-aries-dev/)
+ to the Aries Developer list archive
+
+The Aries Commits list receives notifications when changes are committed to
+the Aries source tree.
+
+ * [Subscribe](mailto:aries-commits-subscribe@incubator.apache.org.html)
+ to the Aries Commits list
+ * [Unsubscribe](mailto:aries-commits-unsubscribe@incubator.apache.org.html)
+ from the Aries Commits list
+ * [Post](mailto:aries-commits@incubator.apache.org.html)
+ to the Aries Commits list
+ * [View](http://mail-archives.apache.org/mod_mbox/incubator-aries-commits/)
+ to the Aries Commits list archive

community/overview.mdtext

@@ -0,0 +1,16 @@
+Title: Community
+<a name="Community-Community"></a>
+# Community
+
+There are many ways to be part of the Apache Aries community. You will find
+suggestions under [getting involved](gettinginvolved.html)
+. 
+
+ - [Getting Involved](gettinginvolved.html)
+ - [Who we are](people.html)
+ - [Mailing lists](mailinglists.html)
+ - [Aries Group Blog](http://blogs.apache.org/aries/)
+
+You can also find us on IRC, attach freenode and join #apache-aries.
+
+Our twitter tag is #apache-aries.

community/people.mdtext

@@ -0,0 +1,57 @@
+Title: People
+
+This is a list of the people involved in the Apache Aries Incubator and
+their roles.
+
+<table>
+<tr><th>Name</th><th>Organization</th><th>PPMC Member</th><th>Mentor</th><th>Champion</th><th>IPMC
+</tr>
+<tr><td>Adam Wojtuniak </td><td>Ericsson </td><td> </td><td> </td><td> </td><td> </td></tr>
+<tr><td>Alan Cabrera</td><td>LinkedIn</td><td> (/)</td><td> </td><td> </td><td> (/) </td></tr>
+<tr><td>Alan Keane</td><td>Ericsson </td><td> </td><td> </td><td> </td><td> </td></tr>
+<tr><td>Alasdair Nottingham</td><td>IBM</td><td> (/)</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Andrew Osborne</td><td>IBM</td><td> (/)</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Bartosz Kowalewski</td><td> </td><td> </td><td> </td><td> </td><td> </td></tr>
+<tr><td>Bernd Kolb</td><td>SAP</td><td> (/)</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Bertrand Delacretaz</td><td> </td><td> (/)</td><td>(/) emeritus</td><td> </td><td> (/) </td></tr>
+<tr><td>Carsten Ziegeler</td><td> </td><td> (/)</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Chris Wilkinson</td><td>IBM</td><td> </td><td> </td><td> </td><td> </td></tr>
+<tr><td>Dan Kulp</td><td>Talend</td><td> (/)</td><td> </td><td> </td><td> (/) </td></tr>
+<tr><td>David Bosschaert</td><td>Red Hat</td><td> (/)</td><td> </td><td> </td><td>	 </td></tr>
+<tr><td>David Jencks</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Davanum Srinivas (Dims)</td><td>IBM</td><td>(/)</td><td>(/)</td><td> </td><td> (/) </td></tr>
+<tr><td>Dimo Stoilov</td><td>SAP</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Emily Jiang</td><td>IBM</td><td> </td><td> </td><td> </td><td> </td></tr>
+<tr><td>Eoghan Glynn</td><td>Progress</td><td> (/)</td><td>	</td><td> </td><td> </td></tr>
+<tr><td>Graham Charters</td><td>IBM</td><td> (/)</td><td>	</td><td> </td><td> </td></tr>
+<tr><td>Guillaume Nodet</td><td>Progress</td><td> (/)</td><td>(/)</td><td>(/)</td><td>(/)</td></tr>
+<tr><td>Hiram Chirino</td><td>Progress</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Holly Cummins</td><td>IBM</td><td> </td><td> </td><td> </td><td> </td></tr>
+<tr><td>Ian Robinson</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>James Strachan</td><td>Progress</td><td> (/)</td><td>	</td><td> </td><td> (/) </td></tr>
+<tr><td>Jarek Gawor</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> (/) </td></tr>
+<tr><td>Jean-Sebastien Delfino</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Jeremy Hughes</td><td>IBM</td><td> (/) </td><td> </td><td> </td><td> </td></tr>
+<tr><td>Joe Bohn</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Kevan Miller</td><td>IBM</td><td>(/)</td><td>(/)</td><td>(/)</td><td>(/)</td></tr>
+<tr><td>Lei "Rex" Wang</td><td>IBM</td><td> </td><td> </td><td> </td><td> </td></tr>
+<tr><td>Lin Sun</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Kiril Mitov</td><td>SAP</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Mark Nuttall</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Niclas Hedhman</td><td> </td><td>	</td><td> </td><td> </td><td>(/)</td></tr>
+<tr><td>Niklas Gustavsson</td><td> </td><td> (/)</td><td> </td><td> </td><td>	 </td></tr>
+<tr><td>Nikolai Tankov</td><td>SAP</td><td> (/)</td><td> </td><td> </td><td>	 </td></tr>
+<tr><td>Oisin Hurley</td><td>Progress</td><td> (/)</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Peter Peshev</td><td>SAP</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Raymond Feng</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Rick McGuire</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Roman Roelofsen</td><td>ProSyst</td><td> (/)</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Sabine Heider</td><td>SAP</td><td> (/) </td><td> </td><td> </td><td> </td></tr>
+<tr><td>Sergey Beryozkin</td><td>Progress</td><td> (/)</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Stuart McCulloch</td><td> </td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Timothy Ward</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Todor Boev</td><td>ProSyst</td><td> (/)</td><td> </td><td> </td><td>	 </td></tr>
+<tr><td>Valentin Mahrwald</td><td>IBM</td><td> (/)</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Violeta Georgieva</td><td>SAP</td><td> (/)</td><td> </td><td> </td><td> </td></tr>
+<tr><td>Zoe Slattery</td><td>IBM</td><td> (/)	</td><td> </td><td> </td><td> </td></tr>
+</table>

development/buildingaries.mdtext

@@ -0,0 +1,133 @@
+Title: BuildingAries
+<a name="BuildingAries-ExtractingandbuildingAries"></a>
+# Extracting and building Aries
+
+There are two ways to do this. The first avoids using the command line but
+can leave you with some fixing up to do on the projects.
+
+<a name="BuildingAries-Prereqs"></a>
+## Prereqs
+
+ * Check that Maven is 2.0.10 or higher (mvn --version)
+ * Download and extract eclipse-jee-ganymede-SR2-linux-gtk.tar.gz (this is
+the 3.4 version)
+ * Install Subversion client http://subclipse.tigris.org/update_1.6.x (Just
+the Subclipse and Core)
+ * Install m2eclipse http://m2eclipse.sonatype.org/update/ (Maven
+Integration and Maven optional components)
+
+
+
+<a name="BuildingAries-BuildatthecommandlinethenimportintoEclipseifyouneedEclipse."></a>
+## Build at the command line then import into Eclipse if you need Eclipse.
+This is the easiest way to build Aries and then work on the modules using
+Eclipse. If you don't care about Eclipse go to the next section.
+
+ * check out from the command line {{svn co
+https://svn.apache.org/repos/asf/incubator/aries/trunk aries}}
+ * cd aries
+ * mvn clean
+ * cd parent
+ * mvn install
+ * cd ../eba-maven-plugin
+ * mvn install (*See note below*)
+ * cd ..
+ * mvn install
+ * mvn eclipse:eclipse (should see 'BUILD SUCCESSFUL' message)
+ * fire up eclipse and switch to the Java perspective
+ * import the projects. File->import->General->existing projects into
+workspace. Import 'blueprint, 'jndi', 'testsupport' and 'transaction'
+
+If everything looks good run a	maven build with the target 'install' (adds
+jars to your local repository) or 'package' (just creates jars in your
+workspace). Hit F5 in the package explorer view to refresh and you should
+see packaged jar files under the *target* directories in the projects.
+
+<br>
+
+- - - 
+**Note:**
+Note: There is currently (September 2010) what appears to be a timing issue
+that is causing unpredictable test failures during a full build. If you see
+test failures, try 'mvn install -fae'
+
+- - - 
+<a name="BuildingAries-Justbuildit-noEclipse"></a>
+## Just build it - no Eclipse
+ * check out from the command line {{svn co
+https://svn.apache.org/repos/asf/incubator/aries/trunk aries}}
+ * cd aries
+ * mvn clean
+ * cd parent
+ * mvn install
+ * cd ../eba-maven-plugin
+ * mvn install
+ * cd ..
+ * *mvn -fn install* (-fn continues after failures), or {{mvn -fn
+package}} (alternatively, you can disable the tests with {{mvn
+-Dmaven.test.skip=true install}} with the side-effect of making the build
+process much faster)
+
+<a name="BuildingAries-Eclipseonly"></a>
+## Eclipse only
+This should work if you are command-line averse. On the other hand it seems
+to be the best way to get into a mess with the M2Eclipse plugin.
+
+ * In the SVN view, add the aries repository
+https://svn.apache.org/repos/asf/incubator/aries
+ * Expand the repository, right click on trunk and take 'check out as Maven
+project'
+There will be errors in the projects. To fix these:
+ * Right click on pom/xml in the aries project, select 'run as Maven
+build....'
+ * Type 'clean' in as the build goal
+ * Repeat the process using 'eclipse:eclipse' as the build goals'
+ * Close and re-open all the projects
+
+If there are still failures see the "Fixing failures" step below. If
+everything looks good run a final maven build with the target 'install'
+(adds jars to your local repository) or 'package' (just creates jars in
+your workspace). Hit F5 in the package explorer view to refresh and you
+should see packaged jar files under the *target* directories in the
+projects.
+
+
+<a name="BuildingAries-Fixingfailures"></a>
+## Fixing failures
+
+<a name="BuildingAries-InEclipse"></a>
+##### In Eclipse
+
+You will see some of the blueprint projects don't build. To fix this you
+need to comment out the following line:
+
+    <!-- <classpathentry kind="src"
+    path="/Users/linsun/aries/blueprint/blueprint-api/src/main/resources/org/osgi/service/blueprint"
+    including="blueprint.xsd" excluding="**/*.java"/> -->
+
+
+in the .classpath file in the aries-blueprint-core project.
+
+If there is a build error in the org.apache.aries.blueprint.itests project
+then remove this jar:
+
+    org/apache/felix/org.osgi.foundation/1.2.0.jar
+
+from the project's classpath.
+
+If there is a build error in the aries-jmx-core project then configure this
+project's build path to add the JRE System Library to Java Build Path.
+
+There should be no outstanding errors.
+
+<a name="BuildingAries-Outofmemoryerrors"></a>
+##### Out of memory errors
+You may find that building Aries fails with out of memory exceptions on
+some systems (eg Mac)  if you use the standard Java settings. Setting the
+two environment variables as shown below may help.
+
+    export MAVEN_OPTS="-XX:MaxPermSize=128m -Xms512m -Xmx512m
+    -XX:+HeapDumpOnOutOfMemoryError"
+    export JAVA_OPTS="-Xmx1024m -XX:MaxPermSize=128m
+    -XX:+HeapDumpOnOutOfMemoryError"
+