aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/google/protobuf/service.h
diff options
context:
space:
mode:
authorGravatar kenton@google.com <kenton@google.com@630680e5-0e50-0410-840e-4b1c322b438d>2010-01-08 03:56:03 +0000
committerGravatar kenton@google.com <kenton@google.com@630680e5-0e50-0410-840e-4b1c322b438d>2010-01-08 03:56:03 +0000
commit7b7a80eae4f46cca5d3a2781b4412ef769856cdb (patch)
tree21e30be605eec4eaac32653e692ba7f1aedee9c6 /src/google/protobuf/service.h
parent83aba29ebee2bb0885ab2db04b3ad6b22463fe58 (diff)
Tweak doc comments.
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