google / google/google-java-format
Support Markdown Documentation Comments (JEP 467, JDK 23)
- Lenguaje dominante
- Java
- Estrellas
- 6.2k
- Forks
- 937
- Merge medio
- 6 min
- PR fusionados (30 d)
- 3
Descripción
Consider the following code:
```java
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:
1. The doc comment is split into two lines, but the second line starts with `//` instead of `///`.
2. 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.
Guía de contribución
Evaluación
Este issue todavía no se ha evaluado.