On Dec 31, 2007, at 3:12 PM, Thomas Aylott - subtleGradient wrote:

Can we get a general show of hands on how widely used JSDoc is, and if it's the only doc system for JavaScript? If it is we might want to consider just moving this into the main JavaScript bundle?

I think there's another one. Someone will have to get a real answer though. Maybe ask around in all the js library IRC channels.

Looking at Google I've found two others, but will need a Javascript guy to tell me how popular they all are, and how cross-compatible the syntax is, if at all.

* The "Comment" snippet seems misnamed, it should be Doc Comment or similar. Or seeing as we have a block comment shortcut (⌘⌥/) we could either make it that a second press of the shortcut would convert the current comment block into a doc comment block, or make a second shortcut.

I'd like to keep the comment toggle on and off only. A 3 state toggle doesn't sound fun. But that might actually be the best option since it's a known shortcut.

Well that is the thing, currently the block comment is not a toggle, hitting it twice only inserts a second nested block comment. So right now it would mean not really loosing any functionality, however I can easily see having it a toggle in the future. We could do for the third shortcut of either ⌃⌥⌘/ or ⌥⌘⇧/ and make it a standard shortcut to insert a documentation block comment.
_______________________________________________
textmate-dev mailing list
[email protected]
http://lists.macromates.com/mailman/listinfo/textmate-dev

Reply via email to