Description Frederic Fusier 2008-06-20 10:43:47 EDT

Using 3.4 candidate I20080617-2000.

Working on fix for bug 233259, I discovered that the comment formatter does not work properly with the string references.

The following test case:
public class Test {
        /**
         * @see "string reference: 01234567"
         * @see "string reference: 012345678"
         * @see "string reference: 01234567 90"
         * @see "string reference: 01234567890123"
         */
        void foo() {
        }
}

is formatted as follow using Eclipse built-in + 'max line width for comments'=40:
public class Test {
	/**
	 * @see "string reference: 01234567"
	 * @see 
	 *      "string reference: 012345678"
	 * @see 
	 *      "string reference: 01234567 90"
	 * @see 
	 *      "string reference: 01234567890123"
	 */
	void foo() {
	}
}
I would expect the string reference to stay on the same line than the @see tag...

Note that 3.3 formatter behavior is worst as it splits the string, hence producing a javadoc syntax error:
public class Test {
	/**
	 * @see "string reference: 01234567"
	 * @see "string reference:
	 *      012345678"
	 * @see "string reference: 01234567
	 *      90"
	 * @see "string reference:
	 *      01234567890123"
	 */
	void foo() {
	}
}