2010-08-05 29 views
5

Có công cụ nào để tự động thêm thẻ @since vào tất cả các yếu tố khi tôi muốn có phiên bản phát hành không?Thẻ @since javadoc tự động cho các bản phát hành

Vì vậy, chúng ta hãy nói rằng tôi có một loạt các phương pháp và hệ thống cơ sở của tôi đang làm việc bây giờ, vì vậy tôi quyết định phát hành nó như là phiên bản 0.1.0

Những gì tôi muốn bây giờ là một công cụ để tìm kiếm cho mỗi @since mất tích và thêm nó cho phù hợp.

Tôi đang sử dụng Eclipse và tôi đã tìm thấy JAutodoc, nhưng theo như tôi thấy, nó chỉ cho phép tìm kiếm các thẻ bị thiếu và tôi phải thêm chúng theo cách thủ công.

EDIT: Một cách giải quyết khác có thể thú vị đối với một người nào đó: Từ đầu sử dụng một mẫu Eclipse có quyền kể từ khi thẻ và sau mỗi bản phát hành thay đổi mẫu.

+0

Câu hỏi hay. – whiskeysierra

Trả lời

3

Điều này nghe có vẻ giống như công cụ xây dựng của bạn sẽ cung cấp cho bạn. Nếu bạn đang sử dụng maven bạn nên có một cái nhìn tại javadoc: sửa chữa. Có vẻ như nó thực hiện chính xác những gì bạn muốn:

http://maven.apache.org/plugins/maven-javadoc-plugin/fix-mojo.html

+0

Tôi đã cố gắng nhìn vào maven một thời gian trước đây. Lúc đầu nó trông rất hứa hẹn và nó vẫn còn. Nhưng cho đến bây giờ tôi chưa bao giờ xoay xở để làm cho nó hoạt động được. Dù sao, từ tháng tới tôi hy vọng sẽ có thêm thời gian và sẽ có một lần nữa. Vì vậy, cảm ơn cho đến nay! – Mene

0

Tôi có thể chỉ cần thêm một bài học tôi học được khoảng 27 năm trước: không cố gắng làm cho số điều khiển phiên bản của bạn phù hợp với số lượng phát hành sản phẩm của bạn. Đó là cách điên rồ nói dối.

+0

Vấn đề là: Nếu API của bạn công khai và những người khác đang sử dụng nó và bạn có các bản phát hành khác nhau và không phải ai cũng có phiên bản mới nhất, đó là điều tốt để mọi người biết liệu họ có thể sử dụng một phương pháp cụ thể hay không. Hoặc bạn có một giải pháp tốt hơn? Tôi luôn cởi mở; D – Mene

Các vấn đề liên quan