undefect. CWE-407 — 63 sites patched across 27 ecosystems

Authors: russell@unturf.com · brackishbert@gmail.com · foxhop.net · TimeHexOn.com Patches, unit tests, benchmarks, whitepaper, and outreach briefs. Public domain — no copyright claimed. Use freely.
2026-03-26 17:11:57 -04:00 · 2026-03-26 17:11:57 -04:00 · 0a580b313d
commit 0a580b313d
70422 changed files with 17213626 additions and 0 deletions
--- a/test/langtools/jdk/javadoc/tool/testLineCommentOption/TestLineCommentOption.java
+++ b/test/langtools/jdk/javadoc/tool/testLineCommentOption/TestLineCommentOption.java
@ -0,0 +1,101 @@
+/*
+ * Copyright (c) 2023, 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.
+ *
+ * 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      8298405
+ * @summary  Markdown support in the standard doclet
+ * @library  /tools/lib ../../lib
+ * @modules jdk.compiler/com.sun.tools.javac.api
+ *          jdk.compiler/com.sun.tools.javac.main
+ *          jdk.javadoc/jdk.javadoc.internal.tool
+ * @build    toolbox.ToolBox javadoc.tester.*
+ * @run main TestLineCommentOption
+ */
+
+import java.nio.file.Path;
+import java.util.List;
+import java.util.Optional;
+import java.util.ServiceLoader;
+import java.util.stream.StreamSupport;
+
+import com.sun.source.doctree.DocCommentTree;
+import com.sun.source.doctree.DocTree;
+import com.sun.source.doctree.RawTextTree;
+import com.sun.source.doctree.TextTree;
+import com.sun.source.util.DocTreeFactory;
+import com.sun.source.util.DocTrees;
+
+import com.sun.tools.javac.api.JavacTrees;
+
+import javadoc.tester.JavadocTester;
+import jdk.javadoc.doclet.DocletEnvironment;
+import jdk.javadoc.doclet.StandardDoclet;
+import toolbox.ToolBox;
+
+public class TestLineCommentOption extends JavadocTester {
+    public static void main(String... args) throws Exception {
+        var tester = new TestLineCommentOption();
+        tester.runTests();
+    }
+
+    private final ToolBox tb = new ToolBox();
+
+
+    // This is a somewhat worthless test case, given all the test cases for
+    // Markdown content in line comments.
+    @Test
+    public void testNoOption(Path base) throws Exception {
+        // use a dummy option
+        // note that we cannot use -Xlint:dangling-doc-comments in javadoc
+        test(base, "-XDdummy", "Line comment");
+        // in the future, check for diagnostic output about a dangling comment
+    }
+
+    @Test
+    public void testOption(Path base) throws Exception {
+        test(base, "--disable-line-doc-comments", "Traditional comment");
+    }
+
+    void test(Path base, String option, String expect) throws Exception {
+        Path src = base.resolve("src");
+        tb.writeJavaFiles(src, """
+            package p;
+            /**
+             * Traditional comment.
+             */
+            /// Line comment
+            public class C {
+                private C() { }
+            }""");
+
+        javadoc("-d", base.resolve("api").toString(),
+                "--source-path", src.toString(),
+                option,
+                "p");
+        checkExit(Exit.OK);
+
+        checkOutput("p/C.html", true,
+                expect);
+    }
+}