Use jsDoc style for block comments

A new PR on 0.9-work in place of previous #1166.
Block comments especially ones with `@param` and `@constructor` should ideally follow jsDoc style ie, `/** ... */`