use java doc syntax

[bakesteve]

Any chance that we could use java docs - much more widely used IMHO than haskell-like
also means anyone who marked up fro google closure compiler can use this out the box

[uxdiogenes]

Agreed. +1

[owain]

Or JSDoc syntax might make more sense... very similar to javadoc but also gets utilised by things like google closure compiler...

https://developers.google.com/closure/compiler/docs/js-for-compiler

[goatslacker]

-1

Would be cool to compile these into something Google Closure compiler can use but no on the Java docs, they are gross and verbose.