Michael Sheets | 1 Jan 2008 09:28

Re: [SVN] r8757 (JavaScript JSDoc)

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.
Luke Daley | 2 Jan 2008 01:31
Gravatar

Re: [SVN] r8757 (JavaScript JSDoc)


On 31/12/2007, at 8:42 PM, Michael Sheets wrote:

> * Unsure of tab trigger of /* might it be trigger by accident as  
> people align comments? Would /** change that, or is it not an issue?

For JavaDoc, I set the snippet to `doc`. Not saying that's right,  
just that it's more convenient then /**

> * 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.

Again, I used `Doc Block` as the JavaDoc documentation refers to them  
as.

> * Could add a new rule to the JavaScript grammar to give doc blocks  
> their own scope to make the snippets more narrowly focused.

I agree with this.

LD.
Favicon

Re: [SVN] r8522 (JavaScript)

On Nov 24, 2007, at 5:28 AM, Michael Sheets wrote:
> [NEW] Add a Javascript beautifier script, with a shortcut of ⌃Q.

Should you commit a [CHANGED] tag since it has since changed?
For historic purposes of the changelog.

—Thomas Aylott – subtleGradient—
Takaaki Kato | 3 Jan 2008 03:00
Gravatar

[SVN] r8758

090 (environment variables) is done. 4 files to go

Changed:
U   trunk/Manual/pages/ja/090_environment_variables.mdown
U   trunk/Manual/pages/ja/_read_me.mdown
Takaaki Kato | 3 Jan 2008 05:37
Gravatar

[SVN] r8759

file 040 is translated

Changed:
U   trunk/Manual/pages/ja/040_working_with_text.mdown
U   trunk/Manual/pages/ja/_read_me.mdown
Luke Daley | 3 Jan 2008 07:49
Gravatar

[SVN] r8760 (Groovy)

* Added '#values' item in repository to group strings, vars, structures, consts etc.
* Seperated class object definition
* Negative numbers now scoped properly
* Added assignment operator
* Added 'constant.other.key.groovy' for map keys
* Moved 'constant.numeric' out into seperate collection
* Added scoping for annotations (not quite complete)
* Added scoping for structures (arrays and maps)

Changed:
U   branches/Groovy.tmbundle/Syntaxes/Groovy.tmLanguage
Luke Daley | 3 Jan 2008 08:57
Gravatar

[SVN] r8761 (Groovy)

* Improved operator coverage
* Improved annotation support
* Added more support functions

Changed:
U   branches/Groovy.tmbundle/Syntaxes/Groovy.tmLanguage
Michael Sheets | 5 Jan 2008 11:08

[SVN] r8762 (HTML Revised)

First try at doctype matching.

Changed:
U   trunk/Review/Bundles/HTML Revised.tmbundle/Syntaxes/HTML.plist
Michael Sheets | 6 Jan 2008 08:12

[SVN] r8763 (Bundle Development)

Add new rule for a repository item containing a pattern array.

Changed:
A   trunk/Bundles/Bundle Development.tmbundle/Snippets/Patterns (Repository).tmSnippet
U   trunk/Bundles/Bundle Development.tmbundle/info.plist
Luke Daley | 6 Jan 2008 09:12
Gravatar

[SVN] r8764 (Groovy)

Improved test assertion snippets

Changed:
U   branches/Groovy.tmbundle/Snippets/assert(__).tmSnippet
U   branches/Groovy.tmbundle/Snippets/assertEquals(__).tmSnippet
A   branches/Groovy.tmbundle/Snippets/assertFalse.tmSnippet
U   branches/Groovy.tmbundle/Snippets/assertNotEquals(__).tmSnippet
U   branches/Groovy.tmbundle/Snippets/assertNotNull(__).tmSnippet
U   branches/Groovy.tmbundle/Snippets/assertNull(__).tmSnippet
A   branches/Groovy.tmbundle/Snippets/assertSame.tmSnippet
A   branches/Groovy.tmbundle/Snippets/assertTrue.tmSnippet
U   branches/Groovy.tmbundle/Snippets/shouldFail(__) { __ }.tmSnippet

Gmane