Description Benno Baumgartner 2007-07-11 05:29:17 EDT

N20070707-0010

Given:
package test;

public class E01 {

	/**
	 * The foo method.
	 * foo is a substitute for bar.
	 * 
	 * @param param1 The first parameter
	 * @param param2
	 *            The second parameter.
	 *            If <b>null</b>the first parameter is used
	 */
	public void foo(Object param1, Object param2) {
	}

}
1. Use Eclipse [built-in] profile for code formatting
2. Format the code
Is:
package test;

public class E01 {

	/**
	 * The foo method. foo is a substitute for bar.
	 * 
	 * @param param1
	 *            The first parameter
	 * @param param2
	 *            The second parameter. If <b>null</b>the first parameter is
	 *            used
	 */
	public void foo(Object param1, Object param2) {
	}

}
Should:
package test;

public class E01 {

	/**
	 * The foo method. 
         * foo is a substitute for bar.
	 * 
	 * @param param1
	 *            The first parameter
	 * @param param2
	 *            The second parameter. 
         *            If <b>null</b>the first parameter is used
	 */
	public void foo(Object param1, Object param2) {
	}

}
Hint that the line break is preserved in comment block for param2 and comment block above the @param section.
Either:
  If ToolFactory.M_FORMAT_EXISTING do not remove line breaks in comment blocks 
Or:
  Add option 'Wrap on maximum line width' if enabled then behavior as is (default) if disabled then line breaks are untouched in comment blocks.