--- old/test/com/sun/javadoc/InheritDocForUserTags/DocTest.java Fri Jan 22 12:21:32 2016 +++ /dev/null Fri Jan 22 12:21:32 2016 @@ -1,248 +0,0 @@ -/* - * Copyright (c) 2013, 2015, Oracle and/or its affiliates. All rights reserved. - * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. - * - * This code is free software; you can redistribute it and/or modify it - * under the terms of the GNU General Public License version 2 only, as - * published by the Free Software Foundation. - * - * This code is distributed in the hope that it will be useful, but WITHOUT - * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or - * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License - * version 2 for more details (a copy is included in the LICENSE file that - * accompanied this code). - * - * You should have received a copy of the GNU General Public License version - * 2 along with this work; if not, write to the Free Software Foundation, - * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. - * - * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA - * or visit www.oracle.com if you need additional information or have any - * questions. - */ - -/* - * @test - * @bug 8008768 - * @summary Using {@inheritDoc} in simple tag defined via -tag fails - * @author Mike Duigou - * @library ../lib - * @modules jdk.javadoc - * @build JavadocTester - * @run main DocTest - */ - -/** - * DocTest documentation. - * - * @apiNote DocTest API note. - * @implSpec DocTest implementation spec. - * @implNote DocTest implementation note. - */ -public class DocTest extends JavadocTester { - public static void main(String... args) throws Exception { - DocTest tester = new DocTest(); - tester.runTests(); - } - - @Test - void test() { - javadoc("-verbose", - "-d", "DocTest", - "-tag", "apiNote:optcm:API Note", - "-tag", "implSpec:optcm:Implementation Requirements:", - "-tag", "implNote:optcm:Implementation Note:", - "-package", - testSrc("DocTest.java") - ); - checkExit(Exit.OK); - - // javadoc does not report an exit code for an internal exception (!) - // so monitor stderr for stack dumps. - checkOutput(Output.STDERR, false, "at com.sun"); - } - - /** - * DocTest() documentation. - * - * @apiNote DocTest() API note. - * @implSpec DocTest() implementation spec. - * @implNote DocTest() implementation note. - */ - public DocTest() { - } - - /** - * DocTest.testMethod() documentation. - * - * @apiNote DocTest.testMethod() API note. - * @implSpec DocTest.testMethod() implementation spec. - * @implNote DocTest.testMethod() implementation note. - */ - public void testMethod() { - } -} - -/** - * DocTestWithTags documentation. - * - * @apiNote DocTestWithTags API note. - *
- *    DocTestWithTags API note code sample.
- * 
- * @implSpec DocTestWithTags implementation spec. - *
- *    DocTestWithTags implementation spec code sample.
- * 
- * @implNote DocTestWithTags implementation note. - *
- *    DocTestWithTags implementation note code sample.
- * 
- */ -class DocTestWithTags { - - /** - * DocTestWithTags() documentation. - * - * @apiNote DocTestWithTags() API note. - *
-     *    DocTestWithTags() API note code sample.
-     * 
- * @implSpec DocTestWithTags() implementation spec. - *
-     *    DocTestWithTags() implementation spec code sample.
-     * 
- * @implNote DocTest() implementation note. - *
-     *    DocTest() implementation note code sample.
-     * 
- */ - public DocTestWithTags() { - } - - /** - * DocTest.testMethod() documentation. - * - * @apiNote DocTestWithTags.testMethod() API note. - *
-     *    DocTestWithTags.testMethod() API note code sample.
-     * 
- * @implSpec DocTestWithTags.testMethod() implementation spec. - *
-     *    DocTestWithTags.testMethod() API implementation spec code sample.
-     * 
- * @implNote DocTest.testMethod() implementation note. - *
-     *    DocTest.testMethod() API implementation code sample.
-     * 
- */ - public void testMethod() { - } -} - -class MinimallyExtendsDocTest extends DocTest { -} - -/** - * SimpleExtendsDocTest documentation. - */ -class SimpleExtendsDocTest extends DocTest { - - /** - * SimpleExtendsDocTest() documentation. - */ - public SimpleExtendsDocTest() { - - } - - /** - * SimpleExtendsDocTest.testMethod() documenation. - */ - @java.lang.Override - public void testMethod() { - } -} - -/** - * {@inheritDoc} - */ -class SimpleInheritDocDocTest extends DocTest { - - /** - * {@inheritDoc} - */ - public SimpleInheritDocDocTest() { - } - - /** - * {@inheritDoc} - */ - @java.lang.Override - public void testMethod() { - } -} - -/** - * {@inheritDoc} - * - * @apiNote {@inheritDoc} - * @implSpec {@inheritDoc} - * @implNote {@inheritDoc} - */ -class FullInheritDocDocTest extends DocTest { - - /** - * {@inheritDoc} - * - * @apiNote {@inheritDoc} - * @implSpec {@inheritDoc} - * @implNote {@inheritDoc} - */ - public FullInheritDocDocTest() { - - } - - /** - * {@inheritDoc} - * - * @apiNote {@inheritDoc} - * @implSpec {@inheritDoc} - * @implNote {@inheritDoc} - */ - @java.lang.Override - public void testMethod() { - } -} - -/** - * {@inheritDoc} and FullInheritDocPlusDocTest documentation. - * - * @implSpec {@inheritDoc} and FullInheritDocPlusDocTest API note. - * @implNote {@inheritDoc} and FullInheritDocPlusDocTest implementation specification. - * @apiNote {@inheritDoc} and FullInheritDocPlusDocTest implementation note. - */ -class FullInheritDocPlusDocTest extends DocTest { - - /** - * {@inheritDoc} and FullInheritDocPlusDocTest() documentation. - * - * @implSpec {@inheritDoc} and FullInheritDocPlusDocTest() API note. - * @implNote {@inheritDoc} and FullInheritDocPlusDocTest() implementation specification. - * @apiNote {@inheritDoc} and FullInheritDocPlusDocTest() implementation note. - */ - public FullInheritDocPlusDocTest() { - - } - - /** - * {@inheritDoc} and FullInheritDocPlusDocTest.testMethod() documentation. - * - * @implSpec {@inheritDoc} and FullInheritDocPlusDocTest.testMethod() API note. - * @implNote {@inheritDoc} and FullInheritDocPlusDocTest.testMethod() implementation specification. - * @apiNote {@inheritDoc} and FullInheritDocPlusDocTest.testMethod() implementation note. - */ - @java.lang.Override - public void testMethod() { - } -} - --- /dev/null Fri Jan 22 12:21:32 2016 +++ new/test/jdk/javadoc/doclet/InheritDocForUserTags/DocTest.java Fri Jan 22 12:21:32 2016 @@ -0,0 +1,248 @@ +/* + * Copyright (c) 2013, 2015, Oracle and/or its affiliates. All rights reserved. + * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. + * + * This code is free software; you can redistribute it and/or modify it + * under the terms of the GNU General Public License version 2 only, as + * published by the Free Software Foundation. + * + * This code is distributed in the hope that it will be useful, but WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + * version 2 for more details (a copy is included in the LICENSE file that + * accompanied this code). + * + * You should have received a copy of the GNU General Public License version + * 2 along with this work; if not, write to the Free Software Foundation, + * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. + * + * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA + * or visit www.oracle.com if you need additional information or have any + * questions. + */ + +/* + * @test + * @bug 8008768 + * @summary Using {@inheritDoc} in simple tag defined via -tag fails + * @author Mike Duigou + * @library ../lib + * @modules jdk.javadoc + * @build JavadocTester + * @run main DocTest + */ + +/** + * DocTest documentation. + * + * @apiNote DocTest API note. + * @implSpec DocTest implementation spec. + * @implNote DocTest implementation note. + */ +public class DocTest extends JavadocTester { + public static void main(String... args) throws Exception { + DocTest tester = new DocTest(); + tester.runTests(); + } + + @Test + void test() { + javadoc("-verbose", + "-d", "DocTest", + "-tag", "apiNote:optcm:API Note", + "-tag", "implSpec:optcm:Implementation Requirements:", + "-tag", "implNote:optcm:Implementation Note:", + "-package", + testSrc("DocTest.java") + ); + checkExit(Exit.OK); + + // javadoc does not report an exit code for an internal exception (!) + // so monitor stderr for stack dumps. + checkOutput(Output.STDERR, false, "at com.sun"); + } + + /** + * DocTest() documentation. + * + * @apiNote DocTest() API note. + * @implSpec DocTest() implementation spec. + * @implNote DocTest() implementation note. + */ + public DocTest() { + } + + /** + * DocTest.testMethod() documentation. + * + * @apiNote DocTest.testMethod() API note. + * @implSpec DocTest.testMethod() implementation spec. + * @implNote DocTest.testMethod() implementation note. + */ + public void testMethod() { + } +} + +/** + * DocTestWithTags documentation. + * + * @apiNote DocTestWithTags API note. + *
+ *    DocTestWithTags API note code sample.
+ * 
+ * @implSpec DocTestWithTags implementation spec. + *
+ *    DocTestWithTags implementation spec code sample.
+ * 
+ * @implNote DocTestWithTags implementation note. + *
+ *    DocTestWithTags implementation note code sample.
+ * 
+ */ +class DocTestWithTags { + + /** + * DocTestWithTags() documentation. + * + * @apiNote DocTestWithTags() API note. + *
+     *    DocTestWithTags() API note code sample.
+     * 
+ * @implSpec DocTestWithTags() implementation spec. + *
+     *    DocTestWithTags() implementation spec code sample.
+     * 
+ * @implNote DocTest() implementation note. + *
+     *    DocTest() implementation note code sample.
+     * 
+ */ + public DocTestWithTags() { + } + + /** + * DocTest.testMethod() documentation. + * + * @apiNote DocTestWithTags.testMethod() API note. + *
+     *    DocTestWithTags.testMethod() API note code sample.
+     * 
+ * @implSpec DocTestWithTags.testMethod() implementation spec. + *
+     *    DocTestWithTags.testMethod() API implementation spec code sample.
+     * 
+ * @implNote DocTest.testMethod() implementation note. + *
+     *    DocTest.testMethod() API implementation code sample.
+     * 
+ */ + public void testMethod() { + } +} + +class MinimallyExtendsDocTest extends DocTest { +} + +/** + * SimpleExtendsDocTest documentation. + */ +class SimpleExtendsDocTest extends DocTest { + + /** + * SimpleExtendsDocTest() documentation. + */ + public SimpleExtendsDocTest() { + + } + + /** + * SimpleExtendsDocTest.testMethod() documenation. + */ + @java.lang.Override + public void testMethod() { + } +} + +/** + * {@inheritDoc} + */ +class SimpleInheritDocDocTest extends DocTest { + + /** + * {@inheritDoc} + */ + public SimpleInheritDocDocTest() { + } + + /** + * {@inheritDoc} + */ + @java.lang.Override + public void testMethod() { + } +} + +/** + * {@inheritDoc} + * + * @apiNote {@inheritDoc} + * @implSpec {@inheritDoc} + * @implNote {@inheritDoc} + */ +class FullInheritDocDocTest extends DocTest { + + /** + * {@inheritDoc} + * + * @apiNote {@inheritDoc} + * @implSpec {@inheritDoc} + * @implNote {@inheritDoc} + */ + public FullInheritDocDocTest() { + + } + + /** + * {@inheritDoc} + * + * @apiNote {@inheritDoc} + * @implSpec {@inheritDoc} + * @implNote {@inheritDoc} + */ + @java.lang.Override + public void testMethod() { + } +} + +/** + * {@inheritDoc} and FullInheritDocPlusDocTest documentation. + * + * @implSpec {@inheritDoc} and FullInheritDocPlusDocTest API note. + * @implNote {@inheritDoc} and FullInheritDocPlusDocTest implementation specification. + * @apiNote {@inheritDoc} and FullInheritDocPlusDocTest implementation note. + */ +class FullInheritDocPlusDocTest extends DocTest { + + /** + * {@inheritDoc} and FullInheritDocPlusDocTest() documentation. + * + * @implSpec {@inheritDoc} and FullInheritDocPlusDocTest() API note. + * @implNote {@inheritDoc} and FullInheritDocPlusDocTest() implementation specification. + * @apiNote {@inheritDoc} and FullInheritDocPlusDocTest() implementation note. + */ + public FullInheritDocPlusDocTest() { + + } + + /** + * {@inheritDoc} and FullInheritDocPlusDocTest.testMethod() documentation. + * + * @implSpec {@inheritDoc} and FullInheritDocPlusDocTest.testMethod() API note. + * @implNote {@inheritDoc} and FullInheritDocPlusDocTest.testMethod() implementation specification. + * @apiNote {@inheritDoc} and FullInheritDocPlusDocTest.testMethod() implementation note. + */ + @java.lang.Override + public void testMethod() { + } +} +