Eclipse - cách đặt cảnh báo javadoc chỉ cho các thư mục cụ thể, không phải toàn bộ dự án

Question

Một số đồng nghiệp của tôi thiếu kỷ luật và không phải lúc nào cũng viết tài liệu về lớp học của họ (không phải lúc nào = không bao giờ). Tôi đã cố gắng ép buộc họ viết tài liệu bằng cách thiết lập cảnh báo dự án vì thiếu javadocs bình luận. Chúng tôi có hai thư mục nguồn 'src' và 'tests' - rõ ràng không phải tất cả các phương thức @Test đều cần tài liệu và cảnh báo này có dư thừa. Nhưng bây giờ tất cả các bài kiểm tra không có giấy tờ có những cảnh báo khó chịu, dự án có hàng trăm cảnh báo và tôi sợ rằng một số cảnh báo nguy hiểm thực sự sẽ bị bỏ qua (vì có hàng trăm người vô dụng).

Cách đặt cảnh báo chỉ trên thư mục 'src' và bỏ qua các cảnh báo trên thư mục 'kiểm tra'?

Answer 1

Tôi e rằng không có cài đặt nào để tắt xác thực javadoc bị thiếu nghiêm ngặt đối với các lớp/phương pháp thử nghiệm. Thậm chí còn có một đề xuất được đăng trên Eclipse bugzilla here nhưng cuối cùng nó đã đến một kết thúc chết.

Cách duy nhất, không hòa hợp để giải quyết vấn đề này là bằng cách chú thích các phương pháp thử nghiệm đó với chú thích @SuppressWarnings("javadoc").