Demo of disagreements during javadoc inheritance

Test.java

import java.io.IOException;

public class Test {

    public static void main(String[] args) throws IOException {
        SubMultiSuper multiSuper = new SubMultiSuper();
        multiSuper.test(0); // javadoc for the "test" method is the interesting part
    }

    public interface SuperInt1 {
        /**
         * A test.
         */
        int test(int a) throws IOException;
    }

    public interface SuperInt2 extends SuperInt1 {
        /**
         * @param a the a param
         */
        @Override
        int test(int a) throws IOException;
    }

    public interface SuperInt3 {
        /**
         * Never used, shadowed by body in super int 1.
         *
         * @throws IOException never
         */
        int test(int a) throws IOException;
    }

    public interface SuperInt4 {
        /**
         * @return foo
         */
        int test(int a) throws IOException;
    }

    public static class SubMultiSuper implements SuperInt2, SuperInt3, SuperInt4 {
        @Override
        public int test(int a) throws IOException {
            return 0;
        }
    }
}