who doesn't like conceptual comments?

Author: Stephen Hawley

SwiftRuntimeLibrary/SwiftNativeObject.cs

@@ -10,6 +10,15 @@ public abstract class SwiftNativeObject : SwiftNativeInstance, ISwiftObject {
 		SwiftMetatype class_handle;
 		SwiftObjectFlags object_flags = SwiftObjectFlags.IsSwift;
 
+
+		// this is the one standard constructor for all objects
+		// The classHandle is here so that the object matches the structure of the
+		// ObjC counterpart.
+		// "But why," you ask, "is the registry an argument since it is a singleton?"
+		// "Because it's entirely possible to have a constructor in swift that will turn into
+		// SomeObject(IntPtr someThing, SwiftMetatype classHandle)
+		// but it should be impossible to have one with the signature below since the type
+		// SwiftObjectRegistry doesn't exist in swift.
 		protected SwiftNativeObject (IntPtr handle, SwiftMetatype classHandle, SwiftObjectRegistry registry)
 		{
 			if (SwiftNativeObjectTagAttribute.IsSwiftNativeObject (this)) {