X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=README.md;h=04a1ced64dcb0f8cf189f1aeeec591273483bd96;hb=refs%2Fheads%2Fnext-previous-event;hp=f4b4cba584700def3a35fcda826e8342ecbb389a;hpb=634e7ffd47ecb706d382fe77976ec0c94e60b912;p=deliverable%2Ftracecompass.git diff --git a/README.md b/README.md index f4b4cba584..04a1ced64d 100644 --- a/README.md +++ b/README.md @@ -34,7 +34,10 @@ wiki page: Compiling manually ------------------ -To build the plugins manually using Maven, simply run the following command from +The Maven project build requires version 3.3 or later. It can be downloaded from + or from the package management system of your distro. + +To build the project manually using Maven, simply run the following command from the top-level directory: mvn clean install @@ -45,33 +48,42 @@ take some time, to skip them you can append `-Dmaven.test.skip=true` to the mvn clean install -Dmaven.test.skip=true -The RCP is not built by default, to build it you need to add `-Pbuild-rcp` to -the `mvn` command: - - mvn clean install -Pbuild-rcp -Dmaven.test.skip=true +Stand-alone application (RCP) packages will be placed in +`rcp/org.eclipse.tracecompass.rcp.product/target/products`. -This will build the RCP for all supported architectures. The resulting archives -will be placed in `rcp/org.eclipse.tracecompass.rcp.product/target/products`. - -These commands will also build the p2 update site, which will be placed in -`releng/org.eclipse.tracecompass.releng-site/target/repository`. +The p2 update site, used for installation as plugins inside Eclipse, will be +placed in `releng/org.eclipse.tracecompass.releng-site/target/repository`. Maven profiles and properties ----------------------------- -The following Maven profiles, and their corresponding properties, are defined in +The following Maven profiles and properties are defined in the build system. You can set them by using `-P[profile name]` and `-D[property name]=[value]` in `mvn` commands. +* `-Dtarget-platform=[target]` + + Defines which target to use. This is used to build against various versions of + the Eclipse platform. Available ones are in + `releng/org.eclipse.tracecompass.target`. The default is usually the latest + stable platform. To use the staging target for example, use + `-Dtarget-platform=tracecompass-eStaging`. + * `-Pctf-grammar` Re-compiles the CTF grammar files. This should be enabled if you modify the `.g` files in the `ctf.parser` plugin. -* `-Pbuild-rcp` +* `-P -build-rcp` + + Disables the "build-rcp" profile to skip building the RCP archives. + +* `-Prun-custom-test-suite` - Builds the RCP archives. Refer to the previous section for details. + Runs a test suite present in `releng/org.eclipse.tracecompass.alltests`. The + test suite to run has to be defined by `-DcustomTestSuite=[name]`, for example + `-DcustomTestSuite=RunAllPerfTests`. * `-Pdeploy-rcp`