removed deprecated field factories from example codes, added licence tags, improved javadocs

svn changeset:7785/svn branch:6.0

1 files changed, 19 insertions, 2 deletions

diff --git a/src/com/vaadin/ui/FormFieldFactory.java b/src/com/vaadin/ui/FormFieldFactory.java
index fafe9caac7..a0dac130f8 100644
--- a/src/com/vaadin/ui/FormFieldFactory.java
+++ b/src/com/vaadin/ui/FormFieldFactory.java
@@ -1,13 +1,30 @@
+/* 
+@ITMillApache2LicenseForJavaFiles@
+ */
 package com.vaadin.ui;
 
 import java.io.Serializable;
 
 import com.vaadin.data.Item;
 
+/**
+ * Factory interface for creating new Field-instances based on {@link Item},
+ * property id and uiContext (the component responsible for displaying fields).
+ * Currently this interface is used by {@link Form}, but might later be used by
+ * some other components for {@link Field} generation.
+ * 
+ * <p>
+ * 
+ * @author IT Mill Ltd.
+ * @version
+ * @VERSION@
+ * @since 6.0
+ * @see TableFieldFactory
+ */
 public interface FormFieldFactory extends Serializable {
     /**
-     * Creates a field based on the item, property id and the component where
-     * the Field will be placed in.
+     * Creates a field based on the item, property id and the component (most
+     * commonly {@link Form}) where the Field will be presented.
      * 
      * @param item
      *            the item where the property belongs to.