annotate-extension/README.md

Brackets JSDoc Annotate
=================

A brackets extension to generate JSDoc annotations for your functions.

To install, place the ```annotate``` folder inside the ```brackets/src/extensions/user``` folder.

**Compatible with Brackets Sprint10**

Usage
=====
Open a project in Brackets, place your cursor before a function definition, and select ```Annotate``` form the ```Edit``` menu.
Alternatively, use the keyboard shortcut `CTRL`+`Shift`+`D` on Windows, or `⌘`+`Shift`+`D` on Mac.

This will create a JSDoc like annotation according to the function signature.  It will add ```@private``` if the function starts with an underscore. It will create a ```@param``` for each parameter.


Known issues
=====

No ```@return``` is generated since the extension only looks at the function signature to generate the annotation, not its body.
First commit 2012-06-13 16:12:30 +00:00			`Brackets JSDoc Annotate`
			`=================`

			`A brackets extension to generate JSDoc annotations for your functions.`

			To install, place the ```annotate``` folder inside the ```brackets/src/extensions/user``` folder.

updated for brackets sprint10 2012-06-22 10:06:39 +00:00			`Compatible with Brackets Sprint10`

First commit 2012-06-13 16:12:30 +00:00			`Usage`
			`=====`
			Open a project in Brackets, place your cursor before a function definition, and select ```Annotate``` form the ```Edit``` menu.
Update README.md 2012-10-07 17:48:45 +00:00			Alternatively, use the keyboard shortcut `CTRL`+`Shift`+`D` on Windows, or `⌘`+`Shift`+`D` on Mac.
First commit 2012-06-13 16:12:30 +00:00
			This will create a JSDoc like annotation according to the function signature. It will add ```@private``` if the function starts with an underscore. It will create a ```@param``` for each parameter.


			`Known issues`
			`=====`

Added support for function expressions 2012-09-24 08:06:31 +00:00			No ```@return``` is generated since the extension only looks at the function signature to generate the annotation, not its body.