[HBASE-12310] Remove custom doclet from hbase-annotations

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Not A Problem
• Assignee: Unassigned
• Reporter: Andrew Kyle Purtell
• Created: 21/Oct/14 17:38
• Updated: 17/Jun/22 17:47
• Resolved: 24/Dec/14 19:18

Description

hbase-annotations includes a custom doclet used for filtering APIs out of the user API javadoc given our project specific interface annotations. However, this is problematic for a few reasons:

• To build the doclet we include a system scope dependency to tools.jar. Default Nexus rules disallow that. Staging downstream HBase artifacts will be problematic. I don't know how we were able to release 0.98.7 with this in place. I think someone will be looking into the Apache Nexus configuration.
• As I understand it, system scope dependencies will not be supported by Maven 4 because they've been determined to be generally problematic.
• As busbey mentioned on HBASE-12299, the root pom specifies the javadoc dependency for all modules and it creates a circular need with the hbase-annotations module.

Do we really need a custom doclet? Can we simply remove all of this?

Issue Links

• relates to: HBASE-12299 Can't assemble tarballs after HBASE-12261