aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorGravatar Thomas Van Lenten <thomasvl@google.com>2017-03-15 10:50:31 -0400
committerGravatar Thomas Van Lenten <thomasvl@google.com>2017-03-15 10:50:31 -0400
commit5e4f14fae41f67cbcb2fbe2b7901914f293837cb (patch)
treeccad44221612b83a12114ad0a56a771020263f62
parent43f2db776c265a9b22500e7a67af583b2b4ce85f (diff)
Document deep copy in the header
-rw-r--r--objectivec/GPBMessage.h5
1 files changed, 5 insertions, 0 deletions
diff --git a/objectivec/GPBMessage.h b/objectivec/GPBMessage.h
index c07ec888..2c325ba8 100644
--- a/objectivec/GPBMessage.h
+++ b/objectivec/GPBMessage.h
@@ -66,6 +66,11 @@ CF_EXTERN_C_END
/**
* Base class that each generated message subclasses from.
*
+ * @note @c NSCopying support is a "deep copy", in that all sub objects are
+ * copied. Just like you wouldn't want a UIView/NSView trying to
+ * exist in two places, you don't want a sub message to be a property
+ * property of two other messages.
+ *
* @note While the class support NSSecureCoding, if the message has any
* extensions, they will end up reloaded in @c unknownFields as there is
* no way for the @c NSCoding plumbing to pass through a