내 프로젝트의 버전 번호에 약간의 문제가 있습니다. 나는 4 개 클래스 한 두 세 네Javadoc 버전 관리
나는이 소프트웨어를 해제 처음이 예를 들어
말, 그것은 내 자바 문서에서 버전 1.0.0
으로 표시됩니다 나는 이제 테스트 클래스의 버그로 돌려 보내는 것이 @version 1.0.0
으로이 모든 클래스에 대해 의견을 두
클래스 2를 업데이트하고 버전 1.0.1을 릴리스해야합니다.
모든 클래스에서 @version 태그를 업데이트합니까?
아니면 결국 javadoc 주석에 다른 버전 번호가있는 클래스가 한꺼번에 있습니까?
정답은 버그의 영향을받는 파일을 변경하는 것입니다.
버전 또는 버전을 제어 버전으로 남겨 둡니다. 완벽한 세계에서 스크립트는 버전을 동기화 된 상태로 유지합니다.
물론이 질문은 주관적입니다. 마케팅 도구로 버전 태그를 사용하려는 경우 예, 동일한 코드를 말하는 모든 코드를 유지하려고합니다.
버그 수정은 버전 번호에서 수정 번호 (3 번째 버전) 만 변경하기 때문에 버그 수정이 전혀 영향을 미치지 않을 것이라고 생각합니다. 그리고 당신은 javadoc에 리비전 번호를 넣을 필요가 없습니다. javadoc은 API를 기술하는 데 사용되고 API는 버그 수정으로 변경되지 않기 때문에 쓸모가 없습니다. 당신은 단지 예를 들어 넣어한다는 뜻
@version 1.2하지 @version 1.2.6
귀하의 javadoc는 단지 당신이 당신의 API를 변경할 때 변경 - 당신이 주요 (1 차)를 변경하는 것보다 또는 마이너 (2nd) 버전 번호가 javadoc에 투영되어야합니다.
다른 클래스는 이전 버전과 버전 번호에서 "상속"되기 때문에 변경된 클래스의 버전 번호 만 변경해야한다고 생각합니다. 변경된 수업은 그대로 두어야합니다. 그러나 나는 그것에 대해 확실하지 않습니다.