This is an automated email from the ASF dual-hosted git repository.
markt pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/tomcat.git
commit 8e05a017af74642068b56cadec25f93ebbf75dad
Author: Mark Thomas <ma...@apache.org>
AuthorDate: Mon Jan 8 12:11:41 2024 +0000
Update the docs for running the tests
---
BUILDING.txt | 17 ++++++++++++++---
1 file changed, 14 insertions(+), 3 deletions(-)
diff --git a/BUILDING.txt b/BUILDING.txt
index 0acef652a1..d4e248b7b0 100644
--- a/BUILDING.txt
+++ b/BUILDING.txt
@@ -492,9 +492,20 @@ NOTE: Cobertura is licensed under GPL v2 with parts of it
being under
(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 deactivated by using the
- following property:
+ Performance tests may be an absolute test (how long to complete a number
+ of iterations of an operation or set of operations) or may be a relative
+ test (how long two or more different approaches take to generate the same
+ result). The absolute tests may be destructive in that they run until the
+ system runs out of resources.
+
+ Where there is no benefit in running an absolute performance test as part
+ of a standard test run, the test will be excluded by naming it
+ Tester*Performance.java.
+
+ The relative tests are included as part of a standard test run however,
+ where the assumptions made about host capabilities are not true (e.g. on
+ CI systems running in virtual machine) the tests may be deactivated by
+ using the following property:
test.excludePerformance=true
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
