[
https://issues.apache.org/jira/browse/HBASE-12310?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14178731#comment-14178731
]
Andrew Purtell edited comment on HBASE-12310 at 10/21/14 5:54 PM:
------------------------------------------------------------------
Understood that we needed to clone/fork the Hadoop doclet code once we created
our own interface annotations. Maybe we do not and should not need to use
Hadoop's custom doclet either. If they are using the same build time
configuration to build their doclet I'm not sure what the long term disposition
of it is. Maybe there is some way to filter what we want with the default
doclet. Maybe creating user API docs is problematic enough to not be worth the
hassle. For discussion.
was (Author: apurtell):
Understood that we needed to clone/fork the Hadoop doclet code once we created
our own interface annotations. Maybe we do not and should not need to use
Hadoop's custom doclet either.
> Remove custom doclet from hbase-annotations
> -------------------------------------------
>
> Key: HBASE-12310
> URL: https://issues.apache.org/jira/browse/HBASE-12310
> Project: HBase
> Issue Type: Bug
> Reporter: Andrew Purtell
>
> 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?
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
