• file
• revisions
• annotate
• diff
• comparison
• raw

test/tools/doclint/OverridesTest.java@153d0309e698 (annotated)

test/tools/doclint/OverridesTest.java

Mon, 31 Aug 2015 13:37:01 -0700

author

asaha

date

Mon, 31 Aug 2015 13:37:01 -0700

changeset 2971

153d0309e698

parent 1465

a22f23fb7abf

child 2525

2eb010b6cb22

permissions

-rw-r--r--

Added tag jdk8u65-b12 for changeset 54e958a3719e

jjg@1455	1	/*
jjg@1455	2	* Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
jjg@1455	3	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
jjg@1455	4	*
jjg@1455	5	* This code is free software; you can redistribute it and/or modify it
jjg@1455	6	* under the terms of the GNU General Public License version 2 only, as
jjg@1455	7	* published by the Free Software Foundation.
jjg@1455	8	*
jjg@1455	9	* This code is distributed in the hope that it will be useful, but WITHOUT
jjg@1455	10	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
jjg@1455	11	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
jjg@1455	12	* version 2 for more details (a copy is included in the LICENSE file that
jjg@1455	13	* accompanied this code).
jjg@1455	14	*
jjg@1455	15	* You should have received a copy of the GNU General Public License version
jjg@1455	16	* 2 along with this work; if not, write to the Free Software Foundation,
jjg@1455	17	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
jjg@1455	18	*
jjg@1455	19	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
jjg@1455	20	* or visit www.oracle.com if you need additional information or have any
jjg@1455	21	* questions.
jjg@1455	22	*/
jjg@1455	23
jjg@1455	24	/*
jjg@1455	25	* @test
jjg@1465	26	* @bug 8004832
jjg@1465	27	* @summary Add new doclint package
jjg@1455	28	* @build DocLintTester
jjg@1455	29	* @run main DocLintTester -Xmsgs:all OverridesTest.java
jjg@1455	30	*/
jjg@1455	31
jjg@1455	32	/*
jjg@1455	33	* This is a test that missing comments on methods may be inherited
jjg@1455	34	* from overridden methods. As such, there should be no errors due
jjg@1455	35	* to missing comments (or any other types of error) in this test.
jjg@1455	36	*/
jjg@1455	37
jjg@1455	38	/** An interface. */
jjg@1455	39	interface I1 {
jjg@1455	40	/**
jjg@1455	41	* A method
jjg@1455	42	* @param p a param
jjg@1455	43	* @throws Exception an exception
jjg@1455	44	* @return an int
jjg@1455	45	*/
jjg@1455	46	int m(int p) throws Exception;
jjg@1455	47	}
jjg@1455	48
jjg@1455	49	/** An extending interface. */
jjg@1455	50	interface I2 extends I1 { }
jjg@1455	51
jjg@1455	52	/** An abstract class. */
jjg@1455	53	abstract class C1 {
jjg@1455	54	/**
jjg@1455	55	* A method
jjg@1455	56	* @param p a param
jjg@1455	57	* @throws Exception an exception
jjg@1455	58	* @return an int
jjg@1455	59	*/
jjg@1455	60	int m(int p) throws Exception;
jjg@1455	61	}
jjg@1455	62
jjg@1455	63	/** An implementing class. */
jjg@1455	64	class C2 implements I1 {
jjg@1455	65	int m(int p) throws Exception { return p; }
jjg@1455	66	}
jjg@1455	67
jjg@1455	68	/** An extending class. */
jjg@1455	69	class C3 extends C1 {
jjg@1455	70	int m(int p) throws Exception { return p; }
jjg@1455	71	}
jjg@1455	72
jjg@1455	73	/** An extending and implementing class. */
jjg@1455	74	class C4 extends C1 implements I1 {
jjg@1455	75	int m(int p) throws Exception { return p; }
jjg@1455	76	}
jjg@1455	77
jjg@1455	78	/** An implementing class using inheritdoc. */
jjg@1455	79	class C5 implements I1 {
jjg@1455	80	/** {@inheritDoc} */
jjg@1455	81	int m(int p) throws Exception { return p; }
jjg@1455	82	}
jjg@1455	83
jjg@1455	84	/** An implementing class with incomplete documentation. */
jjg@1455	85	class C6 implements I1 {
jjg@1455	86	/** Overriding method */
jjg@1455	87	int m(int p) throws Exception { return p; }
jjg@1455	88	}
jjg@1455	89
jjg@1455	90	/** A class implementing an inherited interface. */
jjg@1455	91	class C7 implements I2 {
jjg@1455	92	int m(int p) throws Exception { return p; }
jjg@1455	93	}