The JavaDoc example for Dialog seems outdated (in Beta 2):
 Dialog d = new Dialog();
 d.setHeading("Exit Warning!");
 d.addText("Do you wish to save before exiting?");
 d.setSize(300, 100);
Apparently, we use now setHeadingText() and setSize() takes strings instead. And setButtons() became setPredefinedButtons(). Oh, and addText doesn't seem to exist. Apparently one have to add widgets to this container. The Explorer Demo shows good code, fortunately (I used it before checking the JavaDoc...).
Just a heads up... I suppose you will revise the whole JavaDoc before going GA, anyway.