|
1 /* |
|
2 * Copyright 1999 Sun Microsystems, Inc. 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, |
|
20 * CA 95054 USA or visit www.sun.com if you need additional information or |
|
21 * have any 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 |
|
37 public 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 } |