Merge pull request #1682 from SAP/pr-jdk-23+24

Merge to tag jdk-23+24

make/CompileDemos.gmk

@@ -183,7 +183,7 @@ $(eval $(call SetupBuildDemo, SwingSet2, \
 ))
 
 $(eval $(call SetupBuildDemo, Font2DTest, \
- DISABLED_WARNINGS := rawtypes deprecation unchecked serial cast this-escape, \
+ DISABLED_WARNINGS := rawtypes deprecation unchecked serial cast this-escape dangling-doc-comments, \
  DEMO_SUBDIR := jfc, \
 ))
 

make/autoconf/spec.gmk.template

@@ -675,7 +675,7 @@ DOCS_REFERENCE_JAVADOC := @DOCS_REFERENCE_JAVADOC@
 SOURCE_REVISION_TRACKER := $(SUPPORT_OUTPUTDIR)/src-rev/source-revision-tracker
 
 # Interim langtools modules and arguments
-INTERIM_LANGTOOLS_BASE_MODULES := java.compiler jdk.compiler jdk.javadoc
+INTERIM_LANGTOOLS_BASE_MODULES := java.compiler jdk.compiler jdk.internal.md jdk.javadoc
 INTERIM_LANGTOOLS_MODULES := $(addsuffix .interim, $(INTERIM_LANGTOOLS_BASE_MODULES))
 INTERIM_LANGTOOLS_ADD_EXPORTS := \
  --add-exports java.base/sun.reflect.annotation=jdk.compiler.interim \

make/data/docs-resources/resources/jdk-default.css

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2017, 2024, 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
@@ -23,56 +23,62 @@
  * questions.
  */
 
+@import url('../api/resource-files/fonts/dejavu.css');
+
 body {
- margin: 2em 2em;
  font-family: DejaVu Sans, Bitstream Vera Sans, Luxi Sans, Verdana, Arial, Helvetica, sans-serif;
  font-size: 10pt;
+ margin: 0;
+ padding: 0;
+ height: 100%;
+ width: 100%;
+ min-width: 100%;
  line-height: 1.4;
 }
 
 pre, code, tt {
- font-family: DejaVu Sans Mono, Bitstream Vera Sans Mono, Luxi Mono,
- Courier New, monospace;
+ font-family: DejaVu Sans Mono, Bitstream Vera Sans Mono, Luxi Mono, Courier New, monospace;
+}
+
+main, footer {
+ margin: 16px 27px;
+}
+
+/* Adjust horizontal margin for content elements outside of main element */
+:is(body, header) > :is(nav, h1, h2, h3, h4, h5, h6, p, .sub-title) {
+ margin-left: 27px;
+ margin-right: 27px;
 }
 
 blockquote {
- margin: 1.5ex 0em 1.5ex 2em;
+ margin: 1.5ex 0 1.5ex 2em;
 }
 
 p {
- padding: 0pt;
- margin: 1ex 0em;
+ margin-top: 1ex;
+ margin-bottom: 1ex;
 }
 
-p:first-child, pre:first-child { margin-top: 0pt; }
-
-h1 {
- font-weight: bold;
- padding: 0pt;
- margin: 2ex .5ex 1ex 0pt;
+dd > p:first-child, pre:first-child {
+ margin-top: 0;
 }
 
 h1:first-child, h2:first-child {
- margin-top: 0ex;
+ margin-top: 0;
 }
 
-h2 {
- font-weight: bold;
- padding: 0pt;
- margin: 2ex 0pt 1ex 0pt;
+h1, h2 {
+ margin-top: 2ex;
+ margin-bottom: 1ex;
 }
 
-h3 {
- font-weight: bold;
- padding: 0pt;
- margin: 1.5ex 0pt 1ex 0pt;
+h3, h4, h5 {
+ margin-top: 1.5ex;
+ margin-bottom: 1ex;
 }
 
 h4, h5 {
  font-size: 100%;
- font-weight: bold;
- padding: 0pt;
- margin: 1.5ex 0pt 1ex 0pt;
 }
 
 .subtitle {
@@ -100,7 +106,7 @@ a[href]:hover {
 }
 
 a img {
- border-width: 0px;
+ border-width: 0;
 }
 
 img {
@@ -154,9 +160,9 @@ table.centered td {
 
 .draft-header {
  text-align: center;
- font-size: 80%;
+ font-size: 11.2px;
  padding: 6px;
- margin: -2.5em -2.5em 2.5em -2.5em;
+ line-height: initial;
 }
 
 .legal-footer {
@@ -183,29 +189,31 @@ nav#TOC ul ul li::before {
  content: " \2022 "
 }
 
-header#title-block-header {
- margin-top:-2em;
+/* Rules below replicate sizing of navigation bar in API docs */
+header#title-block-header div.navbar {
+ padding: 0 20px 0 26px;
+ margin-bottom: 30px;
+ background-color: #4D7A97;
+ color: #FFFFFF;
+ height: 44px;
+ overflow: hidden;
+ font-size: 0.857em;
+ line-height: initial;
+ display: flex;
+ flex-direction: row-reverse;
+ align-items: center;
 }
 
-header#title-block-header div.navbar {
- margin: 0 -2.5em 2.5em -2.5em;
- padding: 0 2.5em;
- background-color:#4D7A97;
- color:#FFFFFF;
- float:left;
- width:100%;
- clear:right;
- min-height:2.8em;
- padding-top:10px;
- overflow:hidden;
- font-size:12px;
+header#title-block-header div.navbar nav {
+ flex: 1 1 auto;
+ font-size: 12px;
+ white-space: nowrap;
 }
 
 header#title-block-header div.navbar div {
- float:right;
- font-size:11px;
- height:2.9em;
- margin: auto 0;
+ flex: 0 0 auto;
+ font-size: 10.978px;
+ white-space: nowrap;
 }
 
 header#title-block-header ul {

make/ide/visualstudio/hotspot/src/classes/build/tools/projectcreator/FileTreeCreator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2024, 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
@@ -54,7 +54,7 @@ public FileTreeCreator(Path startDir, Vector<BuildConfig> allConfigs, WinGammaPl
  attributes.push(new DirAttributes());
  }
 
- public class DirAttributes {
+ public static class DirAttributes {
 
  private HashSet<BuildConfig> ignores;
  private HashSet<BuildConfig> disablePch;

make/jdk/src/classes/build/tools/intpoly/FieldGen.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2018, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2018, 2024, 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
@@ -778,7 +778,7 @@ private String generate(FieldParams params) throws IOException {
  result.appendLine("}");
 
  result.appendLine("@Override");
- result.appendLine("protected void mult(long[] a, long[] b, long[] r) {");
+ result.appendLine("protected int mult(long[] a, long[] b, long[] r) {");
  result.incrIndent();
  for (int i = 0; i < 2 * params.getNumLimbs() - 1; i++) {
  result.appendIndent();
@@ -804,6 +804,9 @@ private String generate(FieldParams params) throws IOException {
  }
  }
  result.append(");\n");
+ result.appendIndent();
+ result.append("return 0;");
+ result.appendLine();
  result.decrIndent();
  result.appendLine("}");
 
@@ -833,7 +836,7 @@ private String generate(FieldParams params) throws IOException {
  // }
  // }
  result.appendLine("@Override");
- result.appendLine("protected void square(long[] a, long[] r) {");
+ result.appendLine("protected int square(long[] a, long[] r) {");
  result.incrIndent();
  for (int i = 0; i < 2 * params.getNumLimbs() - 1; i++) {
  result.appendIndent();
@@ -874,6 +877,9 @@ private String generate(FieldParams params) throws IOException {
  }
  }
  result.append(");\n");
+ result.appendIndent();
+ result.append("return 0;");
+ result.appendLine();
  result.decrIndent();
  result.appendLine("}");
 

make/jdk/src/classes/build/tools/taglet/JSpec.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2017, 2024, 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
@@ -30,6 +30,8 @@
 import java.util.Set;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+
 import javax.lang.model.element.Element;
 
 import com.sun.source.doctree.DocTree;
@@ -157,7 +159,10 @@ public String toString(List<? extends DocTree> tags, Element elem) {
  continue;
  }
 
- String tagText = contents.toString().trim();
+ String tagText = contents.stream()
+ .map(Object::toString)
+ .collect(Collectors.joining())
+ .trim();
  Matcher m = TAG_PATTERN.matcher(tagText);
  if (m.find()) {
  String chapter = m.group("chapter");

make/jdk/src/classes/build/tools/taglet/ToolGuide.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2017, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2017, 2024, 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
@@ -30,6 +30,8 @@
 import java.util.Set;
 import java.util.regex.Matcher;
 import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+
 import javax.lang.model.element.Element;
 import javax.lang.model.element.PackageElement;
 import javax.lang.model.element.TypeElement;
@@ -105,8 +107,11 @@ public String toString(List<? extends DocTree> tags, Element elem) {
  continue;
  }
 
- UnknownBlockTagTree blockTag = (UnknownBlockTagTree)tag;
- String tagText = blockTag.getContent().toString().trim();
+ UnknownBlockTagTree blockTag = (UnknownBlockTagTree) tag;
+ String tagText = blockTag.getContent().stream()
+ .map(Object::toString)
+ .collect(Collectors.joining())
+ .trim();
  Matcher m = TAG_PATTERN.matcher(tagText);
  if (m.matches()) {
  String name = m.group("name");

make/modules/java.base/Java.gmk

@@ -27,7 +27,7 @@
 # new warning is added to javac, it can be temporarily added to the
 # disabled warnings list.
 #
-# DISABLED_WARNINGS_java +=
+DISABLED_WARNINGS_java += dangling-doc-comments
 
 DOCLINT += -Xdoclint:all/protected \
  '-Xdoclint/package:java.*,javax.*'

make/modules/jdk.incubator.vector/Java.gmk

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2020, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2020, 2024, 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
@@ -23,4 +23,6 @@
 # questions.
 #
 
+DISABLED_WARNINGS_java += dangling-doc-comments
+
 DOCLINT += -Xdoclint:all/protected

make/modules/jdk.internal.md/Java.gmk

@@ -0,0 +1,26 @@
+#
+# Copyright (c) 2024, 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. Oracle designates this
+# particular file as subject to the "Classpath" exception as provided
+# by Oracle in the LICENSE file that accompanied this code.
+#
+# 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.
+#
+
+COPY += .txt

make/modules/jdk.jpackage/Java.gmk

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2020, 2023, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2020, 2024, 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
@@ -23,6 +23,8 @@
 # questions.
 #
 
+DISABLED_WARNINGS_java += dangling-doc-comments
+
 COPY += .gif .png .txt .spec .script .prerm .preinst \
  .postrm .postinst .list .sh .desktop .copyright .control .plist .template \
  .icns .scpt .wxs .wxl .wxi .ico .bmp .tiff .service

make/modules/jdk.unsupported/Java.gmk

@@ -0,0 +1,26 @@
+#
+# Copyright (c) 2024, 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. Oracle designates this
+# particular file as subject to the "Classpath" exception as provided
+# by Oracle in the LICENSE file that accompanied this code.
+#
+# 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.
+#
+
+DISABLED_WARNINGS_java += dangling-doc-comments