[ 
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:47 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 javadoc 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. As user doc is set to 
show public & protected classes only, 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)

Reply via email to