langtools/test/tools/doclint/ReferenceTest.java
author naoto
Tue, 29 Mar 2016 17:06:33 -0700
changeset 36739 145210aba850
parent 30730 d3ce7619db2c
permissions -rw-r--r--
8152704: jlink command line output/help message improvement Reviewed-by: mchung
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     1
/*
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     2
 * @test /nodynamiccopyright/
20256
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 19125
diff changeset
     3
 * @bug 8004832 8020556 8002154
14962
19ffdfafbcd2 8005307: fix missing @bug tags
jjg
parents: 14952
diff changeset
     4
 * @summary Add new doclint package
30730
d3ce7619db2c 8076543: Add @modules as needed to the langtools tests
akulyakh
parents: 20256
diff changeset
     5
 * @modules jdk.compiler/com.sun.tools.doclint
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     6
 * @build DocLintTester
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     7
 * @run main DocLintTester -Xmsgs:-reference ReferenceTest.java
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     8
 * @run main DocLintTester -ref ReferenceTest.out ReferenceTest.java
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
     9
 */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    10
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    11
/** */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    12
public class ReferenceTest {
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    13
    /**
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    14
     * @param x description
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    15
     */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    16
    public int invalid_param;
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    17
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    18
    /**
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    19
     * @param x description
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    20
     */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    21
    public class InvalidParam { }
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    22
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    23
    /**
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    24
     * @param x description
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    25
     */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    26
    public void param_name_not_found(int a) { }
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    27
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    28
    /**
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    29
     * @param <X> description
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    30
     */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    31
    public class typaram_name_not_found { }
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    32
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    33
    /**
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    34
     * @see Object#tooStrong()
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    35
     */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    36
    public void ref_not_found() { }
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    37
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    38
    /**
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    39
     * @return x description
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    40
     */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    41
    public int invalid_return;
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    42
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    43
    /**
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    44
     * @return x description
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    45
     */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    46
    public void invalid_return();
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    47
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    48
    /**
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    49
     * @throws Exception description
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    50
     */
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    51
    public void exception_not_thrown() { }
19125
db8cab0ecbd9 8020556: doclint does not check type variables for @throws
jjg
parents: 14962
diff changeset
    52
db8cab0ecbd9 8020556: doclint does not check type variables for @throws
jjg
parents: 14962
diff changeset
    53
    /**
db8cab0ecbd9 8020556: doclint does not check type variables for @throws
jjg
parents: 14962
diff changeset
    54
     * @param <T> throwable
db8cab0ecbd9 8020556: doclint does not check type variables for @throws
jjg
parents: 14962
diff changeset
    55
     * @throws T description
db8cab0ecbd9 8020556: doclint does not check type variables for @throws
jjg
parents: 14962
diff changeset
    56
     */
db8cab0ecbd9 8020556: doclint does not check type variables for @throws
jjg
parents: 14962
diff changeset
    57
    public <T extends Throwable> void valid_throws_generic() throws T { }
20256
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 19125
diff changeset
    58
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 19125
diff changeset
    59
    /**
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 19125
diff changeset
    60
     * {@link java.util.List<String>}
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 19125
diff changeset
    61
     * {@link java.util.List<String>#equals}
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 19125
diff changeset
    62
     * @see java.util.List<String>
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 19125
diff changeset
    63
     * @see java.util.List<String>#equals
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 19125
diff changeset
    64
     */
9154c5cc0d9f 8002154: [doclint] doclint should check for issues which are errors in javadoc
jjg
parents: 19125
diff changeset
    65
    public void invalid_type_args() { }
14952
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    66
}
d0022ae20516 8004832: Add new doclint package
jjg
parents:
diff changeset
    67