Doc tweaks

Author: sfackler

src/io/mod.rs

@@ -1,4 +1,4 @@
-//! Types and traits for TLS adaptors.
+//! Types and traits for TLS support.
 pub use priv_io::Stream;
 
 use std::error::Error;
@@ -10,7 +10,7 @@ pub mod openssl;
 #[cfg(feature = "with-security-framework")]
 pub mod security_framework;
 
-/// A trait implemented by TLS adaptors.
+/// A trait implemented by TLS streams.
 pub trait TlsStream: fmt::Debug + Read + Write + Send {
     /// Returns a reference to the underlying `Stream`.
     fn get_ref(&self) -> &Stream;
@@ -19,7 +19,8 @@ pub trait TlsStream: fmt::Debug + Read + Write + Send {
     fn get_mut(&mut self) -> &mut Stream;
 }
 
-/// A trait implemented by types that can negotiate TLS over a Postgres stream.
+/// A trait implemented by types that can initiate a TLS session over a Postgres
+/// stream.
 pub trait TlsHandshake: fmt::Debug {
     /// Performs a client-side TLS handshake, returning a wrapper around the
     /// provided stream.