aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/google/protobuf/service.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/google/protobuf/service.h')
-rw-r--r--src/google/protobuf/service.h10
1 files changed, 7 insertions, 3 deletions
diff --git a/src/google/protobuf/service.h b/src/google/protobuf/service.h
index 83f5f38d..a6a7d16d 100644
--- a/src/google/protobuf/service.h
+++ b/src/google/protobuf/service.h
@@ -32,10 +32,14 @@
// Based on original Protocol Buffers design by
// Sanjay Ghemawat, Jeff Dean, and others.
//
-// This module declares the abstract interfaces underlying proto2 RPC
-// services. These are intented to be independent of any particular RPC
+// DEPRECATED: This module declares the abstract interfaces underlying proto2
+// RPC services. These are intented to be independent of any particular RPC
// implementation, so that proto2 services can be used on top of a variety
-// of implementations.
+// of implementations. Starting with version 2.3.0, RPC implementations should
+// not try to build on these, but should instead provide code generator plugins
+// which generate code specific to the particular RPC implementation. This way
+// the generated code can be more appropriate for the implementation in use
+// and can avoid unnecessary layers of indirection.
//
//
// When you use the protocol compiler to compile a service definition, it