You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@hbase.apache.org by "Jonathan Hsieh (JIRA)" <ji...@apache.org> on 2013/09/20 08:29:54 UTC
[jira] [Comment Edited] (HBASE-9585) Update javadoc builder in pom
to exclude empty packages in user api javadoc
[ https://issues.apache.org/jira/browse/HBASE-9585?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13772651#comment-13772651 ]
Jonathan Hsieh edited comment on HBASE-9585 at 9/20/13 6:28 AM:
----------------------------------------------------------------
The original patch is the only way we can do it to get the result that we want via pom configuration.
I tried using mvn <subpackages> tag but it is recursively inclusive. [1] The mvn <excludePackageNames> tag is recursively inclusive but applied after the subpackages tag adds package. [2]. These are essentially just passed to the javadoc commands cmd line args.
[1] http://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#subpackages
[2] http://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#excludePackageNames
was (Author: jmhsieh):
The original patch is the only we can do to get the result that we want via pom configuration.
I tried using mvn <subpackages> tag but it is recursively inclusive. [1] The mvn <excludePackageNames> tag is recursively inclusive but applied after the subpackages tag adds package. [2]. These are essentially just passed to the javadoc commands cmd line args.
[1] http://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#subpackages
[2] http://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#excludePackageNames
> Update javadoc builder in pom to exclude empty packages in user api javadoc
> ---------------------------------------------------------------------------
>
> Key: HBASE-9585
> URL: https://issues.apache.org/jira/browse/HBASE-9585
> Project: HBase
> Issue Type: Sub-task
> Components: documentation
> Reporter: Jonathan Hsieh
> Assignee: Jonathan Hsieh
> Attachments: hbase-9585.patch, user-javadoc.png
>
>
> There are many packages that have no apis exposed but are present in the javadoc after the @InterfaceAudience.Public apis. Make them go away.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira