Mailing-List: contact ace-commits-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: ace-dev@incubator.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1207101 -
 /incubator/ace/branches/0.8.1-RC/ace-pom/README.txt
Date: Mon, 28 Nov 2011 12:19:24 -0000
To: ace-commits@incubator.apache.org
From: marrs@apache.org
Message-Id: <20111128121924.D71B123888FD@eris.apache.org>

Author: marrs
Date: Mon Nov 28 12:19:24 2011
New Revision: 1207101

URL: http://svn.apache.org/viewvc?rev=1207101&view=rev
Log:
Adding README to top level dir.

Added:
    incubator/ace/branches/0.8.1-RC/ace-pom/README.txt

Added: incubator/ace/branches/0.8.1-RC/ace-pom/README.txt
URL: http://svn.apache.org/viewvc/incubator/ace/branches/0.8.1-RC/ace-pom/README.txt?rev=1207101&view=auto
==============================================================================
--- incubator/ace/branches/0.8.1-RC/ace-pom/README.txt (added)
+++ incubator/ace/branches/0.8.1-RC/ace-pom/README.txt Mon Nov 28 12:19:24 2011
@@ -0,0 +1,47 @@
+Apache ACE
+==========
+
+Apache ACE is a software distribution framework that allows you to centrally manage and distribute software components, configuration data and other artifacts to target systems. It is built using OSGi and can be deployed in different topologies. The target systems are usually also OSGi based, but don't have to be.
+
+Go to the website for more information about ACE:
+http://incubator.apache.org/ace/
+
+
+Building from source
+--------------------
+
+Prerequisites
+
+ - Java 6 SDK
+ - Maven 2.2.1
+
+
+Building the full source distribution
+
+For convenience, when we do a full distribution of all the components that make up Apache ACE, we also release a component that contains all the sources. This helps you get started with the source code of the project more easily. You need an artifact called 'ace-release-full', which you unzip and then build like this:
+
+mvn install
+
+
+Building all artifacts at once
+
+Another way to build the full project, is to download all the individual source components that make up Apache ACE, unzip each of them (they should all extract into their own folder) and then at the top level, build the project like this:
+
+mvn -r install
+
+Note: this does not work with Maven 3 (which does not have the -r option)
+
+
+Building a single artifact
+
+The final way to build the project, is by building a single source component. You can do that as long as you have the dependencies that are required by this project installed in either your local Maven cache, or in the repository at Apache. Getting all dependencies in your local Maven cache can be done by either downloading and installing them by hand (if you actually run Maven and a dependency is missing, it will explain you how to do that) or by doing a full source build once. Building the artifact is done like this:
+
+mvn install
+
+
+Getting Started
+---------------
+
+Detailed instructions on how to proceed once you've built the whole project, can be found on the Apache ACE website:
+
+http://incubator.apache.org/ace/getting-started.html