[folding] show comment first line for folded sections

[lalmat]

I think it could be really useful to change the multiline comment folding.

When you fold a comment like this (like above php function) :

/**
 * Print person name on terminal
 *
 * @param person $p
 * @return void
 */

You see this :

/** ...

In some editors like phpStorm or Eclipse, it's folded like this :

* Print person name on terminal ...

That's very more useful ;)

Is it possible to implement this kind of folding ?

[aeschli]

This is not easy to implement with the current approach that we picked. The main reason is that our folding strategy is based on indentation only and doesn't have an understanding of what it folds (comments, blocks...). To do what you suggest it would need to have a language understanding in order to know that the folded content starts with a comment and to use the first line of the comment. Just showing the 2nd line instead of the first will not work in all cases.

We have #3422 for adding language agnostic folding which is a prerequisite

[aeschli]

Depends on #70794

[gorn]

Language agnostic folding has been implemented, so this can be implemented as well now.

[lalmat]

Yes !! Good news ! Thank you.

[abhishekmadhu]

Is someone working on a PR?
If not, I would like to try my hands on this. Will this be a good first issue for the repository?

@aeschli?

[aeschli]

@abhishekmadhu I'm not aware of anyone working on it. But it's quite a complex issue. Happy to give you more details.