google / google/google-java-format

Allow lines to start with `@foo` inside a block tag like `{@code}`

Đang mở
#824 0 bình luận 1 reaction 0 người được giao Xem trên GitHub
Ngôn ngữ chính
Java
Star
6.2k
Fork
937
Merge trung bình
6 phút
Pull request đã merge (30 ngày)
3

Mô tả

IIRC, we currently consider such an appearance of `@foo` to be an invalid tag (or, if it is a recognized one like `@return`, maybe a valid tag? or maybe never a valid tag because we're upset that the previous inline tag was never closed?). It is invalid... until Java 15, at which point https://bugs.openjdk.org/browse/JDK-8241780 saves us.

On those grounds, we don't format the Javadoc at all (which is not necessarily a great failure mode, but that's another issue).

Maybe we should just allow this, at least for cases that are not normally Javadoc tags, like `@Override`?

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Đánh giá

Issue này chưa được đánh giá.

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.