Re: [DISCUSS] Migrate to Yetus Interface classification annotations

Thanks Masatake for the suggestions. I agree that until Yetus comes to final conclusion on whether to keep or drop IA/IS annotations for higher JDK versions (or fix/drop doclet support), we should hold on for now. Thanks Sean and Akira for providing the context. On Tue, 28 Sep 2021 at 6:55 PM,

Re: [DISCUSS] Migrate to Yetus Interface classification annotations

Thanks, Akira and Viraj. My understanding is that we have options like 1. migrate org.apache.yetus:audience-annotations to Java >= 9 then migrate Hadoop to the new org.apache.yetus:audience-annotations. 2. "use the Jigsaw feature to export only @Public elements to other projects and

Re: [DISCUSS] Migrate to Yetus Interface classification annotations

> The problem comes from the removal of com.sun.tools.doclets.* packages Agree. Here is the summary of the replacement package *jdk.javadoc.doclet*. Here is the migration guide

Re: [DISCUSS] Migrate to Yetus Interface classification annotations

Hi Masatake, The problem comes from the removal of com.sun.tools.doclets.* packages in Java 10. In Apache Hadoop, I removed the doclet support for filtering javadocs when the environment is Java 10 or upper. https://issues.apache.org/jira/browse/HADOOP-15304 Thanks, Akira On Tue, Sep 28, 2021

Re: [DISCUSS] Migrate to Yetus Interface classification annotations

In particular, there has been an outstanding problem with doclet support for filtering javadocs by annotation since JDK9 came out. Could you give me a pointer to relevant Yetus JIRA or ML thread? On 2021/09/28 1:17, Sean Busbey wrote: I think consolidating on a common library and tooling for

Re: [DISCUSS] Migrate to Yetus Interface classification annotations

I think consolidating on a common library and tooling for defining API expectations for Hadoop would be great. Unfortunately, the Apache Yetus community recently started a discussion around dropping their maintenance of the audience annotations codebase[1] due to lack of community interest. In

[DISCUSS] Migrate to Yetus Interface classification annotations

Since the early days, Hadoop has provided Interface classification annotations to represent the scope and stability for downstream applications to select Hadoop APIs carefully. After some time, these annotations (InterfaceAudience and InterfaceStability) have been migrated to Apache Yetus. As of