/* * Copyright (c) 2003, 2021, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ /* * @test * @bug 8250768 8261976 * @summary test generated docs for items declared using preview * @library ../../lib * @modules jdk.javadoc/jdk.javadoc.internal.tool * jdk.javadoc/jdk.javadoc.internal.doclets.formats.html.resources:+open * @build javadoc.tester.* * @run main TestPreview */ import java.nio.file.Paths; import java.text.MessageFormat; import java.util.ResourceBundle; import javadoc.tester.JavadocTester; public class TestPreview extends JavadocTester { public static void main(String... args) throws Exception { TestPreview tester = new TestPreview(); tester.runTests(); } @Test public void testUserJavadoc() { String doc = Paths.get(testSrc, "doc").toUri().toString(); javadoc("-d", "out-user-javadoc", "-XDforcePreview", "--enable-preview", "-source", System.getProperty("java.specification.version"), "--patch-module", "java.base=" + Paths.get(testSrc, "api").toAbsolutePath().toString(), "--add-exports", "java.base/preview=m", "--module-source-path", testSrc, "-linkoffline", doc, doc, "m/pkg"); checkExit(Exit.OK); checkOutput("m/pkg/TestPreviewDeclarationUse.html", true, "TestPreviewDeclaration"); checkOutput("m/pkg/TestPreviewAPIUse.html", true, "CorePREVIEW"); checkOutput("m/pkg/DocAnnotation.html", true, "public @interface DocAnnotation"); checkOutput("m/pkg/DocAnnotationUse1.html", true, "
pkg.DocAnnotationUse1
"); checkOutput("m/pkg/DocAnnotationUse2.html", true, "
pkg.DocAnnotationUse2
"); } @Test public void testPreviewAPIJavadoc() { javadoc("-d", "out-preview-api", "--patch-module", "java.base=" + Paths.get(testSrc, "api").toAbsolutePath().toString(), "--add-exports", "java.base/preview=m", "--source-path", Paths.get(testSrc, "api").toAbsolutePath().toString(), "--show-packages=all", "preview"); checkExit(Exit.OK); checkOutput("preview-list.html", true, """
Record Classes
Record Class
Description
""", """
Methods
Method
Description
Returns the value of the i record component.
"""); } }