Support Markdown Documentation Comments (JEP 467, JDK 23)
odenix opened this issue · 0 comments
odenix commented
Consider the following code:
import java.nio.ByteBuffer;
interface BufferAllocator {
/// Returns a lease for a [ByteBuffer] with at least the specified [capacity][ByteBuffer#capacity].
LeasedByteBuffer getByteBuffer(long minCapacity);
}
Formatting the above code causes the following issues:
- The doc comment is split into two lines, but the second line starts with
//
instead of///
. - The import statement is removed, breaking the links.
Disabling Javadoc formatting doesn't prevent either issue.
The only workaround I could find was to disable google-java-format.
Tested with JDK 23 and google-java-format 1.24.0.