Documented WidgetFactory

svn changeset:1715/svn branch:trunk

src/com/itmill/toolkit/terminal/gwt/client/WidgetFactory.java

@@ -4,8 +4,18 @@ import com.google.gwt.user.client.ui.Widget;
 
 public interface WidgetFactory {
 
+	/** Create an uninitialized component that best matches given UIDL.
+	 * 
+	 * @param uidl UIDL to be painted with returned component.
+	 * @return New uninitialized and unregistered component that can paint given UIDL.
+	 */
 	Widget createWidget(UIDL uidl);
 
+	/** Test if the given component implementation conforms to UIDL.
+	 * 
+	 * @param currentWidget Current implementation of the component
+	 * @param uidl UIDL to test against
+	 * @return true iff createWidget would return a new component of the same class than currentWidget
+	 */
 	boolean isCorrectImplementation(Widget currentWidget, UIDL uidl);
-	
 }