Add API docs for Clock, GoogleMap, YahooMap, Chart, FilteringTable widgets

[bill]

Clock, GoogleMap?, YahooMap?, Chart, FilteringTable? widgets need summary for the widget itself (ex: "interface to yahoo maps that ..."), and comment for each parameter to the widget.

[bill]

OK, I'm looking. YahooMaps?, GoogleMaps?, and FilteringTable? need comments for the widgets themselves, and comments on the all the parameters to the widgets. Actually, the parameters need to be declared in the property list, not in the constrctor. I think this is the part you don't like but that's the standard so you have to do it.

[Tom Trenka]

Either you're blind or I'm dreaming; I just looked in the repo and all of those widget are fully documented.

​http://trac.dojotoolkit.org/browser/trunk/src/widget/GoogleMap.js ​http://trac.dojotoolkit.org/browser/trunk/src/widget/FilteringTable.js ​http://trac.dojotoolkit.org/browser/trunk/src/widget/YahooMap.js

[bill]

I think you're probably misunderstanding about the documentation format we're using (for the rest of the widgets). If you look at FilteringTable?, for instance:

	<table dojoType="filteringTable" id="parsedFromHtml" 
		multiple="true" alternateRows="true" maxSortable="2"
		cellpadding="0" cellspacing="0" border="0">

It has parameters like "multiple", "alternateRows", etc. Each of those parameters needs to be documented. And also you need a comment right above the dojo.widget.defineWidget() call. Compare to something like

​http://trac.dojotoolkit.org/browser/trunk/src/widget/DatePicker.js

[Tom Trenka]

I can do that at some point.

It would have been nice to know that there was a fairly extensive set of documentation changes that only affected widgets, though.

[Tom Trenka]

(In [6502]) Fixes #1781.

[(none)]

Milestone 0.4.1 deleted