1/*
2 * Copyright (c) 1999, 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 4160204 4234488
27 * @summary Create empty javadoc comments and verify that javac does not crash.
28 * @compile EmptyDocComments.java
29 */
30
31// WARNING: This file intentionally contains whitespace characters at the end of
32// some lines.  Do not delete them!
33
34// If this file fails to compile, then the test has failed.  The test does not
35// need to be run.
36
37public class EmptyDocComments
38{
39    public static void Main(String [] args)
40    {
41    }
42
43    // Verify that empty doc comments don't cause a crash.
44
45    /**
46     *  */
47    public static void emptyDocComment0()
48    {
49        System.out.println("javadoc comment");
50        System.out.println("- contains whitespace");
51        System.out.println("- ends on same line as potential comment");
52    }
53
54    /**
55     ***/
56    public static void emptyDocComment1()
57    {
58        System.out.println("javadoc comment");
59        System.out.println("- contains nothing");
60        System.out.println("- ends on same line as potential comment");
61    }
62
63    /** */
64    public static void emptyDocComment2()
65    {
66        System.out.println("javadoc comment");
67        System.out.println("- contains whitespace");
68        System.out.println("- ends on same line as comment start");
69    }
70
71    /**
72      *
73      */
74    public static void emptyDocComment3()
75    {
76        System.out.println("javadoc comment");
77        System.out.println("- contains whitespace");
78        System.out.println("- ends on new line ");
79    }
80
81    /***/
82    public static void emptyDocComment4()
83    {
84        System.out.println("minimal javadoc comment");
85        System.out.println("- contains nothing");
86        System.out.println("- ends on same line as comment start");
87    }
88
89    /**/
90    public static void emptyDocComment5()
91    {
92        System.out.println("minimal _java_ comment");
93        System.out.println("- contains nothing");
94        System.out.println("- ends on same line as comment start");
95    }
96
97    /** **** */
98    public static void emptyDocComment6()
99    {
100        System.out.println("javadoc comment");
101        System.out.println("- contains \"*\"");
102        System.out.println("- ends on same line as comment start");
103    }
104
105    // Verify that we properly handle very small, non-empty comments.
106
107    /** a */
108    public static void singleChar0()
109    {
110        System.out.println("javadoc comment");
111        System.out.println("- contains a single character");
112        System.out.println("- ends on same line as comment start");
113    }
114
115    /**
116     * a      */
117    public static void singleChar1()
118    {
119        System.out.println("javadoc comment");
120        System.out.println("- contains a single character and trailing whitespace");
121        System.out.println("- ends on same line as potential comment");
122    }
123
124    /**
125     * a
126     */
127    public static void singleChar2()
128    {
129        System.out.println("javadoc comment");
130        System.out.println("- contains a single character, no trailing whitespace");
131        System.out.println("- ends on new line ");
132    }
133
134    /**
135       a
136     */
137    public static void singleChar3()
138    {
139        System.out.println("javadoc comment");
140        System.out.println("- contains a single character and trailing whitespace");
141        System.out.println("- ends on new line ");
142    }
143}
144