1 /*
2  * Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved.
3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4  *
5  * This code is free software; you can redistribute it and/or modify it
6  * under the terms of the GNU General Public License version 2 only, as
7  * published by the Free Software Foundation.
8  *
9  * This code is distributed in the hope that it will be useful, but WITHOUT
10  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
12  * version 2 for more details (a copy is included in the LICENSE file that
13  * accompanied this code).
14  *
15  * You should have received a copy of the GNU General Public License version
16  * 2 along with this work; if not, write to the Free Software Foundation,
17  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
18  *
19  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
20  * or visit www.oracle.com if you need additional information or have any
21  * questions.
22  */
23 
24 /*
25  * @test
26  * @bug 7021614
27  * @summary extend com.sun.source API to support parsing javadoc comments
28  * @modules jdk.compiler/com.sun.tools.javac.api
29  *          jdk.compiler/com.sun.tools.javac.file
30  *          jdk.compiler/com.sun.tools.javac.tree
31  *          jdk.compiler/com.sun.tools.javac.util
32  * @build DocCommentTester
33  * @run main DocCommentTester SerialTest.java
34  */
35 
36 class SerialTest {
37     /**
38      * @serial include
39      */
include()40     void include() { }
41 /*
42 DocComment[DOC_COMMENT, pos:1
43   firstSentence: empty
44   body: empty
45   block tags: 1
46     Serial[SERIAL, pos:1
47       description: 1
48         Text[TEXT, pos:9, include]
49     ]
50 ]
51 */
52 
53     /**
54      * @serial exclude
55      */
exclude()56     void exclude() { }
57 /*
58 DocComment[DOC_COMMENT, pos:1
59   firstSentence: empty
60   body: empty
61   block tags: 1
62     Serial[SERIAL, pos:1
63       description: 1
64         Text[TEXT, pos:9, exclude]
65     ]
66 ]
67 */
68 
69     /**
70      * @serial description
71      */
description()72     void description() { }
73 /*
74 DocComment[DOC_COMMENT, pos:1
75   firstSentence: empty
76   body: empty
77   block tags: 1
78     Serial[SERIAL, pos:1
79       description: 1
80         Text[TEXT, pos:9, description]
81     ]
82 ]
83 */
84 
85     /**
86      * @serial
87      */
empty()88     void empty() { }
89 /*
90 DocComment[DOC_COMMENT, pos:1
91   firstSentence: empty
92   body: empty
93   block tags: 1
94     Serial[SERIAL, pos:1
95       description: empty
96     ]
97 ]
98 */
99 
100 }
101 
102