Description Ulli Hafner 2007-03-01 05:20:05 EST

It would be nice, if the JavaDoc checker could be more rigid (maybe an option in the settings Java Compiler->JavaDoc). Currently. the compiler checks only for @return and @see tags if there is a valid description provided (Missing description warning). However, for @param and @throws tags, the compiler checks only for the presence of the tags and not if there is a valid content (description) provided.

Example:

	/**
	 * Changes the Password of the specified user.
	 * 
	 * @param user
	 * @param password
	 * @throws SQLException
	 * @see
	 * @return
	 */
	public boolean changePassword(String user, String password) throws SQLException;

The compiler now shows a warning for the missing description in the @see and @return tags, but not in the @param and @throws tags. It would be nice if you could add this enhancement, since these empty tags are almost useless.