Bug 228320

The below method of formatting javadoc comments has achieved a (small) level of popularity due to its increased legibility:

/**
 * Apply the foo algorithm to the specified Bar.
 *
 * @param Bar
 * The Bar.
 *
 * @param count
 * The number of times the algorithm should be applied
 * to the specified Bar. This must be a positive prime
 * number, except during a full moon, when the specified
 * value must be a member of the Fibonacci sequence.
 *
 * @param quick
 * If TRUE, apply the "quick" (less accurate)
 * implementation of the algorithm. Note that sheep-style
 * Bar objects are currently not supported with the quick
 * implementation.
 *
 * @return
 * The number of wizard levels gained while applying the
 * algorithm.
 *
 * @throws FooException
 * If there was a problem applying the algorithm to the
 * specified Bar.
 *
 * @author Alvin
 */
public int foo(Bar bar, int count, boolean quick) throws FooException;

In order for Netbeans to be able to format comments in this manner, two new formatter settings are required. This issue covers the "descriptions on new line" setting, which would force all descriptions to start on a new line, instead of starting on the same line as the javadoc keyword/parameter name.