The MailetDocs plugin for Maven2 finds all mailets and matchers (as defined by the Mailet API). It generates reports on each and then combines all into a single catalog.
To include the generated documentation, this should be included in the reports generated for a project:
<reporting>
...
<plugins>
<plugin>
<groupId>org.apache.james</groupId>
<artifactId>maven-mailetdocs-plugin</artifactId>
<version>0.1</version>
</plugin>
...
</plugins>
</reporting>