__doc__ for functions, classes, objects etc.

Peter van der Zee ecma at qfox.nl
Sun Aug 21 11:26:12 PDT 2011


On Sun, Aug 7, 2011 at 6:56 PM, Dmitry A. Soshnikov
<dmitry.soshnikov at gmail.com> wrote:
> Hi,
>
> What about to standardize (Python's) "__doc__"-umentation comments for JS?

What's the difference between that and the /** ... */ way of "JSDoc"?

/**
 * This function does stuff
 * @constructor
 * @param {Object} foo
 * @returns {Array}
 */
var f = function(){ ... };

What would a new language construct for this solve?

- peter


More information about the es-discuss mailing list