Почему средство форматирования кода Eclipse ломает </a> в теге Javadoc @see?

Question

Я использую Eclipse 3.4 и настроил средство форматирования кода Java со всеми параметрами на вкладке Комментарии . Проблема в том, что когда я форматирую комментарий к документу, который содержит:

* @see <a href="test.html">test</a>

средство форматирования кода вставляет пробел в закрывающий HTML, разбивая его:

* @see <a href="test.html">test< /a>

Почему? Как мне остановить это?

Это не исправлено, если отключить любой из параметров на вкладке Комментарии , например Формат HTML-тегов . Единственный найденный мной обходной путь - это полностью отключить форматирование Javadoc, отключив опции Включить форматирование комментариев Javadoc и Включить параметры форматирования комментариев , что означает, что мне придется форматировать блоки комментариев вручную .

Answer 1

Я могу только предположить, что это ошибка в Eclipse. Это происходит только с тегами @ see , это также происходит со всеми 3 настройками встроенного кодировщика кода.

Есть несколько интересных ошибок, о которых уже сообщалось, но я не смог найти эту конкретную. См., Например, поиск @ см. в Eclipse Bugzilla .

Answer 2

Это может быть ошибка в Eclipse 3.4. Я использую 3.3 (M20080221-1800), и не наблюдаю такого поведения.

Answer 3

Строгие спецификации XML требуют, чтобы у самозакрывающихся тегов был пробел перед закрывающей косой чертой, например:

<gcServer enabled="true" /> <!-- note the space just after "true" -->

Я могу только предположить, как сказал Барт, что в переформаторе Eclipse есть ошибка, которая считает закрывающий тег фактически самозакрывающимся тегом. Еще одна идея: Можете ли вы проверить, что ваши теги a сбалансированы (то есть нет открытых тегов выше в документе)?