re-arrange exports, some doc string updates

src/ws/client.rs

@@ -268,6 +268,10 @@ struct Inner {
     closed: bool,
 }
 
+/// Future that implementes client websocket handshake process.
+///
+/// It resolves to a pair of `ClientReadr` and `ClientWriter` that
+/// can be used for reading and writing websocket frames.
 pub struct ClientHandshake {
     request: Option<SendRequest>,
     tx: Option<UnboundedSender<Bytes>>,

src/ws/mod.rs

@@ -82,7 +82,7 @@ pub type WsError = ProtocolError;
 #[deprecated(since="0.4.2", note="please use `ws::HandshakeError` instead")]
 pub type WsHandshakeError = HandshakeError;
 
-/// Websocket errors
+/// Websocket protocol errors
 #[derive(Fail, Debug)]
 pub enum ProtocolError {
     /// Received an unmasked frame from client