clean up class comments

src/Spring/Spring.Aop/Aop/Framework/AutoProxy/AbstractAdvisorAutoProxyCreator.cs

@@ -39,10 +39,10 @@ namespace Spring.Aop.Framework.AutoProxy
     /// any particular aspects, such as pooling aspects.
     /// </summary>
     /// <remarks>
-    /// <p>Subclasses must implement the abstract findCandidateAdvisors() method
+    /// <p>Subclasses must implement the abstract FindCandidateAdvisors() method
     /// to return a list of Advisors applying to any object. Subclasses can also
-    /// override the inherited shouldSkip() method to exclude certain objects
-    /// from autoproxying, but they must be careful to invoke the shouldSkip()
+    /// override the inherited ShouldSkip() method to exclude certain objects
+    /// from autoproxying, but they must be careful to invoke the ShouldSkip()
     /// method of this class, which tries to avoid circular reference problems
     /// and infinite loops.</p>
     /// <p>Advisors or advices requiring ordering should implement the Ordered interface.

src/Spring/Spring.Core/Objects/Factory/Config/IInstantiationAwareObjectPostProcessor.cs

@@ -27,15 +27,22 @@ namespace Spring.Objects.Factory.Config {
 	/// <summary>
 	/// Subinterface of
 	/// <see cref="Spring.Objects.Factory.Config.IObjectPostProcessor"/>
-	/// that adds a before-instantiation callback.
+	/// that adds a before-instantiation callback and a callback after instantiation but before
+	/// explicit properties are set or autowiring occurs.
 	/// </summary>
 	/// <remarks>
-	/// <p>
-	/// Typical use cases might include being used to suppress the default
-	/// instantiation of specific target objects, perhaps in favour of creating
-	/// proxies with special <c>Spring.Aop.ITargetSource</c>s (pooling targets,
-	/// lazily initializing targets, etc).
-	/// </p>
+	/// <para>
+	/// Typically used to suppress default instantiation for specific target objects,
+	/// for example to create proxies with special <c>Spring.Aop.ITargetSource</c>s (pooling targets,
+	/// lazily initializing targets, etc), or to implement additional injection strategies such as field
+	/// injection.
+	/// </para>
+	/// <para>
+	/// NOTE: This interface is a special purpose interface, mainly for internal use within the framework.
+	/// It is recommended to implement the plain <see cref="IObjectPostProcessor"/> interface as far as 
+	/// possible, or to derive from <see cref="IInstantiationAwareObjectPostProcessor"/> in order to be shielded
+	/// from extension to this interface.
+	/// </para>
 	/// </remarks>
 	/// <author>Juergen Hoeller</author>
 	/// <author>Rick Evans (.NET)</author>