update Core inline docs

[alex]

after discussion w/ pottedmeat, we need to:

• refactor Base and Core docs to drop the "usage" param and replace it with "examples"
• make use of /*===== blocks for documentation of generated or clever definitions
• ensure full doc coverage

[alex]

(In [11112]) usage -> examples. Refs #4820

[pottedmeat]

(In [11140]) Refs #4820. Updated examples and descriptions that use code to work with tomorrow's API tool update.

[alex]

(In [11151]) expanding documentation and reducing file size for dojo.NodeList?. Refs #4820

[alex]

(In [11152]) minor doc update. Refs #4820

[pottedmeat]

(In [11198]) Refs #4820. Update to show external-doc style

[alex]

(In [11215]) docs for dojo.loaded and dojo.unloaded. Refs #4820

[alex]

(In [11216]) make dojo.delegate public and add docs. Refs #4820

[alex]

(In [11217]) add back in docs for deprecated() and experimental(). Refs #4820

[alex]

(In [11218]) updating inline docs such that they get picked up by the parser. Refs #4820

[alex]

(In [11224]) go with "example" instead of "usage". Refs #4820

[alex]

(In [11225]) clean up doc formatting and a bit of structure. Also some code size reductions. Refs #4820. Refs #3961

[jburke]

(In [11254]) Refs #4820. Format the kwArgs docs for IO methods so they show up nice in the parsed docs.

[jburke]

(In [11255]) Refs #4820. Try to avoid the user from hitting a bundle loading error case.

[pottedmeat]

(In [11336]) Refs #4820. Update documentation

[pottedmeat]

(In [11339]) Refs #4820. Cleaning up documentation

[pottedmeat]

(In [11356]) Refs #4820. Documentation updates

[pottedmeat]

(In [11363]) Refs #4820. Documentation updates

[alex]

(In [11376]) minor doc updates. Refs #4820

[alex]

(In [11377]) minor doc update. Refs #4820

[alex]

(In [11378]) minor doc updates and formatting for debugging. Refs #4820. toJson() no longer tries to handle DOM nodes. Fixes #4186

[alex]

(In [11379]) documentation updates. Refs #4820

[alex]

(In [11380]) documentation updates. Refs #4820

[alex]

(In [11381]) minor formatting updates. Refs #4820

[alex]

(In [11382]) minor doc formatting updates for readability. Refs #4820

[alex]

(In [11383]) clean up doc formatting. Refs #4820

[alex]

(In [11385]) comment formatting cleanup. Refs #4820

[alex]

(In [11386]) update for dojo.cookie() docs. Refs #4820

[alex]

(In [11387]) doc updates to ensure that we capture the optional property bags correctly. Refs #4820

[dante]

(In [11481]) refs #4820 - dijit doc updates to trunk only

[dante]

(In [11482]) refs #4820 - more simple doc fill-ins

[dante]

(In [11488]) refs #4820 - doc updates

[dante]

(In [11489]) refs #4820 - more docs

[dante]

(In [11490]) refs #4820 - documnetation updates

[dante]

(In [11496]) refs #4820 - dialog doc update

[dante]

(In [11498]) refs #4820 and refs #4901 - doc additions and one small superlclass.apply change

[dante]

(In [11500]) refs #4820 - doc updates

[dante]

(In [11501]) refs #4820 - more doc updates.

[peller]

(In [11755]) Fix doc typos. Refs #4820

[alex]

(In [12289]) expand docs for registerModulePath(). Refs #4820

[pottedmeat]

(In [12348]) Refs #4820

• The bane of Torrey's existence is now fixed
• FadeArgs? will now show up properly in docs
• !strict

[peller]

(In [12607]) Fix up comments to match signatures, show multiple types on arguments and document their behavior, use common naming of parameters. Refs #4820

[peller]

(In [12665]) fixup docs. Refs #4820 !strict

[peller]

(In [12667]) Better, but still not great, definition for dojo.data. Refs #4820

[peller]

(In [12701]) Ok, it really was JavaScript? 1.6, despite the misleading URLs. Refs #4820

[bill]

(In [13921]) Put colon after "summary" keyword, refs #4820 !strict