Блочные комментарии полностью сворачиваются (Eclipse, NetBeans). Почему?

Question

[Sorbing]

Здравствуйте, хабровчане.

Сразу разверну суть вопроса — почему при сворачивании (folding) ф-ции (метода) в IDE объявление ф-ции и параметры отображаются, тогда как блочные комментарии сворачиваются полностью? Почему бы при сворачивании блока документации к методу/ф-ции не отображать первую строку с кратким описанием.

Опишу суть вопроса визуально (Eclipse IDE).
Сейчас сворачивание документации работает так (не отображается краткое описание):



Но удобней было бы наблюдать свёрнутый блок коментария так:



Приходится часто сворачивать / разворачивать блоки документации или ждать хинт с описанием свернутого блока.

Проверял в IDE Eclipse и NetBeans. По Eclipse высказался тут и тут.


Что думаете по этому поводу? Или такое желаемое поведение все же не логичное?

Спасибо.

Answer 1

[Андрей]

PHPStorm


Сворачивает в

Comments

[Sorbing]

Блин! Знал что где-то подвох, нельзя просить ~ €100 за то, что есть бесплатно (IDE). Вот в Jetbrains продумали этот момент. Надеюсь в Eclipse меня услышат и подтянут этот момент. Morfi, спасибо за инфу.

Answer 2

[bald2b]

1. При наведении мыши на свернутый блок показывается описание
2. Если нажать Ctrl+Shift+Space (в Netbeans) также показывается javadoc.
Так что правильно скрывают, зачем место занимать

Comments

[Sorbing]

Вы правы — «Если нажать..». Но если свернуть все методы (Collapse All) с комментариями — они будут отображаться компактным списком и понять что это за метод можно только по его названии. Если свёрнутый блок документации каждого метода/свойства дополнить кратким описанием, то места больше это не займет.
Вместо такого списка:


Мы увидим что-то типа этого:


Вместо пустой конструкции /** мы видим short description.

[bald2b]

Я бы предложил написать к ним в issue tracker, предложение дельное, могут и принять

[Sorbing]

Я написал, но, походу промахнулся. С инглишем у меня не ахти. Не подскажете линк?

[Sorbing]

Запостил сюда.

[inox]

Проблема не в самом Eclipse, а в его реализации для конкретного языка, потому как, например, в Eclipse CDT блочные комментарии сворачиваются так, как вы и хотите.

[Sorbing]

Он чё! Уяснил. Спасибо.

Answer 3

[Sorbing]

Я так понимаю folding мало кто использует.

Answer 4

[Sorbing]

YAHOO! Только что «принял» обновления Eclipse — разработчики пофиксили сворачивание комментов (проверил в PDT и JSDT).
Нужно еще разработчикам Spket подсказать.

Comments

[Sorbing]

Скрин интересующимся:

[bald2b]

Поздравляю :)