From 6d1a51bb79aa429dc2bc268b3ba0305a2c1b15bd Mon Sep 17 00:00:00 2001 From: Herve Boutemy Date: Fri, 8 Jul 2011 22:53:03 +0000 Subject: [PATCH] added documentation found in pom.xml in site git-svn-id: https://svn.apache.org/repos/asf/maven/core-integration-testing/trunk@1144535 13f79535-47bb-0310-9956-ffa450edef68 --- its/core-it-suite/src/site/apt/index.apt | 58 ++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 its/core-it-suite/src/site/apt/index.apt diff --git a/its/core-it-suite/src/site/apt/index.apt b/its/core-it-suite/src/site/apt/index.apt new file mode 100644 index 0000000000..98fee733c1 --- /dev/null +++ b/its/core-it-suite/src/site/apt/index.apt @@ -0,0 +1,58 @@ + ----- + Maven Integration Tests + ----- + Hervé Boutemy + ----- + 2011-07-08 + ----- + +~~ Licensed to the Apache Software Foundation (ASF) under one +~~ or more contributor license agreements. See the NOTICE file +~~ distributed with this work for additional information +~~ regarding copyright ownership. The ASF licenses this file +~~ to you under the Apache License, Version 2.0 (the +~~ "License"); you may not use this file except in compliance +~~ with the License. You may obtain a copy of the License at +~~ +~~ http://www.apache.org/licenses/LICENSE-2.0 +~~ +~~ Unless required by applicable law or agreed to in writing, +~~ software distributed under the License is distributed on an +~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +~~ KIND, either express or implied. See the License for the +~~ specific language governing permissions and limitations +~~ under the License. + +~~ NOTE: For help with the syntax of this file, see: +~~ http://maven.apache.org/doxia/references/apt-format.html + +Maven Integration Tests + + By default, the project just packages the tests in an artifact. To actually run them, activate the profile "run-its": + ++---- +mvn clean test -Prun-its ++---- + + This will subject the Maven version running the build to the integration tests. If you would like to test a different + Maven distribution, you can use the system property "mavenHome" to specify the path of the Maven distribution to test: + ++---- +mvn clean test -Prun-its -DmavenHome= ++---- + + Alternatively, you can just specify the version of a previously installed/deployed Maven distribution which will be + downloaded, unpacked and tested: + ++---- +mvn clean test -Prun-its -DmavenVersion=2.2.1 ++---- + + To run the ITs using embedded Maven 3.x, additionally activate the profile "embedded". + + ITs that don't require to fork Maven can also be run from the IDE using the Maven projects from the workspace if the + Maven dependencies are added to the test class path. + + If you're behind a proxy, use the system properties proxy.host, proxy.port, proxy.user and proxy.pass to specify the + required proxy setup for the ITs. Alternatively, set the system property maven.it.central to a URL of a local + repository manager that proxies the required artifacts.