aboutsummaryrefslogtreecommitdiffhomepage
path: root/python
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 /python
parent83aba29ebee2bb0885ab2db04b3ad6b22463fe58 (diff)
Tweak doc comments.
Diffstat (limited to 'python')
-rwxr-xr-xpython/google/protobuf/service.py8
1 files changed, 6 insertions, 2 deletions
diff --git a/python/google/protobuf/service.py b/python/google/protobuf/service.py
index dd136c9a..180b70e8 100755
--- a/python/google/protobuf/service.py
+++ b/python/google/protobuf/service.py
@@ -28,12 +28,16 @@
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-"""Declares the RPC service interfaces.
+"""DEPRECATED: Declares the RPC service interfaces.
This module declares the abstract interfaces underlying proto2 RPC
services. These are intended 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.
"""
__author__ = 'petar@google.com (Petar Petrov)'