Вы можете использовать javadoc
для создания документации для вас, при условии, что вы добавляете комментарии javadoc к своему методу.
Например, предположим, что у вашего класса есть метод User getUser(int id)
. Также предположим, что ваш класс находится в пакете com.example.myproject
. Непосредственно перед определением метода вы должны поместить что-то вроде этого
/**
* Returns a user given an id
*
* @param id the id the User has on database
* @return An instance of <code>User</code> corresponding to the given id
*/
public User getUser(int userId) {
Обратите внимание, что комментарий начинается с /**
, а не с /*
.
Как только вы это сделаете, вы можете вызвать javadoc
, чтобы сгенерировать html-документацию для вашего пакета.
javadoc com.example.yourproject
Здесь - руководство для javadoc
с дальнейшими инструкциями, если вам нужно сделать что-нибудь более причудливое. И здесь - несколько советов о том, как лучше всего написать вашу документацию (устаревшую, но все же хорошую).