document the dojo API

[dante]

generic ticket (because I can't find one that exists) to ref when making changes to trunk/dojo regarding documentation. 1.0 is right around the corner, so the time is now to bring all your parameters and summaries up to date. there are a lot of undocumented or poorly documented public APIs.

[dante]

(In [10691]) refs #4611 - small doc fixes to loader.js

[dante]

(In [10692]) refs #4611 - a simple php doc-parser explorer that doesn't need drupal or databases. meant to be used to provide a 'live' example of what parser is reading from the source tree.

for example: _browse.php?ns=dojo&file=_base/html.js&ajaxy=1 and ​http://redesign.dojotoolkit.org/?q=jsdoc/dojo/HEAD/object/dojo._base.html/dojo.toggleClass&source

both show the same parameter parsing issue in dojo.toggleClass putting the first word of the param as the param type ( /* if */ ).

can be used to parse custom docs using the doc parser based on files in modules/

[dante]

(In [10771]) refs #4611 - cannot have (lowercased) reserved words as the first word in a summary or comment block, or the parser goes into a different tangent. minor cleanups and assit parser.

[dante]

(In [10780]) refs #4611 - a few doc touchups to dijit - getting close to 1.0 we need to double check things are being parsed. if they are not it's either syntax problem or a parser bug, either way needs to be addressed.

[dante]

random doc patch and jslint readiness

[dante]

(In [10972]) refs #4611 - documentation cleanups (and minor jslint-love) to RichText?.js

[dante]

there are a few of these floating around. documentation is a constant :)

[dante]

(In [11659]) refs #4611 - doc updates

[dante]

(In [11660]) refs #4611 - remove usage:, use example: (though not being picked up atm) and refs #4901 - one this.inherited() change

[bill]

(In [13869]) Missing summary: keyword; refs #4611