Fix some warnings, add some docs

1 files changed, 7 insertions, 0 deletions

diff --git a/main/src/core/MonoDevelop.Core/MonoDevelop.Projects.Extensions/SolutionItemTypeNode.cs b/main/src/core/MonoDevelop.Core/MonoDevelop.Projects.Extensions/SolutionItemTypeNode.cs
index 37283b264d..5c00072556 100644
--- a/main/src/core/MonoDevelop.Core/MonoDevelop.Projects.Extensions/SolutionItemTypeNode.cs
+++ b/main/src/core/MonoDevelop.Core/MonoDevelop.Projects.Extensions/SolutionItemTypeNode.cs
@@ -109,6 +109,13 @@ namespace MonoDevelop.Projects.Extensions
 				return await factory.CreateItem (fileName, typeGuid);
 			}
 			try {
+				// Some subclasses (such as ProjectTypeNode) need to assign some data to
+				// the object before it is initialized. However, by default initialization
+				// is automatically made by the constructor, so to support this scenario
+				// the initialization has to be delayed. This is done by setting the
+				// MonoDevelop.DelayItemInitialization logical context property.
+				// When this property is set, the object is not initialized, and it has
+				// to be manually initialized by calling EnsureInitialized.
 				CallContext.LogicalSetData ("MonoDevelop.DelayItemInitialization", true);
 				return (SolutionItem) Activator.CreateInstance (ItemType);
 			} finally {