javadoc error 및 no description 그리고 unmappable character for encoding ms949 문제

이클립스에서 java8 로 javadoc 생성시 처음엔

unmappable character for encoding ms949

이런 에러로 아예 파일도 생성이 안되었다

해당 문제는 윈도우 운영체제에서 export encoding 문제로

javadoc export 시에 옵션을 utf-8로 지정하면 해결이 된다.

javadoc 출력에서 next > next

Configure Javadoc options 화면에서

VM option 항목에
-encoding UTF-8 -docencoding UTF-8 -charset UTF-8

로 주면 된다

그리고 생성되는데 no description 경고나 error identifier 같은 에러 및 경고의 경우

파라미터의 @param 다음에 해당 파라미터의 이름이 공백을 기준으로 생성되는데

@param : 파람명
이런식으로 하면 구분자를 자동으로 공백으로 인식해야 되는데 인식 못하는 기호가 붙어서 이고
정사으로 처리하면
@param [자동으로 붙는 파라미터명] [설명]
이렇게 공백으로 구분을 두고 써야 에러나 경고가 안나온다
즉 파라미터명은 자동으로 생성되니 냅두고 설명만 잘쓰면 된다는거다

no description 은 아무런 설명을 달지 않으면 나오는 경고 문이다.

자바 8 부터 주석문에 대해서 강화 되었다는 소리를 들어서 인지 예전에는 인지 하지 못했던 경고 및 에러다
주석문도 잘 써야 된다.