Chore/semi colons (#799)

* Add helpers for easier Transports creation (#777)

* Add helpers for easier Transports creation

* Fix doctests

* Fix ' ;' occurrences

misc/mdns/src/dns.rs

@@ -54,7 +54,7 @@ pub fn build_query() -> Vec<u8> {
     // Program-generated transaction ID; unused by our implementation.
     append_u16(&mut out, rand::random());
 
-    // Flags ; 0x0 for a regular query.
+    // 0x0 flag for a regular query.
     append_u16(&mut out, 0x0);
 
     // Number of questions.
@@ -98,7 +98,7 @@ pub fn build_query_response(
     let mut out = Vec::with_capacity(320);
 
     append_u16(&mut out, id);
-    // Flags ; 0x84 for an answer.
+    // 0x84 flag for an answer.
     append_u16(&mut out, 0x8400);
     // Number of questions, answers, authorities, additionals.
     append_u16(&mut out, 0x0);
@@ -156,7 +156,7 @@ pub fn build_service_discovery_response(id: u16, ttl: Duration) -> Vec<u8> {
     let mut out = Vec::with_capacity(69);
 
     append_u16(&mut out, id);
-    // Flags ; 0x84 for an answer.
+    // 0x84 flag for an answer.
     append_u16(&mut out, 0x8400);
     // Number of questions, answers, authorities, additionals.
     append_u16(&mut out, 0x0);

misc/mdns/src/service.rs

@@ -175,7 +175,7 @@ impl MdnsService {
     /// Polls the service for packets.
     pub fn poll(&mut self) -> Async<MdnsPacket> {
         // Send a query every time `query_interval` fires.
-        // Note that we don't use a loop here ; it is pretty unlikely that we need it, and there is
+        // Note that we don't use a loop here—it is pretty unlikely that we need it, and there is
         // no point in sending multiple requests in a row.
         match self.query_interval.poll() {
             Ok(Async::Ready(_)) => {
@@ -472,7 +472,7 @@ impl<'a> fmt::Debug for MdnsResponse<'a> {
 
 /// A peer discovered by the service.
 pub struct MdnsPeer<'a> {
-    /// The original packet ; will be used to determine the addresses.
+    /// The original packet which will be used to determine the addresses.
     packet: &'a Packet<'a>,
     /// Cached value of `concat(base32(peer_id), service name)`.
     record_value: String,

protocols/identify/src/id_transport.rs

@@ -184,9 +184,9 @@ where TMuxer: muxing::StreamMuxer + Send + Sync + 'static,
                     // Here is a tricky part: we need to get back the muxer in order to return
                     // it, but it is in an `Arc`.
                     let unwrapped = Arc::try_unwrap(muxer).unwrap_or_else(|_| {
-                        panic!("we clone the Arc only to put it into substreams ; once in the \
+                        panic!("We clone the Arc only to put it into substreams. Once in the \
-                                Finishing state, no substream or upgrade exists anymore ; \
+                                Finishing state, no substream or upgrade exists anymore. \
-                                therefore there exists only one instance of the Arc; QED")
+                                Therefore, there exists only one instance of the Arc. QED")
                     });
 
                     // We leave `Poisoned` as the state when returning.

protocols/identify/src/identify.rs

@@ -107,7 +107,7 @@ where
             }
             EitherOutput::First(sender) => {
                 let observed = self.observed_addresses.get(&peer_id)
-                    .expect("We only receive events from nodes we're connected to ; we insert \
+                    .expect("We only receive events from nodes we're connected to. We insert \
                              into the hashmap when we connect to a node and remove only when we \
                              disconnect; QED");
                 self.to_answer.push((sender, observed.clone()));

protocols/kad/src/behaviour.rs

@@ -479,7 +479,7 @@ where
                 let (query, purpose, provider_peers) = self
                     .active_queries
                     .remove(&finished_query)
-                    .expect("finished_query was gathered when iterating active_queries ; qed");
+                    .expect("finished_query was gathered when iterating active_queries; QED.");
                 match purpose {
                     QueryPurpose::Initialization => {},
                     QueryPurpose::UserRequest => {

protocols/kad/src/handler.rs

@@ -745,8 +745,8 @@ fn process_kad_request<TUserData>(
 ) -> Result<KademliaHandlerEvent<TUserData>, io::Error> {
     match event {
         KadRequestMsg::Ping => {
-            // TODO: implement ; in practice the PING message is never used, so we may consider
+            // TODO: implement; although in practice the PING message is never
-            //       removing it altogether
+            //       used, so we may consider removing it altogether
             Err(io::Error::new(
                 io::ErrorKind::InvalidData,
                 "the PING Kademlia message is not implemented",

protocols/kad/src/query.rs

@@ -92,8 +92,8 @@ enum QueryStage {
     Iterating {
         /// Number of successful query results in a row that didn't find any closer node.
         // TODO: this is not great, because we don't necessarily receive responses in the order
-        //       we made the queries ; it is possible that we query multiple far-away nodes in a
+        //       we made the queries. It is possible that we query multiple far-away nodes in a
-        //       row, and obtain results before the result of the closest nodes
+        //       row, and obtain results before the result of the closest nodes.
         no_closer_in_a_row: usize,
     },