TooltipDialog documentation incorrect

[davidb]

See comments on http://dojotoolkit.org/book/dojo-book-0-9/part-2-dijit/layout/dialog regarding show and hide.

There is confusion as to how to invoke TooltipDialog.
Note dijit/tests/test_Dialog.html uses a DropDownButton to invoke.

[bill]

OK, I just updated that page.

[Stefan Bird]

That page still says TooltipDialog? has a hide() method, when in fact it doesn't.

As mentioned by http://dojotoolkit.org/book/dojo-book-0-9/part-2-dijit/layout/dialog#comment-16063, to programmatically hide a TooltipDialog? you need to call its onCancel() method instead, which is a little odd.

Either the documentation should be updated to state that TooltipDialog? doesn't have a hide() method and to call onCancel() instead, or a hide() method should be added (which possibly calls onCancel() internally).

[bill]

The current documentation for TooltipDialog is ​http://docs.dojocampus.org/dijit/TooltipDialog and ​http://api.dojotoolkit.org/jsdoc/1.3/dijit.TooltipDialog. The former doesn't mention any methods and the latter just has the correct list.

The dojo-book-0-9 is notorious for problems like this; it was just too hard to keep it updated so now we use the auto-generated api.dojotoolkit.org. But we haven't been maintaining it for years, you should really use the new documentation.

[bill]

PS: in case the above is unclear, I meant that we haven't been maintaining dojo-book-0-9 (http://dojotoolkit.org/book/dojo-book-0-9/part-2-dijit/layout/dialog) for years.