8196202: Javadoc should not generate frames by default

Reviewed-by: ksrini
This commit is contained in:
Jonathan Gibbons 2018-05-29 11:20:04 -07:00
parent b721c804c5
commit 8589446792
41 changed files with 176 additions and 62 deletions

View file

@ -198,9 +198,9 @@ public class HtmlConfiguration extends BaseConfiguration {
/** /**
* Specifies whether or not frames should be generated. * Specifies whether or not frames should be generated.
* Defaults to true; can be set by --frames; can be set to false by --no-frames; last one wins. * Defaults to false; can be set to true by --frames; can be set to false by --no-frames; last one wins.
*/ */
public boolean frames = true; public boolean frames = false;
/** /**
* This is the HTML version of the generated pages. * This is the HTML version of the generated pages.
@ -740,6 +740,7 @@ public class HtmlConfiguration extends BaseConfiguration {
new Option(resources, "--frames") { new Option(resources, "--frames") {
@Override @Override
public boolean process(String opt, List<String> args) { public boolean process(String opt, List<String> args) {
reporter.print(WARNING, getText("doclet.Frames_specified", helpfile));
frames = true; frames = true;
return true; return true;
} }

View file

@ -403,10 +403,10 @@ doclet.usage.docencoding.description=\
Specify the character encoding for the output Specify the character encoding for the output
doclet.usage.frames.description=\ doclet.usage.frames.description=\
Enable the use of frames in the generated output (default) Enable the use of frames in the generated output
doclet.usage.no-frames.description=\ doclet.usage.no-frames.description=\
Disable the use of frames in the generated output Disable the use of frames in the generated output (default)
doclet.usage.override-methods.parameters=\ doclet.usage.override-methods.parameters=\
(detail|summary) (detail|summary)
@ -450,3 +450,10 @@ doclet.HTML_4_specified=\
The default is currently HTML5 and the support for HTML 4.01 will be removed\n\ The default is currently HTML5 and the support for HTML 4.01 will be removed\n\
in a future release. To suppress this warning, please ensure that any HTML constructs\n\ in a future release. To suppress this warning, please ensure that any HTML constructs\n\
in your comments are valid in HTML5, and remove the -html4 option. in your comments are valid in HTML5, and remove the -html4 option.
# L10N: do not localize the option names --frames
doclet.Frames_specified=\
You have specified to generate frames, by using the --frames option.\n\
The default is currently to not generate frames and the support for \n\
frames will be removed in a future release.\n\
To suppress this warning, remove the --frames option and avoid the use of frames.

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2002, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2002, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4636655 * @bug 4636655 8196202
* @summary Add title attribute to <FRAME> tags for accessibility * @summary Add title attribute to <FRAME> tags for accessibility
* @author dkramer * @author dkramer
* @library ../lib * @library ../lib
@ -42,6 +42,7 @@ public class AccessFrameTitle extends JavadocTester {
@Test @Test
void test() { void test() {
javadoc("-d", "out", javadoc("-d", "out",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2002, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2002, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4636667 7052425 8016549 * @bug 4636667 7052425 8016549 8196202
* @summary Use <H1, <H2>, and <H3> in proper sequence for accessibility * @summary Use <H1, <H2>, and <H3> in proper sequence for accessibility
* @author dkramer * @author dkramer
* @library ../lib * @library ../lib
@ -44,6 +44,7 @@ public class AccessH1 extends JavadocTester {
void test() { void test() {
javadoc("-d", "out", javadoc("-d", "out",
"-doctitle", "Document Title", "-doctitle", "Document Title",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4637604 4775148 8183037 8182765 * @bug 4637604 4775148 8183037 8182765 8196202
* @summary Test the tables for summary attribute * @summary Test the tables for summary attribute
* @author dkramer * @author dkramer
* @library ../lib * @library ../lib
@ -45,7 +45,10 @@ public class AccessSummary extends JavadocTester {
@Test @Test
void testAccessSummary() { void testAccessSummary() {
javadoc("-d", "out", "-sourcepath", testSrc, "p1", "p2"); javadoc("-d", "out",
"--frames",
"-sourcepath", testSrc,
"p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
checkSummary(false); checkSummary(false);
} }
@ -54,6 +57,7 @@ public class AccessSummary extends JavadocTester {
void testAccessSummary_html4() { void testAccessSummary_html4() {
javadoc("-d", "out-html4", javadoc("-d", "out-html4",
"-html4", "-html4",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4524350 4662945 4633447 * @bug 4524350 4662945 4633447 8196202
* @summary stddoclet: {@docRoot} inserts an extra trailing "/" * @summary stddoclet: {@docRoot} inserts an extra trailing "/"
* @author dkramer * @author dkramer
* @library ../lib * @library ../lib
@ -56,6 +56,7 @@ public class DocRootSlash extends JavadocTester {
javadoc("-d", "out", javadoc("-d", "out",
"-Xdoclint:none", "-Xdoclint:none",
"-overview", (srcdir + "/overview.html"), "-overview", (srcdir + "/overview.html"),
"--frames",
"-header", "<A HREF=\"{@docroot}/package-list\">{&#064;docroot}</A> <A HREF=\"{@docRoot}/help-doc\">{&#064;docRoot}</A>", "-header", "<A HREF=\"{@docroot}/package-list\">{&#064;docroot}</A> <A HREF=\"{@docRoot}/help-doc\">{&#064;docRoot}</A>",
"-sourcepath", srcdir, "-sourcepath", srcdir,
"p1", "p2"); "p1", "p2");

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2002, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2002, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4645058 4747738 4855054 8024756 8141492 * @bug 4645058 4747738 4855054 8024756 8141492 8196202
* @summary Javascript IE load error when linked by -linkoffline * @summary Javascript IE load error when linked by -linkoffline
* Window title shouldn't change when loading left frames (javascript) * Window title shouldn't change when loading left frames (javascript)
* @author dkramer * @author dkramer
@ -43,6 +43,7 @@ public class JavascriptWinTitle extends JavadocTester {
@Test @Test
void test() { void test() {
javadoc("-d", "out", javadoc("-d", "out",
"--frames",
"-doctitle", "Document Title", "-doctitle", "Document Title",
"-windowtitle", "Window Title", "-windowtitle", "Window Title",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4034096 4764726 6235799 8182765 * @bug 4034096 4764726 6235799 8182765 8196202
* @summary Add support for HTML keywords via META tag for * @summary Add support for HTML keywords via META tag for
* class and member names to improve API search * class and member names to improve API search
* @author dkramer * @author dkramer
@ -53,6 +53,7 @@ public class MetaTag extends JavadocTester {
javadoc("-d", "out-1", javadoc("-d", "out-1",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-keywords", "-keywords",
"--frames",
"-doctitle", "Sample Packages", "-doctitle", "Sample Packages",
"p1", "p2"); "p1", "p2");
@ -66,6 +67,7 @@ public class MetaTag extends JavadocTester {
javadoc("-d", "out-2", javadoc("-d", "out-2",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-notimestamp", "-notimestamp",
"--frames",
"-doctitle", "Sample Packages", "-doctitle", "Sample Packages",
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -80,6 +82,7 @@ public class MetaTag extends JavadocTester {
"-html4", "-html4",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-keywords", "-keywords",
"--frames",
"-doctitle", "Sample Packages", "-doctitle", "Sample Packages",
"p1", "p2"); "p1", "p2");
@ -94,6 +97,7 @@ public class MetaTag extends JavadocTester {
"-html4", "-html4",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-notimestamp", "-notimestamp",
"--frames",
"-doctitle", "Sample Packages", "-doctitle", "Sample Packages",
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2002, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2002, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4766385 * @bug 4766385 8196202
* @summary Test that the header option for upper left frame * @summary Test that the header option for upper left frame
* is present for three sets of options: (1) -header, * is present for three sets of options: (1) -header,
* (2) -packagesheader, and (3) -header -packagesheader * (2) -packagesheader, and (3) -header -packagesheader
@ -46,6 +46,7 @@ public class PackagesHeader extends JavadocTester {
// First test with -header only // First test with -header only
javadoc("-d", "out-header", javadoc("-d", "out-header",
"-header", "Main Frame Header", "-header", "Main Frame Header",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -60,6 +61,7 @@ public class PackagesHeader extends JavadocTester {
// Second test with -packagesheader only // Second test with -packagesheader only
javadoc("-d", "out-packages-header", javadoc("-d", "out-packages-header",
"-packagesheader", "Packages Frame Header", "-packagesheader", "Packages Frame Header",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -76,6 +78,7 @@ public class PackagesHeader extends JavadocTester {
javadoc("-d", "out-both", javadoc("-d", "out-both",
"-packagesheader", "Packages Frame Header", "-packagesheader", "Packages Frame Header",
"-header", "Main Frame Header", "-header", "Main Frame Header",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4275630 4749453 4625400 4753048 4415270 8074521 8182765 * @bug 4275630 4749453 4625400 4753048 4415270 8074521 8182765 8196202
* @summary Generated HTML is invalid with frames. * @summary Generated HTML is invalid with frames.
* Displays unnecessary horizontal scroll bars. * Displays unnecessary horizontal scroll bars.
* Missing whitespace in DOCTYPE declaration * Missing whitespace in DOCTYPE declaration
@ -49,6 +49,7 @@ public class ValidHtml extends JavadocTester {
"-doctitle", "Document Title", "-doctitle", "Document Title",
"-windowtitle", "Window Title", "-windowtitle", "Window Title",
"-use", "-use",
"--frames",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
@ -72,6 +73,7 @@ public class ValidHtml extends JavadocTester {
"-doctitle", "Document Title", "-doctitle", "Document Title",
"-windowtitle", "Window Title", "-windowtitle", "Window Title",
"-use", "-use",
"--frames",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2002, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2002, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4530730 * @bug 4530730 8196202
* @summary stddoclet: With frames off, window titles have "()" appended * @summary stddoclet: With frames off, window titles have "()" appended
* @author dkramer * @author dkramer
* @library ../lib * @library ../lib
@ -47,6 +47,7 @@ public class WindowTitles extends JavadocTester {
// Test for all cases except the split index page // Test for all cases except the split index page
javadoc("-d", "out-1", javadoc("-d", "out-1",
"-use", "-use",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8071982 * @bug 8071982 8196202
* @summary Test for package-frame.html. * @summary Test for package-frame.html.
* @library ../lib * @library ../lib
* @modules jdk.javadoc/jdk.javadoc.internal.tool * @modules jdk.javadoc/jdk.javadoc.internal.tool
@ -41,6 +41,7 @@ public class TestClassDocCatalog extends JavadocTester {
@Test @Test
void test() { void test() {
javadoc("-d", "out", javadoc("-d", "out",
"--frames",
testSrc("pkg1/EmptyAnnotation.java"), testSrc("pkg1/EmptyAnnotation.java"),
testSrc("pkg1/EmptyClass.java"), testSrc("pkg1/EmptyClass.java"),
testSrc("pkg1/EmptyEnum.java"), testSrc("pkg1/EmptyEnum.java"),

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8162353 8164747 8173707 * @bug 8162353 8164747 8173707 8196202
* @summary javadoc should provide a way to disable use of frames * @summary javadoc should provide a way to disable use of frames
* @library /tools/lib ../lib * @library /tools/lib ../lib
* @modules * @modules
@ -226,6 +226,11 @@ public class TestFramesNoFrames extends JavadocTester {
private boolean frames; private boolean frames;
private boolean overview; private boolean overview;
private static final String framesWarning
= "javadoc: warning - You have specified to generate frames, by using the --frames option.\n"
+ "The default is currently to not generate frames and the support for \n"
+ "frames will be removed in a future release.\n"
+ "To suppress this warning, remove the --frames option and avoid the use of frames.";
Checker(FrameKind fKind, OverviewKind oKind, HtmlKind hKind) { Checker(FrameKind fKind, OverviewKind oKind, HtmlKind hKind) {
this.fKind = fKind; this.fKind = fKind;
@ -240,11 +245,11 @@ public class TestFramesNoFrames extends JavadocTester {
void check() throws IOException { void check() throws IOException {
switch (fKind) { switch (fKind) {
case DEFAULT:
case FRAMES: case FRAMES:
frames = true; frames = true;
break; break;
case DEFAULT:
case NO_FRAMES: case NO_FRAMES:
frames = false; frames = false;
break; break;
@ -272,6 +277,8 @@ public class TestFramesNoFrames extends JavadocTester {
checkNavBar(); checkNavBar();
checkHelpDoc(); checkHelpDoc();
checkWarning();
} }
private void checkAllClassesFiles() { private void checkAllClassesFiles() {
@ -379,6 +386,10 @@ public class TestFramesNoFrames extends JavadocTester {
"overview-summary.html"); "overview-summary.html");
} }
private void checkWarning() {
checkOutput(Output.OUT, frames, framesWarning);
}
private long getPackageCount() { private long getPackageCount() {
return this.classes.stream() return this.classes.stream()
.filter(name -> name.contains(".")) .filter(name -> name.contains("."))

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8000418 8024288 * @bug 8000418 8024288 8196202
* @summary Verify that files use a common Generated By string * @summary Verify that files use a common Generated By string
* @library ../lib * @library ../lib
* @modules jdk.javadoc/jdk.javadoc.internal.tool * @modules jdk.javadoc/jdk.javadoc.internal.tool
@ -41,6 +41,7 @@ public class TestGeneratedBy extends JavadocTester {
@Test @Test
void testTimestamp() { void testTimestamp() {
javadoc("-d", "out-timestamp", javadoc("-d", "out-timestamp",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg"); "pkg");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -52,6 +53,7 @@ public class TestGeneratedBy extends JavadocTester {
void testNoTimestamp() { void testNoTimestamp() {
javadoc("-d", "out-notimestamp", javadoc("-d", "out-notimestamp",
"-notimestamp", "-notimestamp",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg"); "pkg");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8190003 8196201 * @bug 8190003 8196201 8196202
* @summary Special characters in group names should be escaped * @summary Special characters in group names should be escaped
* @library /tools/lib ../lib * @library /tools/lib ../lib
* @modules jdk.javadoc/jdk.javadoc.internal.tool * @modules jdk.javadoc/jdk.javadoc.internal.tool
@ -58,6 +58,7 @@ public class TestGroupName extends JavadocTester {
"package p3; public class C3 { }"); "package p3; public class C3 { }");
javadoc("-d", base.resolve("out").toString(), javadoc("-d", base.resolve("out").toString(),
"--frames",
"-sourcepath", src.toString(), "-sourcepath", src.toString(),
"-group", "abc < & > def", "p1", "-group", "abc < & > def", "p1",
"p1", "p2", "p3"); "p1", "p2", "p3");
@ -90,6 +91,7 @@ public class TestGroupName extends JavadocTester {
"package pc3; public class CC3 { }"); "package pc3; public class CC3 { }");
javadoc("-d", base.resolve("out").toString(), javadoc("-d", base.resolve("out").toString(),
"--frames",
"--module-source-path", src.toString(), "--module-source-path", src.toString(),
"-group", "abc < & > def", "ma", "-group", "abc < & > def", "ma",
"--module", "ma,mb,mc"); "--module", "ma,mb,mc");

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4924383 8149402 * @bug 4924383 8149402 8196202
* @summary Test to make sure the -group option works correctly * @summary Test to make sure the -group option works correctly
* with the given pattern usages. * with the given pattern usages.
* @author jamieh * @author jamieh
@ -60,6 +60,7 @@ public class TestGroupOption extends JavadocTester {
// Make sure that the headers of group that is defined using patterns are printed. // Make sure that the headers of group that is defined using patterns are printed.
void test2() { void test2() {
javadoc("-d", "out-2", javadoc("-d", "out-2",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-group", "Group pkg*", "pkg*", "-group", "Group pkg*", "pkg*",
"-group", "Group abc*", "abc*", "-group", "Group abc*", "abc*",

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4905786 6259611 8162363 * @bug 4905786 6259611 8162363 8196202
* @summary Make sure that headings use the TH tag instead of the TD tag. * @summary Make sure that headings use the TH tag instead of the TD tag.
* @author jamieh * @author jamieh
* @library ../lib * @library ../lib
@ -62,6 +62,7 @@ public class TestHeadings extends JavadocTester {
javadoc("-d", "out", javadoc("-d", "out",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"-header", "Test Files", "-header", "Test Files",
"pkg1", "pkg2"); "pkg1", "pkg2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8073100 8182765 * @bug 8073100 8182765 8196202
* @summary ensure the hidden tag works as intended * @summary ensure the hidden tag works as intended
* @library ../lib * @library ../lib
* @modules jdk.javadoc/jdk.javadoc.internal.tool * @modules jdk.javadoc/jdk.javadoc.internal.tool
@ -44,6 +44,7 @@ public class TestHiddenTag extends JavadocTester {
@Test @Test
public void test1() { public void test1() {
javadoc("-d", "out1", javadoc("-d", "out1",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-package", "-package",
"pkg1"); "pkg1");

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8008164 8169819 8183037 8182765 * @bug 8008164 8169819 8183037 8182765 8196202
* @summary Test styles on HTML tables generated by javadoc. * @summary Test styles on HTML tables generated by javadoc.
* @author Bhavesh Patel * @author Bhavesh Patel
* @library ../lib * @library ../lib
@ -44,6 +44,7 @@ public class TestHtmlTableStyles extends JavadocTester {
javadoc("-d", "out", javadoc("-d", "out",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg1", "pkg2"); "pkg1", "pkg2");
checkExit(Exit.ERROR); checkExit(Exit.ERROR);
checkOutput(Output.OUT, true, checkOutput(Output.OUT, true,
@ -81,6 +82,7 @@ public class TestHtmlTableStyles extends JavadocTester {
"-html4", "-html4",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg1", "pkg2"); "pkg1", "pkg2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -50,6 +50,7 @@ public class TestHtmlTableTags extends JavadocTester {
javadoc("-d", "out", javadoc("-d", "out",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg1", "pkg2"); "pkg1", "pkg2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -64,6 +65,7 @@ public class TestHtmlTableTags extends JavadocTester {
"-html4", "-html4",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg1", "pkg2"); "pkg1", "pkg2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8072945 8081854 8141492 8148985 8150188 4649116 8173707 8151743 8169819 8183037 8182765 * @bug 8072945 8081854 8141492 8148985 8150188 4649116 8173707 8151743 8169819 8183037 8182765 8196202
* @summary Test the version of HTML generated by the javadoc tool. * @summary Test the version of HTML generated by the javadoc tool.
* @author bpatel * @author bpatel
* @library ../lib * @library ../lib
@ -45,6 +45,7 @@ public class TestHtmlVersion extends JavadocTester {
javadoc("-d", "out-1", javadoc("-d", "out-1",
"-private", "-private",
"-linksource", "-linksource",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
@ -62,6 +63,7 @@ public class TestHtmlVersion extends JavadocTester {
"-html4", "-html4",
"-private", "-private",
"-linksource", "-linksource",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
@ -79,6 +81,7 @@ public class TestHtmlVersion extends JavadocTester {
"-html4", "-html4",
"-private", "-private",
"-linksource", "-linksource",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4852280 4517115 4973608 4994589 8026567 8071982 * @bug 4852280 4517115 4973608 4994589 8026567 8071982 8196202
* @summary Perform tests on index.html file. * @summary Perform tests on index.html file.
* Also test that index-all.html has the appropriate output. * Also test that index-all.html has the appropriate output.
* Test for unnamed package in index. * Test for unnamed package in index.
@ -44,6 +44,7 @@ public class TestIndex extends JavadocTester {
@Test @Test
void test() { void test() {
javadoc("-d", "out", javadoc("-d", "out",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg", testSrc("NoPackage.java")); "pkg", testSrc("NoPackage.java"));
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2004, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2004, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4665566 4855876 7025314 8012375 8015997 8016328 8024756 8148985 8151921 8151743 * @bug 4665566 4855876 7025314 8012375 8015997 8016328 8024756 8148985 8151921 8151743 8196202
* @summary Verify that the output has the right javascript. * @summary Verify that the output has the right javascript.
* @author jamieh * @author jamieh
* @library ../lib * @library ../lib
@ -42,6 +42,7 @@ public class TestJavascript extends JavadocTester {
@Test @Test
void test() { void test() {
javadoc("-d", "out", javadoc("-d", "out",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg", testSrc("TestJavascript.java")); "pkg", testSrc("TestJavascript.java"));
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8195795 8201396 * @bug 8195795 8201396 8196202
* @summary test the use of module directories in output, * @summary test the use of module directories in output,
* and the --no-module-directories option * and the --no-module-directories option
* @modules jdk.javadoc/jdk.javadoc.internal.api * @modules jdk.javadoc/jdk.javadoc.internal.api
@ -82,6 +82,7 @@ public class TestModuleDirs extends JavadocTester {
javadoc("-d", base.resolve("api").toString(), javadoc("-d", base.resolve("api").toString(),
"-quiet", "-quiet",
"--frames",
"--module-source-path", src.toString(), "--module-source-path", src.toString(),
"--no-module-directories", "--no-module-directories",
"--module", "ma,mb"); "--module", "ma,mb");
@ -125,6 +126,7 @@ public class TestModuleDirs extends JavadocTester {
javadoc("-d", base.resolve("api").toString(), javadoc("-d", base.resolve("api").toString(),
"-quiet", "-quiet",
"--frames",
"--module-source-path", src.toString(), "--module-source-path", src.toString(),
"--module", "ma,mb"); "--module", "ma,mb");

View file

@ -26,7 +26,7 @@
* @bug 8154119 8154262 8156077 8157987 8154261 8154817 8135291 8155995 8162363 * @bug 8154119 8154262 8156077 8157987 8154261 8154817 8135291 8155995 8162363
* 8168766 8168688 8162674 8160196 8175799 8174974 8176778 8177562 8175218 * 8168766 8168688 8162674 8160196 8175799 8174974 8176778 8177562 8175218
* 8175823 8166306 8178043 8181622 8183511 8169819 8074407 8183037 8191464 * 8175823 8166306 8178043 8181622 8183511 8169819 8074407 8183037 8191464
8164407 8192007 8182765 8196200 8196201 8164407 8192007 8182765 8196200 8196201 8196202
* @summary Test modules support in javadoc. * @summary Test modules support in javadoc.
* @author bpatel * @author bpatel
* @library ../lib * @library ../lib
@ -51,6 +51,7 @@ public class TestModules extends JavadocTester {
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--frames",
"--module-source-path", testSrc, "--module-source-path", testSrc,
"--module", "moduleA,moduleB", "--module", "moduleA,moduleB",
"testpkgmdlA", "testpkgmdlB"); "testpkgmdlA", "testpkgmdlB");
@ -76,6 +77,7 @@ public class TestModules extends JavadocTester {
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--frames",
"--module-source-path", testSrc, "--module-source-path", testSrc,
"--module", "moduleA,moduleB", "--module", "moduleA,moduleB",
"testpkgmdlA", "testpkgmdlB"); "testpkgmdlA", "testpkgmdlB");
@ -102,6 +104,7 @@ public class TestModules extends JavadocTester {
"-nocomment", "-nocomment",
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--module-source-path", testSrc, "--module-source-path", testSrc,
"--module", "moduleA,moduleB", "--module", "moduleA,moduleB",
@ -123,6 +126,7 @@ public class TestModules extends JavadocTester {
"-nocomment", "-nocomment",
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--module-source-path", testSrc, "--module-source-path", testSrc,
"--module", "moduleA,moduleB", "--module", "moduleA,moduleB",
@ -143,6 +147,7 @@ public class TestModules extends JavadocTester {
javadoc("-d", "out-nomodule", javadoc("-d", "out-nomodule",
"-html4", "-html4",
"-use", "-use",
"--frames",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"-sourcepath", testSrc, "-sourcepath", testSrc,
"testpkgnomodule", "testpkgnomodule1"); "testpkgnomodule", "testpkgnomodule1");
@ -161,6 +166,7 @@ public class TestModules extends JavadocTester {
void testHtml5UnnamedModule() { void testHtml5UnnamedModule() {
javadoc("-d", "out-html5-nomodule", javadoc("-d", "out-html5-nomodule",
"-use", "-use",
"--frames",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"-sourcepath", testSrc, "-sourcepath", testSrc,
"testpkgnomodule", "testpkgnomodule1"); "testpkgnomodule", "testpkgnomodule1");
@ -264,6 +270,7 @@ public class TestModules extends JavadocTester {
void testModuleFilesAndLinks() { void testModuleFilesAndLinks() {
javadoc("-d", "out-modulelinks", javadoc("-d", "out-modulelinks",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"--module-source-path", testSrc, "--module-source-path", testSrc,
"--module", "moduleA,moduleB", "--module", "moduleA,moduleB",
"testpkgmdlA", "testpkgmdlB"); "testpkgmdlA", "testpkgmdlB");
@ -328,6 +335,7 @@ public class TestModules extends JavadocTester {
"-author", "-author",
"-version", "-version",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-tag", "regular:a:Regular Tag:", "-tag", "regular:a:Regular Tag:",
"-tag", "moduletag:s:Module Tag:", "-tag", "moduletag:s:Module Tag:",
"--module-source-path", testSrc, "--module-source-path", testSrc,
@ -352,6 +360,7 @@ public class TestModules extends JavadocTester {
"-author", "-author",
"-version", "-version",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-tag", "regular:a:Regular Tag:", "-tag", "regular:a:Regular Tag:",
"-tag", "moduletag:s:Module Tag:", "-tag", "moduletag:s:Module Tag:",
"--module-source-path", testSrc, "--module-source-path", testSrc,
@ -377,6 +386,7 @@ public class TestModules extends JavadocTester {
"-author", "-author",
"-version", "-version",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-tag", "regular:a:Regular Tag:", "-tag", "regular:a:Regular Tag:",
"-tag", "moduletag:s:Module Tag:", "-tag", "moduletag:s:Module Tag:",
"--module-source-path", testSrc, "--module-source-path", testSrc,
@ -453,6 +463,7 @@ public class TestModules extends JavadocTester {
@Test @Test
void testSingleModuleSinglePkg() { void testSingleModuleSinglePkg() {
javadoc("-d", "out-singlemod", javadoc("-d", "out-singlemod",
"--frames",
"--module-source-path", testSrc, "--module-source-path", testSrc,
"--module", "moduleC", "--module", "moduleC",
"testpkgmdlC"); "testpkgmdlC");
@ -468,6 +479,7 @@ public class TestModules extends JavadocTester {
javadoc("-d", "out-singlemodmultiplepkg", javadoc("-d", "out-singlemodmultiplepkg",
"--show-module-contents=all", "--show-module-contents=all",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"--module-source-path", testSrc, "--module-source-path", testSrc,
"--module", "moduleB", "--module", "moduleB",
"testpkg2mdlB", "testpkgmdlB"); "testpkg2mdlB", "testpkgmdlB");
@ -483,6 +495,7 @@ public class TestModules extends JavadocTester {
javadoc("-d", "out-group", javadoc("-d", "out-group",
"--show-module-contents=all", "--show-module-contents=all",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-tag", "regular:a:Regular Tag:", "-tag", "regular:a:Regular Tag:",
"-tag", "moduletag:s:Module Tag:", "-tag", "moduletag:s:Module Tag:",
"--module-source-path", testSrc, "--module-source-path", testSrc,
@ -505,6 +518,7 @@ public class TestModules extends JavadocTester {
"-html4", "-html4",
"--show-module-contents=all", "--show-module-contents=all",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-tag", "regular:a:Regular Tag:", "-tag", "regular:a:Regular Tag:",
"-tag", "moduletag:s:Module Tag:", "-tag", "moduletag:s:Module Tag:",
"--module-source-path", testSrc, "--module-source-path", testSrc,
@ -528,6 +542,7 @@ public class TestModules extends JavadocTester {
javadoc("-d", "out-groupOrder", javadoc("-d", "out-groupOrder",
"--show-module-contents=all", "--show-module-contents=all",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-tag", "regular:a:Regular Tag:", "-tag", "regular:a:Regular Tag:",
"-tag", "moduletag:s:Module Tag:", "-tag", "moduletag:s:Module Tag:",
"--module-source-path", testSrc, "--module-source-path", testSrc,
@ -550,6 +565,7 @@ public class TestModules extends JavadocTester {
javadoc("-d", "out-groupnomodule", javadoc("-d", "out-groupnomodule",
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-group", "Package Group 0", "testpkgnomodule", "-group", "Package Group 0", "testpkgnomodule",
@ -568,6 +584,7 @@ public class TestModules extends JavadocTester {
"-html4", "-html4",
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-group", "Package Group 0", "testpkgnomodule", "-group", "Package Group 0", "testpkgnomodule",
@ -587,6 +604,7 @@ public class TestModules extends JavadocTester {
javadoc("-d", "out-groupPkgOrder", javadoc("-d", "out-groupPkgOrder",
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-group", "Z Group", "testpkgnomodule", "-group", "Z Group", "testpkgnomodule",
@ -604,6 +622,7 @@ public class TestModules extends JavadocTester {
javadoc("-d", "out-groupsinglemodule", javadoc("-d", "out-groupsinglemodule",
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"--module-source-path", testSrc, "--module-source-path", testSrc,
"-group", "Module Group B", "moduleB*", "-group", "Module Group B", "moduleB*",
"--module", "moduleB", "--module", "moduleB",
@ -621,6 +640,7 @@ public class TestModules extends JavadocTester {
"-html4", "-html4",
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"--module-source-path", testSrc, "--module-source-path", testSrc,
"-group", "Module Group B", "moduleB*", "-group", "Module Group B", "moduleB*",
"--module", "moduleB", "--module", "moduleB",
@ -637,6 +657,7 @@ public class TestModules extends JavadocTester {
javadoc("-d", "out-modulename", javadoc("-d", "out-modulename",
"-use", "-use",
"-Xdoclint:none", "-Xdoclint:none",
"--frames",
"--module-source-path", testSrc, "--module-source-path", testSrc,
"--module", "moduleB,test.moduleFullName", "--module", "moduleB,test.moduleFullName",
"testpkg2mdlB", "testpkgmdlB", "testpkgmdlfullname"); "testpkg2mdlB", "testpkgmdlB", "testpkgmdlfullname");

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8196027 * @bug 8196027 8196202
* @summary test navigation links * @summary test navigation links
* @modules jdk.compiler/com.sun.tools.javac.api * @modules jdk.compiler/com.sun.tools.javac.api
* jdk.compiler/com.sun.tools.javac.main * jdk.compiler/com.sun.tools.javac.main
@ -74,6 +74,7 @@ public class TestModuleNavigation extends JavadocTester {
javadoc("-d", base.resolve("out").toString(), "-use", javadoc("-d", base.resolve("out").toString(), "-use",
"-quiet", "-quiet",
"--frames",
"--module-source-path", src.toString(), "--module-source-path", src.toString(),
"--module", "m,m2"); "--module", "m,m2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -24,7 +24,7 @@
/* /*
* @test * @test
* @bug 4131628 4664607 7025314 8023700 7198273 8025633 8026567 8081854 8150188 8151743 8196027 8182765 * @bug 4131628 4664607 7025314 8023700 7198273 8025633 8026567 8081854 8150188 8151743 8196027 8182765
* 8196200 * 8196200 8196202
* @summary Make sure the Next/Prev Class links iterate through all types. * @summary Make sure the Next/Prev Class links iterate through all types.
* Make sure the navagation is 2 columns, not 3. * Make sure the navagation is 2 columns, not 3.
* @author jamieh * @author jamieh
@ -56,6 +56,7 @@ public class TestNavigation extends JavadocTester {
void test(Path ignore) { void test(Path ignore) {
javadoc("-d", "out", javadoc("-d", "out",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg"); "pkg");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -112,6 +113,7 @@ public class TestNavigation extends JavadocTester {
javadoc("-d", "out-html4", javadoc("-d", "out-html4",
"-html4", "-html4",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg"); "pkg");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -150,6 +152,7 @@ public class TestNavigation extends JavadocTester {
void test1(Path ignore) { void test1(Path ignore) {
javadoc("-d", "out-1", javadoc("-d", "out-1",
"-html5", "-html5",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg"); "pkg");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -182,6 +185,7 @@ public class TestNavigation extends JavadocTester {
void test2(Path ignore) { void test2(Path ignore) {
javadoc("-d", "out-2", javadoc("-d", "out-2",
"-nonavbar", "-nonavbar",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg"); "pkg");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -213,6 +217,7 @@ public class TestNavigation extends JavadocTester {
javadoc("-d", "out-3", javadoc("-d", "out-3",
"-html5", "-html5",
"-nonavbar", "-nonavbar",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg"); "pkg");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -24,7 +24,7 @@
/* /*
* @test * @test
* @bug 4789689 4905985 4927164 4827184 4993906 5004549 7025314 7010344 8025633 8026567 8162363 * @bug 4789689 4905985 4927164 4827184 4993906 5004549 7025314 7010344 8025633 8026567 8162363
* 8175200 8186332 8182765 * 8175200 8186332 8182765 8196202
* @summary Run Javadoc on a set of source files that demonstrate new * @summary Run Javadoc on a set of source files that demonstrate new
* language features. Check the output to ensure that the new * language features. Check the output to ensure that the new
* language features are properly documented. * language features are properly documented.
@ -47,6 +47,7 @@ public class TestNewLanguageFeatures extends JavadocTester {
javadoc("-Xdoclint:none", javadoc("-Xdoclint:none",
"-d", "out", "-d", "out",
"-use", "-use",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg", "pkg1", "pkg2"); "pkg", "pkg1", "pkg2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8039410 8042601 8042829 8049393 8050031 8155061 8155995 8167967 8169813 8182765 * @bug 8039410 8042601 8042829 8049393 8050031 8155061 8155995 8167967 8169813 8182765 8196202
* @summary test to determine if members are ordered correctly * @summary test to determine if members are ordered correctly
* @library ../lib/ * @library ../lib/
* @modules jdk.javadoc/jdk.javadoc.internal.tool * @modules jdk.javadoc/jdk.javadoc.internal.tool
@ -129,6 +129,7 @@ public class TestOrdering extends JavadocTester {
tester.javadoc("-d", "out-1", tester.javadoc("-d", "out-1",
"-sourcepath", tester.testSrc, "-sourcepath", tester.testSrc,
"-use", "-use",
"--frames",
"pkg1"); "pkg1");
tester.checkExit(Exit.OK); tester.checkExit(Exit.OK);
@ -383,6 +384,7 @@ public class TestOrdering extends JavadocTester {
List<String> cmdArgs = new ArrayList(); List<String> cmdArgs = new ArrayList();
cmdArgs.add("-d"); cmdArgs.add("-d");
cmdArgs.add("out-2"); cmdArgs.add("out-2");
cmdArgs.add("--frames");
cmdArgs.add("-sourcepath"); cmdArgs.add("-sourcepath");
cmdArgs.add("src"); cmdArgs.add("src");
cmdArgs.add("-package"); cmdArgs.add("-package");

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8173302 8182765 * @bug 8173302 8182765 8196202
* @summary make sure the overview-summary and module-summary pages don't * @summary make sure the overview-summary and module-summary pages don't
* don't have the See link, and the overview is copied correctly. * don't have the See link, and the overview is copied correctly.
* @library ../lib * @library ../lib
@ -45,6 +45,7 @@ public class TestOverview extends JavadocTester {
"-doctitle", "Document Title", "-doctitle", "Document Title",
"-windowtitle", "Window Title", "-windowtitle", "Window Title",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--frames",
"-sourcepath", testSrc("src"), "-sourcepath", testSrc("src"),
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -58,6 +59,7 @@ public class TestOverview extends JavadocTester {
"-doctitle", "Document Title", "-doctitle", "Document Title",
"-windowtitle", "Window Title", "-windowtitle", "Window Title",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--frames",
"-sourcepath", testSrc("src"), "-sourcepath", testSrc("src"),
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -70,6 +72,7 @@ public class TestOverview extends JavadocTester {
"-doctitle", "Document Title", "-doctitle", "Document Title",
"-windowtitle", "Window Title", "-windowtitle", "Window Title",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--frames",
"-sourcepath", testSrc("msrc"), "-sourcepath", testSrc("msrc"),
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -83,6 +86,7 @@ public class TestOverview extends JavadocTester {
"-doctitle", "Document Title", "-doctitle", "Document Title",
"-windowtitle", "Window Title", "-windowtitle", "Window Title",
"-overview", testSrc("overview.html"), "-overview", testSrc("overview.html"),
"--frames",
"-sourcepath", testSrc("msrc"), "-sourcepath", testSrc("msrc"),
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 6492694 8026567 8048351 8162363 8183511 8169819 8074407 * @bug 6492694 8026567 8048351 8162363 8183511 8169819 8074407 8196202
* @summary Test package deprecation. * @summary Test package deprecation.
* @author bpatel * @author bpatel
* @library ../lib/ * @library ../lib/
@ -45,6 +45,7 @@ public class TestPackageDeprecation extends JavadocTester {
javadoc("-d", "out-default", javadoc("-d", "out-default",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", testSrc("C2.java"), testSrc("FooDepr.java")); "pkg", "pkg1", testSrc("C2.java"), testSrc("FooDepr.java"));
checkExit(Exit.OK); checkExit(Exit.OK);
@ -64,6 +65,7 @@ public class TestPackageDeprecation extends JavadocTester {
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"-nodeprecated", "-nodeprecated",
"--frames",
"pkg", "pkg1", testSrc("C2.java"), testSrc("FooDepr.java")); "pkg", "pkg1", testSrc("C2.java"), testSrc("FooDepr.java"));
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2002, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2002, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4074234 * @bug 4074234 8196202
* @summary Make Javadoc capable of traversing/recursing all of given subpackages. * @summary Make Javadoc capable of traversing/recursing all of given subpackages.
* @author jamieh * @author jamieh
* @library ../lib * @library ../lib
@ -42,6 +42,7 @@ public class TestRecurseSubPackages extends JavadocTester {
@Test @Test
void test() { void test() {
javadoc("-d", "out", javadoc("-d", "out",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-subpackages", "pkg1", "-subpackages", "pkg1",
"-exclude", "pkg1.pkg2.packageToExclude"); "-exclude", "pkg1.pkg2.packageToExclude");

View file

@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 4460354 8014636 8043186 8195805 8182765 * @bug 4460354 8014636 8043186 8195805 8182765 8196202
* @summary Test to make sure that relative paths are redirected in the * @summary Test to make sure that relative paths are redirected in the
* output so that they are not broken. * output so that they are not broken.
* @author jamieh * @author jamieh
@ -44,6 +44,7 @@ public class TestRelativeLinks extends JavadocTester {
void test() { void test() {
javadoc("-d", "out", javadoc("-d", "out",
"-use", "-use",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg", "pkg2"); "pkg", "pkg2");
checkExit(Exit.ERROR); checkExit(Exit.ERROR);

View file

@ -24,7 +24,7 @@
/* /*
* @test * @test
* @bug 8141492 8071982 8141636 8147890 8166175 8168965 8176794 8175218 8147881 * @bug 8141492 8071982 8141636 8147890 8166175 8168965 8176794 8175218 8147881
* 8181622 8182263 8074407 8187521 8198522 8182765 8199278 8196201 * 8181622 8182263 8074407 8187521 8198522 8182765 8199278 8196201 8196202
* @summary Test the search feature of javadoc. * @summary Test the search feature of javadoc.
* @author bpatel * @author bpatel
* @library ../lib * @library ../lib
@ -67,6 +67,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:none", "-Xdoclint:none",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
checkExit(Exit.OK); checkExit(Exit.OK);
checkInvalidUsageIndexTag(); checkInvalidUsageIndexTag();
@ -105,6 +106,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:all", "-Xdoclint:all",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
checkExit(Exit.ERROR); checkExit(Exit.ERROR);
checkDocLintErrors(); checkDocLintErrors();
@ -142,6 +144,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:none", "-Xdoclint:none",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
checkExit(Exit.OK); checkExit(Exit.OK);
checkSearchOutput(false); checkSearchOutput(false);
@ -167,6 +170,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:none", "-Xdoclint:none",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
checkExit(Exit.OK); checkExit(Exit.OK);
checkSearchOutput(true); checkSearchOutput(true);
@ -193,6 +197,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:none", "-Xdoclint:none",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
checkExit(Exit.OK); checkExit(Exit.OK);
checkSearchOutput(false); checkSearchOutput(false);
@ -216,6 +221,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:none", "-Xdoclint:none",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
checkExit(Exit.OK); checkExit(Exit.OK);
checkSearchOutput(true); checkSearchOutput(true);
@ -241,6 +247,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:none", "-Xdoclint:none",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
setAutomaticCheckLinks(true); // @ignore JDK-8202627 setAutomaticCheckLinks(true); // @ignore JDK-8202627
checkExit(Exit.OK); checkExit(Exit.OK);
@ -266,6 +273,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:none", "-Xdoclint:none",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
checkExit(Exit.OK); checkExit(Exit.OK);
checkInvalidUsageIndexTag(); checkInvalidUsageIndexTag();
@ -293,6 +301,7 @@ public class TestSearch extends JavadocTester {
"--disable-javafx-strict-checks", "--disable-javafx-strict-checks",
"-package", "-package",
"-use", "-use",
"--frames",
"pkgfx", "pkg3"); "pkgfx", "pkg3");
checkExit(Exit.OK); checkExit(Exit.OK);
checkSearchOutput(true); checkSearchOutput(true);
@ -318,6 +327,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:none", "-Xdoclint:none",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
checkExit(Exit.OK); checkExit(Exit.OK);
checkSearchOutput(true, false); checkSearchOutput(true, false);
@ -345,6 +355,7 @@ public class TestSearch extends JavadocTester {
"-Xdoclint:none", "-Xdoclint:none",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg", "pkg1", "pkg2", "pkg3"); "pkg", "pkg1", "pkg2", "pkg3");
checkExit(Exit.OK); checkExit(Exit.OK);
checkSearchJS(); checkSearchJS();

View file

@ -25,7 +25,7 @@
/* /*
* @test * @test
* @bug 8173425 8186332 8182765 * @bug 8173425 8186332 8182765 8196202
* @summary tests for the summary tag behavior * @summary tests for the summary tag behavior
* @library ../lib * @library ../lib
* @modules jdk.javadoc/jdk.javadoc.internal.tool * @modules jdk.javadoc/jdk.javadoc.internal.tool
@ -157,6 +157,7 @@ public class TestSummaryTag extends JavadocTester {
@Test @Test
void test3() { void test3() {
javadoc("-d", "out3", javadoc("-d", "out3",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-overview", testSrc("p3/overview.html"), "-overview", testSrc("p3/overview.html"),
"p3"); "p3");

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 6227616 8043186 * @bug 6227616 8043186 8196202
* @summary Test the new -top option. * @summary Test the new -top option.
* @author jamieh * @author jamieh
* @library ../lib * @library ../lib
@ -45,6 +45,7 @@ public class TestTopOption extends JavadocTester {
"-use", "-use",
"-top", "TOP TEXT", "-top", "TOP TEXT",
"-d", "out-1", "-d", "out-1",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg"); "pkg");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -68,6 +69,7 @@ public class TestTopOption extends JavadocTester {
"-use", "-use",
"-top", "\u0130{@docroot}TOP TEXT", "-top", "\u0130{@docroot}TOP TEXT",
"-d", "out-2", "-d", "out-2",
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"pkg"); "pkg");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -24,7 +24,7 @@
/* /*
* @test * @test
* @bug 4496290 4985072 7006178 7068595 8016328 8050031 8048351 8081854 8071982 8162363 8175200 8186332 * @bug 4496290 4985072 7006178 7068595 8016328 8050031 8048351 8081854 8071982 8162363 8175200 8186332
* 8182765 * 8182765 8196202
* @summary A simple test to ensure class-use files are correct. * @summary A simple test to ensure class-use files are correct.
* @author jamieh * @author jamieh
* @library ../lib * @library ../lib
@ -46,6 +46,7 @@ public class TestUseOption extends JavadocTester {
javadoc("-d", "out-1", javadoc("-d", "out-1",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"-use", "-use",
"--frames",
"pkg1", "pkg2"); "pkg1", "pkg2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2013, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2013, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -23,7 +23,7 @@
/* /*
* @test * @test
* @bug 8016675 8026736 * @bug 8016675 8026736 8196202
* @summary Test for window title. * @summary Test for window title.
* @author Bhavesh Patel * @author Bhavesh Patel
* @library ../lib * @library ../lib
@ -48,6 +48,7 @@ public class TestWindowTitle extends JavadocTester {
javadoc("-d", "out-js-chars", javadoc("-d", "out-js-chars",
"-windowtitle", title, "-windowtitle", title,
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -72,6 +73,7 @@ public class TestWindowTitle extends JavadocTester {
javadoc("-d", "out-script", javadoc("-d", "out-script",
"-windowtitle", title, "-windowtitle", title,
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -105,6 +107,7 @@ public class TestWindowTitle extends JavadocTester {
javadoc("-d", "out-html-tags", javadoc("-d", "out-html-tags",
"-windowtitle", title, "-windowtitle", title,
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -128,6 +131,7 @@ public class TestWindowTitle extends JavadocTester {
javadoc("-d", "out-html-entities", javadoc("-d", "out-html-entities",
"-windowtitle", title, "-windowtitle", title,
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
@ -148,6 +152,7 @@ public class TestWindowTitle extends JavadocTester {
javadoc("-d", "out-empty-tags", javadoc("-d", "out-empty-tags",
"-windowtitle", title, "-windowtitle", title,
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
@ -167,6 +172,7 @@ public class TestWindowTitle extends JavadocTester {
javadoc("-d", "out-unicode", javadoc("-d", "out-unicode",
"-windowtitle", title, "-windowtitle", title,
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -188,6 +194,7 @@ public class TestWindowTitle extends JavadocTester {
String title = ""; String title = "";
javadoc("-d", "out-empty", javadoc("-d", "out-empty",
"-windowtitle", title, "-windowtitle", title,
"--frames",
"-sourcepath", testSrc, "p1", "p2"); "-sourcepath", testSrc, "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);
@ -205,6 +212,7 @@ public class TestWindowTitle extends JavadocTester {
javadoc("-d", "out-doctitle", javadoc("-d", "out-doctitle",
"-doctitle", title, "-doctitle", title,
"--frames",
"-sourcepath", testSrc, "-sourcepath", testSrc,
"p1", "p2"); "p1", "p2");
checkExit(Exit.OK); checkExit(Exit.OK);

View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2016, 2018, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -242,6 +242,7 @@ public class TestScriptInComment {
opts.add(srcDir.getPath()); opts.add(srcDir.getPath());
opts.add("-d"); opts.add("-d");
opts.add(outDir.getPath()); opts.add(outDir.getPath());
opts.add("--frames");
if (option.text != null) if (option.text != null)
opts.add(option.text); opts.add(option.text);
for (String opt: template.getOpts(srcDir)) { for (String opt: template.getOpts(srcDir)) {

View file

@ -190,9 +190,8 @@ class APITest {
* Standard files generated by processing a documented class pkg.C. * Standard files generated by processing a documented class pkg.C.
*/ */
protected static Set<String> standardExpectFiles = new HashSet<>(Arrays.asList( protected static Set<String> standardExpectFiles = new HashSet<>(Arrays.asList(
"allclasses-frame.html", "allclasses.html",
"allclasses-index.html", "allclasses-index.html",
"allclasses-noframe.html",
"allpackages-index.html", "allpackages-index.html",
"constant-values.html", "constant-values.html",
"deprecated-list.html", "deprecated-list.html",
@ -233,7 +232,6 @@ class APITest {
"package-search-index.js", "package-search-index.js",
"package-search-index.zip", "package-search-index.zip",
"pkg/C.html", "pkg/C.html",
"pkg/package-frame.html",
"pkg/package-summary.html", "pkg/package-summary.html",
"pkg/package-tree.html", "pkg/package-tree.html",
"resources/glass.png", "resources/glass.png",

View file

@ -190,9 +190,8 @@ class APITest {
* Standard files generated by processing a documented class pkg.C. * Standard files generated by processing a documented class pkg.C.
*/ */
protected static Set<String> standardExpectFiles = new HashSet<>(Arrays.asList( protected static Set<String> standardExpectFiles = new HashSet<>(Arrays.asList(
"allclasses-frame.html", "allclasses.html",
"allclasses-index.html", "allclasses-index.html",
"allclasses-noframe.html",
"allpackages-index.html", "allpackages-index.html",
"constant-values.html", "constant-values.html",
"deprecated-list.html", "deprecated-list.html",
@ -233,7 +232,6 @@ class APITest {
"package-search-index.js", "package-search-index.js",
"package-search-index.zip", "package-search-index.zip",
"pkg/C.html", "pkg/C.html",
"pkg/package-frame.html",
"pkg/package-summary.html", "pkg/package-summary.html",
"pkg/package-tree.html", "pkg/package-tree.html",
"resources/glass.png", "resources/glass.png",