[MJAVADOC-78] Add a flag to provide standard doclet parameters to custom ones too

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.0
• Fix Version/s: 2.5
• Assignee: Siveton Vincent
• Reporter: Andrea Aime
• Created: 03/Jun/06 12:24
• Updated: 29/Jul/08 17:56
• Resolved: 29/Jul/08 17:56

Description

I'm working on a custom doclet that wraps the standard doclet and add extra behaviour (automated class diagram generation in class javadocs and package javadocs). I want to run it under maven 2, but I've stumbled against the default behaviour: standard doclet parameters such as -link are provided only if the javadoc is the standard one (in AbstractJavadocMojo.java, the check is "if ( StringUtils.isEmpty( doclet ) ) ...").

A generally good behaviour would be not perform assumptions, but to call XXXDoclet.optionLength for each parameter, and see if the doclet accepts them or not (and thus provide only the one accepted). As an alternative, add at least a flag to allow the provision of the standard doclet parameters to the custom ones as well.