jashkenas/coffee-script — Issue #2012: /* unbuffered Multiline Comments syntax */ for JSDoc
Author: quangv
Created: 2012-01-06 23:15:00+00:00
State: open

Okay so [JSDoc](http://code.google.com/p/jsdoc-toolkit/wiki/CookBook) syntax is awesome.

```javascript
MyClass = Class.create(
{
/**
* Description of constructor.
* @class Description of class.
* @constructs
*/
initialize: function(arg0, arg1) {
},
}
);
```
As discuss on #782 you can simply do something like

```coffeescript
class MyClass
###*
Description of constructor.
@class Description of class.
@constructs
###
constructor: (arg0, arg1)->
```

Looks good...

But when I thought about it, for production code you might not want your inline documentation to show... CoffeeScript has no way of supporting unbuffered multi-line comments.

How about `/* ... */` for unbuffered multi-line comments?

related: #1350, #1925