Add some docs

Author: davidpdrsn

tests/compression/src/lib.rs

@@ -1,9 +1,5 @@
 #![allow(unused_imports)]
 
-// TODO(david): document that using a multi threaded tokio runtime is
-// required (because of `block_in_place`)
-// TODO(david): send_gzip on channel, but disabling compression of a message
-
 use self::util::*;
 use futures::{Stream, StreamExt};
 use std::{

tonic-build/src/client.rs

@@ -58,13 +58,16 @@ pub fn generate<T: Service>(
                     #service_ident::new(InterceptedService::new(inner, interceptor))
                 }
 
-                // TODO(david): docs
+                /// Compress requests with `gzip`.
+                ///
+                /// This requires the server to support it otherwise it might respond with an
+                /// error.
                 pub fn send_gzip(mut self) -> Self {
                     self.inner = self.inner.send_gzip();
                     self
                 }
 
-                // TODO(david): docs
+                /// Enable decompressing responses with `gzip`.
                 pub fn accept_gzip(mut self) -> Self {
                     self.inner = self.inner.accept_gzip();
                     self

tonic-build/src/server.rs

@@ -46,13 +46,13 @@ pub fn generate<T: Service>(
 
     let configure_compression_methods = if compression_enabled {
         quote! {
-            // TODO(david): docs
+            /// Enable decompressing requests with `gzip`.
             pub fn accept_gzip(mut self) -> Self {
                 self.accept_compression_encodings.enable_gzip();
                 self
             }
 
-            // TODO(david): docs
+            /// Compress responses with `gzip`, if the client supports it.
             pub fn send_gzip(mut self) -> Self {
                 self.send_compression_encodings.enable_gzip();
                 self