Tại sao chú thích javadoc mặc định của lớp IntelliJ mặc định sử dụng cú pháp không chuẩn?

Question

Tại sao nhận xét javadoc mặc định của lớp IntelliJ mặc định sử dụng cú pháp không chuẩn? Thay vì tạo một dòng với "Người dùng: jstauffer", nó có thể tạo một dòng với "@author jstauffer". Các dòng khác mà nó tạo ra (Ngày và Giờ) có thể không có cú pháp javadoc để sử dụng nhưng tại sao không sử dụng cú pháp javadoc khi có sẵn?

Để tham khảo ở đây là một ví dụ:

/** 
* Created by IntelliJ IDEA. 
* User: jstauffer 
* Date: Nov 13, 2007 
* Time: 11:15:10 AM 
* To change this template use File | Settings | File Templates. 
*/

Answer 1

Tôi không chắc chắn lý do tại sao ý tưởng không sử dụng thẻ @author theo mặc định.

Nhưng bạn có thể thay đổi hành vi này bằng cách truy cập File -> Settings -> File Templates và chỉnh sửa mục nhập File Header trong tab Includes.

Tính đến IDEA 14 đó là: File -> Settings -> Editor -> File and Code Templates -> Includes -> File Header

Answer 2

Giá trị mặc định là có thể đọc được, có thể sử dụng, nhưng không tuân theo hoặc đề nghị bất kỳ tiêu chuẩn mã hóa.

Tôi cho rằng lý do IntelliJ không sử dụng thẻ Javadoc theo mặc định, là để tránh sự can thiệp có thể xảy ra với bất kỳ tiêu chuẩn mã hóa/javadoc nào có thể tồn tại trong các cửa hàng phát triển. Nó sẽ được rõ ràng cho người dùng nếu mặc định cần phải được sửa đổi để một cái gì đó thích hợp hơn.

Tôi đang làm việc ở đâu, việc sử dụng thẻ tác giả không được khuyến khích vì nhiều lý do khác nhau.

Answer 3

Có thể đoạn trích đầu bạn hiển thị cũ hơn javadoc và chỉ được mượn từ một số tài liệu chuẩn mã hóa, có thể được viết cho C++.

Answer 4

Vì đó là mẫu tệp mặc định mà bạn phải thay đổi theo tiêu chuẩn của tổ chức hoặc sở thích của bạn.

phỏng đoán tốt nhất của tôi.

Answer 5

Trong AndroidStuido 1.0.2 trên Mac

Go trong Preferences sau đó ở bên trái khoảng File và Mã Templates Sau khi chọn tập tin và mã mẫu trên phía bên tay phải chọn bao gồm tab chọn tệp Header và thay đổi tiêu đề tệp của bạn.