+ various javadoc improvements

src/main/java/org/springframework/data/gemfire/GemfireTemplate.java

@@ -137,7 +137,7 @@ public class GemfireTemplate extends GemfireAccessor {
 	 * Create a close-suppressing proxy for the given GemFire {@link Region}.
 	 * Called by the <code>execute</code> method.
 	 * 
-	 * @param pm the GemFire Region to create a proxy for
+	 * @param region the GemFire Region to create a proxy for
 	 * @return the Region proxy, implementing all interfaces
 	 * implemented by the passed-in Region object 
 	 * @see Region#close()

src/main/java/org/springframework/data/gemfire/RegionFactoryBean.java

@@ -230,7 +230,7 @@ public class RegionFactoryBean<K, V> implements DisposableBean, FactoryBean<Regi
 	 * Sets the data policy. Used only when a new region is created.
 	 * Overrides the settings specified through {@link #setAttributes(RegionAttributes)}.
 	 * 
-	 * @param scope
+	 * @param dataPolicy the region data policy
 	 */
 	public void setDataPolicy(DataPolicy dataPolicy) {
 		this.dataPolicy = dataPolicy;

src/main/java/org/springframework/data/gemfire/package-info.java

@@ -0,0 +1,14 @@
+
+/**
+ *
+ * Package providing integration of 
+ * <a href="http://www.gemstone.com/products/gemfire">GemFire</a>
+ * with Spring concepts.
+ *  
+ * <p/>Contains helper classes, a tempalte plus callback for GemFire
+ * access and an implementation of Spring's transaction SPI for local
+ * GemFire transactions.
+ *
+ */
+package org.springframework.data.gemfire;
+

src/main/java/org/springframework/data/gemfire/serialization/AsmInstantiatorGenerator.java

@@ -35,7 +35,7 @@ import com.gemstone.gemfire.DataSerializable;
 import com.gemstone.gemfire.Instantiator;
 
 /**
- * ASM based {@link InstantiatorFactory} implementation. This class relies on ASM 2.x package
+ * ASM based {@link InstantiatorGenerator} implementation. This class relies on ASM 2.x package
  * repacked by Spring framework to minimize the number of dependencies and avoid any versioning
  * confusion.
  * 

src/main/java/org/springframework/data/gemfire/serialization/InstantiatorFactoryBean.java

@@ -110,7 +110,7 @@ public class InstantiatorFactoryBean implements BeanClassLoaderAware, FactoryBea
 	 * Sets the auto-registration of this {@link Instantiator} during the container startup.
 	 * Default is true, meaning the registration will occur once this factory is initialized.
 	 * 
-	 * @see #register(Instantiator)
+	 * @see Instantiator#register(Instantiator)
 	 * @param autoRegister the autoRegister to set
 	 */
 	public void setAutoRegister(boolean autoRegister) {

src/main/java/org/springframework/data/gemfire/serialization/InstantiatorGenerator.java

@@ -29,8 +29,10 @@ public interface InstantiatorGenerator {
 
 	/**
 	 * Returns a (potentially new) Instantiator that optimizes the instantiation of the given types.
-	 *  
-	 * @return
+	 *
+	 * @param clazz class produced by the instantiator 
+	 * @param classId instantiator class id
+	 * @return an instantiator optimized for the given type.
 	 */
 	Instantiator getInstantiator(Class<? extends DataSerializable> clazz, int classId);
 }

src/main/java/org/springframework/data/gemfire/serialization/package-info.java

@@ -0,0 +1,9 @@
+
+/**
+ *
+ * Classes supporting the <code>org.springframework.data.gemfire</code> package.
+ * Provides various serialization helpers.
+ *
+ */
+package org.springframework.data.gemfire.serialization;
+