Update comment at the top of message.h and message_lite.h to document that it should only be extended by gencode and not user code.

protobuf-github-bot · copybara-github · commit 6a6ba52361b7 · 2025-06-23T13:47:26.000-07:00
This was already the intended state, this only updates the comment to clarify.

PiperOrigin-RevId: 774911342
diff --git a/src/google/protobuf/message.h b/src/google/protobuf/message.h
@@ -10,9 +10,13 @@
 //  Sanjay Ghemawat, Jeff Dean, and others.
 //
 // Defines Message, the abstract interface implemented by non-lite
-// protocol message objects.  Although it's possible to implement this
-// interface manually, most users will use the protocol compiler to
-// generate implementations.
+// protocol message objects.
+//
+// This is only intended to be extended by protoc created gencode or types
+// defined in the Protobuf runtime. It is not intended or supported for
+// application code to extend this class, and any protected methods may be
+// removed without being it being considered a breaking change as long as the
+// corresponding gencode does not use it.
 //
 // Example usage:
 //
@@ -180,7 +184,7 @@ class MessageReflectionFriend;
 namespace expr {
 class CelMapReflectionFriend;  // field_backed_map_impl.cc
 class SudoMapReflectionFriend;
-}
+}  // namespace expr
 
 namespace internal {
 class MapFieldPrinterHelper;  // text_format.cc
diff --git a/src/google/protobuf/message_lite.h b/src/google/protobuf/message_lite.h
@@ -12,6 +12,12 @@
 //
 // Defines MessageLite, the abstract interface implemented by all (lite
 // and non-lite) protocol message objects.
+//
+// This is only intended to be extended by protoc created gencode or types
+// defined in the Protobuf runtime. It is not intended or supported for
+// application code to extend this class, and any protected methods may be
+// removed without being it being considered a breaking change as long as the
+// corresponding gencode does not use it.
 
 #ifndef GOOGLE_PROTOBUF_MESSAGE_LITE_H__
 #define GOOGLE_PROTOBUF_MESSAGE_LITE_H__
