Tag @snippet not respected when formatting Javadoc

[future2r]

If I use the Java18 snippet tag, all Javadoc is still joined to a single line.
I copied the formatter settings from an Eclipse project, where everything works fine.

Environment

• Operating System: Windows 11
• JDK version: OpenJDK 21
• Visual Studio Code version: 1.94.0
• Java extension version: 1.35.1

Steps To Reproduce

1. Create a Java file with this content

public class SnippetTest {

    /**
     * This is a snippet test.
     * {@snippet : 
     * System.out.println("Hello World");
     * }
     * @param args
     *            the arguments
     */
    public static void main(final String[] args) {
        System.out.println("Hello World");
    }
}

2. Format the file with the attached settings.

Current Result

public class SnippetTest {

    /**
     * This is a snippet test. {@snippet : System.out.println("Hello World"); }
     * 
     * @param args
     *            the arguments
     */
    public static void main(final String[] args) {
        System.out.println("Hello World");
    }
}

Expected Result

see the first code block

Additional Informations

format.zip

[rgrunber]

It might be related to our implementation of @snippet support in JDT-LS, eclipse-jdtls/eclipse.jdt.ls#2028 . There's a few things lacking from our support listed there.

[fbricon]

After formatting, the aforementioned javadoc now looks like :

    /**
     * This is a snippet test.
     * {@snippet :
     * 
     * System.out.println("Hello World");
     * }
     * 
     * @param args
     *            the arguments
     */

The extra empty line is added when there's a whitespace added after the :. The formatting removes it and adds that line. Then if you delete the blank line, formatting again keeps it intact.

Not sure if it's a bug or a feature, but I'm inclined to close this one.