Repository: maven-surefire Updated Branches: refs/heads/master f79aa400a -> cf6e75c8f
SUREFIRE-1309: Clarifying use of regular expressions for inclusion/exclusion Project: http://git-wip-us.apache.org/repos/asf/maven-surefire/repo Commit: http://git-wip-us.apache.org/repos/asf/maven-surefire/commit/cf6e75c8 Tree: http://git-wip-us.apache.org/repos/asf/maven-surefire/tree/cf6e75c8 Diff: http://git-wip-us.apache.org/repos/asf/maven-surefire/diff/cf6e75c8 Branch: refs/heads/master Commit: cf6e75c8f1707cfcc12ccd7f1dbc95f2569ac252 Parents: f79aa40 Author: Sander Verhagen <[email protected]> Authored: Mon Dec 26 23:39:56 2016 -0800 Committer: Tibor17 <[email protected]> Committed: Wed Dec 28 17:25:51 2016 +0100 ---------------------------------------------------------------------- .../src/site/apt/examples/inclusion-exclusion.apt.vm | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/maven-surefire/blob/cf6e75c8/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt.vm ---------------------------------------------------------------------- diff --git a/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt.vm b/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt.vm index 22b1ce2..e5d3408 100644 --- a/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt.vm +++ b/maven-surefire-plugin/src/site/apt/examples/inclusion-exclusion.apt.vm @@ -5,7 +5,7 @@ ------ 2010-01-09 ------ - + ~~ 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 @@ -164,7 +164,16 @@ Inclusions and Exclusions of Tests +---+ Note the syntax <<<%regex[expr]>>>, where <<<expr>>> is the actual expression and the rest is just wrapping. Also - note that regex matches are done over <<<*.class>>> files and not <<<*.java>>> files. + note the following about the use of regular expressions: + + * Regex matches are done over <<<*.class>>> files and not <<<*.java>>> files + + * Regex matches are done over paths using slashes ("<<</>>>") and not package names using dots ("<<<.>>>"), so the + "<<<.>>>" in <<<pkg.*Slow.*.class>>> is a regex metacharacter, which happens to match any character, notably + the (forward) slashes ("<<</>>>") that make up the path. Slashes here are <forward>, even on Windows + + * The trailing <<<.class>>> is interpreted literally, and not as a regular expression ("<<<\.class>>>" does not + work here) * Multiple Formats in One
