From 5e4f14fae41f67cbcb2fbe2b7901914f293837cb Mon Sep 17 00:00:00 2001 From: Thomas Van Lenten Date: Wed, 15 Mar 2017 10:50:31 -0400 Subject: [PATCH] Document deep copy in the header --- objectivec/GPBMessage.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/objectivec/GPBMessage.h b/objectivec/GPBMessage.h index c07ec8888d..2c325ba85b 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