From 9abfa5f170bd8b2770da6e682958da039160d64c Mon Sep 17 00:00:00 2001
From: lumi <lumi@pew.im>
Date: Tue, 21 Feb 2017 13:55:20 +0100
Subject: [PATCH] document ClientBuilder

---
 src/client.rs | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/client.rs b/src/client.rs
index 5f28806..9e3c54b 100644
--- a/src/client.rs
+++ b/src/client.rs
@@ -14,6 +14,7 @@ use xml::reader::XmlEvent as ReaderEvent;
 
 use std::sync::mpsc::{Receiver, channel};
 
+/// A builder for `Client`s.
 pub struct ClientBuilder {
     jid: Jid,
     host: Option<String>,
@@ -21,6 +22,7 @@ pub struct ClientBuilder {
 }
 
 impl ClientBuilder {
+    /// Create a new builder for an XMPP client that will connect to `jid` with default parameters.
     pub fn new(jid: Jid) -> ClientBuilder {
         ClientBuilder {
             jid: jid,
@@ -29,16 +31,19 @@ impl ClientBuilder {
         }
     }
 
+    /// Set the host to connect to.
     pub fn host(mut self, host: String) -> ClientBuilder {
         self.host = Some(host);
         self
     }
 
+    /// Set the port to connect to.
     pub fn port(mut self, port: u16) -> ClientBuilder {
         self.port = port;
         self
     }
 
+    /// Connects to the server and returns a `Client` when succesful.
     pub fn connect(self) -> Result<Client, Error> {
         let host = &self.host.unwrap_or(self.jid.domain.clone());
         let mut transport = SslTransport::connect(host, self.port)?;