Re: [DISCUSS] Migrate to Yetus Interface classification annotations

2021-09-29 Thread Viraj Jasani
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, Ma

Re: [DISCUSS] Migrate to Yetus Interface classification annotations

2021-09-28 Thread Masatake Iwasaki
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 creat

Re: [DISCUSS] Migrate to Yetus Interface classification annotations

2021-09-28 Thread Viraj Jasani
> 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

2021-09-28 Thread Akira Ajisaka
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 at

Re: [DISCUSS] Migrate to Yetus Interface classification annotations

2021-09-27 Thread Masatake Iwasaki
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

2021-09-27 Thread Sean Busbey
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