생성 된 Javadoc에 표시되는 문서 주석의 일부를 제외하는 방법

Question

프로젝트에서 우리는 API javadocs를 작성하려고합니다. 문서 세부 사항에서 벗어나 우리는 히스토리 세부 사항을 쓰고 싶다. 예를 들어 특정 이슈 수정을 위해 메소드가 수정 된 경우 해당 메소드에 대한 javadoc 주석과 함께 이슈의 세부 사항을 문서화하려고합니다.

/** 
* Displays the details for a valid registered customer against the specified <code>Integer customerId</code>.<br> 
* Responsible to check the existance of the customer before sending back the information for the "Customer Reference" screen. 
* 
* @param customerId the customer id to fetch the details for 
* @return <code>jsp</code> file name for "Customer Reference" screen along with Customer details 
* 
* BTS-1947 | custom fields not displayed correctly | 25-10-2016 | Vaibhav 
*/ 
public String displayCustomerInfo(Integer customerId) { 

문제는 우리의 javadoc 도구를 사용하여 생성의 javadoc에 부분 BTS-1947 | custom fields not displayed correctly | 25-10-2016 | Vaibhav를 표시하지 않는 것입니다. 그렇게 할 수 있습니까? 아니면 javadoc을 사용하여 업데이트 기록을 유지 관리하는 더 좋은 방법이 있습니까?

Answer 1

jdk1.7을 사용하는 경우 사용자 정의 태그를 사용할 수 있습니다. javadoc이 컴파일 될 때, 커스텀 태그를 가지고 아무것도 보이지 않습니다. 그것은 당신에게 경고를 줄 것이다. 예를 들어 : 사용자 정의 태그로 자바 독을 컴파일하는 동안

/** 
* Displays the details for a valid registered customer against the specified <code>Integer customerId</code>.<br> 
* Responsible to check the existance of the customer before sending back the information for the "Customer Reference" screen. 
* 
* @param customerId the customer id to fetch the details for 
* @return <code>jsp</code> file name for "Customer Reference" screen along with Customer details 
* 
* @custom BTS-1947 | custom fields not displayed correctly | 25-10-2016 | Vaibhav 
*/ 
public String displayCustomerInfo(Integer customerId) { 

jdk1.8 오류를 줄 것이다.

희망 사항은 도움을 받으십시오.