You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by rj...@apache.org on 2017/04/15 18:44:33 UTC
svn commit: r1791534 - in /tomcat/tc7.0.x/trunk: BUILDING.txt
webapps/docs/changelog.xml
Author: rjung
Date: Sat Apr 15 18:44:33 2017
New Revision: 1791534
URL: http://svn.apache.org/viewvc?rev=1791534&view=rev
Log:
Document the property test.excludePerformance
in BUILDING.txt (plus slightly reduce unneeded
delta to TC8.0.x).
Modified:
tomcat/tc7.0.x/trunk/BUILDING.txt
tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml
Modified: tomcat/tc7.0.x/trunk/BUILDING.txt
URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/BUILDING.txt?rev=1791534&r1=1791533&r2=1791534&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/BUILDING.txt (original)
+++ tomcat/tc7.0.x/trunk/BUILDING.txt Sat Apr 15 18:44:33 2017
@@ -321,7 +321,6 @@ directory:
output/build/logs
-
By default the testsuite is run three times to test 3 different
implementations of Tomcat connectors: BIO, NIO and APR. (If you are not
familiar with Tomcat connectors, see config/http.html in documentation for
@@ -446,19 +445,29 @@ as for the property "test.name".
output/coverage
- 6. Some tests include checks that the access log valve entries are as expected.
+ 6. The performance tests are written to run reasonably powerful machines (such
+ as a developer may use day to day) assuming no other resource hungry
+ processes are running.
+
+ These assumptions are not always true (e.g. on CI systems running in a
+ virtual machine) so the performance tests may be disabled by using the
+ following property:
+
+ test.excludePerformance=true
+
+ 7. Some tests include checks that the access log valve entries are as expected.
These checks include timings. On slower / loaded systems these checks will
often fail. The checks may be relaxed by using the following property:
test.relaxTiming=true
- 7. It is known that some platforms (e.g. OSX El Capitan) require IPv4 to
+ 8. It is known that some platforms (e.g. OSX El Capitan) require IPv4 to
be the default for the multicast tests to work. This is configured by
the following property:
java.net.preferIPv4Stack=true
- 8. It is possible to control whether the output of the tests is displayed
+ 9. It is possible to control whether the output of the tests is displayed
on the console or not. By default it is displayed and can be disabled
by the following property:
@@ -471,6 +480,8 @@ as for the property "test.name".
* NOTE: Checkstyle is licensed under LGPL. Using Checkstyle during Tomcat
build is optional and is off by default.
+ See http://checkstyle.sourceforge.net/ for more information.
+
Tomcat comes with a Checkstyle configuration that tests its source code
for certain conventions, like presence of the license header.
@@ -486,7 +497,7 @@ is located in the following directory:
output/res/checkstyle
-It is possible to run the check separately by invoking the "validate"
+It is possible to run the check separately by calling the "validate"
target. The command is:
cd ${tomcat.source}
Modified: tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml
URL: http://svn.apache.org/viewvc/tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml?rev=1791534&r1=1791533&r2=1791534&view=diff
==============================================================================
--- tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml (original)
+++ tomcat/tc7.0.x/trunk/webapps/docs/changelog.xml Sat Apr 15 18:44:33 2017
@@ -61,6 +61,10 @@
<subsection name="General">
<changelog>
<add>
+ Document the property <code>test.excludePerformance</code>
+ in BUILDING.txt. (rjung)
+ </add>
+ <add>
Allow to exclude JUnit test classes using the build property
<code>test.exclude</code> and document the property in
BUILDING.txt. (rjung)
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org