Запретить Eclipse преобразовывать символ @ в тегах <pre>javadoc в @ - PullRequest
0 голосов
/ 16 октября 2019

У меня есть комментарии Javadoc для одного из моих пакетов (package-info.java), которые в основном выглядят так:

<code>/**
 * <pre>
 * {@code
 * // Some comments...
 * final Foo<Integer> foo = new Foo<>(0);
 * }
 * 
* * / package com.holt.mypackage;

Я также включил Сохранить действия с помощью Форматировать все строки в свойствах проекта. Каждый раз, когда я сохраняю файл, Eclipse заменяет {@code на:

* {
*   &#64;code

... полностью ломая мой Javadoc.

Я пытался использовать <pre> и <code> вручную, нозатем плагин Maven javadoc жалуется на недопустимые символы < и > в HTML (из-за Foo<>). Если я отключу Сохранить действия , все будет хорошо работать от Eclipse до Maven.

Есть ли способ запретить Eclipse заменять такие символы?

1 Ответ

1 голос
/ 17 октября 2019

Как указано здесь вам необходимо «повернуть» Форматировать фрагменты кода Java внутри тега «pre» setting »:

  1. Window > Preferences
  2. Java > Code Style > Formatter
  3. Если у вас нет пользовательского профиля, нажмите New...
  4. Edit...
  5. Comments> Снимите отметку Форматировать фрагменты кода Java ...

В результате Eclipse IDE больше не будет форматировать содержимое тегов <pre>.

Если вы все еще хотите воспользоватьсяформатирование советую использовать тег <code>. Вам просто нужно правильно экранировать символы <>, как показано ниже:

/**
 * 
 * 
 * // Some comments...
 * final Foo<Integer> foo = new Foo<>(0);
 * }
 * 
 * 
* * / package com.holt.mypackage;

См. этот SO ответ .

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...