При добавлении многострочного комментария в Eclipse и его форматировании (Ctrl + Shift + F), он автоматически помещает звездочку (*) в начале каждой новой строки внутри блока комментариев.
/*
* this is my comment
*/
В чем причина такого поведения?
Как отключить его?
В Eclipse 4.2 и более поздних версиях решение: Window → Preferences → Java → Code Style → Formatter →
$profileName → Изменить...() → Комментарии → * Отменить проверку [] Включить форматирование комментариев блока.
Обратите внимание, что автор запросил комментарии к блоку (/*), а не комментарии Javadoc (/**).
Преодоление ведущего * для комментариев Javadoc un-check [] Включить форматирование комментариев Javadoc
(*) Если $profileName → Edit... не работает, создайте новый шаблон с помощью "New...".
Это стандартный формат javadoc. Параметры форматирования в eclipse находятся в правом щелчке на вашем проекте- > properties- > Java Code Style- > Formatter- > Edit- > Comment tab, но я не вижу возможности отключить это поведение.
Перейдите к Tools/Options/Editor/Formatting и выберите Language = Java, Category = Comments и снимите флажок Add Leading Star.
Пожалуйста, не делайте этого.
Это был стандартный способ написания комментариев блока с первых дней языка программирования C. Нарушение таких соглашений делает его более трудным для других (включая автоматизированные инструменты) для чтения вашего кода.
Если вам нужно быстро комментировать/раскомментировать Java-код, вы можете попробовать ярлык Ctrl+/. Он будет использовать однострочные комментарии (//) для комментирования текущей строки или любого количества выделенных строк кода.
С eclipse 4.2.1 я использовал функцию форматирования off/on, не забудьте оставить тег форматирования на той же строке, что и тег комментариев, другой из которых будет выглядеть кошмар звезд.
// @formatter:off
/*
Eclipse your * are messing up my comments big time and If I used you
more often I'd put a patch together to add back in the "Add Leading Star" option
*/
// @formatter:on
Функции включения/выключения должны быть повернуты "on" в настройках Eclipse: Java > Стиль кодa > Formatter. Нажмите кнопку "Изменить", "Выкл./Вкл. Теги", отметьте "Включить выкл./Вкл. Теги".
С
Как отключить форматирование кода Eclipse для определенных разделов кода Java?
Кроме того. Для удобства использования я меняю теги на //off//on
Аналогичная статья Как отключить '*' в многострочных комментариях в Eclipse?
Перейти к Window/Preferences/Code Style/Formatter.
В Active Profile вместо Eclipse [Встроенный] создайте новый профиль и нажмите "Изменить".
Нажмите на раскрывающееся менюComments и снимите флажок: