Как отключить форматирование JavaDoc в IntelliJ IDEA

Я хочу использовать стиль JavaDoc:

/**
 * Description.
 *
 * @param param1     parameter description
 * @param param2     parameter description
 * @return           return description.
 * @throws exception exception description.
 */

Как вы можете видеть, я хочу использовать выравнивание для правильного описания параметров, возвратов и исключений.

Этот стиль используется в http://www.oracle.com/technetwork/articles/java/index-137868.html

Итак, мой вопрос:, как я могу настроить этот стиль в IDEA 2016.xx или как я могу отключить форматирование для javaDoc без использования специальных комментариев //@formatter:off и //@formatter:on, если это возможно?

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

PS: Я пробовал форматирование в файле- > Настройки- > Редактор- > Стиль кода- > Java- > JavaDoc, Включить форматирование JavaDoc в выключенное (и воспроизведение со всеми настройками в этом разделе). И мое выравнивание по JavaDoc сбрасывается на Ctrl-Alt-L

Спасибо за отзыв!

Ответы

Ответ 1

Есть три плагина для intellij, которые могут помочь:

  • автоматическое выравнивание
  • вкладка
  • Строковое манипулирование

Для меня лучше всего подходит last. Когда я формирую текст, я выбираю часть текста, который я хочу отформатировать, щелкните правой кнопкой мыши → String Manipulation → Align → Align to Column. Здесь вам нужно немного поэкспериментировать с настройками. Это работает для меня.

Смотрите снимок экрана: введите описание изображения здесь Я добавил пробел (синий маркер на изображении) в качестве разделителя; выбрал комментарий javadoc и использовал вышеупомянутую функцию. Он работает.