parse coffee comment syntax

[hokaccha]

Add CoffeeScript comment syntax support.

set options --syntaxtype coffee.

$ yuidoc --syntaxtype coffee -e .coffee input

CoffeeScript code is this.

###*
# The test project
# @project tester
# @title The Tester
# @icon http://a.img
# @url http://one.url
# @url http://two.url
# @author admo
# @contributor davglass
# @contributor entropy
###

[travisbot]

This pull request passes (merged 36fa2df into c81f2dc).

[davglass]

@hokaccha Thanks for the Pull Request! In order for me to accept this change, I need you to sign the YUI CLA to prove that these changes are yours:

http://yuilibrary.com/contribute/cla/

Thanks

[hokaccha]

@davglass I signed YUI CLA. yuilibrary.com username is 'hokaccha'.

Thank you.

[davglass]

Thanks, as soon as it's approved I'll merge this in.

[davglass]

This is in release 0.3.19 that I just pushed up to npm. Thanks!

[esamattis]

Why not just detect the syntaxtype by file extension? Currently it seems impossible to support multilang projects.

[artsyca]

HI! I have a question about this syntax, and it's related to the 'DocBlockr' plugin for Sublime Text 3. (I'm asking a parallel question on their side.

AS it stands, this plugin outputs comments of this form:

###*
 * @method methodName
 * @param {String} foo Argument 1
 * @param {Object} config A config object
 * @param {String} config.name The name on the config object
 * @param {Function} config.callback A callback function on the config object
 * @param {Boolean} [extra=false] Do extra, optional work
 * @return {Boolean} Returns true on success
###

Which throw the dreaded warn: (docparser): Missing item type error.

Changing them to

###*
# @method methodName
# @param {String} foo Argument 1
# ...
###

or

###*
@method methodName
@param {String} foo Argument 1
...
###

will work (but is quite inconvenient for users of this plugin)

Is there any way to make yuidoc accept the first format?
(As you can imagine, I'm asking if DocBlockr can output one of the other two formats!)

Your help in this matter is greatly appreciated!