Maven Project Web Site
  1. Maven Project Web Site
  2. MNGSITE-128

Inconsistent, missing docs for maven plugin naming conventions and auto operations based on that

    Details

    • Type: Improvement Improvement
    • Status: Closed Closed
    • Priority: Minor Minor
    • Resolution: Fixed
    • Labels:
      None
    • Number of attachments :
      0

      Description

      The page http://maven.apache.org/guides/plugin/guide-java-plugin-development.html has a small entry under "shortening the command line" which says that artifactId patterns maven-$name-plugin and $name-maven-plugin are treated specially (by convention).

      The email of Sep 27, 2008 to maven users list, from Stephen Connolly says

      AFAIK only plugins with the groupId org.apache.maven.plugins are allowed to
      use the maven-______-plugin pattern. I could not find this documented (other than on the users email list.).

      The page http://maven.apache.org/guides/introduction/introduction-to-plugin-prefix-mapping.html

      says that the conventional mappings only happen for the "maven-$name-plugin" style, and don't mention the other style ($name-maven-plugin).

      I recommend using the text from the 1st ref (which seems to be the clearest) as a starting point, to augment and expand the text in the 3rd ref.

      The Complete Reference book is missing this information, as well, I believe.

        Activity

        Hide
        Brett Porter added a comment -

        actually, the first description wasn't very accurate when you read the whole paragraph. I've clarified the 3rd, and made the 1st reference it for more information.

        We don't have any influence over the Sonatype books, you'd need to file bugs there with them.

        Show
        Brett Porter added a comment - actually, the first description wasn't very accurate when you read the whole paragraph. I've clarified the 3rd, and made the 1st reference it for more information. We don't have any influence over the Sonatype books, you'd need to file bugs there with them.

          People

          • Assignee:
            Brett Porter
            Reporter:
            Marshall Schor
          • Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: