DocLintFormatTest.java revision 3882:b1d7dfdd0ffb 
1/*
2 * Copyright (c) 2012, 2017, 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 8172474
27 * @summary javac should enable doclint checking for HTML 5
28 * @library /tools/lib
29 * @modules jdk.compiler/com.sun.tools.javac.api
30 *          jdk.compiler/com.sun.tools.javac.main
31 * @build toolbox.ToolBox toolbox.JavacTask
32 * @run main DocLintFormatTest
33 */
34
35import java.nio.file.Files;
36import java.nio.file.Path;
37import java.nio.file.Paths;
38import java.util.List;
39
40import toolbox.JavacTask;
41import toolbox.Task;
42import toolbox.ToolBox;
43
44public class DocLintFormatTest {
45    public static void main(String... args) throws Exception {
46        new DocLintFormatTest().run();
47    }
48
49    private ToolBox tb = new ToolBox();
50    private Path src = Paths.get("src");
51    private Path classes = Paths.get("classes");
52
53    void run() throws Exception {
54        Files.createDirectories(classes);
55
56        tb.writeJavaFiles(src,
57            //        1         2
58            //2345678901234567890
59            "/** This is an <tt>HTML 4</tt> comment. */ public class Test4 { }",
60            "/** This is an <mark>HTML 5</mark> comment. */ public class Test5 { }"
61        );
62
63        test(src.resolve("Test4.java"), "html4");
64        test(src.resolve("Test4.java"), "html5",
65                "Test4.java:1:16: compiler.err.proc.messager: tag not supported in the generated HTML version: tt");
66        test(src.resolve("Test5.java"), "html4",
67                "Test5.java:1:16: compiler.err.proc.messager: tag not supported in the generated HTML version: mark");
68        test(src.resolve("Test5.java"), "html5");
69
70        if (errors > 0) {
71            throw new Exception(errors + " errors occurred");
72        }
73    }
74
75    void test(Path file, String format, String... expect) {
76        System.err.println("Test: " + format + " " + file);
77        List<String> output = new JavacTask(tb)
78                  .outdir(classes)
79                  .options("-XDrawDiagnostics", "-Xdoclint", "--doclint-format", format)
80                  .files(file)
81                  .run(expect.length == 0 ? Task.Expect.SUCCESS : Task.Expect.FAIL)
82                  .writeAll()
83                  .getOutputLines(Task.OutputKind.DIRECT);
84
85        if (expect.length == 0) {
86            if (!(output.size() == 1 && output.get(0).isEmpty())) {
87                error("All output unexpected.");
88            }
89        } else {
90            for (String e : expect) {
91                if (!output.contains(e)) {
92                    error("expected output not found: " + e);
93                }
94            }
95        }
96    }
97
98    void error(String message) {
99        System.err.println("Error: " + message);
100        errors++;
101    }
102
103    private int errors = 0;
104}
105
106