Остановить Eclipse от искажения моих комментариев

Есть ли способ остановить затмение от искажения комментариев в моих исходных файлах?

Моя главная проблема - не дать ему обернуть их словами. Мне удалось настроить eclipse так, чтобы он не переносил код на слова, но, похоже, он все еще делает это с комментариями.

Код, который я ввожу так:

public int myVariable = 100; // this variable is a very interesting variable and it does lots of stuff

Закончите так:

public int myVariable = 100; // this variable
                             // is a very
                             // interesting
                             // variable and
                             // it does lots
                             // of stuff

eclipse comments code-formatting
person Omar Kooheji    schedule 19.10.2009    source источник
comment
Хотя я в целом против размещения комментариев после кода, проблема актуальна и в других отношениях: Eclipse иногда искажает HTML в Javadoc или автоматически создает не-Javadoc комментарии для участников, чтобы они больше не отображались одинаково. Очень некрасиво.   -  person Joey    schedule 19.10.2009
comment
@Johannes: достаточно просто отключить форматирование кода для всех комментариев (включая Javadoc)   -  person Jonathan Fingland    schedule 19.10.2009
comment
Я тоже против комментариев после кода, но наш ведущий разработчик не против, а искаженный код eclipse делает поиск файлов для изменений действительно сложным.   -  person Omar Kooheji    schedule 19.10.2009
comment
Я слышал, что люди возражают против комментариев, но почему после кода? Это что-то религиозное?   -  person orbfish    schedule 04.02.2011
comment
Это просто глупое религиозное предпочтение (говорить людям, что разрешены только стратегические, а не тактические комментарии). Если у вас есть очень короткий тактический комментарий, то его размещение в конце строки может быть вполне уместным. В качестве альтернативы можно было бы добавить целую новую строку выше, которая занимает место по вертикали. Разработчики часто недооценивают эффект расточительного использования вертикального пространства. Я думаю, что метод намного легче читать, если весь метод виден на одном экране, без вертикальной прокрутки. Тактические комментарии могут помочь в этом. Нет причин удалять инструменты из набора инструментов.   -  person Nate    schedule 13.08.2011
comment
Аналогичное поведение наблюдается в Oxygen.1 Eclipse 4.7.1. У меня включен один активный профиль форматирования, и он записывает изменения (как только я обнаружил, что вам нужно включить запись предпочтений Oomph в другом месте). Но настройка «Сохранить пробел между кодом и строковыми комментариями» не действует. Я также отключил форматирование строковых комментариев. Нет эффекта. Переключение Никогда не соединять линии не действует. Нет настроек для конкретного проекта.   -  person Alan    schedule 08.10.2017

Ответы (5)


arrow_upward
16
arrow_downward

Перейдите в меню "Окно" -> настройки
выберите интересующий вас редактор из списка слева. (например, Java)
затем должен быть подраздел под названием "Стиль кода", а под ним «Формат».

Затем вам нужно будет создать новый профиль форматирования. (Встроенный профиль не редактируется) На последней вкладке конфигурации профиля есть опции для форматирования комментариев

person Jonathan Fingland    schedule 19.10.2009

arrow_upward
74
arrow_downward

Существует еще одно решение, которое можно использовать для подавления форматирования комментариев к определенным блокам. Используйте /*- (обратите внимание на дефис) в начале комментария к блоку, и форматирование не повлияет на форматирование остальной части файла.

/*-
 * Here is a block comment with some very special
 * formatting that I want indent(1) to ignore.
 *
 *    one
 *        two
 *            three
 */

Источник: http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-141999.html#680

person Michelle Crane    schedule 28.03.2011
comment
Лучший ответ. ДОЛЖЕН быть ответ. - person Andrew Mackenzie; 14.02.2013
comment
Красиво - как раз то, что я искал! - person Joe; 04.05.2013
comment
Нет, похоже, это недопустимо для комментариев /**. Какие-либо предложения? - person King Midas; 21.10.2014
comment
Обновлен URL-адрес документов оракула. oracle.com/technetwork/java/javase/documentation/ - person Will Vanderhoef; 15.01.2015

arrow_upward
13
arrow_downward

  1. Перейдите в «Настройки» -> «Java» -> «Стиль кода» -> «Форматтер».
  2. Там отредактируйте профиль и перейдите на последнюю вкладку под названием «Комментарии».
  3. Снимите флажок «Включить форматирование строкового комментария»
person Simon Lehmann    schedule 19.10.2009
comment
Tx... также флажок для отключения форматирования блочного комментария, чего я и хотел... - person mike rodent; 14.03.2017
comment
Мне помогли строки «Никогда не присоединяйся». - person George; 04.11.2017

arrow_upward
1
arrow_downward

Окно->Настройки->Java->Стиль кода->Формат. Создайте новый форматер. Нажмите «Изменить», а затем выберите вкладку «Комментарии», снятые флажки «Включить форматирование строкового комментария» и «Включить форматирование блочного комментария».

person Srinivasu    schedule 03.04.2013
comment
Это идентично ответу @Simon Lehmann, сделанному намного раньше, чем вы ответили здесь ... -1 для вас, +1 для него. - person cellepo; 28.12.2015

arrow_upward
0
arrow_downward

Вы можете использовать <pre></pre> в оболочке, этот блок не будет форматироваться.

/*
 * <pre class="prettyprint">
 * public class Activity extends ApplicationContext {
 *     protected void onCreate(Bundle savedInstanceState);
 *
 *     protected void onStart();
 *
 *     protected void onRestart();
 *
 *     protected void onResume();
 *
 *     protected void onPause();
 *
 *     protected void onStop();
 *
 *     protected void onDestroy();
 * }
 * </pre>
 */
person Yang J    schedule 07.12.2019