dangling-doc-comments being a bit too picky

2024-10-09 Thread Max Rydahl Andersen
Hi, I noticed that Java 23 `javac -Xlint:dangling-doc-comments test.java` where `test.java` is: ```java ///usr/bin/env jbang "$0" "$@" ; exit $? /** * test */ public class test { public static void main(String[] args) { System.out.println("Javadoc should not complain about the 1s

RFR: 8340565: Create separate index page for terms defined by the index tag

2024-10-09 Thread Hannes Wallnöfer
This change adds a conditional `search-tags.html` page to list all search tags defined by the `{@index ... }` tag. Since search tags work very similar to the `{@systemProperty ...}` tag and are internally represented by the same class I changed `SystemPropertiesWriter.java` into an abstract base

Re: RFR: 8338596: Clarify handling of restricted and caller-sensitive methods [v8]

2024-10-09 Thread Maurizio Cimadamore
> This PR moves the section on restricted methods from the the javadoc of > `java.lang.foreign` package into a standalone static [javadoc > page](https://cr.openjdk.org/~mcimadamore/jdk/restricted_javadoc_section/docs/api/java.base/java/lang/foreign/doc-files/RestrictedMethods.html). > > This is

Withdrawn: 8333230: Improve code example in doclet package

2024-10-09 Thread Nizar Benalla
On Fri, 16 Aug 2024 17:08:41 GMT, Nizar Benalla wrote: > Can I please get a review for this simple change? It's an attempt to improve > the code example in doclet package. > Here are the generated docs with the [new code > example.](https://cr.openjdk.org/~nbenalla/GeneratedDocs/newDocletExampl

Re: RFR: 8333230: Improve code example in doclet package [v2]

2024-10-09 Thread Nizar Benalla
On Mon, 19 Aug 2024 16:35:29 GMT, Nizar Benalla wrote: >> Can I please get a review for this simple change? It's an attempt to improve >> the code example in doclet package. >> Here are the generated docs with the [new code >> example.](https://cr.openjdk.org/~nbenalla/GeneratedDocs/newDocletEx