Comment continuation about sublime-jsdocs

[spadgos]

It already does this, no?

The only thing is that in your second example it won't like you demonstrate because it's not a docblock (a comment block that starts with /** instead of just /*). This is by design.

[canni]

lol, it does work, maybe I was in some weird context when I had checked.

As about /* I use it a lot, but not as a function docblock but as a inline-multiline comment

In my dev team we follow simple rulre:

comments starting from // are for devs only, and they're removed automatically on deploy,
comments in:

/*
 *
 */

are meant to stay in code as important things, but invisible for doc generation software

[spadgos]

Ok, seems reasonable then. I imagine that it'll be a configuration setting which is turned off by default though.

[spadgos]

@canni - question: would it work for you if the leading * is added only if the current line starts with a comment? eg:

/*
aBlock.ofCode('which is commented out'); <<A>>
*/

/*
 * important comments to stay here or something<<B>>
 */

So, in the above, pressing enter at <<A>> would not add an asterisk (same behaviour as you see right now), but at <<B>> it would.

[canni]

I think this is good solution, but better I think it would be to write: /**/<<cursor>> move back cursor /*<<here>>*/ pres enter and this give cursor:

/*
 * <<here>>
 */

It would be simply faster and less typing required

[spadgos]

i disagree on that, actually. That's a fairly esoteric interaction -- difficult to remember when you want it to happen, and confusing when it is triggered accidentally.

How about this instead (in each of these, imagine the cursor at the |):

/*|

press: enter

/*
|
*/

press: *

/*
 *|
 */

press: enter

/*
 *
 *|
 */

Alternatively, /*| followed by ctrl+enter (or shift, whatever) would result in:

/*
 *|
 */

[canni]

First solution is good for me :)