Author: marrs
Date: Tue Apr 23 13:13:12 2013
New Revision: 1470938
URL: http://svn.apache.org/r1470938
Log:
Modified the getting started guide after some changes to the release process.
Modified:
ace/site/trunk/content/dev-doc/getting-started.mdtext
Modified: ace/site/trunk/content/dev-doc/getting-started.mdtext
URL:
http://svn.apache.org/viewvc/ace/site/trunk/content/dev-doc/getting-started.mdtext?rev=1470938&r1=1470937&r2=1470938&view=diff
==============================================================================
--- ace/site/trunk/content/dev-doc/getting-started.mdtext (original)
+++ ace/site/trunk/content/dev-doc/getting-started.mdtext Tue Apr 23 13:13:12
2013
@@ -10,17 +10,18 @@ There are two ways to obtain a copy of t
Point your browser to: http://ace.apache.org/download.html
-On that page you will find, amongst others, a link to the latest released
sources. The page will automatically select a download mirror close to you.
Download the archive and then type:
+On that page you will find, amongst others, a link to the latest released
sources, plus an archive containing all binary third-party dependencies. The
page will automatically select a download mirror close to you. Download both
the source and dependencies archive and then type:
:::sh
- $ unzip apache-ace-src-1.0.0.zip
+ $ unzip apache-ace-1.0.0-src.zip
+ $ unzip apache-ace-1.0.0-deps.zip
### Checkout from subversion
:::sh
$ svn co http://svn.apache.org/repos/asf/ace/trunk apache-ace
-In both cases you end up with a copy of the source code in the apache-ace
folder.
+In both cases you end up with a copy of the source code.
## Building the sources
@@ -68,15 +69,27 @@ If you want to develop for ACE, you migh
#### Running & debugging
-One of the benefits of the migration to BndTools is that we can now directly
run ACE from Eclipse with almost zero effort. In fact, it is even possible to
directly debug or profile ACE from Eclipse.
+One of the benefits of the migration to BndTools is that we can now directly
run ACE from Eclipse with almost zero effort. In fact, it is even possible to
directly debug or profile ACE from Eclipse. All runnable projects start with
"run-" and contain a ".bndrun" file.
##### ACE server
-To run or debug the ACE server, you open up the "<tt>server.bndrun</tt>" file
in the "run-server" project. This will present you with a view in which you can
directly choose to run it (use "Run OSGi") or debug it (use "Debug OSGi").
Alternatively, you can right click on "server.bndrun" and choose either "Run As
-> OSGi Run" or "Debug As -> OSGi Run".
+To run or debug the ACE server, you open up the "<tt>server.bndrun</tt>" file
in the "run-server" project. This will present you with a view in which you can
directly choose to run it (use "Run OSGi") or debug it (use "Debug OSGi").
Alternatively, you can right click on "server.bndrun" and choose either "Run As
-> Bnd OSGi Run Launcher" or "Debug As -> Bnd OSGi Run Launcher".
+
+##### ACE obr
+
+To run or debug the ACE obr, you open up the "<tt>obr.bndrun</tt>" file in the
"run-obr" project. This will present you with a view in which you can directly
choose to run it (use "Run OSGi") or debug it (use "Debug OSGi").
Alternatively, you can right click on "obr.bndrun" and choose either "Run As ->
Bnd OSGi Run Launcher" or "Debug As -> Bnd OSGi Run Launcher".
+
+##### ACE client
+
+To run or debug the ACE client, you open up the "<tt>client.bndrun</tt>" file
in the "run-client" project. This will present you with a view in which you can
directly choose to run it (use "Run OSGi") or debug it (use "Debug OSGi").
Alternatively, you can right click on "client.bndrun" and choose either "Run As
-> Bnd OSGi Run Launcher" or "Debug As -> Bnd OSGi Run Launcher".
+
+##### ACE server-allinone
+
+To run or debug the "all in one" ACE server, you open up the
"<tt>server-allinone.bndrun</tt>" file in the "run-server-allinone" project.
This will present you with a view in which you can directly choose to run it
(use "Run OSGi") or debug it (use "Debug OSGi"). Alternatively, you can right
click on "server-allinone.bndrun" and choose either "Run As -> Bnd OSGi Run
Launcher" or "Debug As -> Bnd OSGi Run Launcher".
##### ACE target
-You can also directly run a target from Eclipse. Doing this is almost equal as
running the ACE server described in the previous section. The only difference
is that for running a target, you need to use the "<tt>target.bndrun</tt>" file
from the "run-target" project.
+You can also directly run a target from Eclipse. Doing this is almost equal as
running the ones described in the previous sections. The only difference is
that for running a target, you need to use the "<tt>target.bndrun</tt>" file
from the "run-target" project.
##### Unit tests
