> The documentation does not really mention about the comment toggle working 
> with the marker symbol.

True the document is only relative to the pref for the marker, not mentioned on 
the document on the action, feel free to provide a PR to add such linking from 
the action because so far nobody has needed it.

The fact that for a lot of languages the delimited comments (eg `/*` and `*/` 
for C/C++ and many others) __do not nest__ and as such they are a problem if 
the selected lines happens to include a comment.

For example if the three lines below are selected and commented by the 
delimiting (multiple line as you call it) comments:
```C
a = 1;
b = foo(a /*parameter 1*/, 55, "whatever");
a = a + b;
```
the selected three lines are not removed as expected, instead the code seen by 
the compiler is:
```C
,55, "whatever");
a = a + b; */
```
which of course does not compile.

Whereas single line comments work fine using `Comment` and `Uncomment`.

But toggle has problems too, if you have no specifier of a marker it just 
toggles the three selected lines:

```C
pay(user_salary, monthly, to_user);
// pay(user_salary, daily, to_me);
pay(rent);
```
to
```C
// pay(user_salary, monthly, to_user);
pay(user_salary, daily, to_me);
// pay(rent);
```
which is probably not what you intended but pays me lots ;-).

If a marker is specified (eg default ~), toggle will not toggle comments that 
do not have the marker, so the result is:

```C
//~ pay(user_salary, monthly, to_user);
// pay(user_salary, daily, to_me);
//~ pay(rent);
```
and toggles back to

```C
pay(user_salary, monthly, to_user);
// pay(user_salary, daily, to_me);
pay(rent);
```



-- 
Reply to this email directly or view it on GitHub:
https://github.com/geany/geany/discussions/3997#discussioncomment-11093498
You are receiving this because you are subscribed to this thread.

Message ID: <geany/geany/repo-discussions/3997/comments/11093...@github.com>

Reply via email to