Auto-insert `//` for additional non-dartdoc comment lines

https://github.com/Dart-Code/Dart-Code/issues/147 requested automatically inserting /// when pressing Enter on a dartdoc comment line, but could we do the same for non-dartdoc comment lines? IMO we should just preserve whatever the current comment marker is.

I vaguely recall seeing some discussion about this before, but if it happened, I seem unable to find it now. Is it intentionally not done because there’s some expectation that users might be annoyed if they write a comment, hit Enter, and then expect to write code? If that’s a concern, is it possible to have an option, or maybe make, say, Enter/Shift+Enter do different things?

[DanTup]

Yes, I like that - and I think it’s reasonable to have it enabled always (as long as you haven’t set the setting to none).

I’ve added this line to the end of the setting because I also couldn’t come up with a better way, but I’m open to changing it before it ships if someone has a better idea. Thanks!

So with the default (tripleSlash), it won’t add // to the end of a comment, but it will when there is text after the caret. It’ll try to do the right thing with spaces too - so if you press <enter> with a space after the caret it will avoid inserting an additional one after the slashes.

[DanTup]

With the former, I’m in the mode of writing documentation (or at least larger) comments. In contrast, with `//, I’m usually writing a single-line comment or I’ve just commented out a block of code.

That’s fair. I’m a bit on the fence - the new behaviour surprised me a few times (because I’m used to it not happening), but a few times was helpful to.

Please do file a new issue, and I’ll add a setting. Thanks!