Uploaded image for project: 'Maven Surefire'
  1. Maven Surefire
  2. SUREFIRE-1348

Documentation of parameter "argLine" for goal "surefire:test" lacks mention of a key change made in v2.17

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: 2.12, 2.12.1, 2.12.2, 2.12.3, 2.12.4, 2.13, 2.14, 2.14.1, 2.15, 2.16
    • Fix Version/s: 2.20
    • Component/s: Maven Surefire Plugin
    • Labels:
      None

      Description

      The documentation for the argLine parameter here indicates "since v2.1" and the description refers to the @

      {argLine} syntax but doesn't mention that you have to be using surefire-maven-plugin v2.17 or greater for that functionality to work. See "SUREFIRE-1047 - Add @{...} property evaluation for the argLine".

      Probably the goal arguments page plus the FAQ page that it links to should be updated with a mention of the minimum required maven-surefire-plugin version.


      I noticed this while experiencing issue "SUREFIRE-1273". Resolution of that issue should have been simple but I was on surefire-maven-plugin v2.12 and the documentation made it appear that @{argLine}

      was supported since v2.1. I needed to upgrade but there wasn't any obvious indication of that.

        Activity

        Hide
        hudson Hudson added a comment -

        SUCCESS: Integrated in Jenkins build maven-surefire #1686 (See https://builds.apache.org/job/maven-surefire/1686/)
        SUREFIRE-1348 Documentation of parameter "argLine" for goal (tibor17: http://git-wip-us.apache.org/repos/asf/?p=maven-surefire.git&a=commit&h=04a90a8a93077090b74ab0c585ee019b63d0f217)

        • (edit) maven-surefire-plugin/src/site/fml/faq.fml
        • (edit) maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/AbstractSurefireMojo.java
        Show
        hudson Hudson added a comment - SUCCESS: Integrated in Jenkins build maven-surefire #1686 (See https://builds.apache.org/job/maven-surefire/1686/ ) SUREFIRE-1348 Documentation of parameter "argLine" for goal (tibor17: http://git-wip-us.apache.org/repos/asf/?p=maven-surefire.git&a=commit&h=04a90a8a93077090b74ab0c585ee019b63d0f217 ) (edit) maven-surefire-plugin/src/site/fml/faq.fml (edit) maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/AbstractSurefireMojo.java
        Show
        tibor17 Tibor Digana added a comment - https://git-wip-us.apache.org/repos/asf?p=maven-surefire.git;a=commit;h=04a90a8a93077090b74ab0c585ee019b63d0f217
        Hide
        tibor17 Tibor Digana added a comment -

        I will mention Version 2.17.

        Show
        tibor17 Tibor Digana added a comment - I will mention Version 2.17 .
        Hide
        tibor17 Tibor Digana added a comment -

        Gordon Daugherty
        Do you want to document that new syntax using @{} was introduced in Version 2.17?
        You can open pull-request in GitHub and fix it right there. First of all please check the git history of parameter argLine in class AbstractSurefireMojo.
        We plan a new release of 2.20. Do you want me to include your fix in 2.20?

        Show
        tibor17 Tibor Digana added a comment - Gordon Daugherty Do you want to document that new syntax using @{} was introduced in Version 2.17? You can open pull-request in GitHub and fix it right there. First of all please check the git history of parameter argLine in class AbstractSurefireMojo . We plan a new release of 2.20. Do you want me to include your fix in 2.20?

          People

          • Assignee:
            tibor17 Tibor Digana
            Reporter:
            gjd6640 Gordon Daugherty
          • Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved:

              Development