12
Tôi đang làm việc trên một ứng dụng được liên tục tái cấu trúc để cải thiện nó. Bây giờ, nếu chúng ta đổi tên một lớp nào đó để nắm bắt tốt hơn ý định của nó, tất cả tài liệu đề cập đến lớp không được cập nhật tự động, trừ khi bạn sử dụng các liên kết ({@link ClassName}) để tham chiếu đến lớp. Tuy nhiên,Làm cho JavaDoc mạnh mẽ chống lại việc tái cấu trúc
Nguyên tắc JavaDoc tuyên bố rằng "nên sử dụng liên kết nội tuyến một cách kinh tế", vì các liên kết nổi bật và thu hút sự chú ý của người đọc, điều mà tôi thấy hợp lý. Ngoài ra, bạn không thể liên kết đến các tham số của một phương thức.
Có cách nào khác trong JavaDoc để làm cho nhận xét mạnh mẽ hơn để tái cấu trúc mà tôi không biết?
Bạn đang tái cấu trúc như thế nào? Khi đổi tên trong Eclipse có tùy chọn để tìm kiếm thông qua các bình luận. –
Vâng, tôi sử dụng Eclipse và tôi nhớ đã thấy điều đó. Tôi không nhận được tùy chọn tuy nhiên (sử dụng Ctrl + Alt + R), và tôi không thể tìm thấy bất cứ điều gì trong các thiết lập để thay đổi điều đó. Dù sao, điều đó sẽ hoạt động nhiều nhất, nhưng tất nhiên nó có thể không rõ ràng. – alexsb
IntelliJ tìm kiếm thông qua các nhận xét, chuỗi và tệp để tìm những thứ cần đổi tên. Nó cũng cung cấp để đổi tên trường, biến và tham số .. Tôi cho rằng Eclipse cũng làm như vậy. –