Here's the Javadoc example, using Doxygen syntax: /// Issues a series of barks. /// @param times the number of times to bark. /// @return true if all barks were successful. boolean bark(int times); ...