Неверный разрыв строки в комментариях к Javadoc в Eclipse

Question

Есть небольшая, но раздражающая ошибка, я думаю, во встроенном форматировщике Java Eclipse.У меня есть комментарий Javadoc, который выглядит следующим образом:

/**
 * - - - stuff - - - {@code mTasksBelow}.
 */

, где точка в конце находится в столбце 81. Форматировщик настроен на перенос комментариев Javadoc в строке 80. К сожалению, когда я форматирую код, онделает это:

/**
 * - - - stuff - - - {@code mTasksBelow}
 * .
 */

Это помещает пробел между текстом и периодом в сгенерированном выводе, поэтому браузер, отображающий Javadoc в HTML, например, также будет думать, что это нормально, чтобы разбить там.

Похоже, что этого не произойдет, если точка не следует за тегом Javadoc.(Например, если строка заканчивается закрывающей круглой скобкой и точкой в ​​столбце 81, она будет правильно разрываться перед последним словом.)

Я мог бы переместить столбец переноса, но это только переместило бы проблему.Я не хочу отключать разрывы строк, потому что мне нравится, чтобы мой источник Javadoc был таким же читаемым, как и сгенерированный вывод.Есть какие-то настройки, которые я пропускаю или это действительно ошибка?

Answer 1

Что ж, тут не так уж много веселья. Чтобы обойти это, попробуйте включить / выключить теги в формататоре Eclipse.

Окно -> Настройки -> Java -> Форматтер -> Редактировать -> Выкл. / Вкл. Теги -> Включить Выкл. / Вкл. Теги

Затем вам необходимо окружить свой комментарий этими тегами, чтобы средство форматирования не касалось его (обратите внимание, что теги должны быть в отдельных блоках комментариев, иначе Eclipse будет их игнорировать). Например:

//@formatter:off
/**
 * Oddly formatted comment.              MUHAHAHAHAH :)
 **/
//@formatter:on

Presto ... Formatter не будет касаться этого. Проверено на Juno на Fedora 17. Надеюсь, это поможет.

Answer 2

Ну, теперь это новая ошибка Eclipse .Очевидно, он все еще будет присутствовать в первом выпуске Indigo.