doc comment tweaks

1 files changed, 6 insertions, 4 deletions

diff --git a/src/google/protobuf/message.h b/src/google/protobuf/message.h
index eecd91a7..54b596d5 100644
--- a/src/google/protobuf/message.h
+++ b/src/google/protobuf/message.h
@@ -32,9 +32,10 @@
 //  Based on original Protocol Buffers design by
 //  Sanjay Ghemawat, Jeff Dean, and others.
 //
-// This file contains the abstract interface for all protocol messages.
-// Although it's possible to implement this interface manually, most users
-// will use the protocol compiler to generate implementations.
+// 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.
 //
 // Example usage:
 //
@@ -168,7 +169,8 @@ struct Metadata {
 };
 
 // Returns the EnumDescriptor for enum type E, which must be a
-// proto-declared enum type.
+// proto-declared enum type.  Code generated by the protocol compiler
+// will include specializations of this template for each enum type declared.
 template <typename E>
 const EnumDescriptor* GetEnumDescriptor();