[
https://issues.apache.org/jira/browse/HBASE-21861?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16765589#comment-16765589
]
Sakthi edited comment on HBASE-21861 at 2/12/19 1:50 AM:
---------------------------------------------------------
In branch-2.0, looks like user doc was being generated for
"InterfaceAudience.Private" annotations as well. It should have been only for
public annotations. Looks like it was commented out due to HBASE-19663. I tried
uncommenting it again and built the website. It was a successful build.
Also it eliminates the case where private-annotated public class's javadoc
refers to a inherited package-private class's members. But, as user doc is set
to show public & protected classes only and not package-private classes, this
results in a "missing file" issue.
After this change, now these private-annotated classes' wouldn't be visible
from user doc but would still be accessible from dev doc.
was (Author: jatsakthi):
In branch-2.0, looks like user doc was being generated for
"InterfaceAudience.Private" annotations as well. It should have been only for
public annotations. Looks like it was commented out due to HBASE-19663. I tried
uncommenting it again and built the website. It was a successful build.
Also it eliminates the case where private-annotated public class's javadoc
refers to a inherited package-private class's members. But, as user doc is set
to show public & protected classes only and not package-private classes, this
results in a "missing file" issue.
After this change, now these private-annotated javadoc wouldn't be visible from
user doc but would still be accessible from dev doc.
> Handle the missing file issues from the Linkchecker job
> -------------------------------------------------------
>
> Key: HBASE-21861
> URL: https://issues.apache.org/jira/browse/HBASE-21861
> Project: HBase
> Issue Type: Sub-task
> Reporter: Sakthi
> Assignee: Sakthi
> Priority: Major
> Fix For: 1.2.11
>
> Attachments: hbase-21861.branch-1.2.001.patch,
> hbase-21861.branch-2.0.001.patch, hbase-21861.master.001.patch
>
>
> The parent jira contains the numbers for the missing files. This jira is to
> track specifically the fixes in that aspect.
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
