britter commented on a change in pull request #217: Set properties readonly 
where it doesn't make sense to change values
URL: https://github.com/apache/maven-surefire/pull/217#discussion_r253294402
 
 

 ##########
 File path: 
maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/AbstractSurefireMojo.java
 ##########
 @@ -242,11 +242,12 @@
     private String[] additionalClasspathElements;
 
     /**
-     * The test source directory containing test class sources.
+     * The test source directory containing test class sources. Only used by 
the TestNG provider to process JavaDoc
+     * tags.
      *
      * @since 2.2
      */
-    @Parameter( defaultValue = "${project.build.testSourceDirectory}", 
required = true )
+    @Parameter( defaultValue = "${project.build.testSourceDirectory}", 
readonly = true )
 
 Review comment:
   The problem I'm having with this being marked as required is, that is will 
make `testSourceDirectory` show up at the very top of the [documentation 
page](https://maven.apache.org/surefire/maven-surefire-plugin/test-mojo.html). 
This unnecessary highlights a property that is only used by legacy 
implementations of TestNG. As said above, I would remove it completely.

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
[email protected]


With regards,
Apache Git Services

Reply via email to