Available Configuration Options

You can refer to the goal documentation to discover the different configuration options for this plugin.

How to Use

In your pom.xml, insert this segment:

<project>
  ...
  <build>
    ...
  </build>
  ...
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>taglist-maven-plugin</artifactId>
        <version>3.2.1</version>
      </plugin>
    </plugins>
  </reporting>
  ...
</project>

NOTE: If you like having cross references included you need to define the taglist-maven-plugin after maven-jxr-plugin otherwise you will get a warning (See also FAQ).

The report will be generated when executing the site life cycle phase, like this:

mvn site

The TagList plugin allows tags to be found using three matching methods: exact match, ignore case match, and regular expression match. The matched tags are grouped into tag classes. For instance:

<project>
  ...
  <build>
    ...
  </build>
  ...
  <reporting>
    <plugins>
      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>taglist-maven-plugin</artifactId>
        <version>3.2.1</version>
        <configuration>
          <tagListOptions>
            <tagClasses>
              <tagClass>
                <displayName>Todo Work</displayName>
                <tags>
                  <tag>
                    <matchString>todo</matchString>
                    <matchType>ignoreCase</matchType>
                  </tag>
                  <tag>
                    <matchString>FIXME</matchString>
                    <matchType>exact</matchType>
                  </tag>
                </tags>
              </tagClass>
            </tagClasses>
          </tagListOptions>
        </configuration>
      </plugin>
    </plugins>
  </reporting>
  ...
</project>

See also type description taglistOptions.